1. 简介
此文档的目的在于让使用者能够快速熟悉N32WB03x系列蓝牙SOC芯片的开发套件以及Keil MDK-ARM的相关设定,以减少开发前期的准备时间,降低开发难度。
官网地址:https://www.nationstech.com/cpjs273/
文档地址:https://www.nationstech.com/uploadfile/file/20230206/1675671659217095.pdf
N32WB031_STB 开发板:https://www.nationstech.com/uploadfile/file/20230206/1675669890941879.zip
1.1 产品简介
N32WB03x系列蓝牙芯片是国民技术新一代高性能、超低功耗的蓝牙5.1芯片,采用32位Arm® Cortex®-M0内核,最高工作主频64MHz,片上集成48KB SRAM,256/512KB Flash。芯片集成先进的 BLE5.1射频收发器,符合蓝牙BLE5.1规范,可配置为标准的1Mbps BLE模式,2Mbps增强BLE模式, 125Kbps BLE远程模式(S8),500Kbps BLE远程模式(S2)。支持AOA(到达角)和AOD(离去角),支持 RSS I ( 接 收 器 信 号 强 度 指 示 ),同 时 支 持 主 从 角 色,支 持 多 连 接,支 持 数 据 包 长 度 扩 展,支 持 KEYSCAN,IRC,10位1.33Msps ADC(可配置为16位16Ksps),支持模拟MIC输入,PGA放大,支持基 本、通用、高级TIMER,RTC,WWDG,IWDG,LPUART,USART,SPI,I2C等外设。
1.2 主要资源
1.3 典型应用
2. SDK/开发固件文件目录结构
SDK 目录下是一个以固件库版本命名的文件,其中包含五个子文件夹:
2.1 doc
即SDK相关的说明文档,包含SDK使用指南和固件升级使用指南等。
2.2 firmware
CMSIS:
微控制器软件接口标准,是Cortex-M处理器系列的与供应商无关的硬件抽象层, CMSIS提供了内核与外设、
实时操作系统和中间设备之间的通用接口。
包含了用来访问内核的寄存器设备的名称定义,地址定义和配置函数。该接口包括调试通道定义。
提供片上所有外设的定义,包括所有外设寄存器头文件、启动文件、系统初始化模板文件。
n32wb03x_std_periph_driver:
芯片外设的标准驱动函数,包括.c 的源文件和.h 的头文件。用户可移植到项目中,快速完成对某个外设模块的使用。
2.3 middleware
中间层固件,主要如下两个目录:
Third_Party
FreeRTOS: FreeRTOS 相关库
Nationstech
ble_library: 蓝牙BLE 相关库
ns_ble_stack: ble 蓝牙协议栈头文件
ns_ble_profile: ble profile 库源码
ns_library: ble 程序其他库源码,包含 log,sleep 和 timer 等
2.4 utilities
工具软件目录, 里面主要包含:
dfu:固件升级相关工具软件目录和调用这些工具的 bat 脚本
Image:使用 bat 脚本生成的 bin 文件和用于DFU 演示的 bin 文件
JLink:烧录工具
Keys:用于生成 dfu 升级 bin 的密匙
NSAndroidUtil: DFU 测试 APK
NSUtil:串口升级工具软件和源码
2.5 projects Projects
目录包含开发板目录,开发板目录下包含:
bsp:包含调试串口打印功能的 log 函数,用于外设例程在调试过程答应各种调试信息。
pplication:应用例程,使用了多种外设或者功能需求的综合性例程
peripheral_alone: 外设综合例程,包含串口通信,TIM 的 PWM 输出,ADC 读取和转为电压,IO 输出,IO输入中断响应和 RTC 休眠唤醒
ble_hid_rcu:蓝牙遥控器例程,使用 KEYSCAN 模块,ADC PGA 模块读取声音和蓝牙HID 数据发 送
FreeRTOS:Freertos 相关例程
ble:蓝牙从机例程,通过对具体 profile 的蓝牙例程了解蓝牙程序开发的基本方法
dis:设备服务例程
hid_mouse: 蓝牙鼠标例程
rdtss: 蓝牙数传例程(128bit UUID),包含 DFU空中升级项目选项
rdtss_16bit: 蓝牙数传例程(16bit UUID),包含 DFU 空中升级项目选项
heart_rate: 蓝牙心率服务例程
blood_pressure: 蓝牙血压服务例程。
ble_central:蓝牙主机例程
central_rdtsc:蓝牙数传服务主机例程。可以配合 rdtss 例程使用。
central_rdts_c&s:蓝牙数传服务主机和从机模式切换例程。可以配合rdtss或central_rdtsc例程使用。
central_relay_1m1s:蓝牙数传服务中继例程,即一主一从同时工作。可以配合 rdtss 例程使用。
dfu:设备固件升级例程
common: dfu 公共库目录
app_ota:蓝牙空中升级例程
image_update:单 bank模式下,image_update 例程源码
app_usart:串口升级例程(跳转 masterboot)
masterboot:固件升级 boot,包含串口升级,固件校验和跳转
peripheral: 包含各个外设功能模块的例程项目,实现每个外设模块的基本功能应用开发,用户可以通过这些例程项目快速了解芯片外设用法。
3. 项目配置与烧录
3.1 编译环境安装
请安装KEIL MDK-ARM开发环境,版本要求为V5.00以上,建议使用V5.24.2.0。从MDK的官网可以下载得到MDK的安装包,然后安装即可,关于的MDK安装请看这个大佬的教程。
MDK安装教程:https://blog.csdn.net/bruceoxl/article/details/108548573
MDK下载地址:https://www.keil.com/download/product/
3.2 固件支持包安装
双击运行N32WB03x_DFP.1.1.0.pack安装Keil芯片支持包。
支持包地址:https://www.nationstech.com/uploadfile/file/20230206/1675669890941879.zip
3.3 编译环境配置
注:所有例程已经按如下配置完成,所以运行例程不需要重新配置编译环境。
Target页的FLASH和RAM配置
不包含ble功能项目
包含ble功能项目target页
带DFU功能项目,请参考《固件升级使用指南.PDF》
Linker页
勾选使用Target页的memory配置
带ble项目需要加middlewares\Nationstech\ble_library\ns_ble_stack\symdef\symbol_g15.obj文件于Misc control,注意包含蓝牙主机功能的程序使用的obj文件是symbol_g15_central.obj
Debug页
调试器选择CMSIS-DAP Debugger作为开发板上的NS-Link
Setting页面如下图
3.4 编译与下载
编译:点击菜单的build按钮
下载:点击菜单的download按钮
调试:点击菜单的start/stop debug session按钮
注意:下载程序后无法继续再下载
可能1: 代码中将SWDIO/SWDCLK用作其他用途,导致仿真接口失效。一般情况下不建议使用仿真引 脚用作其他功能设计
可能2:芯片进入低功耗sleep模式,此时仿真接口失效,需要在唤醒状态下下载,直接reset然后下载。
3.5 BLE工程目录结构
以rdtss蓝牙项目工程为例
Project Target
N32WB03x: 蓝牙工程,不带DFU配置,一般ble项目只有这个target
OTA_IMG_1:带蓝牙OTA工程,配置为Bank1地址
OTA_IMG_2:带蓝牙OTA工程,配置为Bank2地址
目录结构如下
STARTUP:芯片启动文件 CMSIS:芯片内核配置 FWLB:芯片外设驱动库 BLE_STACK:蓝牙BLE协议栈 BLE_PROFILE:蓝牙BLE profile NS_DUF(可选):蓝牙OTA固件升级相关库 Crypto(可选):蓝牙OTA固件升级使用的加密相关库 NS_LIB:蓝牙应用相关库 BLE_APP:蓝牙应用代码 USER:用户应用代码 CONFIG:配置文件 DOC:说明文档 1、功能说明 蓝牙BLE数传服务(rdts)例程,使用128bit UUID。BLE主机连接设备后,下行数据将透传到USART1,USART1收到的数据将透传到BLE主机 2、使用环境 软件开发环境: KEIL MDK-ARM V5.24.2.0 硬件环境: 基于N32WB031_STB开发板 3、使用说明 系统配置; 1、时钟源:HSI=64M 2、调试串口使用的是LPUART(PB1/PB2),波特率是115200,8bit数据位,无校验位,1bit停止位,无流控。 3、数据串口使用USART1(PB6/PB7),波特率115200,8bit数据位,无校验位,1bit停止位,无流控。 4、蓝牙BLE名:NS_RDTSS 5、LED1开机即亮,LED2指示连接状态,蓝牙连上后亮 使用方法: 1、编译后烧录到开发板 4、注意事项 由于程序会进入sleep模式,则SWD将不能访问,请按RESET按钮后,在一秒之内执行烧录程序步骤。
main.c
/***************************************************************************** * Copyright (c) 2019, Nations Technologies Inc. * * All rights reserved. * **************************************************************************** * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the disclaimer below. * * Nations' name may not be used to endorse or promote products derived from * this software without specific prior written permission. * * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY NATIONS "AS IS" AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE * DISCLAIMED. IN NO EVENT SHALL NATIONS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ /** * @file main.c * @author Nations Firmware Team * @version v1.0.1 * * @copyright Copyright (c) 2019, Nations Technologies Inc. All rights reserved. */ /** @addtogroup * @{ */ /* Includes ------------------------------------------------------------------*/ #include "n32wb03x.h" #include "rwip.h" #include "ns_ble.h" #include "ns_sleep.h" #include "ns_delay.h" #include "ns_log.h" #include "app_usart.h" #include "app_gpio.h" #include "app_ble.h" #if (CFG_APP_NS_IUS) #include "ns_dfu_boot.h" #endif /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ #define DEMO_STRING "\r\n Nations raw data transfer server(128bit UUID) demo \r\n" /* Private constants ---------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private function prototypes -----------------------------------------------*/ /* Private functions ---------------------------------------------------------*/ /** * @brief main function * @param * @return * @note Note */ int main(void) { //for hold the SWD before sleep delay_n_10us(200*1000); NS_LOG_INIT(); #if (CFG_APP_NS_IUS) if(CURRENT_APP_START_ADDRESS == NS_APP1_START_ADDRESS){ NS_LOG_INFO("application 1 start new ...\r\n"); }else if(CURRENT_APP_START_ADDRESS == NS_APP2_START_ADDRESS){ NS_LOG_INFO("application 2 start new ...\r\n"); } #endif app_ble_init(); NS_LOG_INFO(DEMO_STRING); // periph init LedInit(LED1_PORT,LED1_PIN); // power led LedInit(LED2_PORT,LED2_PIN); //connection state LedOn(LED1_PORT,LED1_PIN); app_usart_dma_enable(ENABLE); //init text usart_tx_dma_send((uint8_t*)DEMO_STRING, sizeof(DEMO_STRING)); delay_n_10us(500); //disable usart for enter sleep app_usart_dma_enable(DISABLE); while (1) { /*schedule all pending events*/ rwip_schedule(); ns_sleep(); } } /** * @brief user handle before enter sleep mode * @param * @return * @note */ void app_sleep_prepare_proc(void) { } /** * @brief user handle after wake up from sleep mode * @param * @return * @note */ void app_sleep_resume_proc(void) { } /** * @} */
4 Memory分配
4.1 Flash分配
N32WB031芯片FLASH地址范围是0x01000000 - 0x0107FFFF,总空间为512K字节,分为BankA、BankB两个Bank,空间大小分别是256K字节,BankA地址范围是0x01000000 - 0x0103FFFF,BankB地址范围是0x01040000 - 0x0107FFFF。用户代码运行范围只能是其中一个Bank,默认使用BankA。注意N32WB031KC系列FLASH空间是256K,即只有BankA区域。
需要使用固件升级功能请参考《固件升级使用指南.PDF》里面的FLASH内存分布章节。
4.2 RAM
N32WB031芯片RAM地址范围是0x20000000 - 0x2000BFFF,可用空间为48K字节
如果使用蓝牙功能,蓝牙协议栈将占用0x20000000 -
0x20003FFF,总共16K字节RAM,用户代码可以使用0x20004000 - 0x2000BFFF,总共32K字节RAM
如果不用蓝牙功能,则用户代码可以使用全部48K字节RAM
5. 系统时钟
5.1 不带蓝牙协议栈例程
系统时钟源可以选择HSE或者HSI,所有外设例程默认使用HSI 64M作为系统时钟源。低速时钟源可以选择外部晶体LSE 32.768K或者内部LSI 32K时钟源。
5.2 蓝牙例程
所有蓝牙例程默认使用HSI 64M作为系统时钟源,使用LSI作为低速时钟源,必须外接32M晶体为蓝牙射频专用时钟源。系统时钟源不建议更改,低速时钟源可以选择外部晶体LSE 32.768K或者内部LSI 32K时钟源,但是只能在蓝牙协议栈初始化函数里配置LSI或者LSE并初始化低速时钟源,用户代码后续不能切换低速时钟源,否则将影响蓝牙协议栈的功能。