快捷搜索：
手动升级 SDK 时步骤太烦琐，如何简化？
手动升级 SDK 时步骤太烦琐，如何简化？
ingchips_sdk_setup_vX.Y.Z.exe /silent
当开发工具发生变化（比如更新了 Keil、Gnu 工具链）时，可用普通模式安装。
注意: SDK v8.1.1 或更新版本才支持 /silent 参数 。
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": "........"
}
}
上面就为 test 特性添加了两个字段，第一个是类型为 abc 的 “Hello”，第二个是类型为 def 的 “World”。 再次打开 Profile Editor 可看到新添加的字段：
Wizard 里跨芯片家族（如 ING68xx <-> ING9188xx）切换时出错，如何解决？
在 Wizard 里跨芯片家族（如 ING68xx <-> ING9188xx）切换工程的芯片型号时，有时会出现如下错误：
解决方法：进入工程的源代码目录，会发现多个 startup_ing… 文件，确认无误后，将不需要的 startup 文件移出， 然后重新切换工程的芯片型号。
如何查看 SDK 示例的 Markdown 文档？
Wizard 会把项目里的 doc/index.md 文件识别为文档。完成以下配置后，通过 “More info…” 菜单可直接打开这些 Markdown 格式的文档。
-
准备 Markdown 文档查看器
只要装上 Markdown Viewer 扩展， 浏览器就可以充当 Markdown 文档查看器。
-
使用 Edge
-
从 Microsoft Store 安装;
-
进入“扩展” → “管理扩展” → “Markdown Viewer” → “详细信息”，勾选“允许访问文件 URL”，如图所示。
-
-
其它浏览器（Chrome/Opera）
请参考 Markdown Viewer 文档。
-
-
打开 Wizard 设置（Options），填入 Markdown 文档查看器的路径。
如何进行空中升级
这里 是空中固件升级（FOTA）的快速演示。
1）服务端：为蓝牙设备加入升级服务
ingWizard 可以在新建项目时自动添加 INGCHIPS FOTA 服务。 也可以自行设计 FOTA 服务。
2）客户端：对于 INGCHIPS FOTA 服务，提供以下使用不同语言开发的升级程序、工具：
- 桌面系统（Windows/MacOS/Linux）
Web FOTA (JavaScript)
- Android
Web FOTA (JavaScript)
ING BLE (C#)
FOTA (Java/Kotlin)
微信小程序 ING BLE
- iOS
ING BLE (JavaScript)
微信小程序 ING BLE
- ING918 芯片：参考 SDK 附带的 Central FOTA 示例 (C/Zig)。
如何抓取 log？
针对不同的问题需要抓取不同类型的 log：
1）死机（出现 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 并自动转储。
2）蓝牙协议层面的问题
此时需要可以抓取芯片内部的 Trace 以及（或者）空口 log。
- 芯片 Trace
工程向导在新建工程会自动添加芯片 Trace 的相关代码。当使用芯片 Trace 功能时，需要禁止系统进入深睡眠模式。
- 空口 log
使用 Ellisys Bluetooth Tracker、 Sodera Series of Bluetooth Protocol Analyzers 等蓝牙空口抓包工具。
