企业官网建设流程全解析

简介：面向嵌入式开发者的中微半导体BAT32G137开发资源包（版本1.00.4）现已开放下载。该资源覆盖CMSIS标准库与项目开发例程，适用于基于ARM Cortex-M内核的低功耗应用场景，尤其适合希望复用STM32开发经验的工程师快速上手国产MCU。文件共591个，压缩包仅1.62MB，主要包含C源码、H头文件、汇编启动文件以及uvprojx/uvoptx工程配置，另有readme说明、map映像文件和FLM烧写算法，结构与Keil MDK及STM32CubeIDE兼容。例程涵盖GPIO、SPI、I2C、UART、ADC、PWM定时器等常用外设，从串口通信到ADC采样均有可直接编译的工程模板，便于对照学习外设初始化和CMSIS API调用。目前已有187人学习下载，适合刚接触BAT32G137的初学者以及需要快速搭建项目框架的工程师。该资源将CMSIS库函数、官方例程与工程模板整合为紧凑的离线包，可大幅节省查找分散资料的时间，是进行低功耗嵌入式开发的实用参考。 最近项目里换了一颗 MCU，中微半导体的 BAT32G157，配套的 SDK 版本正好是 Cmsemicon.BAT32G157.1.00.4。这颗料加上这个版本号，前前后后折腾了两周，从最开始点灯都点不亮，到后面把串口、低功耗、ADC 这些模块全部调顺，踩了不少坑，也积累了一些心得。这篇文章不打算写产品手册式的介绍，纯粹是把实际用下来的经验、取舍和排查方法做个整理，给正在评估 BAT32G157，或者准备用 M0+ 做低功耗项目的朋友参考。

1. 前面的话：为什么盯上 BAT32G157 和 1.00.4

1.1 这颗料解决什么问题

BAT32G157 是 Cortex-M0+ 内核的 32 位 MCU，锁定的场景很明确：电池供电、传感器采集、电机控制、白色家电这类对功耗和成本敏感的项目。M0+ 内核的好处不用多说，指令集精简、功耗表现好，开发上手门槛也比老 51 和部分 8 位机高不了太多，尤其是在 Keil 和 GCC 这类工具链已经很成熟的今天，工程迁移成本非常低。

我选择的依据其实很简单。第一是片上外设齐全，定时器、串口、ADC、比较器、低功耗管理模式都给你了，一个中规模系统基本不需要额外挂太多芯片。第二是供货和价格，这两年芯片供应链波动大家都有体会，国产替代料在交期和价格上的优势是实打实的。第三是开发资料，官方 SDK 的例程覆盖还算完整，虽然细节上有些地方写得不够透彻，但至少给了个能跑的起点。

真正让我确定要用它的，是拿到 Cmsemicon.BAT32G157.1.00.4 这个版本之后。这个版本号看着像是一串普通的软件包命名，但对比早先的驱动库，修复了不少影响实际开发的问题。

1.2 1.00.4 版本带来了什么

我特意翻了下 release note，印象比较深的是三处改动。一是串口底层的波特率配置逻辑做了调整，修复了某些外部晶振频率下波特率误差偏大的问题；二是 ADC 校准流程的初始化时序改了，早期版本如果上电后立刻采样，偶尔会读到明显偏大的值；三是定时器 PWM 输出相关的寄存器操作方式变了，给了更统一的接口。

这些改动对老手来说可能只是几个函数的变化，但对调试阶段的影响非常直接。我刚开始用旧版本库写串口测试程序，115200 波特率在 8MHz 内部时钟下怎么都对不上，打印出来全是乱码。换到 1.00.4 之后问题消失。如果你正准备从旧版本迁移，或者直接拿新版本开工，我的建议是：先以这个版本为基准，不要混用旧库文件，尤其是启动文件和系统时钟初始化代码。

2. 从拿到 SDK 到点亮第一颗灯

2.1 工程模板的搭建思路

拿到 SDK 后，我没有直接用官方提供的完整工程，而是自己重新建了一个干净模板。这么做的原因很现实：官方例程往往包含很多不相关的模块，编译一次要加载一堆文件，新手容易分不清哪些是必须的。自己建模板虽然多花半小时，但之后加外设、加驱动都会很清晰。

我的目录结构大概是这样的：

project/ ├── app/ │ ├── main.c │ ├── app_config.h │ └── app_uart.c ├── bsp/ │ ├── gpio.c │ ├── uart.c │ ├── adc.c │ └── lowpower.c ├── cmsis/ │ ├── core_cm0plus.h │ └── system_bat32g157.c ├── device/ │ ├── bat32g157.h │ └── startup_bat32g157.s └── driver/ └── ... // 官方库外设驱动

要点是：官方库文件保持原样，不要改。所有业务代码放在 app 和 bsp 下面，这样官方库升级时，直接替换 device 和 driver 目录即可。这个习惯帮我躲过了好几次升级 SDK 后改到一半忘掉改了什么的尴尬。

在 Keil 里需要设置的几个地方：Device 选择对应型号，C/C++ 的 Include Path 至少包含 cmsis、device、driver 三个目录，宏定义里加上芯片型号，比如BAT32G157。编译优化等级建议先用 -O0，等调试稳定后再考虑 -O2。

2.2 时钟与启动文件的基本配置

启动文件是整个工程跑起来的地基。BAT32G157 作为 M0+ 芯片，中断向量表、堆栈初始化这些事情都靠 startup 文件完成。官方 SDK 里提供的启动文件一般可以直接用，但要注意里面的堆栈大小是否满足项目需求。默认 512 字节栈有时候不够，我一般改成 0x1000，也就是 4KB，省得后期莫名其妙的栈溢出。

时钟配置是重头戏。这颗芯片可以选内部高速 RC 或外部晶振，再经过锁相环倍频到系统主频。如果对功耗有要求，不跑高速外设时可以降频运行；如果跑通信和 PWM，又需要稳定时钟源。我的做法是做一个可配置的时钟结构体，在不同运行阶段切换。

void SystemClock_Config(void) { /* 使用外部晶振，系统主频配置为目标频率 */ RCC_OSCINIT (OSC_HSE | OSC_PLL, FREQ_64M); /* 使能外设时钟 */ RCC_SYSCLKConfig (RCC_SYSCLK_PLL); /* 等待时钟稳定 */ while (!RCC_GetFlagStatus (RCC_FLAG_PLLRDY)); }

上面这段是示意写法，不同 SDK 的函数名会有差异，但整体思路一致。需要特别注意的是，切换时钟源之前一定要等目标时钟就绪，否则会卡死在 while 循环里。早期版本库在这块有过 bug，所以我习惯加个超时计数。

2.3 点灯代码的完整流程

点灯虽然简单，但它是验证整个工程链路的最高效方式。我的点灯步骤是这样：

1. 确认启动文件和系统时钟函数已被调用。
2. 使能 GPIO 端口时钟。
3. 把 LED 引脚配置为推挽输出。
4. 写高/低电平，观察现象。

void LED_Init(void) { GPIO_Config(LED_PORT, LED_PIN, GPIO_MODE_OUT_PP); GPIO_SetPin(LED_PORT, LED_PIN); } void LED_Toggle(void) { GPIO_TogglePin(LED_PORT, LED_PIN); }

我踩过的一个坑是：SDK 的 GPIO 初始化函数如果参数里少使能了端口时钟，代码不会报错，但引脚电平完全没反应。排查方式也非常笨但有效：把初始化函数的返回值打印出来，或者直接看寄存器值。点灯不仅是验证，也是在确认编译链、烧录链、时钟链是否全部正常。如果这一步顺利，后面加外设就有底了。

3. 实际项目里用到的高频外设

3.1 串口调试的坑

串口是所有调试工作的基础，没有它基本等于盲调。BAT32G157 的串口模块支持标准 UART，使用上和其他 M0+ 芯片差别不大，但只要涉及波特率，就一定要回头检查时钟源。串口波特率由外设时钟分频得到，如果外设时钟不是预期值，打印就会乱码。

我在 1.00.4 版本上的经验是：

• 调试阶段用外部晶振作为外设时钟，避免内部 RC 温漂带来的误差。
• 波特率尽量选整数分频能达成的值，比如 115200 在 16MHz 外设时钟下误差很小。
• 串口中断优先级要设置，否则在主循环忙等时可能丢数据。

串口驱动的初始化大致是：

void UART_Init(uint32_t baudrate) { UART_Config(UART1, UART_MODE_TX_RX, baudrate); UART_ITConfig(UART1, UART_IT_RX, ENABLE); NVIC_EnableIRQ(UART1_IRQn); }

如果打印仍然乱码，先别怀疑代码。用示波器看 TX 引脚波形，数一下一位的时间对不对。很多时候是外部晶振没起振，代码却以为起振了。

3.2 低功耗模式与唤醒

BAT32G157 的定位之一就是低功耗，所以低功耗模式的配置我特别上心。系统提供了多种运行/停止模式，我实际最常用的是停止模式和待机模式。停止模式下内核时钟停止，但 RAM 保持，唤醒速度快；待机模式功耗更低，但唤醒后相当于复位，现场需要重建。

现场实测下来，我的系统在停止模式下电流约为微安级别，具体数值和引脚状态、外设时钟开关关系很大。要做到这个量级，除了进入低功耗模式之外，还需要逐个检查 GPIO 状态。未使用的引脚不能悬空，要么配置成输出低电平，要么使能内部下拉，否则会通过引脚漏电。这是低功耗项目最常见，也最容易忽略的问题。

进入停止模式的代码比较直接：

void EnterStopMode(void) { /* 关闭不需要的外设时钟 */ RCC_PeriphClockCmd(DISABLE); /* 配置唤醒源，使用外部中断 */ EXTI_Config(WAKEUP_PIN, EXTI_MODE_FALLING); /* 进入停止模式 */ PWR_EnterSTOPMode(PWR_STOPENTRY_WFI, ENABLE); /* 唤醒后恢复外设时钟 */ RCC_PeriphClockCmd(ENABLE); }

唤醒后第一件事不是干活，而是重新配置时钟和需要的外设。M0+ 从停止模式恢复后，有些外设寄存器会回到默认状态，不能假设它还保留之前的值。

3.3 ADC 采样与数据处理

ADC 也是这个项目里绕不开的模块。BAT32G157 的 ADC 位数对于传感器采集足够用，但前提是参考电压和采样时序要处理好。官方 1.00.4 版本调整了校准初始化时序，我的体会是：所有 ADC 采样前一定要执行校准函数，并且等校准完成标志位置位。

采样电池电压时，我遇到过一个典型问题：电池电压经过电阻分压后接入 ADC，但采到的值波动很大。排查了半天才发现是采样时间太短，内部采样电容还没稳定。把采样时间从最短档位调到中间档位后，数据立刻平滑很多。如果测量动态信号，还要考虑软件滤波。我用了一阶滑动平均，窗口大小取 8 或 16，既能滤掉噪声又不至于太滞后。

uint16_t ADC_ReadFiltered(ADC_TypeDef *ADCx, uint8_t channel) { uint32_t sum = 0; for (int i = 0; i < 16; i++) { sum += ADC_ReadChannel(channel); } return (uint16_t)(sum >> 4); }

这个代码没有做异常值剔除，如果个别采样点严重偏离，均值也会被带偏。实际项目里我会先做简单的中值滤波，再取均值。

4. 避坑指南：常见问题与排查技巧

4.1 下载器连不上的应对

说实话，用 BAT32G157 的过程中最让我头疼的倒不是代码，而是某几次下载器连不上芯片。现象是 Keil 报 SWD 通信失败，目标芯片无法识别。这种情况绝大多数不是芯片坏了，而是进入低功耗模式后调试口被禁用，或者复位引脚被拉死。

我的处理顺序是：

1. 按住复位键不放，点击下载，等下载器开始连接时松开复位。
2. 把 BOOT 引脚拉高，让芯片进入 ISP 模式，擦除全片后再重新连接。
3. 检查下载器供电是否足够，部分下载器在目标板上电瞬间电压跌落会导致握手失败。
4. 降低 SWD 时钟频率，比如从 4MHz 降到 1MHz。

如果以上都试过还是不行，再看硬件电路。SWDIO 和 SWCLK 引脚上不要加过长走线，也不要并联大电容，否则信号质量会差到握手失败。

4.2 程序跑飞和中断进不去

程序跑飞这个问题很隐蔽，特别是刚上电时跑一段就 HardFault。M0+ 没有复杂的内存保护单元，HardFault 大多数时候是指针访问了非法地址，或者栈溢出破坏函数返回地址。我的排查经验分两步：第一步，把编译器生成的 map 文件打开，确认栈和堆大小；第二步，在 HardFault_Handler 里加个断点，进去后查看 LR 和 PC 值，反推是哪个函数调用链。

中断进不去则是另一类问题。常见原因是中断标志位没有清除，或者 NVIC 里没使能对应中断。有一次我发现串口接收中断不触发，单步执行发现接收超时标志一直置位，导致中断服务函数一进去就退出，根本没处理数据。把所有中断标志位全部清除再重新使能后，问题解决。

4.3 升级 SDK 后代码不兼容怎么办

很多人拿到新版本 SDK 的第一反应是直接替换旧文件，结果编译出一堆错误。我的建议是不要盲目替换，先把项目备份，然后对照 release note 逐个模块升级。Cmsemicon.BAT32G157.1.00.4 这个版本相对旧版确实改了不少接口，但大部分是函数名的变化和参数结构体的调整，直接搜索旧函数名，在新库里找到对应实现，就可以平滑迁移。

我自己的迁移策略是分模块做：

• 先编译出一个空 main，确认库文件和启动文件没问题。
• 再依次加回 GPIO、串口、定时器、ADC 驱动，每加一个模块就编译一次。
• 每次只处理一类报错，不要同时改多个文件。

这样即使出错，也知道问题出在哪一层。整个过程看起来慢，实际上比最后集中排查快得多。

5. 关于版本号的一点使用建议

5.1 用 Git 管理 SDK 和项目

Cmsemicon.BAT32G157.1.00.4 这个版本我不会直接当作不可变供应商代码整包丢进项目。我的做法是：在 Git 仓库里单独建一个vendor/cmsemicon目录，把官方 SDK 原封不动提交进去，然后基于它做本地修改。官方如果发布 1.00.5，我就能通过 diff 快速看出改动点，再决定是否合并。

这个习惯在升级驱动库时救了我很多次。有时候官方修复了一个 bug，却引入了另一个新问题，有 diff 记录就能轻松回滚。

5.2 例程代码别直接抄，要理解外设关系

官方例程最大的价值是告诉你“这个外设该怎么初始化”，但实际业务逻辑从来不会那么简单。例程里为了展示功能，往往会顺序执行一堆初始化，而真实项目需要在不同功耗模式之间切换，还要考虑外设之间的优先级和依赖关系。抄例程只能保证功能跑通，保证不了系统稳定。

我的体会是，拿到任何一颗新 MCU，先别急着看代码，花半小时把时钟树和外设总线关系画一遍。哪怕只是画在纸上，后续调试都会顺很多。BAT32G157 的外设并不复杂，但各部分时钟从哪里来、哪个外设和哪个外设共用引脚，这些搞不清楚，后面一定会在某个隐蔽问题上卡住。

最后再分享一个小技巧。如果你在用 BAT32G157 做低功耗产品，我建议你在进入休眠前把所有调试打印关掉，但你仍然可以通过某个空闲引脚的状态来确认代码是否进入休眠。用示波器抓这个引脚的下降沿，比反复看电流表方便得多。这个小习惯帮我快速验证了好几轮低功耗流程是否正确。

本文还有配套的精品资源，点击获取