【N32WB03x SDK使用指南】

这篇具有很好参考价值的文章主要介绍了【N32WB03x SDK使用指南】。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。


【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

1. 简介

此文档的目的在于让使用者能够快速熟悉N32WB03x系列蓝牙SOC芯片的开发套件以及Keil MDK-ARM的相关设定,以减少开发前期的准备时间,降低开发难度。
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

官网地址: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
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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

【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

1.3 典型应用

【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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

SDK 目录下是一个以固件库版本命名的文件,其中包含五个子文件夹:
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

2.1 doc

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

2.2 firmware

  1. CMSIS:
    微控制器软件接口标准,是Cortex-M处理器系列的与供应商无关的硬件抽象层, CMSIS提供了内核与外设、
    实时操作系统和中间设备之间的通用接口。
  • 包含了用来访问内核的寄存器设备的名称定义,地址定义和配置函数。该接口包括调试通道定义。
  • 提供片上所有外设的定义,包括所有外设寄存器头文件、启动文件、系统初始化模板文件。
  1. n32wb03x_std_periph_driver:
    芯片外设的标准驱动函数,包括.c 的源文件和.h 的头文件。用户可移植到项目中,快速完成对某个外设模块的使用。
    【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

2.3 middleware

中间层固件,主要如下两个目录:

  1. Third_Party

 FreeRTOS: FreeRTOS 相关库

  1. Nationstech

 ble_library: 蓝牙BLE 相关库
 ns_ble_stack: ble 蓝牙协议栈头文件
 ns_ble_profile: ble profile 库源码
 ns_library: ble 程序其他库源码,包含 log,sleep 和 timer 等

2.4 utilities

工具软件目录, 里面主要包含:

  1. dfu:固件升级相关工具软件目录和调用这些工具的 bat 脚本

 Image:使用 bat 脚本生成的 bin 文件和用于DFU 演示的 bin 文件
 JLink:烧录工具
 Keys:用于生成 dfu 升级 bin 的密匙
 NSAndroidUtil: DFU 测试 APK
 NSUtil:串口升级工具软件和源码

2.5 projects Projects

目录包含开发板目录,开发板目录下包含:

  1. bsp:包含调试串口打印功能的 log 函数,用于外设例程在调试过程答应各种调试信息。
  2. pplication:应用例程,使用了多种外设或者功能需求的综合性例程

 peripheral_alone: 外设综合例程,包含串口通信,TIM 的 PWM 输出,ADC 读取和转为电压,IO 输出,IO输入中断响应和 RTC 休眠唤醒
 ble_hid_rcu:蓝牙遥控器例程,使用 KEYSCAN 模块,ADC PGA 模块读取声音和蓝牙HID 数据发 送
 FreeRTOS:Freertos 相关例程

  1. ble:蓝牙从机例程,通过对具体 profile 的蓝牙例程了解蓝牙程序开发的基本方法

 dis:设备服务例程
 hid_mouse: 蓝牙鼠标例程
 rdtss: 蓝牙数传例程(128bit UUID),包含 DFU空中升级项目选项
 rdtss_16bit: 蓝牙数传例程(16bit UUID),包含 DFU 空中升级项目选项
heart_rate: 蓝牙心率服务例程
 blood_pressure: 蓝牙血压服务例程。

  1. ble_central:蓝牙主机例程

 central_rdtsc:蓝牙数传服务主机例程。可以配合 rdtss 例程使用。
central_rdts_c&s:蓝牙数传服务主机和从机模式切换例程。可以配合rdtss或central_rdtsc例程使用。
central_relay_1m1s:蓝牙数传服务中继例程,即一主一从同时工作。可以配合 rdtss 例程使用。

  1. dfu:设备固件升级例程

 common: dfu 公共库目录
 app_ota:蓝牙空中升级例程
 image_update:单 bank模式下,image_update 例程源码
 app_usart:串口升级例程(跳转 masterboot)
 masterboot:固件升级 boot,包含串口升级,固件校验和跳转

  1. peripheral: 包含各个外设功能模块的例程项目,实现每个外设模块的基本功能应用开发,用户可以通过这些例程项目快速了解芯片外设用法。
    【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

3.3 编译环境配置

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

  1. Target页的FLASH和RAM配置

 不包含ble功能项目
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 包含ble功能项目target页
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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

  1. Linker页

 勾选使用Target页的memory配置
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 带ble项目需要加middlewares\Nationstech\ble_library\ns_ble_stack\symdef\symbol_g15.obj文件于Misc control,注意包含蓝牙主机功能的程序使用的obj文件是symbol_g15_central.obj
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

  1. Debug页

 调试器选择CMSIS-DAP Debugger作为开发板上的NS-Link
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 Setting页面如下图
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

3.4 编译与下载

 编译:点击菜单的build按钮【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 下载:点击菜单的download按钮【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 调试:点击菜单的start/stop debug session按钮【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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

 可能1: 代码中将SWDIO/SWDCLK用作其他用途,导致仿真接口失效。一般情况下不建议使用仿真引 脚用作其他功能设计
 可能2:芯片进入低功耗sleep模式,此时仿真接口失效,需要在唤醒状态下下载,直接reset然后下载。

3.5 BLE工程目录结构

以rdtss蓝牙项目工程为例
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 Project Target
 N32WB03x: 蓝牙工程,不带DFU配置,一般ble项目只有这个target
 OTA_IMG_1:带蓝牙OTA工程,配置为Bank1地址
 OTA_IMG_2:带蓝牙OTA工程,配置为Bank2地址

目录结构如下
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

 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内存分布章节。
【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

4.2 RAM

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

 如果使用蓝牙功能,蓝牙协议栈将占用0x20000000 -
0x20003FFF,总共16K字节RAM,用户代码可以使用0x20004000 - 0x2000BFFF,总共32K字节RAM
 如果不用蓝牙功能,则用户代码可以使用全部48K字节RAM

【N32WB03x SDK使用指南】,# 国民技术单片机学习,arm开发,网络,物联网,N32WB031_STB

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

参考文献:
官网地址:https://www.nationstech.com/cpjs273/
文档地址:https://www.nationstech.com/uploadfile/file/20230206/1675671659217095.pdf文章来源地址https://www.toymoban.com/news/detail-597407.html

到了这里,关于【N32WB03x SDK使用指南】的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 国民技术N32G430开发笔记(12)- IAP升级 Settings区域数据初始化

    1、假如,有两个产品,A产品跟B产品,硬件都一样,要求一个软件里的board_name为N32G430C8L7_STB_A,另一个软件里的board_name为N32G430C8L7_STB_B。 那我们如何在不改boot程序跟App程序的基础上,快速的使两个软件看上去不同呢? 这里我们将setting区域的数据提前初始化,通过c语言的文

    2024年02月01日
    浏览(52)
  • 国民技术N32G430开发笔记(18)- I2C1 从机收发数据

    1、将PB6 PB7设置为i2c从机,跟android板卡通讯。 2、Android发送 写命令: 0x05 0x02 0x00 0x00 checksum n32将收到的命令打印出来 读版本命令: 0x01 0x02 0x00 0x00 checksum n32将app_version返回电视端 3、i2c从机配置,采用中断方式收发数据。 主要代码: 从机配置代码: 中断处理函数: 接收到数

    2024年02月03日
    浏览(82)
  • 鸿蒙HarmonyOS-SDK管理使用指南

    sdkmgr(点击链接获取)是一个HarmonyOS SDK命令行管理工具,支持Windows、Mac、Linux三个平台。 sdkmgr支持查看、安装和卸载SDK组件,SDK组件包括API和工具链。 适用于DevEco Studio 3.1 Canary1(3.1.0.100)及以上版本。 sdkmgr命令行格式为: command:包括list、install、uninstall、version、help。

    2024年01月15日
    浏览(47)
  • 【Golang】golang使用三方SDK操作容器指南

    大家好 我是寸铁👊 总结了一篇 golang使用三方SDK操作容器✨ 喜欢的小伙伴可以点点关注 💝 这应该是目前全网最全golang使用三方SDK操作容器的指南了✌️ 主要是创建容器的配置信息,常用的字段 使用包如下: 配置创建Docker 容器的结构体,具体字段的含义和用途如下: 1.

    2024年04月11日
    浏览(40)
  • 【Unity 框架】QFramework v1.0 使用指南 架构篇:03. 引入 Command | Unity 游戏框架 | Unity 游戏开发 | Unity 独立游戏

    我们回顾一下目前的代码,如下; 现在,数据共享的问题通过 引入 Model 解决了。 这里再次强调一下,需要共享的数据放 Model 里,不需要共享的,能不放就不放。 虽然引入了 Model,但是这套代码随着项目规模的发展还是有很多的问题。 其中最严重也最常见的就是 Controller

    2024年02月06日
    浏览(68)
  • PWM在STM32中使用指南

    PWM(脉冲宽度调制)是一种常用来控制模拟电路的技术,通过修改脉冲的宽度(即在固定周期内的高电平持续时间)来调控输出信号的平均电压。 一个PWM信号主要包括两个部分:一个是 占空比 ,它决定了信号高电平状态的时间比例;另一个是 频率 ,它决定了PWM周期的长短

    2024年02月22日
    浏览(39)
  • 小米电机CyberGear STM32HAL 使用指南

    在23年8月底 小米正式发售了用于其铁蛋2代的小米“微电机”,准确来说就是目前机器人方向流行的关节电机。根据其参数可知,在同等重量下,小米此款电机不仅在额定扭矩上达到了4NM,峰值扭矩达到了12NM的水平,同时在价格上也基本上算是全网最低。笔者也是通过预购,在发售之

    2024年02月08日
    浏览(38)
  • STM32入门指南(6)—DAC的使用

    本文以 STM32F103ZET6 为例,介绍STM32的DAC的如何在 STM32CubeMX 中配置,以及一些代码上的说明。主要是针对用DAC输出一些特定信号(以各种频率的正弦信号为例)。 硬件: 一块STM32F103ZET6开发板 软件: MDK 532 STM32CubeMX 6.0.1 该芯片的数据手册可以从ST的官网下载到: https://www.stmic

    2024年02月14日
    浏览(36)
  • STM32:CMSIS-DSP使用指南(在单片机上运用常用的数学运算)

    1.keil环境搭建 在STM32中使用DSP库_linuxweiyh的博客-CSDN博客 2.官方文档 [STM32官方DSP文档](file:///E:/Professional_APP/stm32_cubeMX/install_pack/STM32Cube_FW_F4_V1.27.1/Drivers/CMSIS/docs/DSP/html/modules.html) -1.基本数学运算函数 -2.快速数学运算函数 -3.复数运算函数 -4.滤波器 -5.矩阵函数 -6.数学变换 -7.电机

    2024年02月13日
    浏览(60)
  • 【正点原子STM32连载】第四章 APM32初体验 摘自【正点原子】APM32E103最小系统板使用指南

    1)实验平台:正点原子APM32E103最小系统板 2)平台购买地址:https://detail.tmall.com/item.htm?id=609294757420 3)全套实验源码+手册+视频下载地址: http://www.openedv.com/docs/boards/xiaoxitongban 本章并不涉及程序代码的编写,而是介绍如何编译工程、烧录程序以及进行程序的调试仿真,让读者

    2024年02月21日
    浏览(62)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包