【N32WB03x SDK使用指南】

简介: 【N32WB03x SDK使用指南】

1. 简介

此文档的目的在于让使用者能够快速熟悉N32WB03x系列蓝牙SOC芯片的开发套件以及Keil MDK-ARM的相关设定,以减少开发前期的准备时间,降低开发难度。


1.png

官网地址: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

2.png


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 主要资源

3.png


1.3 典型应用


4.png

2. SDK/开发固件文件目录结构

SDK 目录下是一个以固件库版本命名的文件,其中包含五个子文件夹:


5.png

2.1 doc

即SDK相关的说明文档,包含SDK使用指南和固件升级使用指南等。


2.2 firmware

CMSIS:

微控制器软件接口标准,是Cortex-M处理器系列的与供应商无关的硬件抽象层, CMSIS提供了内核与外设、

实时操作系统和中间设备之间的通用接口。

包含了用来访问内核的寄存器设备的名称定义,地址定义和配置函数。该接口包括调试通道定义。

提供片上所有外设的定义,包括所有外设寄存器头文件、启动文件、系统初始化模板文件。

n32wb03x_std_periph_driver:

芯片外设的标准驱动函数,包括.c 的源文件和.h 的头文件。用户可移植到项目中,快速完成对某个外设模块的使用。

6.png

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: 包含各个外设功能模块的例程项目,实现每个外设模块的基本功能应用开发,用户可以通过这些例程项目快速了解芯片外设用法。

7.png

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


8.png

3.3 编译环境配置

注:所有例程已经按如下配置完成,所以运行例程不需要重新配置编译环境。


Target页的FLASH和RAM配置

 不包含ble功能项目

9.png


 包含ble功能项目target页


10.png

 带DFU功能项目,请参考《固件升级使用指南.PDF》


Linker页

 勾选使用Target页的memory配置


11.png

 带ble项目需要加middlewares\Nationstech\ble_library\ns_ble_stack\symdef\symbol_g15.obj文件于Misc control,注意包含蓝牙主机功能的程序使用的obj文件是symbol_g15_central.obj


12.png

Debug页

 调试器选择CMSIS-DAP Debugger作为开发板上的NS-Link


13.png

 Setting页面如下图

14.png


3.4 编译与下载

 编译:点击菜单的build按钮15.png


 下载:点击菜单的download按钮16.png


 调试:点击菜单的start/stop debug session按钮17.png


注意:下载程序后无法继续再下载


 可能1: 代码中将SWDIO/SWDCLK用作其他用途,导致仿真接口失效。一般情况下不建议使用仿真引 脚用作其他功能设计

 可能2:芯片进入低功耗sleep模式,此时仿真接口失效,需要在唤醒状态下下载,直接reset然后下载。


3.5 BLE工程目录结构

以rdtss蓝牙项目工程为例


18.png

 Project Target

 N32WB03x: 蓝牙工程,不带DFU配置,一般ble项目只有这个target

 OTA_IMG_1:带蓝牙OTA工程,配置为Bank1地址

 OTA_IMG_2:带蓝牙OTA工程,配置为Bank2地址


目录结构如下

19.png

 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内存分布章节。


20.png

4.2 RAM

N32WB031芯片RAM地址范围是0x20000000 - 0x2000BFFF,可用空间为48K字节


 如果使用蓝牙功能,蓝牙协议栈将占用0x20000000 -

0x20003FFF,总共16K字节RAM,用户代码可以使用0x20004000 - 0x2000BFFF,总共32K字节RAM

 如果不用蓝牙功能,则用户代码可以使用全部48K字节RAM


21.png


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并初始化低速时钟源,用户代码后续不能切换低速时钟源,否则将影响蓝牙协议栈的功能。

目录
相关文章
|
传感器 监控 JavaScript
NodeJS & Dapr Javascript SDK 官方使用指南
用于在 JavaScript 和 TypeScript 中构建 Dapr 应用程序的客户端库。该客户端抽象了公共 Dapr API,例如服务到服务调用、状态管理、发布/订阅、机密等,并为构建应用程序提供了一个简单、直观的 API。
385 0
NodeJS & Dapr Javascript SDK 官方使用指南
|
开发工具
SDK使用指南
针对参数设计以及SDK读写方面进行说明
602 0
|
分布式计算 Java MaxCompute
MaxCompute Tunnel SDK数据上传利器——BufferedWriter使用指南
MaxCompute 的数据上传接口(Tunnel)定义了数据 block 的概念:一个 block 对应一个 http request,多个 block 的上传可以并发而且是原子的,一次同步请求要么成功要么失败,不会污染其他的 block。这种设计对于服务端来讲十分简洁,但是也把记录状态做 fa.
5905 0
|
6月前
|
JavaScript Java Maven
云效产品使用常见问题之android sdk 构建出aar后,上传到私有maven仓库失败如何解决
云效作为一款全面覆盖研发全生命周期管理的云端效能平台,致力于帮助企业实现高效协同、敏捷研发和持续交付。本合集收集整理了用户在使用云效过程中遇到的常见问题,问题涉及项目创建与管理、需求规划与迭代、代码托管与版本控制、自动化测试、持续集成与发布等方面。
|
6月前
|
安全 开发工具 Android开发
几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK
几个Flutter常见诊断错误与解决Android toolchain - develop for Android devices X Unable to locate Android SDK
1778 0
|
3月前
|
JavaScript 前端开发 Java
[Android][Framework]系统jar包,sdk的制作及引用
[Android][Framework]系统jar包,sdk的制作及引用
75 0
|
10天前
|
程序员 开发工具 Android开发
Android|使用阿里云推流 SDK 实现双路推流不同画面
本文记录了一种使用没有原生支持多路推流的阿里云推流 Android SDK,实现同时推送两路不同画面的流的方法。
34 7
|
3月前
|
开发工具 Android开发
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
161 4
解决Android运行出现NDK at /Library/Android/sdk/ndk-bundle did not have a source.properties file
|
3月前
|
Dart 开发工具 Android开发
Android Studio导入Flutter项目提示Dart SDK is not configured
Android Studio导入Flutter项目提示Dart SDK is not configured
254 4
|
3月前
|
开发工具 Android开发
Flutter: Android SDK not found at this location,Android Studio not found at xxx
Flutter: Android SDK not found at this location,Android Studio not found at xxx
150 2