
OMI EVT 固件测试指南基于 Zephyr Shell 的外设验证与 BLE 吞吐量测试【免费下载链接】FriendAI that sees your screen, listens to your conversations and tells you what to do项目地址: https://gitcode.com/GitHub_Trending/fr/Friend本文以仓库内 omi/firmware/test/README.md 为主线系统讲解 OMI EVT 测试固件的构建流程、全部 Shell 外设测试命令、快速回归测试序列以及 BLE 吞吐量测试方法并结合 omi/firmware/test/src 下的源码逐条印证每个命令的底层实现帮助硬件验证工程师、嵌入式开发者在拿到 EVT 样机后迅速完成整板外设功能验收。OMI 是一款能看到屏幕、能听对话并给出建议的 AI 可穿戴设备项目定位见仓库根目录 README.md其固件运行在基于 nRF5340 的定制主板上。本文聚焦仓库中专门为EVTEngineering Verification Test工程验证测试阶段编写的测试固件工程omi/firmware/test它把 BLE、Wi-Fi、电池、SPI Flash、IMU、麦克风、LED、按键、振动马达、SD 卡、深睡等全部外设以 Zephyr Shell 命令的形式暴露出来一条命令即可验证一路外设。读完本文你将掌握测试固件的工程结构与构建方法、11 组 Shell 命令的完整用法与源码级原理、一条覆盖全部外设的快速测试序列以及利用 GATT Notify 测量 BLE 实际吞吐量的完整操作步骤。一、测试固件工程概览omi/firmware/test是一个独立的 Zephyr 应用工程与正式固件omi/firmware下的其他应用并列存在专门用于 EVT 样机的整板功能验收。从仓库目录结构看该工程包含文件/目录作用src/main.c应用入口初始化各外设模块、启动 UART Shell、监听用户按键src/ble.cble on/ble off命令BLE 使能与 NUS Shell 传输src/battery.cbat get命令SAADC 采样电池电压与充电状态src/spi_flash.cflash命令族JEDEC ID / 擦除 / 读 / 写src/imu.cimu get命令读取 LSM6DS3TR-C 六轴数据src/mic.cmic capture命令PDM 麦克风录音采样src/led.cled on/off命令PWM 驱动 RGB LEDsrc/button.cbutton check命令按键事件监听src/motor.cmotor on/off命令振动马达控制src/sd.csd命令族ext2 文件系统挂载与文件操作src/systemoff.csys off命令进入 System OFF 深睡src/ble_throughput.cBLE 吞吐量测试三线程 GATT Notify 压测omi.conf工程 Kconfig 配置外设驱动、BLE、Wi-Fi、文件系统等app.overlay设备树覆盖IMU 驱动替换与引脚适配CMakePresets.jsonVS Code nRF Connect 构建预设sysbuild.confsysbuild 配置MCUboot 与双核启动CMakeLists.txt通过file(GLOB app_sources src/*.c)自动收集所有源码文件新增测试模块无需手动维护源文件列表。二、环境准备与初始化原文档明确指出该工程基于Zephyr RTOS作为操作系统并依赖nRF Connect SDKNCS提供 BLE 协议栈支持。开始使用前需要准备VS Code及 nRF Connect for VS Code 扩展nRF Connect ExtensionnRF Connect SDK完整安装包含 Zephyr、Toolchain、Nordic 驱动等按照官方 nRF Connect SDK Getting Started 指南安装即可通过 VS Code 的 nRF Connect 扩展完成 SDK 与 Toolchain 的自动检测。从 CMakePresets.json 可以看出本测试固件的目标板为omi/nrf5340/cpuappnRF5340 应用核网络核运行 BLE Controller 固件工程名为evt_test见 CMakeLists.txt构建目录固定为build/build_OMI_test。三、构建步骤VS Code 方式原文档给出的构建流程如下结合 CMakePresets.json 可补充说明在 VS Code 中打开 nRF Connect 扩展点击Open an existing application导航选择omi/firmware/test文件夹在应用面板中点击Add Build Configuration图标选择与硬件匹配的 CMake Preset。本工程预设名为build_OMI_test显示名 Devkit V2Debug 配置Ninja 生成器其缓存变量已固定BOARDomi/nrf5340/cpuapp、CONF_FILEomi.conf点击Build Configuration开始构建VS Code 通知栏会显示构建进度。由于sysbuild被启用工程根目录存在 Kconfig.sysbuild 与 sysbuild.conf实际构建产物还包括 MCUboot Bootloader 以及网络核固件用于双核NRF_DEFAULT_IPC_RADIO/NETCORE_IPC_RADIO_BT_HCI_IPC默认开启联合启动。熟悉命令行的情况下也可以在 nRF Connect 终端中执行west build -p auto -b omi/nrf5340/cpuapp -- -DCONF_FILEomi.conf完成同样的构建Zephyr 标准构建流程再用west flash烧录。四、Shell 命令参考完整外设测试指令集固件启动后见 src/main.c 的main()初始化外设 →shell_start()启动 UART Shell → 进入按键事件循环所有测试命令都通过Zephyr Shell 接口执行Shell 传输通道有两个UART 串口CONFIG_SHELL_BACKEND_SERIALyBLE NUSNordic UART ServiceCONFIG_SHELL_BT_NUSy即手机通过 nRF Connect 等 App 连接后可经蓝牙直接输入 Shell 命令。下面按原文档顺序逐一给出命令表与源码级解释。4.1 BLE 命令控制低功耗蓝牙的开关命令说明示例ble on开启 BLE 并以Omi EVT名称广播ble onble off关闭 BLE 并停止广播ble off注意BLE 使用 Nordic UART ServiceNUS作为 Shell 的蓝牙传输通道默认设备名Omi EVT由 omi.conf 中CONFIG_BT_DEVICE_NAMEOmi EVT定义。源码印证src/ble.cble on对应cmd_ble_on()L107 起流程为注册 SMP 配对回调bt_conn_auth_cb_register支持 Passkey 显示配对→bt_enable()初始化协议栈 →shell_bt_nus_init()初始化 NUS Shell →bt_le_adv_start()启动可连接广播。广播包ad[]包含通用可连接标志与完整设备名扫描响应包sd[]携带 OMI 自定义 128 位服务 UUID19B10000-E8F2-537E-4F6C-D104768A1214。ble off对应cmd_ble_off()L150 起先注销配对回调再bt_disable()关闭协议栈。设备侧通过CONFIG_BT_SMPy启用安全配对连接建立后调用shell_bt_nus_enable(conn)把 NUS 挂到当前连接上。4.2 WiFi 命令控制 nRF70 系列 Wi-Fi 模块命令说明示例wifi scan扫描可用 Wi-Fi 网络wifi scanwifi connect -s ssid连接 Wi-Fi 接入点wifi connect -s MyNetworkwifi disconnect断开当前 APwifi disconnectwifi status获取当前 Wi-Fi 连接状态wifi statuswifi ap接入点模式子命令wifi ap说明这些命令并非本工程自定义而是由 Zephyr 的NET_L2_WIFI_SHELL即wifiShell 模块提供。工程通过 omi.conf 启用CONFIG_NETWORKINGy、CONFIG_WIFIy、CONFIG_WIFI_NRF70y、CONFIG_NET_L2_WIFI_SHELLy接入该命令集同时启用了 IPv4CONFIG_NET_IPV4y、DHCPCONFIG_NET_DHCPV4y、TCPCONFIG_NET_TCPy与网络统计CONFIG_NET_STATISTICSy。此外配置了固定 MAC 地址CONFIG_WIFI_FIXED_MAC_ADDRESS14:5A:FC:5E:37:9C并开启 nRF70 低功耗CONFIG_NRF_WIFI_LOW_POWERy。sysbuild.conf中SB_CONFIG_WIFI_NRF70_SCAN_ONLYy表明当前构建以扫描验证为主。4.3 电池/充电命令监测电池电压与充电状态命令说明示例输出bat get读取电池 ADC 原始值与充电状态Raw: 2048, Voltage: 4.2V, Charging: Yes注意电压由 ADC 原始值换算而来充电状态表示设备是否连接充电器。源码印证src/battery.ccmd_bat_get()L74 起的采样链路是 nRF5340 SAADC 的 AIN0 通道关键参数为10 位分辨率ADC_RESOLUTION 10、增益 1/3ADC_GAIN_1_3、内部参考电压 1.8VADC_REF_INTERNAL、采集时间 10µs。采样前先触发NRF_SAADC_S-TASKS_CALIBRATEOFFSET 1做偏移校准校准会污染首个结果因此取第二个样本m_buffer[1]电压换算公式为(raw * 1.8) / 1024 * 31/3 分压网络回乘 3。充电状态由bat_chg_pin的 GPIO 边沿中断回调battrey_input_cb实时维护到全局变量is_charging——低电平表示充电中且充电时自动点亮绿色 LED索引 1。4.4 SPI Flash 命令对外部 SPI NOR Flash 进行读/写/擦除命令说明示例flash id读取 Flash 芯片 JEDEC IDflash idflash erase addr擦除指定地址所在页flash erase 0x1000flash read addr len从地址读取字节flash read 0x0 32flash write addr data向地址写入十六进制数据flash write 0x0 aabbccdd注意地址使用十六进制以0x前缀写入数据为十六进制编码如aabbccdd表示 4 字节0xAA、0xBB、0xCC、0xDD写入前必须先擦除Flash 的位只能通过擦除清零。源码印证src/spi_flash.c四个命令分别对应cmd_flash_idL14、cmd_flash_eraseL49、cmd_flash_readL95、cmd_flash_writeL143。实现要点flash id调用flash_read_jedec_id()输出 3 字节厂商/型号/容量 IDflash erase先通过flash_get_page_info_by_offs()查询目标地址所在页大小再flash_erase()整页擦除flash read按SHELL_HEXDUMP_BYTES_IN_LINE分块调用flash_read()并以十六进制 dump 输出flash write把命令行中的十六进制字符串两两一组解析为字节strtoul(hex_byte, NULL, 16)后flash_write()每个命令执行前都会把flash_mosi引脚置高、pm_device_action_run(flash, PM_DEVICE_ACTION_RESUME)唤醒 Flash结束后PM_DEVICE_ACTION_SUSPEND挂起配合 omi.conf 的CONFIG_FLASHy、CONFIG_FLASH_JESD216_APIyJEDEC ID 查询 API与CONFIG_PM_DEVICEy实现低功耗管理。4.5 IMU/传感器命令读取 LSM6DS3TR-C 六轴 IMU 的加速度计与陀螺仪数据命令说明示例输出imu get读取加速度计与陀螺仪 XYZ 值Accel: X0.02 Y-0.01 Z9.81 m/s², Gyro: X0.1 Y-0.2 Z0.0 rad/s注意加速度计单位为 m/s²陀螺仪单位为 rad/s。源码印证src/imu.c 与 app.overlaycmd_imu_get()L17 起先把加速度计和陀螺仪的采样频率统一设置为 12.5 Hzsensor_attr_set(..., SENSOR_ATTR_SAMPLING_FREQUENCY, ...)然后sensor_sample_fetch()抓取样本再分别sensor_channel_get()读取SENSOR_CHAN_ACCEL_XYZ与SENSOR_CHAN_GYRO_XYZ以整数.小数六位精度打印。这里有一个关键适配细节LSM6DS3TR-C 的 WHO_AM_I 寄存器值为 0x6AZephyr 原生 LSM6DSO 驱动不匹配因此 app.overlay 将设备树节点lsm6dso的compatible改为st,lsm6dsl并删除 LSM6DSO 特有的accel-pm/gyro-pm属性使驱动与芯片匹配。此外 omi.conf 中CONFIG_LSM6DSLy、CONFIG_LSM6DSL_TRIGGER_NONEy、CONFIG_SENSORy与CONFIG_I2Cy、CONFIG_I2C_SHELLy为该模块提供支撑imu_poweron()通过SYS_INIT(..., POST_KERNEL, 89)在系统启动早期给 IMU 供电引脚上电。4.6 麦克风命令从 PDM 麦克风采集音频命令说明示例mic capture [seconds]采集指定时长音频默认 1 秒mic capture 3注意默认采集时长为 1 秒输出原始 PCM 采样值到控制台采样率16000 Hz。源码印证src/mic.ccmd_mic_capture()L52 起实现要点关键参数宏SAMPLE_RATE_HZ 1600016 kHz、SAMPLE_BITS 1616 位、CHANNEL_COUNT 2双声道、CAPTURE_MS 1000、TIMEOUT_MS 2000单块大小BLOCK_SIZE (16bit/8) * (16000 * 1000)/1000 * 2即每 1 秒 64 KB块数BLOCK_COUNT 2用K_MEM_SLAB_DEFINE_STATIC定义内存池执行流程mic_power_on()拉高pdm_en_pin与pdm_thsel_pin给麦克风上电 →dmic_configure()配置 PDM 时钟1–3.5 MHz与流参数 → 循环dmic_trigger(DMIC_TRIGGER_START)/dmic_read()/ 逐样本以 int16 打印 /DMIC_TRIGGER_STOP→ 结束后mic_power_off()下电。命令行以S开始、E结束标记数据段便于上位机脚本截取通道映射在mic_init()中用dmic_build_channel_map将 PDM 左右声道映射到 0/1 通道。4.7 LED 命令通过 PWM 控制 RGB LED命令说明示例led on num按索引点亮 LEDled on 0led off num按索引关闭 LEDled off 0LED 索引映射索引颜色0红1绿2蓝源码印证src/led.cled_control()L11 起通过switch把索引映射到设备树节点led_red/led_green/led_blue对应的 PWM 通道点亮时将 PWM 脉冲宽度设为完整周期pulse_width_ns led_spec-period即 100% 占空比满亮度熄灭时设为 0最终经pwm_set_pulse_dt()输出。omi.conf 末尾CONFIG_PWMy为 PWM 驱动提供支持。4.8 按键命令检查按键状态与事件命令说明示例输出button check进入按键监听模式5 秒超时usr button pressed/usr button released注意命令最多等待按键事件 5 秒报告按下与松开事件按 CtrlC 退出监听模式。源码印证src/button.ccmd_buttons_check()L20 起先pm_device_runtime_get(buttons)唤醒按键输入设备、清空消息队列input_button然后k_msgq_get(..., K_SECONDS(5))阻塞等待事件Zephyr 输入子系统回调buttons_input_cb通过INPUT_CALLBACK_DEFINE(buttons, ...)注册收到INPUT_KEY_ENTER事件时按evt.value区分按下1/松开0并打印usr button pressed/usr button released5 秒无事件则返回No input received。值得注意主循环 src/main.c 中也监听了同一消息队列用户按键会触发马达振动 100ms 并点亮红色/蓝色 LED 的联动反馈。4.9 马达/触觉反馈命令控制振动马达命令说明示例motor on打开马达100ms 后自动关闭motor onmotor off立即关闭马达motor off注意马达出于安全考虑会在 100ms 后自动关闭用于触觉反馈测试。源码印证src/motor.ccmd_motor_on()L15 起置高motor_pin后通过k_work_schedule(motor_off_work, K_MSEC(100))调度一个延迟工作项100ms 后由motor_off_work_handler自动拉低引脚cmd_motor_off()L27 起立即关断并k_work_cancel_delayable()取消尚未触发的自动关断。延迟工作项在SYS_INIT(motor_init, APPLICATION, ...)中初始化。4.10 SD 卡命令管理 SD 卡文件系统ext2命令说明示例sd mount挂载 SD 卡文件系统sd mountsd unmount卸载 SD 卡文件系统sd unmountsd ls path列出目录内容sd ls /extsd read file读取整个文件内容sd read test.txtsd write file data追加数据到文件不存在则创建sd write log.txt Hello Worldsd rm file删除文件sd rm old.txtsd readline file line读取文件指定行sd readline log.txt 5注意文件系统ext2挂载点/extls命令使用绝对路径如sd ls /ext、sd ls /ext/mydirread/write/rm的路径相对于挂载点如sd read test.txt实际读取/ext/test.txtwrite追加数据并带换行符sd ls /显示系统根目录只会看到挂载点对应的ext文件夹。源码印证src/sd.c挂载逻辑cmd_mount()L105 起依次执行 SD 上电sd_enable_power(true)PM_DEVICE_ACTION_RESUME、disk_access_ioctl(DISK_IOCTL_CTRL_INIT)初始化、读取扇区数与扇区大小并打印容量MB随后fs_mount()挂载若磁盘上没有文件系统则自动fs_mkfs(FS_EXT2, ...)格式化后再挂载。文件操作命令都先拼出/ext/file绝对路径再调用 Zephyr FS APIwrite使用FS_O_CREATE | FS_O_WRITE | FS_O_APPEND打开并在数据后追加\nreadline逐字节读取并统计行号定位目标行。工程配置方面omi.conf 启用了CONFIG_FILE_SYSTEMy、CONFIG_FILE_SYSTEM_EXT2y、CONFIG_FILE_SYSTEM_MKFSy、CONFIG_DISK_DRIVER_SDMMCy并设置CONFIG_EXT2_DISK_STARTING_SECTOR2082GPT 后第一个分区的起始扇区模块初始化时app_sd_init()会自动执行一次 mount unmount 以验证 SD 通路。4.11 系统命令系统电源管理命令说明示例sys off进入 System OFF深睡模式sys off注意设备进入最低功耗状态按用户按键唤醒并重启进入 System OFF 前会关闭 WiFi RPU。源码印证src/systemoff.ccmd_sys_off()L13 起的执行顺序为拉低rfsw_en射频开关失能→rpu_disable()关闭 Wi-Fi 无线电处理单元在CONFIG_WIFI下编译→ 将用户按键usr_btn配置为输入并使能GPIO_INT_LEVEL_LOW低电平唤醒中断 → 挂起控制台设备 →sys_poweroff()进入 System OFF。唤醒后设备将重新复位启动这与主循环 src/main.c 中 启动失败或长时间无操作时自动sys off 的兜底逻辑pm_device_runtime_get(buttons)失败时执行shell_execute_cmd(NULL, sys off)相呼应保证无人值守时自动进入最低功耗。五、快速测试序列一条龙回归全部外设原文档给出了一套推荐的整板回归序列覆盖 LED、马达、电池、IMU、按键、Flash、SD 卡、麦克风、BLE、Wi-Fi、深睡共 11 项检查可直接复制到 Shell 中逐步执行# 1. Test LEDs led on 0 led off 0 led on 1 led off 1 led on 2 led off 2 # 2. Test Motor motor on motor off # 3. Test Battery bat get # 4. Test IMU imu get # 5. Test Button button check # (press button within 5 seconds) # 6. Test Flash flash id flash erase 0x0 flash write 0x0 deadbeef flash read 0x0 4 # 7. Test SD Card sd mount sd ls /ext sd write test.txt Hello Omi sd read test.txt sd unmount # 8. Test Microphone mic capture 1 # 9. Test BLE ble on # (connect with nRF Connect app) ble off # 10. Test WiFi wifi scan # 11. System Off Test sys off # (press button to wake)执行要点LED 按红绿蓝三色各点灭一次肉眼即可确认 PWM 三通道马达motor on后可触摸外壳感受 100ms 振动脉冲bat get重点关注电压数值是否落在合理电池区间以及充电状态位imu get在静止状态下 Z 轴加速度应接近 9.8 m/s²Flash 测试中flash write 0x0 deadbeef后flash read 0x0 4应回读DE AD BE EF注意 src/spi_flash.c 的cmd_flash_read按页对齐要求实际回读可能包含整页内容需核对首 4 字节sd mount会自动打印扇区数与容量sd read test.txt应回显Hello Omimic capture 1输出以S开头、E结尾的 int16 PCM 序列ble on后用 nRF Connect App 扫描到名为Omi EVT的设备并连接wifi scan应列出周围 AP最后sys off进入深睡按用户按键唤醒完成闭环。六、BLE 吞吐量测试除逐外设功能验证外该工程还提供了一套 BLE 吞吐量测量方案用于评估设备实际无线传输速率。完整操作说明见 omi/firmware/test/BLE_THROUGHPUT_TEST.md实现源码位于 src/ble_throughput.c另有 src/ble_throughput_test.c 承载入口调用。6.1 吞吐量测试的构建配置创建一个prj.conf或在现有配置中追加并写入以下内容重点是放大 BLE 协议栈缓冲以支撑大包高频通知# BLE # CONFIG_BTy CONFIG_BT_PERIPHERALy CONFIG_BT_DEVICE_NAMEOmi BLE Throughput Test CONFIG_BT_MAX_CONN1 CONFIG_BT_MAX_PAIRED1 CONFIG_BT_DEVICE_APPEARANCE22 CONFIG_BT_GATT_DYNAMIC_DBy # # Large BLE packets / BLE Buffers # CONFIG_BT_L2CAP_TX_MTU498 CONFIG_BT_CTLR_DATA_LENGTH_MAX251 CONFIG_BT_CTLR_PHY_2My CONFIG_BT_CTLR_PHY_CODEDy CONFIG_BT_CTLR_SDC_MAX_CONN_EVENT_LEN_DEFAULT400000 CONFIG_BT_CONN_TX_MAX20 CONFIG_BT_BUF_ACL_RX_SIZE1024 CONFIG_BT_L2CAP_TX_BUF_COUNT10 CONFIG_BT_BUF_ACL_TX_SIZE2048 # CONFIG_RING_BUFFERy # # Logs CONFIG_LOGy CONFIG_UART_CONSOLEy CONFIG_CONSOLEy CONFIG_PRINTKy CONFIG_LOG_PRINTKy这些选项的作用分别是CONFIG_BT_L2CAP_TX_MTU498与CONFIG_BT_BUF_ACL_TX_SIZE2048扩大单次通知的 L2CAP/ACL 承载能力CONFIG_BT_CTLR_DATA_LENGTH_MAX251启用 LE 2M PHY 下的 251 字节数据长度扩展DLECONFIG_BT_CTLR_PHY_2My与CONFIG_BT_CTLR_PHY_CODEDy开启 2M PHY 与 Coded PHYCONFIG_BT_CTLR_SDC_MAX_CONN_EVENT_LEN_DEFAULT400000允许单个连接事件持续更长时间以提升总线利用率CONFIG_BT_CONN_TX_MAX20、CONFIG_BT_L2CAP_TX_BUF_COUNT10、CONFIG_BT_BUF_ACL_RX_SIZE1024则是收发缓冲队列的扩容。6.2 入口 main.c 与 CMakeLists创建一个src/main.c调用由测试模块导出的transport_ble_test()#include zephyr/kernel.h #include zephyr/shell/shell.h #include zephyr/pm/device_runtime.h // Declare the external test function extern int transport_ble_test(void); int main(void) { // Call the BLE throughput test function transport_ble_test(); while (1) { k_msleep(1000); // Sleep for a second } return 0; }并确保CMakeLists.txt把测试源文件纳入构建本仓库的 CMakeLists.txt 通过file(GLOB app_sources src/*.c)已自动包含src/ble_throughput_test.c与src/ble_throughput.ccmake_minimum_required(VERSION 3.20.0) find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE}) project(omi_test) file(GLOB app_sources src/main.c src/ble_throughput_test.c) target_sources(app PRIVATE ${app_sources})6.3 构建、烧录与日志监控按 Zephyr 标准流程构建并烧录west build -p auto -b your_board west flash板子通过 USB 枚举出多个串口设备后先确认设备节点再打开串口控制台macOS 示例$ ls -l /dev/*.usb* crw-rw-rw- 1 root wheel 0x9000003 Apr 26 16:36 /dev/cu.usbmodem0000697303521 crw-rw-rw- 1 root wheel 0x9000005 Apr 26 16:36 /dev/cu.usbmodem108NTMX2S5392 crw-rw-rw- 1 root wheel 0x9000023 Apr 26 16:56 /dev/cu.usbmodem1101 crw-rw-rw- 1 root wheel 0x9000002 Apr 26 16:36 /dev/tty.usbmodem0000697303521 crw-rw-rw- 1 root wheel 0x9000004 Apr 26 16:36 /dev/tty.usbmodem108NTMX2S5392 crw-rw-rw- 1 root wheel 0x9000022 Apr 26 16:59 /dev/tty.usbmodem1101 $ screen /dev/tty.usbmodem1101 1152006.4 手机端配合与结果观测在智能手机上下载并安装 Omi AI App连接名为Omi BLE Throughput Test的 BLE 设备并订阅 Notify 特征在串口控制台观察每秒输出的吞吐量指标。源码级原理src/ble_throughput.c该测试定义了三个内核线程配合环形缓冲区组成生产者-消费者模型writer 线程优先级 7每 10ms 向test_ring_buf可容纳 150 个 100 字节包写入 100 字节测试数据首字节递增作为序号写满失败则累计test_write_failed_countreader/notifier 线程优先级 6等待连接current_conn与客户端订阅test_subscribed由 GATT CCC 回调ble_throughput_ccc_cfg_changed维护就绪后从环形缓冲区取出整包并通过bt_gatt_notify()推送若返回-EAGAIN/-ENOMEM表示对端队列已满则将数据回填缓冲区延迟重试logger 线程优先级 8每秒基于k_uptime_get()时间差与原子计数器test_gatt_notify_count、test_write_failed_count、test_notify_failed_count计算并打印BLE Test Rate - Writes/s: N (Fail: x), Notifies/s: N (Fail: x)即实际 GATT Notify 速率与失败率。测试服务使用 128 位 UUID19B10001-E8F2-537E-4F6C-D104768A1215与正式固件 transport 服务保持一致以便客户端复用通过ble_throughput这个 Shell 命令组ble_throughput on/ble_throughput off启停压测。注意启动前必须已建立 BLE 连接并完成 Notify 订阅否则命令会返回-ENOTCONN未连接或-EPERM未订阅。七、关键工程配置速查以下是测试固件中与上述命令直接相关的核心配置便于排障与定制构建目标CMakePresets.json 固定BOARDomi/nrf5340/cpuapp、Debug 构建、Ninja 生成器输出目录build/build_OMI_testShell 传输omi.conf 中CONFIG_SHELL_BACKEND_SERIALyUARTCONFIG_SHELL_BT_NUSyBLE NUSCONFIG_SHELL_AUTOSTARTn表示 Shell 由main()显式启动BLE 身份CONFIG_BT_DEVICE_NAMEOmi EVT、CONFIG_BT_DIS_MANUFBased Hardware、CONFIG_BT_DIS_FW_REV_STR0.0.9、CONFIG_BT_DIS_HW_REV_STR5.0蓝牙设备信息服务IMU 适配app.overlay 将 LSM6DS3TR-C 的驱动绑定为st,lsm6dslWHO_AM_I 0x6A并删除 LSM6DSO 专属的accel-pm/gyro-pm属性文件系统ext2、挂载点/ext、CONFIG_EXT2_DISK_STARTING_SECTOR2082CONFIG_FILE_SYSTEM_MKFSy允许首次挂载自动格式化双核启动sysbuild.conf 启用 MCUboot、双镜像更新SB_CONFIG_MCUBOOT_UPDATEABLE_IMAGES2、网络核安全启动与 OTA 支持CONFIG_NCS_SAMPLE_MCUMGR_BT_OTA_DFUysysbuild/mcuboot.conf 进一步配置了升级策略CONFIG_BOOT_UPGRADE_ONLYy、防降级电源管理CONFIG_PM_DEVICEy、CONFIG_POWEROFFy配合sys off实现 System OFF 深睡。八、结语omi/firmware/test是 OMI 硬件 EVT 阶段的一站式验证工具它以 Zephyr Shell 为交互入口把主板上的每一路外设都抽象成一条命令配合上文给出的快速测试序列可以在几分钟内完成从 LED、马达、电池、IMU 到 Flash、SD 卡、麦克风、BLE、Wi-Fi、深睡的全链路回归而 BLE 吞吐量测试模块则通过三线程 环形缓冲 GATT Notify 的压测模型为无线传输性能提供了可量化的评估手段。无论是产线老化测试脚本的编写还是 EVT 问题复现与定位这套命令集与本文的源码级解读都能直接派上用场。更多细节可回溯原文档 omi/firmware/test/README.md 与吞吐量测试说明 omi/firmware/test/BLE_THROUGHPUT_TEST.md结合各外设源码逐一核对实现。【免费下载链接】FriendAI that sees your screen, listens to your conversations and tells you what to do项目地址: https://gitcode.com/GitHub_Trending/fr/Friend创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考