Spike 打开后提示 BB60C 固件过旧/要求升级，或自己写的程序调用 API 报错，怎么处理？

故障现象

三种典型表现：

1. Spike 能识别设备，但弹出提示要求更新设备固件，升级过程中断或反复回到同一提示；
2. 同一台仪器在不同电脑上表现不一致——新装的电脑提示"设备不支持"或功能缺失（如打不开实时/IQ 相关菜单）；
3. 用 C/C++、Python、LabVIEW 等二次开发调用 BB60C API 时返回错误码，或设备枚举不到，但 Spike 本身能正常连。

原因分析

BB60C 的软件栈由三层耦合：Spike 桌面软件版本 + 设备固件版本 + API（开发包）版本，三者必须互相兼容。公开资料明确存在对应关系，例如 Firmware Version 6 支持快速 I/Q 与实时调谐速度、适配 Spike 3.0.11 与 BB60C API 3.0.6；Firmware Version 7 增加 USB 3.0 数据传输能力。另外自 Spike 3.0.0 起，Signal Hound 用单一软件平台服务全系列频谱仪，老 BBApp 时代的文档与新版不再一一对应——按旧文档操作新版软件，是"看起来功能不见了"的主要原因。

处理步骤

一、固件与软件版本对齐（表现 1、2）

1. 只从官方下载页取包。 到 Signal Hound 官方支持页 BB60C/BB60A Downloads 下载最新 Spike、对应固件更新工具与固件文件，不要用代理网站的历史压缩包。
2. 升级前把链路做到最稳。 固件升级最怕中途断连——用后置原生 USB 3.0 口、原装短线、不经过任何 Hub，关闭屏幕保护与睡眠，笔记本务必接电源。
3. 先关 Spike 再升级。 升级工具运行时关闭所有 Spike 实例与其他可能占用设备的程序（GNU Radio、MATLAB、自研上位机、SoapySDR 宿主程序），否则设备被占用会导致刷写失败。
4. 升级完必须重启用一次。 固件写入后把 USB 拔出重插，等设备指示灯稳定绿色，再启动 Spike 核对显示的固件版本是否已变更。
5. 仍报"过旧"时的顺序。 逐个核对 Spike 版本、API 版本、固件版本三者是否与官方兼容表匹配。若只升 Spike 未升固件（或反之），提示会一直存在。多台设备批量升级时，务必确认是否为同一硬件版本（BB60C 与 BB60A、BB60D 固件不通用，刷错版本可能造成设备无法启动）。

二、二次开发（API）连不上（表现 3）

1. 运行时依赖。 API 通常需配套运行时库（如 MSVC 运行库、32/64 位运行时），程序位数必须与 API 库位数一致——64 位程序链接 32 位库是常见报错原因。
2. 驱动与共享冲突。 Spike 运行时会独占设备。先彻底关闭 Spike，再启动自研程序。 反之亦然。同一时刻两者抢设备，表现为 API 返回"设备已被占用/无法打开"。
3. 多设备场景用序列号寻址。 同时挂多台 BB60C 时，必须按序列号显式指定目标设备，否则默认打开的设备与预期不一致，看似"连接成功但设置没生效"。
4. 系统平台支持范围。 官方 API 支持 Windows 与 Linux；公开通知显示 BB 系列后续扩展了对通用 ARM Linux（AArch64）与 Apple Silicon Mac 的支持。若在不受支持的平台（如某些国产系统未装 Wine/兼容层）上调用，会出现枚举失败——先确认平台在支持列表内。
5. 调用顺序规范化。 标准流程为：枚举设备 → 打开 → 设置参考源/衰减/增益 → 设置中心频率与跨度 → 调取数据。跳过必需步骤（如未选择正确的输入/参考配置）会返回参数错误。
6. 交叉验证。 用官方示例程序在同一台电脑跑一次，若示例正常而自研程序报错，问题在程序侧；若示例也失败，回到固件/驱动/占用问题排查。

三、避免版本混乱的管理建议

给每台仪器建一张卡片：设备型号 + 序列号 + 硬件版本 + 固件版本 + Spike 版本 + API 版本 + 验证通过的电脑。设备转手、软件重装时按卡核对，能省掉大量"查不出来"的时间。

（依据 Signal Hound 官方下载页版本说明、BB60C 用户手册与官方平台支持通知整理）