简介：AD9361_CS_Installer_v215.7z 是面向 AD936X 系列射频收发器用户的官方配置工具安装包，版本 v215，适合无线通信、SDR、测试测量与雷达系统工程师用于理解寄存器含义、生成初始配置表并加快系统调试。压缩包共 217 个文件，约 165.33MB，以 71 个 mst、69 个 cab、46 个 msi 等安装组件为主，辅以 13 个 rtf、10 个 pdf 文档及少量 exe、xml、dll 文件，兼顾安装部署与说明查阅。已有 438 人学习。包内工具通常提供寄存器浏览器、配置生成器、示例配置和文档支持，可帮助读者把工作模式、频率、增益、滤波器等参数落实为可用的寄存器配置，减少手工查表与试错，提升射频前端设计与验证效率。

1. AD936X 的 CS 安装包：它不是一个驱动，是一台“寄存器提词器”

第一次拿到 AD9361_CS_Installer_v215.7z 的人，八成会以为这是驱动或者固件烧写工具。解压完发现是个 Windows 桌面程序，双击弹出一堆下拉框，填了几个数不知道下一步，就关掉了。AD936X 这类 2×2 收发器的启动过程，本质上就是几百条 SPI 寄存器写操作——采样率、模拟带宽、本振频率、各级增益、直流与正交校准，全都藏在那 10 位地址空间里。CS 这套工具干的事，就是把你在界面上填的数字翻译成这张寄存器表，同时充当一块连到板子上的 USB 前端。它适合三类人：刚接手评估板、SPI 都还没通的新手；要复现一份初始化序列的 FPGA 或嵌入式工程师；手里有一份跑不通的配置、想找个参照做 diff 的射频同学。装它之前有几件事必须先想清楚，否则大半时间不是耗在参数上，而是耗在设备管理器和驱动签名上。

2. 装前把环境钉死：Windows 版本、运行库和那个“未知设备”

2.1 安装包里三层分工：GUI、USB 通道、SPI 帧

先把调用链捋清楚，后面出问题才知道该在哪一层停手。CS 的界面只负责参数编排和脚本导出，它本身并不直接碰芯片。真正的路径是：界面把参数打包，通过 USB 下发到板载控制器（多数板子是 USB 转 SPI 桥，或者直接挂在 FPGA 的 USB 核上），控制器再按 AD936X 的时序把这些字节一个 bit 一个 bit 推到 SPI 总线上。也就是说，CS 是“提词器”，念台词的是桥后面的那颗控制器。

再往下就是芯片侧的帧格式了。AD936X 的 SPI 访问是 24 个时钟周期：前 16 位是指令段，最高位是读写标志，中间 10 位是地址（覆盖 0x000 到 0x3FF），低位填充；后 8 位是数据段。地址宽度只有 10 位这件事，直接决定了后面所有脚本的边界检查逻辑——超过 0x3FF 的地址一定是导出或解析出了错，不可能是芯片的问题。

链路拆完，排错就有了顺序感：界面连不上，先怀疑 USB 层；能连上但读回全是 0xFF 或 0x00，问题在 SPI 层；SPI 正常但状态机不推进，才轮到寄存器序列本身。很多人在第三步反复折腾配置，其实是第二步的线接错了。

2.2 解压到纯英文路径，并先留一份哈希

7z 包在 Windows 上双击解压，默认会落到带空格甚至中文的目录里。CS 生成脚本时会把路径写进临时文件，路径一长或者带非 ASCII 字符，导出的表就可能被截断成半截，而且它不报错，你在后面调试时会以为是自己寄存器写错了。我一般固定解到一个短的英文目录。

# 解到短路径，避免后续生成脚本时路径被截断 7z x AD9361_CS_Installer_v215.7z -oD:/ad936x_cs -y # 解压后先算一次哈希留档，方便日后确认装的是同一份东西 certutil -hashfile D:/ad936x_cs/setup.exe SHA256

第一条命令里-o后面跟输出目录，-y表示全部覆盖确认，避免中途停下来等人。第二条用的是 Windows 自带的 certutil，-hashfile指定目标文件，算法选 SHA256。算出来的一串记在笔记里，以后换了机器、换了安装包，先比一次哈希，能省掉“为什么同样的配置在我这跑不通”这类扯皮。

另外三样东西要提前确认：系统版本（老版本安装器在较新的 Windows 上会卡在驱动安装阶段）、VC++ 运行库、以及管理员权限。最后一条最容易被忽略——不以管理员身份跑安装程序，驱动文件会装到用户目录而不是系统驱动目录，设备管理器里就会永远挂着一个黄叹号。

2.3 设备管理器里的黄叹号：三种成因逐个排

板子插上，设备管理器里出现一个带黄叹号的“未知设备”，这是最高频的第一次翻车。成因基本就三类，按概率从高到低排。

第一类是驱动签名。较新的 Windows 默认强制驱动签名，安装包里带的驱动如果签名较老，会被直接拦掉。判断方法很简单：右键设备看“属性 → 详细信息 → 硬件 ID”，如果能读出正常的 VID/PID，说明设备枚举是成功的，纯粹是驱动没绑上。解决办法是在启动设置里临时允许未签名的驱动加载，装完再恢复，别长期关着。

第二类是线。USB 线分充电线和数据线，充电线只有电源两芯，插上去板子灯亮，但枚举不出来。这个坑我见过不止一次，现象是设备管理器里连未知设备都不出现，一点反应没有。换一根确认能传数据的线，或者直接换 USB 口（前置面板的口供电和信号质量都差一些，尽量用主板直出的口）。

第三类是安装顺序。先插板子再装软件，Windows 会抢先用自带的通用驱动去匹配，等安装程序再想绑自己的驱动时，设备已经被占住了。正确顺序是先装完 CS 和驱动，重启，再上电插板子。如果已经反了，到设备管理器里卸载设备并勾上“删除驱动程序软件”，拔掉重插再来一遍。

提示：这三类里只有第一类需要改系统设置，改完记得恢复。剩下两类都是物理层和顺序问题，别一上来就去动签名。

2.4 装完的第一件事不是填参数，是确认能读写

界面能打开不代表链路通。安装完成后，先做一次最朴素的读写验证：在 CS 里点读取，看能不能读到芯片的产品标识寄存器。AD936X 的 0x000 地址是产品 ID，不同型号读回的值不同，具体数值对照手册里的表。读回来的如果是 0xFF，说明 MISO 被上拉、芯片根本没应答；如果是 0x00，可能是 MOSI 环回或者 MISO 被下拉。两种情况都别急着怀疑芯片坏了，先看片选和时钟。

这一步过了，再去看波形。CS 里一般带一个简单的收发面板，能配本振、能看接收数据的时域。本振设到 1 GHz 附近，接收端接一根短线或者天线，能看到底噪随增益变化，基本就说明 SPI 配置和数据接口都活着了。这时候再去改采样率、带宽这些参数，改动才有反馈。

3. 从图形界面到寄存器表：把一份 AD936X 配置变成能跑的序列

3.1 AD936X 上电后的四个阶段，CS 只负责第二段

搞不清阶段划分，就会把所有问题都归到“配置写错了”。实际上 AD936X 从上电到出数据，分四段，责任方各不相同。

第一段是供电与复位。几路电源的上电顺序、参考时钟稳定、RESETB 释放，这些是硬件的事，CS 管不了。参考时钟没稳就去写 SPI，写进去的值会莫名其妙地丢。

第二段是 SPI 配置。使能 SPI、配时钟分频、配两级 PLL（基带 PLL 和射频 PLL）、配各级抽取/插值滤波器、配数据接口模式。这一段是 CS 的主场，导出脚本就是这一段。

第三段是校准。基带的直流偏移、射频直流偏移、TX 和 RX 的正交校准，全在这段跑。校准要花几百毫秒，期间芯片不接受正常收发。

第四段是把使能状态机推进到目标状态（RX、TX 或 FDD）。这一步做完，数据接口上才开始有有效帧。

分清楚这四段的意义在于：CS 导出的脚本只覆盖第二段和第四段，第三段的校准通常由脚本里的一段专用写入触发，或者由驱动自己完成。如果你把导出的表一股脑从头写到尾，中间没留校准时间，现象就是“配置全写进去了，但前几百毫秒数据全是垃圾”。

3.2 五个必须先定死的参数

在 CS 里填参数之前，这五个数得先和硬件对齐，任何一个对不上，后面全白干。

参考时钟这一项，很多人以为“板子上标了 40M 就是 40M”，实际晶振有偏差，CS 里填 40 MHz 而实际是 39.9 MHz，本振就会偏出几十 kHz。做窄带应用时这个偏差足够让信号跑出滤波器。参考时钟的准确值，用频率计测一次比看丝印靠谱。

采样率这一项，要和 FPGA 侧的时钟配置严格对应。CS 里设 61.44 MSPS，FPGA 侧按 30.72 去解，出来的 I/Q 就是两倍速的错位数据，频谱上看着像镜像，其实是帧解析错了。这类问题在频谱仪上最难认，因为“看起来像有信号”。

3.3 导出 CSV 还是 C 数组：两种产物的用法差别

CS 一般提供两种导出形式。CSV 是给人看的，一行一个地址和值，方便 diff 和审阅；C 数组是给编译器的，直接塞进固件里循环写。两种都要导，用途完全不同。

调试阶段用 CSV。板子跑不通的时候，把 CS 导出的 CSV 和你固件里实际写下去的表逐行 diff，能立刻看出是漏了某一段、还是某一行的值不一样。这个动作比盯着代码看半小时有效得多。

量产或固化阶段用 C 数组。但要注意数组里的顺序不能随便调，尤其是涉及使能位和状态机推进的那几条，位置错了整段配置就废了。

还有一个容易忽略的点：CS 导出的表里有相当一部分是“写进去但读不回来”的寄存器，这类只能写不能验证，出了错没有回读可对。所以导出之后第一件事不是直接烧，是先做结构体检。

3.4 用 Python 给导出的寄存器表做一次体检

下面这段脚本不碰硬件，纯粹对导出的 CSV 做静态检查。它的价值在于：能在上板之前抓出地址越界、值越界、重复地址、以及使能位写错位置这四类错误。

import csv import re import sys from collections import Counter ADDR_MAX = 0x3FF # AD936X 的地址空间只有 10 位 ENSM_REG = 0x3F # 使能状态机控制寄存器 def load_table(path): """读取 CS 导出的寄存器表，兼容逗号/制表符分隔和带注释行的文件。""" rows = [] with open(path, newline='', encoding='utf-8-sig') as f: for lineno, raw in enumerate(f, 1): line = raw.strip() # 跳过空行和常见注释前缀 if not line or line.startswith(('#', '//', ';')): continue parts = [p.strip() for p in re.split(r'[,\t;]+', line) if p.strip()] if len(parts) < 2: continue try: addr = int(parts[0], 16) # 地址按十六进制解析 val = int(parts[1], 16) # 数据段固定 8 bit except ValueError: continue # 表头、说明行直接跳过 rows.append((lineno, addr, val)) return rows def check(path): rows = load_table(path) problems = [] addr_cnt = Counter(a for _, a, _ in rows) for addr, cnt in addr_cnt.items(): if cnt > 3: problems.append(f"地址 0x{addr:03X} 出现 {cnt} 次，确认是否有意为之") for lineno, addr, val in rows: if addr > ADDR_MAX: problems.append(f"第 {lineno} 行地址 0x{addr:X} 越界（超过 10 bit）") if not 0 <= val <= 0xFF: problems.append(f"第 {lineno} 行数据 0x{val:X} 超过 8 bit") ensm_pos = [i for i, (_, a, _) in enumerate(rows) if a == ENSM_REG] if not ensm_pos: problems.append("整张表里没有写 0x3F，状态机不会被推进") elif ensm_pos[-1] != len(rows) - 1: problems.append(f"0x3F 最后一次出现在第 {ensm_pos[-1] + 1} 条，后面还有 {len(rows) - 1 - ensm_pos[-1]} 条写入") return len(rows), problems if __name__ == "__main__": count, issues = check(sys.argv[1]) print(f"共解析 {count} 条写入") for p in issues: print(" [问题]", p) if not issues: print("结构检查通过")

这段代码的逻辑很直白：load_table负责脏活，把各种分隔符和注释行吃掉，只留地址和值；check做四件事——统计重复地址（有些寄存器确实要写多次，超过三次就值得看一眼）、检查地址是否超出 10 位、检查数据是否超出 8 位、以及检查 0x3F 这条关键写入是不是压在表尾。

参数上只有一个地方需要按实际情况改：ENSM_REG。不同型号和不同版本的配置表，状态机控制在寄存器映射里的位置可能不一样，用之前对一眼手册。ADDR_MAX和 8 位数据是 AD936X 的硬约束，不用改。

跑完这个检查，再去上板，能把一大半“配置看起来写了但没生效”的问题挡在板子外面。血泪经验是：先把表体检一遍，比在示波器前面蹲一下午便宜太多。

4. 避坑：五个让 CS 和 AD936X 对不上的现场

4.1 逐条拆解：现象、原因、解决

现场一：能连上，读回来的值全是 0xFF。

现象是 CS 界面一切正常，点读取，每个寄存器都返回 0xFF，看起来像是芯片里存了全 1。原因是 MISO 被上拉，芯片根本没在应答——可能是片选 CSB 没接或者接错，也可能是 SPI 的时钟极性/相位和芯片要求不一致，导致采样点全错。解决顺序：先用示波器看 CSB 有没有拉低、SCLK 有没有波形；再看 CPOL/CPHA 配置，AD936X 用的是特定的 SPI 模式，模式配错时数据位会整体错开；最后把 SCLK 从几 MHz 降到 1 MHz 试一次，长线或者飞线的情况下时序裕量很容易不够。

现场二：设备管理器里一个设备正常，另一个挂了黄叹号。

现象是插上板子后出现两个 USB 设备，一个能用，另一个永远装不上。原因是这块板子做成了 USB 复合设备，安装程序只成功绑定了其中一个接口。解决：在设备管理器里对那个黄叹号手动“更新驱动程序 → 浏览计算机 → 指向安装目录下的驱动文件夹”，让它按 INF 匹配，不要用自动搜索。如果还是不行，先卸载设备并勾选删除驱动，重启后重新走一遍安装程序。

现场三：脚本全写进去了，状态机卡在 ALERT 不往前走。

现象是所有寄存器写入都返回成功，但读状态位一直是 ALERT，数据接口没有帧。原因通常是 0x3F 这条使能写入的位置不对——写在了配置中途，后面的配置把它覆盖掉了，或者干脆漏了最后的推进步骤。解决：把 0x3F 的写入挪到表的最后，前面所有时钟、PLL、滤波器、接口配置都写完之后再动它。用上文的体检脚本能直接抓到这一类。

现场四：一上电就采数据，前几百毫秒全是噪声和直流。

现象是采集软件一开就录，录下来的头一段完全不可用。原因是校准没跑完。AD936X 的直流偏移校准和正交校准要几百毫秒，这段时间内输出的是中间态。解决：在脚本里把校准触发之后留足等待时间，或者去读校准完成标志位，等它置位再开始收发。别用固定 delay 拍脑袋，不同温度、不同批次芯片的校准时间会有差异。

现场五：同样的配置，评估板上正常，自研板上完全不通。

现象是 CS 导出的表在评估板上跑得好好的，搬到自研板就废。原因是两边的硬件前提不一样：参考时钟频率不同、数据接口从 LVDS 改成了 CMOS、电源上电顺序不同。解决：先把参考时钟和接口模式这两项对齐，再逐段比对两份配置表，用 diff 工具一行一行看，差异通常集中在前几十行。别指望“拷过去就能跑”，硬件前提变了，配置表就得跟着变。

4.2 症状对照表：先看哪里再看哪里

出问题的时候最忌乱试。按这张表从上往下走，每一步都有明确的判据。

这张表的价值不在“全”，在于顺序。很多人一上来就怀疑芯片坏了，实际上前五行全是外围问题，芯片本身的概率最低。

4.3 复现顺序：我一般按这个顺序重来一遍

一旦链路出问题，不要在原配置上打补丁，直接从干净状态重来，顺序固定。

第一步，断掉所有配置，只做供电和复位，测参考时钟。频率和幅度都对，才往下走。第二步，只写 SPI 使能和最基本的几条，读产品 ID，确认能读能写。第三步，加载完整的配置表但跳过校准，读回关键寄存器，确认写进去的值能读出来。第四步，触发校准，等完成标志。第五步，推进状态机，看数据接口上有没有帧。第六步，才去接天线看波形。

这个顺序每步都有独立判据，坏在哪一步一目了然。跳过前面几步直接上完整配置，出问题时你面对的是一个黑匣子，只能靠猜。

5. 上电后的头三百毫秒：三步回读把链路钉死

真正能省时间的不是配置写得多漂亮，是有一套固定的回读动作，每次上电都跑一遍。我把它压成三步，写在同一个脚本里，硬件侧只依赖一个标准 SPI 接口。

import spidev import time SPI_BUS, SPI_CS, SPI_HZ = 0, 0, 5_000_000 # 先降速，稳定后再提 def xfer(addr, data=None): """24 bit 帧：16 bit 指令(读写位 + 10 bit 地址) + 8 bit 数据。""" word = (addr & 0x3FF) << 4 if data is not None: word |= 0x8000 # 最高位置 1 表示写 tx = [(word >> 8) & 0xFF, word & 0xFF, 0x00 if data is None else data & 0xFF] rx = spi.xfer2(tx) return rx[2] # 数据段在第三个字节回来 spi = spidev.SpiDev() spi.open(SPI_BUS, SPI_CS) spi.max_speed_hz = SPI_HZ spi.mode = 0 # 第一步：读产品标识，确认 SPI 通路活着 pid = xfer(0x000) print(f"PRODUCT_ID = 0x{pid:02X}") if pid in (0x00, 0xFF): raise SystemExit("SPI 无应答，先查片选、时钟和线序") # 第二步：读一条已知配置，确认写进去的值真的落盘 test_addr, test_val = 0x3F, 0x01 xfer(test_addr, test_val) back = xfer(test_addr) print(f"回读 0x{test_addr:03X} = 0x{back:02X}（写入 0x{test_val:02X}）") # 第三步：等校准标志，等不到就别往下走 deadline = time.time() + 2.0 while time.time() < deadline: if xfer(0x000) not in (0x00, 0xFF): break time.sleep(0.05) print("链路自检结束")

xfer里最需要注意的是位移量：addr & 0x3FF是 10 位地址，左移 4 位填进指令段的中段，0x8000是读写标志。这个布局和手册里的 SPI 帧图对得上，不同型号如果帧格式有差异，改这两处就行。SPI_HZ一开始设 5 MHz 是故意的——飞线、长排线、电平转换芯片都会吃掉时序裕量，先低速确认通路，稳定之后再往 20 MHz 以上提。

三步里第二步最容易被跳过，但它恰恰是最有用的：读产品 ID 只证明“能通信”，读回一条自己刚写的值才证明“写得进去”。这两件事在很多板子上是分开失败的。

第三步的写法是个占位逻辑，实际应该换成读校准完成对应的状态位，具体地址查手册。我用一个循环加超时，是因为校准卡死时最怕无限等——超时退出比等到天荒地老强。

最后说个习惯。早些年我调一块自研板，配置表是从评估板原样拷过来的，上电就是不出数据。查了两天，最后发现是自研板把参考时钟从 40 MHz 换成了 38.4 MHz，配置表里那一行没改，PLL 锁到了隔壁频点，频谱上看什么都有，就是不像信号。从那以后我每次拿到一份新配置，都强制先跑一遍上面这三步回读，再对比参考时钟和接口模式这两项——多花的五分钟，比在频谱仪前面蹲一天划算。希望帮到你。

本文还有配套的精品资源，点击获取