国民技术 N32 开发指南

编制日期 2026-10-14

从硬件安全引擎、RDP 三级读保护与加密下载，到 STM32 移植、低功耗实测与量产烧录 —— 一份把「N32 特有的坑」全部前置的工程手册

结论：国民技术 N32 的差异化不是「更快的平替」，而是 把安全做进了硅片里——国密全系硬件加速 + Flash 加密存储 + MMU 多用户分区 + 安全启动 + 三级读保护 + BOOT 加密下载，这一整条链路在国产通用 MCU 里很少见。它的代价是资料分散且存在版本差异 （同一系列 DS 与 PB 的数值可能不同、不同子系列的寄存器布局有差别），收益是 做安全产品时不用外挂一颗安全芯片。真正让人卡住的从来不是代码，而是四件小事： UID 地址与 STM32 不同（移植必改）、RTC 架构重构且中断改成 EXTI20、 ADC 多一级专用时钟（不配就读不出数）、STM32 有 EEPROM 而 N32 没有。 本文按「选型 → 安全 → 环境 → 外设 → 低功耗 → 硬件 → 移植 → 排障 → 量产」的真实流水线组织， 每一段都给出可复制的代码、可对照的表格、以及该段最常踩的坑。

报告总结

N32 的资料分散在官网产品页、NSING 镜像站、LCSC 参数页、代理商的替代关系表、以及 CSDN / 博客园的迁移实战贴里， 彼此之间没有交叉索引，而且互相矛盾的地方不少（同一个参数 DS 写 4.7 Msps、PB 写 5 Msps； N32L406 的 HSI 有说 8 MHz 有说 16 MHz）。网上的教程绝大多数停留在「装个 PACK → 点灯 → 串口打印」这一步， 一旦遇到读不出芯片 ID、RTC 不唤醒、ADC 恒为 0、量产被抄就无解。本文档做了三件分散资料没做的事：

• 把安全能力当成主线讲：不把 RDP / WRP / 加密存储当成「数据手册最后一章的附加功能」， 而是按四层结构（算法引擎 → 存储保护 → 启动链 → 物理防护）组织，第 3 章是全文最详细的一章。
• 把坑写在坑发生的地方：不单独罗列「常见问题」，而是在讲每个环节时就把该环节的失效现象、原因、处置一起给出。
• 把版本差异标出来：凡 DS 与 PB 冲突、官方与代理商口径不一致的地方，一律标「未核实」并给出该以谁为准， 而不是随手取一个数字写上去。

读者路径

本文档共 11 章 + 4 个附录，按「先跑通、再理解」的顺序组织：

• 只想尽快跑通第一个系统：第 4 章（开发环境）→ 4.6 从零到点灯 → 第 11 章核查清单，三节足够。
• 从 STM32 迁移过来：第 8 章是主线，先看 8.3 二十项必改清单，再按 8.4 的八步做。
• 做安全产品（认证 / 防抄 / 授权）：第 3 章全章，重点是 3.4 读保护与 3.8 加密下载。
• 做电池供电或表计：第 6 章低功耗，注意 LPRCNT 可在 STOP2 下计量这条硬约束。
• 做电机 / BMS：5.7 多 ADC 同步采样 + 5.8 片内 OPAMP + 5.9 定时器 Break 保护。
• 遇到故障：直接翻第 9 章，按八大类现象定位。
• 要量产：第 10 章，重点是 10.3 五层防护与 10.5 ICT 设计。

1 · 文档导读与阅读路径

这一章说明本文档的边界：覆盖什么、不覆盖什么，以及面对 N32 资料的口径冲突该以谁为准。

1.1 覆盖范围

本文档覆盖从选型一颗 N32、装好工具链、点起第一盏灯，到产品化量产与安全防护的完整链路：

• 家族与选型：十六条产品线的定位与规格对照、命名规则逐字段解释、按需求而非按型号的选型决策树。
• 硬件安全引擎：算法覆盖矩阵与一处重要纠偏（G4xx 没有把 SM2 列进 Security Features）、 算法库 API 与调用约定、Flash 存储架构与加密存储、RDP 三级真值表与解除流程、WRP 与 MMU 分区、 UID/UCID 与一机一密、TAMPER 与 CSS、安全启动与加密下载的指令级流程、以及 14 项落地检查清单。
• 开发环境：六种 IDE 的官方支持度、DFP 安装与三处 Include 路径、SDK 目录结构、 四类调试器与 J-Link 的xml 合并坑、串口 ISP 与 BOOT 模式、BOOT 指令集与波特率协商、从零到点灯、链接脚本与 RT-Thread BSP。
• 外设与驱动：总线与时钟使能、GPIO 与 EXTI（含 EXTI20 替代 RTC_IRQn）、 USART（printf / RS485 / LIN / ISO7816）、SPI 与 QSPI、I2C / CAN / USB、SDIO 与 XFMC、 ADC（双时钟是移植必加项、多 ADC 同步）、DAC / OPAMP / COMP / Touch、定时器（互补 PWM 与死区、MOE 位）、 RTC（架构重构）与 DMA、Flash 控制器与 EEPROM 模拟。
• 低功耗：三电源域、六种模式的能力对照、N32L 系列电流实测、唤醒源矩阵、进入代码与通用降耗清单。
• 时钟与硬件设计：时钟源与时钟树、144 MHz 配置完整流程、电源引脚与去耦、NRST 复位电路、 晶振负载电容计算与 LSE 相邻引脚禁止翻转、BOOT 引脚、SWD 与 USB 布线、ESD 设计与最小系统 12 项检查清单。
• 移植与排障：兼容性分三层判断、二十项必改清单、八步流程、八大类故障速查表、通用定位方法论与勘误手册。
• 量产：七种烧录方式、产线 ISP 标准流程、加密烧录与五层防护、UID 写入与产线追溯、ICT / ATE 设计建议。

1.2 不覆盖什么

以下内容超出本文档范围，需要时请查阅对应官方资料：

• 算法库内部实现：原厂算法库以 .lib 静态库形式提供（需签 NDA 获取），本文只给 函数原型、结构体、返回码与调用顺序，不给算法内部逻辑。
• 每一款封装的完整管脚定义：本文给出接口数量与关键引脚原则，完整管脚表必须查对应子系列的 Datasheet 引脚定义表（尤其 FT / FTf 的 5 V 耐受标记）。
• 寄存器位域全集：N32 用户手册动辄上千页，本文只给做决策必须的「哪个模块在哪、找谁帮忙」， 写代码时仍需对着手册核。
• RTOS / 中间件移植：RT-Thread 有官方 N32 BSP、FreeRTOS 改 port 层即可，本文只讲 工程骨架层面必须改的东西（时钟、向量表、堆栈、链接脚本），不逐个驱动过。
• 认证流程本身：EAL4+/EAL5+、商密二级、AEC-Q100 是第三方认证机构的工作， 本文只说明芯片提供哪些能力与认证相关，不解释认证流程。
• PCB 高速仿真与 EMC 整改：本文给的是可执行的规则与官方数值， 实际整改要看板子。

1.3 资料来源与可信度分级

N32 的资料有一个其他国产 MCU 不太常见的特征：同一参数在不同文档里数值不同。 本文对所有数值型信息标注来源与口径，并按下表分级。遇到冲突时的处置原则也写在表下。

2 · 家族全景与选型

这一章把 N32 的十六条子系列摊开，按「你要做什么产品」而不是按型号去理解，最后收敛成一张决策树。

2.1 十六条产品线的分层

国民技术的产品线命名规则是公开的（官网 Product Brief 有专门的型号命名图），先记住一条铁律： 第三个字母决定产品族，第四个字符决定内核，第五个字符决定档位。

2.2 N32G4xx：主力系列

N32G4xx 是绝大多数项目的落点：M4F @144 MHz + 144 KB SRAM + 512 KB Flash + 4 个 ADC + 4 个 OPAMP， 规格上全面覆盖 STM32F1 / F3 / F4 的中高端应用。G455 是最常被拿来做「F103 平替」的型号。

N32G455 完整规格（官方 DS / PB）

2.3 N32G43x：高性价比 M4F

G43x 是「资源够用、价格要低」的那一档。三者的差异集中在模拟外设与电压范围上， 其中N32G430 的电压下限是 2.4 V 而不是 1.8 V，这是最容易踩的坑。

典型应用（官方列出）：电梯控制、5G 通信设备、汽车大灯 / 升窗器 / 电动车控制器 / T-Box、 光伏控制板、BMS、血氧仪、无绳吸尘器、高速风机、电动工具、平衡车。

2.4 N32L4xx / L43x：低功耗与表计

L 系列是电池供电与智能表计的专用线。核心差别不是主频，而是 SRAM2 在 Stop2 / Standby 下保持 + LPRCNT 无磁计量模块能在 Stop2 下工作。

2.5 N32G03x / G05x：宽压与家电

这两条线的共同点是电压上限到 5.5 V，可以直接用家电的 5 V 或电池组供电，省掉一颗 LDO。 G05x 额外带Segment LCD 与 Beeper，是「家电面板 + 显示」的组合。

G030 / G031 是 G032 的精简版：无 CAN、部分型号无 DMA/RTC/GP Timer、ADC/COMP/TSC 精简。 G032 往上 SRAM 提到 16 KB、外设更全、新增 CAN 与硬件加密引擎，最大到 LQFP64。 G033 是2.0~5.5 V 宽压 + 3 路 OPAMP，用于两轮电动车 / 电动工具 / BMS / LED 户外屏。

N32G052 的完整规格：M0 @64 MHz、128 KB Main Flash + 8 KB Data Flash（加密存储、分区管理、硬件 ECC）、 16 KB SRAM（Stop 模式保持）、1×12bit 1 Msps ADC、4 个轨到轨比较器（64 级基准）、 1×8/12bit DAC、Segment LCD 最大 256 段（8×32）、5×UART、3×SPI@16 MHz、2×I2C@1 MHz、1×CAN、 最多 61 GPIO、Beeper 16 mA 驱动、低功耗四模式（Run / Sleep / Stop / Power Down， Power Down 可由 NRST / PA0_WKUP0 / PA2_WKUP1 唤醒）、安全能力含 CRC16 / Flash 加密 / MMU / WRP / RDP 三级 / 时钟失效监测 / 防拆监测 / 96-bit UID + 128-bit UCID。

2.6 N32WB：无线蓝牙系列

2.7 N32S 与 NS350：安全芯片线

如果你的产品需要通过第三方安全认证（商密二级、EAL4+/EAL5+、AEC-Q100）或者需要 TPM 2.0 可信计算，那就不该在通用 MCU 上凑，而是直接用这条线。这也是国民技术的老本行 （本身是安全芯片与可信计算厂商）。

2.8 料号怎么读

N32 的型号命名是公开且规范的，官方 Product Brief 里有专门的命名图。以 N32G455REL7 为例逐字段拆解：

2.9 选型决策路径

把上面这些收敛成七个问题的决策树，从下往上问，第一个命中的分支就是答案：

来源：nationstech.com 产品页 + nsing.com.sg + RT-Thread BSP

补充三条不成文经验：

• 不确定就买官方评估板对应的型号。STB 评估板已经把时钟、调试口、BOOT 串口、 最小系统全部验证过了 —— 你的产品应该从它出发改，而不是从零画原理图。官方命名规则是 N32G45X<封装>-STB，例如 N32G45XRL-STB_LQFP64（N32G457REL7，512 KB Flash， 板载 CMSIS-DAP SWD + USB）。
• 做电机 / BMS 优先看 ADC 与 OPAMP 数量，而不是主频。G455 的 「4×ADC 同步采样 + 4 路 OPAMP（32×PGA）+ 7 个 COMP」这一组能省掉三片外部器件； G435 只有 2 OPAMP + 2 COMP，采样方案要重新设计。
• 同封装内优先选高一档 Flash。G455xB（128KB）与 G455xE（512KB）封装完全相同、 引脚完全相同，差价有限但后期加功能时的返工成本远高于差价。

3 · 硬件安全引擎

这是 N32 真正的差异化所在，也是本文档最详细的一章。国民技术本身是安全芯片与可信计算厂商 （N32S 系列 EAL4+/EAL5+、NS350 TPM2.0、Z32HUA 微认证芯片），N32 通用 MCU 的安全 IP 来自同一套技术栈。

3.0 先看安全能力的四层结构

很多资料把安全能力当成「数据手册最后一章的附加功能」，列一堆算法名就结束了。这样看很容易得出错误结论 —— 比如「有 AES 所以就安全了」。实际上算法只是最基础的一层：如果芯片能被编程器正常读出， AES 加密存储没开，那加密算法再强也没意义。把 N32 的安全能力按四层组织，每层解决不同的问题：

来源：nationstech.com Security Features + N32G45 Series User Manual

四层的关系是叠加生效、缺一不可。举一个具体例子说明为什么：假设只做了第 1 层（用了硬件 SM4） 和第 2 层（开了写保护），没开 Flash 加密存储 —— 攻击者拿编程器读出来仍然是明文固件， SM4 算法再难破解也没有意义。同理，只做了第 2 层（RDP L1）没做第 3 层（加密下载）， 攻击者虽然读不出固件，但可以刷进自己的固件，产品就变成了攻击者的载体。

本章按这个四层结构组织：3.1~3.2 讲第 1 层（算法引擎与算法库），3.3~3.5 讲第 2 层（存储保护）， 3.6~3.7 讲第 4 层中与芯片强相关的一部分（唯一标识与物理防护），3.8 讲第 3 层（启动链）， 3.9 给出把四层落地的 14 项检查清单。

3.1 算法覆盖矩阵与一处重要纠偏

先看全系列算法覆盖情况。这张表来自各系列 Datasheet 与 Product Brief 的 Security Features 段汇总：

各算法能力细节

3.2 算法库 API 与调用约定

国民技术的算法库以 .lib 静态库形式提供（不是源码），需向原厂或代理申请。 以最完整的 EN_UG_NationsN32A455SeriesGeneralCryptographicAlgorithmLibraryUserGuide.pdf 与 EN_UG_N32H49x_Series_Cryptographic_Algorithm_Library_User_Guide_V1.0.0.pdf 为准， N32G03x 版本仅有 AES / SM4 / RNG 三章。

使用步骤（官方描述）：
1. 头文件（n32xxx_aes.h / n32xxx_algo_common.h / Type.h）放入头文件目录
2. 库文件加入工程：
   n32xxx_algo_common.lib  n32xxx_aes.lib   n32xxx_des.lib  n32xxx_hash.lib
   n32xxx_sm1.lib  n32xxx_sm2.lib  n32xxx_sm4.lib  n32xxx_sm7.lib  n32xxx_rng.lib
3. 按指南第 2~9 章的函数描述调用

注意：U32 类型参数要求 4 字节字对齐

基础数据类型（官方 Type.h）

typedef unsigned char      bool;
typedef unsigned char      u8;
typedef signed char        s8;
typedef unsigned short     u16;
typedef signed short       s16;
typedef unsigned int       u32;
typedef signed int         s32;
typedef unsigned long long u64;
typedef signed long long   s64;

DES / TDES API

/* 模式宏定义（官方示例，注意这些是"魔数"不是位域） */
#define DES_ECB     (0x11111111)
#define DES_CBC     (0x22222222)
#define DES_ENC     (0x33333333)
#define DES_DEC     (0x44444444)
#define DES_KEY     (0x55555555)   /* 单倍长密钥 */
#define TDES_2KEY   (0x66666666)
#define TDES_3KEY   (0x77777777)

/* 参数结构体 */
typedef struct {
u32 *in;         /* 待加 / 解密输入 */
    u32 *iv;         /* 初始向量 */
    u32 *out;        /* 输出 */
    u32 *key;        /* 密钥 */
    u32 inWordLen;   /* 明文 / 密文长度（以 word 计） */
    u32 En_De;       /* 0x33333333=加密，0x44444444=解密 */
    u32 Mode;        /* 0x11111111=ECB，0x22222222=CBC */
    u32 keyMode;     /* 0x55555555 / 0x66666666 / 0x77777777 */
} DES_PARM;

/* 返回码枚举（部分） */
#define DES_Crypto_OK         0x0            /* 操作成功 */
#define DES_Init_OK           0x0            /* 初始化成功 */
#define DES_Crypto_ModeError  0x5a5a5a5a     /* 工作模式错误（非 ECB/CBC） */
#define DES_Crypto_EnOrDeError                /* 加 / 解密标志错误 */
#define DES_Crypto_ParaNull                   /* in / out / iv 为空 */
#define DES_Crypto_LengthError                /* 输入长度错误（必须为偶数且非 0） */
#define DES_Crypto_KeyError                   /* keyMode 错误 */
#define DES_Crypto_UnInitError                /* 未初始化 */

AES / SM4 / SM7 / SM1 API

HASH API：分步流式，适合固件验签

大文件或固件镜像的摘要计算必须走流式接口，不要试图一次性读全部数据进内存：

一次性便捷接口：N32H7xx 库提供 One-shot Hash Function（一次性完成）， G4xx 上没有。固件验签的标准写法是 HASH_Init → HASH_Start → 循环 HASH_Update（分块喂入镜像）→ HASH_Finish → HASH_GetResult → 比对。

SM2 API（N32A455 / N32S 算法库）

RNG API：真随机与伪随机

PRNG_Init(...)             /* 伪随机初始化 */
PRNG_SeedUpdate(...)        /* 伪随机种子更新 */
PRNG_GenerateWord(...)      /* 按字生成伪随机数 —— 仅用于非安全场景 */
TRNG_GenerateWord(...)      /* 按字生成真随机数 —— 会话密钥 / Nonce / IV 用这个 */
TRNG_GenerateByte(...)      /* 按字节生成真随机数 */
RNG_GetVersion()

来源：N32G45 Series User Manual Read protection 章节

3.3 Flash 存储架构与加密存储

来源：N32G45 Series User Manual 存储章节

Flash 加密存储（Storage Encryption）

官方描述：「支持加密存储、多用户分区管理及数据保护，支持硬件 ECC 校验， 10 万次擦写，10 年数据保持」。这句话拆开看有四层价值：

• 加密存储 —— Flash 里存放的是密文，读取时经硬件解密后送上总线。 也就是说通过 SWD 或编程器读出来的是密文，无法还原固件。
• 多用户分区管理（MMU） —— 可以把 Flash 划成多个区域，各区域独立配置访问权限与密钥。
• 硬件 ECC —— Flash 有ECC 校验，能检出位翻转。U 盘级可靠性对消费类 MCU 是超配， 但对存校准数据 / 密钥的场合很有价值。
• 10 万次擦写 / 10 年保持 —— 这是参数，不是功能，但它决定了 EEPROM 模拟方案的可行性（见 5.11 节）。

实现要点：需先配置加密密钥（由 TRNG 或用户密钥派生），再通过工具或选项字节使能。 与 RDP 的区别要记清楚：RDP 是访问控制（禁止读），加密存储是保证「就算读出来也不可用」。 两者叠加使用才是完整防护。

3.4 读保护 RDP：L0 / L1 / L2

RDP 是 N32 安全体系里最需要理解清楚、也最容易造成不可逆损失的一环。 它的实现藏在选项字节里，通过 RDP1 / nRDP1（互补）与 RDP2 / nRDP2（互补） 两组字节共同决定当前等级。

三级等级的行为定义（这部分内容直接来自 N32G45 系列用户手册 Read protection 章节）：

从 L1 解除读保护的官方流程

1. 向 FLASH_OPTKEY 写入正确的密钥序列，解锁选项字节区
2. 总线发起命令擦除整个选项字节区（页擦除）
3. 总线向读保护选项字节写 0xA5
4. 芯片内部自动擦除全部主存储区        ← 注意这一步
5. 芯片内部自动向读保护选项字节写 0xA5
6. 系统复位，选项字节块（含新 RDP 值 0xA5）重新装载，读保护释放

工具侧操作：Nations MCU Download Tool

1. BOOT0 接高电平（或用软件跳转 BOOT），重新上电复位 → 进入芯片 BOOT 模式
2. 用 JLINK / USART / USB 任一方式连接设备
3. 打开 Nations MCU Download Tool → 左上角「常用操作」
4. 选择「使能读保护」/「解除读保护」
5. 点击「下载」执行，工具提示操作成功

工具可解除的是 L1；L2 一旦使能便无法解除（不可逆）。 也可用J-Link 侧工具：官方提供的 JLinkNsUnlockTool V1.0.1.exe（配套 JLinkNsUnlockToolConfig.ini）。

3.5 写保护 WRP 与 MMU 多用户分区

写保护 WRP：粒度很粗，但够用

注意粒度问题：低地址区是 2 页（4 KB）一个单元，高地址区是 194 页一个单元。 这意味着 BootLoader 区（放前几页）能得到较细的保护，但 App 区只能整块保护或整块不保护 —— 所以不要指望用 WRP 做到「保护 App 的前 8 KB」。要做更细的分区，得用 MMU。

MMU 多用户分区：方案商模式的正解

典型用法是：方案商把核心算法烧录到指定分区，加密后开放给下游客户二次开发。 官方在介绍 N32L406/403 时明确提到这个用法：「N32L406/403 可运行国民技术自行开发的加密安全库， 可支持密码保护指定范围程序区，方案商烧录核心算法到此区域，提供给下游客户做二次开发， 强化了产品本身的安全性、可靠性和二次开发的使用便利度。」

分区管理的操作入口是 BOOT 指令：

也就是说，分区的擦除与下载都需要密钥认证，不是随便一条指令就能改的。这是方案商模式的技术基础。

3.6 UID / UCID 与一机一密

官方手册给出的典型读法与一机一密的用法：

#define UID_BASE   (0x1FFFF7F0UL)   /* 96-bit  = 3 x 32bit */
#define UCID_BASE  (0x1FFFF7C0UL)   /* 128-bit = 4 x 32bit */

void ReadUID(uint32_t uid[3])
{
uid[0] = *(volatile uint32_t *)(UID_BASE + 0);
    uid[1] = *(volatile uint32_t *)(UID_BASE + 4);
uid[2] = *(volatile uint32_t *)(UID_BASE + 8);
}

/* 官方手册建议的用法：
   "当写 Flash 时，将此唯一标识与软件加解密算法结合，可进一步提高 Flash 中代码的安全性。"
   典型做法 —— 用 UID 派生密钥，实现"一机一密"：
   SM4密钥 = SM3( UID || 厂商主密钥 || 产品型号 )     */

UID 的价值不只是「读出一个序列号」，而是密钥派生的材料。典型用法有三种，按成本从低到高：

3.7 TAMPER 防拆与时钟安全 CSS

各系列 Security Features 段统一列出：「支持时钟失效监测、防拆监测」。 这两项常被当成可靠性特性，但它们本质上是安全特性。

TAMPER 引脚映射

注意：TAMPER 与 RTC / PC13 复用。各封装 / 系列引脚位置不同，必须查对应 DS 引脚定义表。 更重要的是：PC13 同时是「用 LSE 时禁止翻转」的引脚之一（见 7.5 节）， 如果你的产品既要 TAMPER 又要 LSE，这两件事在 PC13 上是冲突的，要靠 PCB 与软件配合取舍。

四层防拆设计实践

时钟安全系统 CSS：防的是故障注入攻击

HSE 失效 → 自动切换到 HSI，并可产生中断（NMI）。它的安全意义常被忽略： 防止攻击者通过注入或停振外部时钟，让 MCU 跑在异常时序下跳过安全检查。 这类攻击叫故障注入（Fault Injection），是针对安全启动流程的经典手段。因此CSS 不是纯可靠性特性 —— 安全启动流程里必须使能 CSS，并在 CSS 中断中进入安全失败状态。

RCC_EnableClockSecuritySystem(ENABLE);   /* 名称以 SDK 为准 */

3.8 安全启动与加密下载

各系列 Security Features 中统一列出三项能力：「支持安全启动、 程序加密下载、安全更新」。这三项构成第 3 层防护。

典型安全启动流程

下面是基于官方能力声明 + 行业通行实现整理的推荐流程（官方未公开一份端到端的参考实现， 所以具体实现需要按自己的方案设计）：

上电复位
  │
  ├─► 芯片内部 BOOT ROM / 用户安全引导区运行（受保护，不可擦改）
  │
  ├─► 读取固件头（版本号 + 长度 + 签名 + 公钥 Hash）
  │
  ├─► 硬件 HASH 引擎计算固件镜像摘要（SHA-256 或 SM3）
  │
  ├─► 硬件非对称引擎验签（RSA/ECC，或 SM2 —— 依系列能力）
  │     └─ 公钥可固化在 BootLoader，或存于受保护分区；
  │        公钥 Hash 烧入 OTP / 选项字节
  │
  ├─► 验签通过 → 解密（若 Flash 加密）→ 跳转用户程序
  │
  └─► 验签失败 → 进入恢复模式 / 锁死 / 触发 TAMPER 事件

加密下载：产线防抄的核心

官方 BOOT 使用指南明确：支持加密下载（AES-128 ECB）。 指令级流程见图7，产线侧的组合建议见 10.3 节。

来源：AN_N32G45x & N32G4FR & N32WB452 Series BOOT interface instruction user guide

安全更新与差分 OTA

国民技术生态资料提到支持「差分 OTA 升级」的行业方案。安全更新有三个要素，缺一不可：

3.9 安全能力落地检查清单

把前面四层结构翻译成可勾选的 14 项。这张清单建议直接贴到产品安全评审的 checklist 里： 它同时覆盖了开发阶段、产线阶段和售后阶段的动作。

4 · 开发环境与工具链

这一章解决「第一次把 N32 跑起来」的所有问题：装什么IDE、装什么包、 工程怎么配、调试器怎么连、程序怎么烧进去。

4.1 工具链全景与选型

来源：nationstech.com 固件和软件页 + 官方资料包清单

下表是官方资料里能拿到的全部选项与支持度。「支持度」列反映的是原厂提供资料的程度，不是软件质量 —— 社区方案往往更灵活，但遇到问题时能查的资料少。

4.2 Keil MDK 与 DFP 安装

PACK 包命名与获取

官方资源页「固件和软件 → IDE 环境包」栏给出如下命名规则与版本要求：

KEIL-N32G030   N32G030 系列 KEIL 开发环境的 PACK 包，支持 KEIL v5.28 及以上    V1.0.4
KEIL-N32G031   ...                                                          V1.0.6
KEIL-N32G032   ...                                                          V0.2.3
KEIL-N32G43x   ...                                                          V1.x
KEIL-N32L43x   ...                                                          V1.x
KEIL-N32G052   ...                                                          V1.1.0
IAR            NSING MCU 基于 IAR 开发环境添加型号的补丁包，IAR v7.x.x+    V1.7.0
JLink          NSING MCU 基于 SEGGER J-Link 添加型号的补丁包，J-Link v6.x.x+ V1.6.0
GCC-N32G030N32G030 系列 GCC 开发环境搭建 V1.1
GCC-N32G052   ...                                                          V1.2.0
N32Cube        N32Cube_for_G03x 初始化代码生成工具，解压密码：n32             V1.0.2

PACK 文件名形态有两种厂商前缀（历史原因）：Nationstech.N32G45x_DFP.1.0.6.pack 与 Nations.N32G430_DFP.1.0.0.pack。安装时两种都会被 Keil 识别，在 Pack Installer 里搜「N32」即可。

安装五步

1. 从官网产品页 →「固件和软件」→「IDE 环境包」下载对应系列 PACK
2. 双击 .pack 文件 → Keil Pack Installer 自动安装（不要手动解压）
3. 打开 Keil → Pack Installer（小立方体图标）搜索 "N32" 确认已安装
4. 新建工程 → Device 数据库选择 "Nationstech :: N32G455REL7"（或对应型号）
5. MDK 自动加载：启动代码、头文件路径、宏定义（如 __N32G455CB__）、
   Flash 编程算法、调试配置

新建工程必配：三个 Include 路径 + 一个宏

Include Paths:
  ├── firmware/CMSIS/Device/Include      （或 CMSIS/device）
  ├── firmware/CMSIS/Include（core_cm4.h 等）
  └── firmware/N32G45x_StdPeriph_Driver/inc

C/C++ → Define:
  USE_STDPERIPH_DRIVER, <器件宏 如 N32G455xx>

还要把 N32G45x_StdPeriph_Driver/src 下的 .c 源文件加入工程。

编译器版本与 Flash 编程算法

4.3 SDK 目录结构

官方 SDK 的通用结构（以 N32G43x 为例）：

N32G43x_SDK/
├── Docs/                # 版本说明、芯片文档索引、readme ← 先看它！
├── Libraries/
│   ├── CMSIS/
│   │   ├── device/      # startup_n32g43x.s、system_n32g43x.c、n32g43x.h
│   │   └── include/     # core_cm4.h 等
│   └── N32G43x_StdPeriph_Driver/
│       ├── inc/         # n32g43x_gpio.h ...
│       └── src/         # n32g43x_gpio.c ...
├── Projects/
│   ├── Examples/        # 按外设分目录：GPIO / UART / ADC / SPI / TIM ...
│   └── Templates/       # 裸机模板、HAL 模板
└── Tools/

N32G430 的实际 SDK（第三方实操帖记录的形态，注意它多了一层中文目录）：

N32G430xx_V1.0.0\
└── 6.软件开发套件\
    ├── PACK\
    │   └── Nations.N32G430_DFP.1.0.0.pack
    └── Nations.N32G430_Library.1.0.0\
        └── projects\
            └── n32g430_EVAL\
                └── examples\
                    └── GPIO\
                        └── MDK-ARM   (Keil 工程)

通用资料包（工具都在这里，不在 SDK 里）：

GeneralFile_V1.0.6
└── CommonPlatform_V1.0.6
    └── Tools
        ├── CMSIS-DAP驱动及安装指南\
        ├── Nations MCU Download Tool V1.3.2\
        ├── Nations MCU Download Tool V1.3.2.7z
        ├── NS general MCU multiple download tool V1.0.7.7z
        └── 第三方量产下载工具清单V1.1.2.xlsx

4.4 调试器：NS-Link / J-Link / CMSIS-DAP

NS-Link / NS-Link-Pro（官方，推荐首选）

• 支持 SWD / JTAG，支持 Flash 编程、在线调试、断点跟踪。
• NS-Link-Pro 额外支持量产在线 + 离线下载，产线方案要考虑它。
• 用 Nations MCU Download Tool 通过 NSLINK(SWD) 烧录时，不需要拉高 BOOT0 —— 这是 NS-Link 相对其他调试器的最大优势（但仅限 NSLINK，其他烧录器不支持走上位机 SWD 口烧录）。
• 资料包：「NSLink 安装、使用、升级资料包」V1.0.0。

J-Link：需要手动添加设备

官方提供的 jlink工具添加Nationstech芯片Vx.x.x 资料包内容：

Device/                 # 下载算法文件（如 N32G45x.FLM）
Samples/                # J-Flash 工程
Nationstech-JLinkDevices.xml       # 需添加的国民技术芯片型号描述
JLinkNsUnlockTool V1.0.1.exe        # 解锁国民技术芯片读保护 L1 的应用程序
JLinkNsUnlockToolConfig.ini        # 解锁工具配置文件
jlink工具添加Nationstech芯片流程_V1.0.pdf  # 官方教程（推荐先读这个）

配置步骤：
1. 把 N32G45x.FLM 复制到 Keil 安装目录 ARM\Flash\ 下
2. 把 Devices / Sample 目录内容复制到 J-Link 安装目录对应位置
3. 修改 JLinkDevices.xml，把 Nationstech-JLinkDevices.xml 内容合并进去

JLink.exe
> connect
> ?         # 按提示选 SWD / 指定器件
>           # 能读出芯片 ID 即配置成功

CMSIS-DAP / DAPLink

• 官方资料包含「CMSIS-DAP 驱动及安装指南」。
• 国民技术多款 STB 评估板板载 CMSIS-DAP 调试器（如 N32G45XRL-STB 的 J4 接口），零成本。
• Keil 里配置：Debug → Use: CMSIS-DAP Debugger → Settings → SW。

四类接口的引脚

来源：BOOT interface instruction user guide + 官方使用指南

4.5 串口 ISP 与 BOOT 模式

进入 BOOT 的两种方式

官方硬件设计指南原文：「BOOT 引脚拉高，芯片复位后从 BOOT 区启动；BOOT 引脚拉低，芯片复位后从用户区启动。」

波特率协商：两条路径

上电后接口自动识别（USART / USB），波特率有两种协商方式：

两代 BOOT 的波特率对照

BOOT 指令集（N32G45x / G4FR / WB452，V2.1 与 V2.2 通用）

其他官方能力：上电 BOOT 自校验（power-on BOOT self-verification）、 跳转到用户区执行、Flash 分区与分区擦除下载的密钥认证、加密下载（AES-128 ECB）。 状态字分「成功状态字 / 失败状态字 / 其他状态字」（详见指南 2.3 节）。

N32G032 的指令集是精简版：CMD_SET_BR、CMD_GET_INF、CMD_FLASH_ERASE、 CMD_FLASH_DWNLD、CMD_DATA_CRC_CHECK、CMD_OPT_RW、CMD_SYS_RESET、 CMD_APP_GO——没有 CMD_KEY_RNG / CMD_KEY_UPDATE / CMD_USERX_OP， 所以 G032 上做不了分区密钥认证的加密下载。

4.6 从零到点灯

最小工程三步走（Keil）

第一步：新建工程，Device 选 N32G455REL7（若无对应器件，先装 DFP）
第二步：把 firmware/CMSIS 与 firmware/N32G4xx_StdPeriph_Driver/src 下的 .c 加入工程
        头文件路径加三处：CMSIS/Device/Include、CMSIS/Include、StdPeriph_Driver/inc
第三步：写 main —— 开 GPIO 时钟 → 配置引脚 → 翻转电平

#include "n32g45x.h"

int main(void)
{
    GPIO_InitType GPIO_InitStructure;

    /* 1. 使能 GPIOB 时钟 —— 一切外设前必须先开时钟 */
    RCC_EnableAPB2PeriphClk(RCC_APB2_PERIPH_GPIOB, ENABLE);

    /* 2. 配置 PB2 推挽输出 50 MHz */
    GPIO_InitStructure.Pin        = GPIO_PIN_2;
    GPIO_InitStructure.GPIO_Mode  = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_InitPeripheral(GPIOB, &GPIO_InitStructure);

    /* 3. 翻转 */
    while (1)
    {
        GPIO_SetBits(GPIOB, GPIO_PIN_2);
        delay_loop(500000);
        GPIO_ResetBits(GPIOB, GPIO_PIN_2);
        delay_loop(500000);
    }
}

时钟配置：最关键也最容易错的一段

/* 若外接 12 MHz 晶振，PLL 倍频系数必须匹配
   错误示例：HSE=12MHz 时 PLL_MUL 仍填 18 → SYSCLK = 216 MHz 超规格
             后果：程序随机死机或复位（表现为「跑一会儿就挂」）           */
RCC_ConfigPll(RCC_PLL_SRC_HSE_DIV1, RCC_PLL_MUL_12, ...);   /* 正确：12×12 = 144 */

/* 改完务必验证实际时钟 —— 这一步不能省 */
RCC_ClocksType clocks;
RCC_GetClocksFreq(&clocks);
printf("SYSCLK=%lu HCLK=%lu PCLK1=%lu PCLK2=%lu\r\n",
       clocks.SysclkFreq, clocks.HclkFreq,
       clocks.Pclk1Freq, clocks.Pclk2Freq);

三个最常见的编译错误

4.7 编译选项与链接脚本

GCC 编译选项（参考 RT-Thread BSP）

CFLAGS  = -mcpu=cortex-m4 -mthumb
        += -mfpu=fpv4-sp-d16 -mfloat-abi=hard      /* M4F 硬件浮点 */
        += -DUSE_STDPERIPH_DRIVER
        += -ffunction-sections -fdata-sections      /* 配合 --gc-sections */
LDFLAGS = -T board/linker_scripts/link.lds
        += -Wl,--gc-sections -Wl,-Map=rtthread.map
        += -specs=nano.specs -specs=nosys.specs     /* newlib-nano 减小体积 */

链接脚本 / 分散加载文件

堆栈配置（RT-Thread 迁移时最常踩）

• OS 初始化卡死 —— 常见原因是堆栈空间设置不当。需要调大 rtconfig.h 中的 RT_MAIN_THREAD_STACK_SIZE 或启动文件里的栈大小。
• N32G45x 的 144 KB SRAM 中16 KB 是 Retention RAM，链接时可以按需规划（通常留给低功耗保持区）。

N32G45x 内存布局

VSCode + GCC + OpenOCD（社区方案）

// .vscode/tasks.json
{ "label": "build", "type": "shell", "command": "make",
  "args": ["-j8"], "group": { "kind": "build", "isDefault": true } }

// .vscode/launch.json（cortex-debug 扩展）
{ "name": "Debug N32 (OpenOCD)", "type": "cortex-debug", "request": "launch",
  "servertype": "openocd", "device": "N32G45x",
  "configFiles": ["interface/cmsis-dap.cfg", "target/n32g45x.cfg"],
  "executable": "./build/n32.elf", "svdFile": "./N32G45x.svd", "runToMain": true }

4.8 RT-Thread 与 N32Cube

RT-Thread BSP 结构（n32g45xrl-stb）

bsp/n32/n32gxx_lxx/n32g45xrl-stb/
├── applications/          # 用户应用 main.c
├── board/
│   ├── board.c / board.h  # 系统时钟初始化、堆内存配置
│   ├── linker_scripts/
│   │   ├── link.lds        # GCC
│   │   ├── link.sct        # MDK(armcc) 分散加载
│   │   └── link.icf        # IAR
│   └── N32G45x_Firmware_Library/
│       ├── CMSIS 器件头文件
│       ├── n32g45x_std_periph_driver/
│       └── USB FS driver
├── Kconfig / SConscript / SConstruct
├── rtconfig.h / rtconfig.py
├── project.uvprojx / .uvoptx        # MDK5
└── project.ewp / .ewd / .eww        # IAR

官方测试版本：MDK5 V5.34 / IAR V8.50 / GCC 6.2.1 20161205。

三部工具链配置（rtconfig.py）

BSP 引脚映射示例（N32G457REL7 STB 板）

已收录的 N32 BSP（v5.0.1 ChangeLog）

n32g43xcl-stb、n32g457qel-stb、n32g45xcl-stb、n32g45xml-stb、 n32g45xrl-stb、n32g45xvl-stb、n32140xcl-stb、n321436_evb、 n32143xml-stb、n32143xrl-stb、n32wb45xl-evb、n32g4frml-stb

串口默认控制台：115200-8-1-N。

5 · 外设与驱动开发

本章按「从 STM32 迁移时最容易踩坑」的顺序组织，而不是按外设分类。 每一节都标出与 STM32 的差异点。

5.0 先看N32G455 的外设总量

对外部设之前，先建立总量概念 —— 这决定了你能用什么方案，省掉多少外部器件。

来源：N32G455 Datasheet + Product Brief

看完这张图，最该记住的三件事：

• 4 个 ADC 可配置为同步 / 交错采样 —— 这是 N32G455 在电机、BMS 场景的核心卖点。 做电机三相电流 + 母线电压同步采样时，采样时刻一致性直接影响控制精度。
• 4 路 OPAMP（32× PGA）+ 7 个 COMP（64 级基准） —— 可以省掉外部运放与比较器。 COMP 输出还能直接连TIM 的 Break 输入做硬件级过流保护。
• USB 只有 Device，没有 Host —— 需要 USB Host / OTG 就得上 N32H49x。

5.1 总线与时钟使能

N32G45x 有内部高速 AHB 总线 + 2 条低速外设总线 APB + 总线矩阵（官方 DS 描述）。 使用任何外设前必须先开时钟：RCC_EnableAPB2PeriphClk() / RCC_EnableAPB1PeriphClk()。不开时钟写寄存器，寄存器写进去了但不生效 —— 这是新工程第一死因。

注意定时器的倍频规则：APB 预分频 ≠ 1 时，定时器时钟会 ×2（与 STM32 一致）。 按官方时钟树章节配置时要注意这条。

5.2 GPIO 与 EXTI

工作模式（与 STM32 SPL 命名基本一致）

速度档：GPIO_Speed_2MHz / GPIO_Speed_10MHz / GPIO_Speed_50MHz。 Speed 是 IO 翻转速率，不是输出电压。EMI 敏感场合降到 2 MHz 或 10 MHz。

硬件约束

复用 AF 与重映射

• N32 提供 AFIO 模块做引脚重映射（remap），机制与 STM32F1 类似。
• 差异警告：N32 的重映射选项数量可能与 STM32 不同（例如 SPI1 的 NSS 重映射选项更少）， 移植时必须查 DS的 Alternate function 表。
• JTAG / SWD 引脚释放：通过 AFIO 把 PA13 / PA14 / PA15 / PB3 / PB4 释放为普通 GPIO （会失去调试能力，慎用；需留 ISP 通道）。

上电默认状态差异（STM32F103 → N32G45X，实测经验，部分未核实）

EXTI：移植时最关键的一处差异

/* N32G45X RTC 唤醒中断配置（迁移时必须新增） */
EXTI_InitType EXTI_InitStruct;
EXTI_InitStruct.EXTI_Line    = EXTI_Line20;          /* ← N32 用 Line20 */
EXTI_InitStruct.EXTI_Mode    = EXTI_Mode_Interrupt;
EXTI_InitStruct.EXTI_Trigger = EXTI_Trigger_Rising;
EXTI_InitStruct.EXTI_LineCmd = ENABLE;
EXTI_InitPeripheral(&EXTI_InitStruct);

中断服务函数命名差异（高频报错源）

处置方式：按编译报错逐个改，或参考 SDK 的 n32g45x_it.c。

NVIC 与向量表重定位

/* IAP BootLoader 跳转前 —— VTOR 必须 512 字节对齐 */
SCB->VTOR = FLASH_BASE | APP_VECTOR_OFFSET;
__set_MSP(*(__IO uint32_t*)APP_ADDR);
((void(*)(void))(*(__IO uint32_t*)(APP_ADDR + 4)))();

5.3 USART / UART：printf、RS485、LIN

N32G455 的 3 个 USART 中，官方描述是「支持 1×ISO7816、1×IrDA、LIN」 ——注意这是「3 个 USART 合起来支持这三种」，不是每个 USART 都同时支持。

printf 重定向

/* Keil (armcc) —— 重写 fputc */
#include <stdio.h>
#include "n32g45x.h"

int fputc(int ch, FILE *f)
{
    USART_SendData(USART1, (uint8_t)ch);
    while (USART_GetFlagStatus(USART1, USART_FLAG_TXDE) == RESET);
    return ch;
}

• GCC (newlib) —— 重写 _write / _write_r； 需要浮点支持时加 -u _printf_float（体积 +约 10 KB）。
• RT-Thread 下无需重定向，直接用 rt_kprintf()，控制台串口在 rtconfig.h 指定。

RS485：必须等 TC 而不是 TXE

void RS485_Send(uint8_t *buf, uint16_t len)
{
    RS485_DE_HIGH();
    for (uint16_t i = 0; i < len; i++)
    {
    USART_SendData(USART2, buf[i]);
 while (USART_GetFlagStatus(USART2, USART_FLAG_TXDE) == RESET);
    }
    /* 必须等 TC（发送完成），等 TXE 会丢最后一字节 */
    while (USART_GetFlagStatus(USART2, USART_FLAG_TXC) == RESET);
 RS485_DE_LOW();
}

LIN 与 ISO7816

• LIN：N32G4xx 的 USART 官方明确支持 LIN。主节点需 LIN 收发器（如 TJA1020）； 从节点可用 USART Break 检测。LIN Break 长度 ≥13 bit 显性位，用 USART 的 LIN Break Detection 功能。
• ISO7816：用于智能卡 / ESAM / PSAM，常与安全芯片（N32S032）或外部安全模块对接 —— 这是 N32 生态的一个特色组合。ISO7816 需要 USART 提供 CLK 输出（如 USART CK 引脚）。
• IrDA：官方描述 3 个 USART 支持 1×IrDA。

5.4 SPI 与 QSPI

_SPI 模式配置四要素

SPI_InitType spi;
spi.DataDirection  = SPI_DIR_DOUBLELINE_FULLDUPLEX;   /* 全双工 */
spi.SpiMode        = SPI_MODE_MASTER;
spi.DataLen        = SPI_DATA_SIZE_8BITS;
spi.CLKPOL         = SPI_CLKPOL_LOW;     /* CPOL */
spi.CLKPHA         = SPI_CLKPHA_FIRST;   /* CPHA（第一边沿采样） */
spi.NSS            = SPI_NSS_SOFT;       /* 软件 NSS */
spi.BaudRatePres   = SPI_BR_PRESCALER_8;
spi.FirstBit       = SPI_FB_MSB;
spi.CRCPoly        = 7;

NSS 硬件设计要点

/* 多从机：SPI 初始化后关闭 NSS 输出 */
SPI_SSOutputCmd(SPI1, DISABLE);

SPI 接各类存储与SD 卡

5.5 I2C / CAN / USB

I2C 实践要点：SDA / SCL 必须配置为复用开漏 + 外部上拉电阻 （4.7 kΩ @100 kHz，2.2 kΩ @400 kHz）；从 ST 移植时 I2C 时序参数（TIMINGR 类）需重算； 总线挂死恢复用主机发 9 个 SCL 脉冲 + STOP。

CAN 需要外部收发器（如 SN65HVD230、TJA1050）；CANH / CANL 差分走线，终端 120 Ω （总线两端各一个）；过滤器用标识符屏蔽 / 列表模式，用法与 STM32 bxCAN 类似。 需要 CAN-FD 就得上 N32H48x / 49x（官方列出 CAN-FD，支持任意 I/O 映射）。

官方设备类支持：CDC（虚拟串口，Win10+ 自带 usbser.sys，无需驱动）、 HID、MSC（大容量存储，配合 SDIO / SPI Flash）、DFU（芯片内置 BOOT 支持）——SDK 都有例程。

5.6 SDIO 与 XFMC

N32 把它命名为 XFMC（部分代理商资料写 FSMC）。 从 STM32 FSMC 移植时，Bank 划分与地址映射不完全一样，需重新调整（迁移实战贴明确提到）。

XFMC 的三类典型应用：

• 外部 SRAM / PSRAM 扩展内存 —— GUI 显存。
• 8080 并口 TFT LCD —— 把 LCD 当作 SRAM 设备寻址，用 1 个地址线做 RS / DC 选择。
• 并行 NOR / NAND —— N32G4xx 没有硬件 NAND 控制器，需要并行 NAND 时走 XFMC。

5.7 ADC：双时钟是移植必加项

来源：N32G45x 用户手册 ADC 章节 + CSDN 迁移实战

规格对照

内部通道

提高精度的硬件与软件措施（官方硬件设计指南 1.7 / 5.3）

5.8 DAC / OPAMP / COMP / Touch

典型应用：OPAMP 用于电机相电流放大（省外部运放）、微弱信号调理、PGA； COMP 用于过流 / 过压快速保护（直接连 TIM 的 Break 输入关断 PWM）、过零检测、低功耗唤醒。

Touch Key（电容触摸）

• 硬件：感应盘建议覆铜 + 开窗，避免覆铜铺地过近；串联 1 kΩ 电阻抑制 ESD。
• 软件：需定期基线校准（温湿度漂移）；防水 / 防误触算法。

5.9 定时器：PWM 互补与死区

N32L43x 额外：通用 5 + 高级 2 + 基本 2 + LPTIM 1（16 bit 低功耗定时器， 支持双脉冲计数，Stop2 可工作），精度 9.25 ns。
N32G052：高级 1（5 通道，4 通道 → 8 路互补 PWM）、通用 4、基本 1（支持 STOP 唤醒）、 WWDG 14 bit、IWDG 12 bit。

PWM 互补输出 + 死区（电机 / 电源核心）

TIM_TimeBaseInitType tim;
tim.Period    = PWM_PERIOD;         /* 自动重装载 */
tim.Prescaler = 0;
tim.ClkDiv    = 0;
tim.CntMode   = TIM_CNT_MODE_UP;
TIM_InitTimeBase(TIM1, &tim);

TIM_OCInitType oc;
oc.OcMode       = TIM_OCMODE_PWM1;
oc.OutputState  = TIM_OUTPUT_STATE_ENABLE;
oc.OutputNState = TIM_OUTPUT_NSTATE_ENABLE;   /* 互补通道使能 */
oc.Pulse        = duty;
oc.OcPolarity   = TIM_OC_POLARITY_HIGH;
oc.OcNPolarity  = TIM_OCN_POLARITY_HIGH;
oc.OcIdleState  = TIM_OC_IDLE_STATE_RESET;
oc.OcNIdleState = TIM_OCN_IDLE_STATE_RESET;
TIM_InitOc1(TIM1, &oc);

/* 死区时间配置（关键，防止上下管直通） */
TIM_BDTRInitType bdtr;
bdtr.DeadTime      = DEADTIME_NS_TO_TICKS(500);   /* 需按时钟频率换算 */
bdtr.BreakState    = TIM_BREAK_STATE_ENABLE;     /* 接 COMP 过流 */
bdtr.BreakPolarity = TIM_BREAK_POLARITY_HIGH;
bdtr.AutomaticOutput = TIM_AUTOMATIC_OUTPUT_ENABLE;
TIM_ConfigBkdt(TIM1, &bdtr);

TIM_EnableCtrlPwmOutputs(TIM1, ENABLE);   /* ← 高级定时器必须调用（MOE 主输出使能） */
TIM_Enable(TIM1, ENABLE);

编码器 / 霍尔 / 低功耗计数

• 编码器：高级与通用定时器支持正交编码输入（X2 / X4），直接读 TIM->CNT。
• 霍尔：可用 TIM 的 XOR / Hall 接口（部分系列支持），或用 3 路输入捕获 + 组合中断； N32H48x 有专门的霍尔 / 超高精度定时器。
• 无磁计量：N32L43x 的 LPTIM 支持双脉冲计数，适合水表计量； N32L436 的 LPRCNT（低功耗 LC 无磁计量模块）可在 STOP2 状态工作，是超低功耗计量的核心。

5.10 RTC 与 DMA

RTC

DMA

DMA_InitType dma;
dma.PeriphAddr     = (uint32_t)&ADC1->DAT;
dma.MemAddr        = (uint32_t)adc_buf;
dma.Direction      = DMA_DIR_PERIPH_SRC;         /* 外设 → 内存 */
dma.BufSize        = ADC_BUF_LEN;
dma.PeriphInc      = DMA_PERIPH_INC_DISABLE;
dma.MemoryInc      = DMA_MEM_INC_ENABLE;
dma.PeriphDataSize = DMA_PERIPH_DATA_SIZE_HALFWORD;
dma.MemDataSize    = DMA_MEM_DATA_SIZE_HALFWORD;
dma.CircularMode   = DMA_MODE_CIRCULAR;          /* 循环模式（连续采样） */
dma.Priority       = DMA_PRIORITY_HIGH;
dma.Mem2Mem        = DMA_M2M_DISABLE;
DMA_Init(DMA1_CH1, &dma);
DMA_EnableChannel(DMA1_CH1, ENABLE);

CRC

N32G455 有独立的 CRC16 / CRC32 硬件运算单元（官方列在 Security Features 段）。 用途：通信校验、固件完整性校验、BOOT 下载数据校验（CMD_DATA_CRC_CHECK）。

CRC_Reset();
uint32_t crc   = CRC_CalcCrc32((uint32_t*)buf, len_in_words);
uint16_t crc16 = CRC_CalcCrc16((uint16_t*)buf, len);

常见 CRC32 为 IEEE 802.3（0x04C11DB7）；N32 的具体多项式与初值未核实， 用之前查用户手册的 CRC 章节。这一点在与上位机 / 产线工具联调时尤其重要 —— 多项式或初值不同，校验永远对不上。

5.11 Flash 控制器与 EEPROM 模拟

存储结构（N32G45x）

页大小 2 KB 是从 WRP 描述反推的（「Page 0~61 每 2 页为一个保护单元，Page 62~255 为一单元」， 两者一致）。具体值请查对应批次 DS 电气特性确认。

等待周期（Wait State / Latency）

N32G455 内置 8 KB 指令 Cache + Flash 加速单元，支持 0 等待执行程序， 但仍需按主频 / 电压配置 Flash 等待周期。精确的 Latency ↔ 频率对照表未在公开 DS 中查到， 可靠的处置是：

/* 官方 SDK 里 SetSysClock() 的做法 —— 直接照抄，不要自己推 */
FLASH_SetLatency(FLASH_LATENCY_4);      /* 数值以官方 SDK 为准 */
FLASH_PrefetchBufCtrl(FLASH_PrefetchBuf_ENABLE);
FLASH_ICacheCtrl(FLASH_ICache_ENABLE);  /* 8 KB I-Cache */

• 上电默认用 HSI 低主频跑，配置完 PLL 后再设置 Flash Latency。
• 顺序：先提 Latency → 再提主频；降频时反向。

（常见参考逻辑，推算、非官方值：≤24 MHz → 0；≤48 MHz → 1；≤72 MHz → 2； ≤108 MHz → 3；≤144 MHz → 4~5。务必以官方 SDK system_n32g45x.c 与实际测试为准。）

读 / 写 / 擦流程

FLASH_Unlock();                    /* 1. 解锁（写 KEY 序列） */
FLASH_ClearFlag(FLASH_FLAG_EOP | FLASH_FLAG_PGERR | FLASH_FLAG_WRPRTERR);

if (FLASH_ErasePage(0x08010000) != FLASH_COMPLETE)   /* 2. 擦除（按页） */
    error_handler();

if (FLASH_ProgramWord(0x08010000, data32) != FLASH_COMPLETE)  /* 3. 编程（字 / 半字） */
    error_handler();

FLASH_Lock();                      /* 4. 上锁 */

EEPROM 模拟：N32 系列没有片内 EEPROM

这一点是 STM32 迁移的高频坑：STM32F1 系列有片内 EEPROM，N32 全系列没有 （官方与代理确认：「N32 系列不支持 EEPROM，需使用 Flash 模拟 EEPROM 功能」）。 典型表现是：原代码里的 EEPROM_Read() / EEPROM_Write() 在 N32 上根本没有对应模块，必须自己实现或改方案。

Flash 模拟 EEPROM 的四个要点：

• 每页开头写状态字（ERASED / RECEIVING / VALID），掉电后能判断页的有效性。
• 页满时搬移有效数据到另一页再擦原页。
• 掉电保护：写入过程中掉电要有恢复逻辑。
• 变量用「虚拟地址 + 数据」格式存，便于查找。

IAP 跳转

#define APP_ADDR  0x08010000    /* App 起始（Boot 占前 64 KB） */

void JumpToApp(void)
{
    uint32_t app_sp  = *(volatile uint32_t*)(APP_ADDR);
    uint32_t app_rst = *(volatile uint32_t*)(APP_ADDR + 4);

    if ((app_sp & 0x2FFE0000) == 0x20000000) {   /* 栈指针合法性检查 */
      __disable_irq();
        /* 关闭已开启的外设、DMA、中断 */
  SysTick->CTRL = 0;
      SCB->VTOR = APP_ADDR;                     /* 重定位向量表 */
   __set_MSP(app_sp);
        ((void(*)(void))app_rst)();
    }
}

App 侧必须同步改三处：链接地址改为 0x08010000； system_n32g45x.c 中的 VECT_TAB_OFFSET 改为 0x10000； 或直接在代码里设 SCB->VTOR = 0x08010000;。三处只改一处是 IAP 跑不起来的经典原因。