N32WB031 测试与模板工程

商务合作联系邮箱（深圳）：xianyi.xia@outlook.com

本项目包含Firmware固件与Web-BLE前端两个项目。

Firmware

本项目基于N32WB031_STB_V1.1开发板，开发板相关资料见assets文件夹。

本项目当前适用于v1.1.0版本SDK.

固件项目目前只支持Keil开发环境。

编译方法

为了使得Keil项目能够支持宏路径，本项目引入了 KeilHelper 工具。

打开Keil项目，第一次点击编译，会弹出窗口选择SDK路径。

选择了有效的SDK路径并确定后。Keil会提示重载项目。点击确定后，即可正常编译项目。

KeilHelper 的更多用法可参阅项目页面。

服务

包含以下蓝牙服务

• DIS(0x180A)
• BAS(0x180F)
• 自定义透传 (0xCC00)
  • Notify(0xCC02)
  • WriteWithoutResponce(0xCC01)

IO

• LED1(PB0)
• LED2(PA6)
• BUTTON1(PB1)
• BUTTON2(PB2)
• LOG: USART:115200 (PB6/PB7)

Usage

烧录完成后，重启EV板，即可观察到LED1与LED2交替闪烁。此时不会进入sleep状态，保持SWD接口可用，方便烧录。

在此时按下Button1或Button2后，测试固件将会开始运行。

开始运行程序后，使用Web-BLE应用可以与开发板连接。在应用中可以控制LED的闪烁与开关。并且应用也会将Button1和Button2的状态实时地反映在界面上。

Known issues

本项目使用的v1.1.0版本的SDK在编译时，会有两个SDK文件报出共5个Warning，其中n32wb03x_qflash.c文件3个，分别在181，199和219行，原因均为定义而未使用的变量。rtdss_16bit_task.c文件2个，分别在345与390行，原因同上。

以上编译警告不影响功能，暂时忽略即可。期待后续的SDK更新能够修复上述问题。

Web-BLE

注意！！！此应用仅兼容部分浏览器与环境，兼容性列表参见 https://developer.mozilla.org/en-US/docs/Web/API/Web_Bluetooth_API#browser_compatibility

建议在Windows、Linux和Android平台上使用最新版本的Chrome以获取良好体验。

无法自行构建Web应用的用户可以使用上述的平台与浏览器点击访问本人搭建的 在线应用 直接使用。

Env

• React
• yarn
• vite
  • vite-plugin-windicss
  • vite-plugin-pwa
• mui
• mobx

项目使用了React前端框架构建，引入了yarn包管理器和前端工具Vite作为基础环境。

UI库使用了mui，并由Vite插件vite-plugin-windicss引入了windicss样式框架。

组件通信与状态同步使用了mobx包。

整个应用通过Vite插件vite-plugin-pwa实现了PWA化。

Install

yarn install

Debug

yarn start

Build

yarn build

Usage

点击Scan按钮配对设备后，将会出现设备框架，点击Connect即可连接。

正常连接后，将可以使用设备框架中的按钮来控制开发板上的LED，并且开发板上Button1和Button2两个按钮的状态也将实时反映在应用的界面上。

点击LED2 ON与LED2 OFF按钮可以控制对应LED的亮灭。

点击LED1 BLINK按钮可以使对应LED开始闪烁，直到点击LED OFF按钮。

按下与松开开发板上的Button1与Button2，应用界面上的按钮会实时反映它们的状态。