FAQ - INGCHIPS

1. 可以在哪些操作系统下进行 ING918 项目开发？

SDK 支持 Windows、Linux、mac OS。但有的 IDE 不支持 Linux、mac OS。

2. 如何快速评估射频性能？

方法 1：使用蓝牙综测仪评估
1. 通过 ingWizard 主菜单 Test → Download BQB RF Test Binary 下载 BQB 测试程序；
2. 将 HCI 串口连接到蓝牙综测仪进行自动测试。
串口参数：
- 二线串口，无硬件流控
- TX、RX 分别为 PIN 2、3
- 波特率：115200
- 数据位：8
- 停止位：1
- 校验：无
` `
方法 2：使用频谱仪评估
1. 通过 ingWizard 主菜单 Test → Download BQB RF Test Binary 下载 BQB 测试程序；
2. 通过 ingWizard 主菜单 Tools → More → BQB RF Test 打开测试工具；
3. 通过 BQB RF Test 工具控制设备发送 CW 信号，使用频谱仪观察信号强度、频偏。
或者，
1. 自行开发程序，调用 gap_vendor_tx_continuous_wave API 发送 CW 信号，使用频谱仪观察信号强度、频偏。
` `
方法 3：使用开发板做简易评估

详情。

3. 如何抓取 log？

针对不同的问题需要抓取不同类型的 log：

死机（出现 HARD_FAULT、ASSERTION、HEAP_OOM 等事件）

此时需要抓取存储转储（Memory Dump）及各寄存器的值。Memory Dump 有两种方法：
- 通过调试器抓取
  
  具体步骤可参阅用户手册。
  
  对于启用了省电模式的场景，建议在出现问题之后，再挂接调试器抓取 log。某些 IDE 在挂接调试器进入调试模式时，总是会复位芯片，所以推荐使用 J-Link Commander。
- 使用代码导出
  
  trace.c 模块里提供了 trace_full_dump 函数。将这个函数放到 HARD_FAULT、ASSERTION、HEAP_OOM 等事件的回调里，就能实现自动转储。UART GATT Console 示例演示了这个函数的用法，通过串口输入 assert 可主动触发 ASSERTION 并自动转储。
蓝牙协议层面的问题

此时需要可以抓取芯片内部的 Trace 以及（或者）空口 log。
- 芯片 Trace
  
  工程向导在新建工程会自动添加芯片 Trace 的相关代码。当使用芯片 Trace 功能时，需要禁止系统进入深睡眠模式。
- 空口 log
  
  使用 Ellisys Bluetooth Tracker、 Sodera Series of Bluetooth Protocol Analyzers 等蓝牙空口抓包工具。
另外也可以从对端设备抓取自身的 log。不同操作系统上的参考方法如下：
- Windows：使用 Bluetooth Virtual Sniffer 实时抓取 HCI log；
- Linux：Blue-Z 协议栈可通过 hcidump 命令抓取 HCI log；
- Android：在开发者工具里勾选 “Enable Bluetooth HCI Snoop Log”；
- iOS：借助 iOS Trace 抓取 iOS 设备的 HCI log。

4. 如何进行空中升级？

这里是空中固件升级（FOTA）的快速演示。

服务端：为蓝牙设备加入升级服务

ingWizard 可以在新建项目时自动添加 INGCHIPS FOTA 服务。也可以自行设计 FOTA 服务。
客户端：对于 INGCHIPS FOTA 服务，提供以下使用不同语言开发的升级程序、工具：
- 桌面系统（Windows/MacOS/Linux）
  - Web FOTA (JavaScript)
  - 自行编译或下载 ING BLE (C#, Windows)
- Android
  - Web FOTA (JavaScript)
  - ING BLE (C#)
  - FOTA (Java/Kotlin)
  - 微信小程序 ING BLE
- iOS
  - ING BLE (JavaScript)
  - 微信小程序 ING BLE
- ING918 芯片：参考 SDK 附带的 Central FOTA 示例 (C/Zig)。

5. 如何查看 SDK 示例的 Markdown 文档？

Wizard 会把项目里的 doc/index.md 文件识别为文档，通过 “More info…” 菜单可直接打开这些 Markdown 格式的文档。 Wizard 内置的查看器存在不足（例如：不支持代码高亮），建议使用外部工具查看。配置步骤如下：

准备 Markdown 文档查看器

只要装上 Markdown Viewer 扩展，浏览器就可以充当 Markdown 文档查看器。
- 使用 Edge
  1. 从 Microsoft Store 安装;
  2. 进入“扩展” → “管理扩展” → “Markdown Viewer” → “详细信息”，勾选“允许访问文件 URL”，如图所示。
- 其它浏览器（Chrome/Opera）
  
  请参考 Markdown Viewer 文档。
打开 Wizard 设置（Options），填入 Markdown 文档查看器的路径。

6. Wizard 里跨芯片家族（如 ING68xx <-> ING9188xx）切换时出错，如何解决？

在 Wizard 里跨芯片家族（如 ING68xx <-> ING9188xx）切换工程的芯片型号时，有时会出现如下错误：

解决方法：进入工程的源代码目录，会发现多个 startup_ing… 文件，确认无误后，将不需要的 startup 文件移出，然后重新切换工程的芯片型号。

7. Wizard 里如何为自定义服务的特征添加字段（Fields）？

蓝牙 SIG 定义的特征带有字段，Profile Editor 能够显示这些字段。实际上，Profile Editor 仅是显示而已，没有其它功能。所以，对于自定义的特征，目前没有提供编辑字段的工具。

如果开发者需要使用这种字段显示功能，那么可通过编辑 JSON 文件手工添加字段：关闭 Wizard，打开 SDK/wizard/cfg/user_characteristics.json，找到要修改的特征，修改 Value，例如：

{
 "com.ingchips.characteristic.test": {
  "value": [{
    "name": "Hello",
    "format": "abc"
   },{
    "name": "World",
    "format": "def"
   }],
  "mandatory": false,
  "uuid": "........"
 }
}