简介STM8L101基础库例程包是面向嵌入式初学者与STM8L系列开发者的实用开发素材共包含35个可直接学习的例程覆盖GPIO控制、定时器、ADC采集、UART/SPI/I2C通信、中断处理及低功耗电源管理等常用外设主题。压缩包内共2000个文件以h头文件和c源程序为主体另含IAR工程配置ewp/ewd、编译输出及调试辅助文件整体约28.46MB目录结构清晰便于按需检索。已有918人学习下载例程按由浅入深组织从基础I/O操作到定时器PWM、串行通信与低功耗唤醒均有注释详实的代码示范可帮助读者快速理解寄存器配置与程序流程。对工程师而言这些例程也是可直接复用的驱动模块能显著缩短传感器采集、便携仪表及无线通信等低功耗产品的开发周期。1. 例程包里被低估的 STM8L101从 35 个 Demo 看超低功耗开发的下限做两节 AAA 电池供电的采集节点时待机电流压到 2μA 以内很多 8 位 MCU 直接出局而 STM8L101 在 Halt 模式下可以稳定停在微安级。比选型更麻烦的是开发资料分散数据手册看寄存器、应用笔记讲场景、官方库又只覆盖主流型号。这套 35 个例程的基础库恰好补齐了中间层——每个外设一个可编译工程从 GPIO 翻转、外部中断唤醒到 Flash 数据区编程都有完整代码而且全部基于寄存器操作不依赖图形配置工具。对于准备在电池供电产品里用这颗芯片的开发者这套例程既是学习路径也是可以直接抄进生产项目的代码底稿。下面是逐层拆解这套资源时真正值得花时间的部分。2. 例程包迷宫从 cspy.bat 反向理解 IAR 工程组织2.1 为什么会有一堆 Demo.Debug.cspy.bat拿到资源包后第一眼看到的是一长串同名批处理文件这不是打包出错。用文本编辑器打开任意一个 Demo.Debug.cspy.bat结构基本是 IAR 命令行调试器的调用封装echo off REM 调用 IAR 公共目录下的 cspy 批处理入口 set CWSPATHC:\IAR Systems\Embedded Workbench 8.40\common\bin REM -f 参数分别加载板级描述文件和编译产物 %CWSPATH%\cspy.bat -f Demo\Demo.Debug\Demo.board -f Demo\Demo.Debug\Demo.outcspy.bat 是 IAR Embedded Workbench 生成的调试启动脚本逻辑是先加载 .board 文件拿到调试器型号、SWIM 接口速率这些硬件描述再加载 .out 可执行文件。例程包里每个 Demo 目录下都有独立一份意味着每个例程都是完整建好的 IAR 工程不用手动移植配置双击脚本或从 IAR 里打开对应 .eww 工程文件就能直接编译和在线调试。这套组织方式的好处是每个外设例程的编译选项、芯片型号、链接脚本都是配套验证过的复制到新项目里不至于出现头文件路径没配置这种低级问题。2.2 35 个例程按外设分组的定位逻辑浏览整个例程目录后会发现35 个工程不是平铺的而是按外设模块和常见应用场景做了分组。命名规律通常是「外设名 功能」比如 TIM2_PWM、ADC_SingleChannel、UART_TxRx 这类组合。下面这个表格是这批例程的常见覆盖范围命名细节在具体资源包里可能有出入但主题基本沿这个方向展开分组方向涉及外设例程里解决的实际问题GPIO 类GPIO、外部中断按键消抖、LED 驱动、边沿触发唤醒定时器类TIM1、TIM2、TIM4毫秒延时、PWM 输出、输入捕获测频通信类UART、SPI、I2C串口收发、与 Flash 芯片通信、读取传感器寄存器低功耗类电源管理、唤醒源Halt 模式进出、外部事件唤醒、看门狗复位数据类ADC、CRC、Flash 编程模拟量采集、校验计算、内部数据区读写这批例程的代码风格偏向寄存器直接操作不像标准外设库那样把配置封装成结构体函数。这种做法对低功耗场景是合理的——每个寄存器位都可以精确控制编译出来的代码也更紧凑。阅读某个具体例程时建议先打开对应的 .h 头文件里面通常把用到的寄存器地址和位定义都做了宏映射这相当于一份精简版寄存器手册。2.3 把例程并入自己工程的两种做法拿一个 GPIO 例程改成自己的业务代码时常见做法是直接复制整个工程目录再改保留 IAR 的工程配置不动。另一种做法是只拷贝 Sources 目录下的 .c 和 .h 文件手动加到现有工程里这种方式适合已经有完整工程框架的开发场景。关键点在于 STM8L101 的启动文件和中断向量表必须沿用例程里配好的版本一旦换成其他路径第一行 main 函数都可能进不去。另外留意例程源码里的晶振配置如果选的不是默认主频UART 波特率和定时器定时值会整体偏移这是移植后第一个要核对的地方。3. GPIO 与时钟门控基础库中可直接挪用的寄存器配置3.1 GPIO 四个寄存器的模式对照STM8L101 的 GPIO 不复杂但配套的四个寄存器DDR、CR1、CR2、ODR/IDR组合起来容易记混。DDR 决定方向CR1 在上拉和推挽之间切换CR2 控制斜率与是否启用外部中断ODR 写输出数据。用 PB 口驱动一个 LED 的标准配置是// PB7 配置为推挽输出用于点亮 LED PB_DDR | 0x80; // DDR 位 7 置 1PB7 设为输出 PB_CR1 | 0x80; // CR1 位 7 置 1输出模式推挽 PB_CR2 ~0x80; // CR2 清 0不使能中断降低斜率 PB_ODR | 0x80; // ODR 置 1输出高电平输出模式下 DDR 决定方向CR1 选择推挽或开漏推挽直接灌电流驱动 LED改成输入模式后 CR1 又切换为上拉使能同一个位在输入输出模式下含义不同这是最容易踩的坑。CR2 在输出模式下控制压摆率低功耗设计里建议全部清零以降低 EMI 和动态功耗输入模式下 CR2 置位则启用该引脚的外部中断功能。上面这段代码执行后 LED 处于常亮状态配合延时函数就能扩展成流水灯例程。3.2 时钟门控不用的外设时钟要关掉STM8L101 的每个外设都挂在独立时钟门控上由 CLK_PCKENR1 和 CLK_PCKENR2 控制。很多人把精力放在调低主频上却忘了关掉没有使用的外设时钟——ADC、SPI、UART 的时钟即使不做任何操作也会贡献可观的动态电流。初始化 GPIO 之前先把外设时钟配置好// 选择内部 16MHz 高速 RC 作为主时钟源 CLK_ICKR | 0x01; // 打开 HSI 内部 RC 振荡器 CLK_CKDIVR 0x00; // 主时钟不分频CPU 跑 16MHz CLK_PCKENR1 0x7F; // 默认开启 GPIO 等基础外设时钟 CLK_PCKENR2 ~0x07; // 关闭不用的外设时钟以降低功耗CLK_CKDIVR 的低 4 位是分频系数0x00 表示 1 分频0x01 表示 2 分频依次类推。PCKENR1 和 PCKENR2 的每一位对应一个外设置 1 开时钟、清 0 关时钟具体位映射在参考手册的时钟章节有完整表格。这里把 PCKENR2 的部分位清零后对应外设立即停止工作即使后续代码误操作其寄存器也不会产生电流消耗。低功耗例程里这套门控逻辑往往配合 Halt 模式一起出现先断外设时钟再停机能把待机电流多往下拉一个档次。3.3 交替翻转实验验证配置有效性配置完成后做一次最小验证用定时器做 500ms 翻转观察 LED 闪烁节奏是否准确。这里先给出 GPIO 层面的翻转逻辑定时器部分留到下一章展开while (1) { PB_ODR ^ 0x80; // 异或翻转 PB7 delay_ms(500); // 依赖 TIM2 实现的毫秒延时 }翻转逻辑本身没有新知识点但值得留意的是 PB_ODR 的异或操作是原子读改写不会被中断打断造成电平抖动。如果要同时翻转多个引脚建议直接写 8 位整体赋值而不是逐位异或否则 LED 会出现肉眼可见的闪烁错乱。4. TIM2 定时、ADC 采集与 UART 收发抄例程前先算好参数4.1 TIM2 定时中断的分频与重装值计算STM8L101 的 TIM2 是 16 位通用定时器例程里最常见用途是生成 1ms 系统时基。设主频 16MHz、不分频1ms 需要计数 16000 次因此自动重装值 ARR 16000 - 1 0x3E7F。实际例程代码通常拆成高字节和低字节分别写入// TIM2 产生 1ms 周期中断 TIM2_PSCR 0x00; // 预分频 1计数时钟 16MHz TIM2_ARRH 0x3E; // 重装值高字节配合低字节组成 16000 TIM2_ARRL 0x7F; // 重装值低字节(0x3E7F 1) / 16MHz 1ms TIM2_IER | 0x01; // 使能更新中断 TIM2_CR1 | 0x01; // 启动计数预分频寄存器 PSCR 置 0 表示计数时钟等于主频也就是 16MHz。重装值拆成两个 8 位寄存器写入是因为 STM8 是 8 位总线一次只能写一个字节。如果定时间隔不是 1ms按公式ARR 定时时间(秒) × 主频 / 预分频 - 1计算即可。例程包里的延时函数一般就是初始化 TIM2 后在主循环里查询更新标志位实现的没有用中断嵌套这样代码的可移植性更好。4.2 ADC 采集的通道选择与 12 位数据组合ADC 例程演示的是单次转换模式关键是两处通道号和转换结果的数据拼装。STM8L101 的 ADC 是 12 位分辨率结果高位放在 ADC_DRH低 4 位放在 ADC_DRL 的高半字节读取时做移位组合// 单次转换模式采集通道 2 ADC_CSR 0x02; // 选择 AIN2 输入通道 ADC_CR2 | 0x01; // 开启 ADC 模块电源 ADC_CR1 | 0x01; // 启动一次转换 while ((ADC_SR ADC_FLAG_EOC) 0); // 等待转换完成EOC 标志置位 uint16_t result ((uint16_t)ADC_DRH 4) | (ADC_DRL 4); // 组合 12 位结果ADC_FLAG_EOC 这个宏在例程包的头文件里有定义不同版本的库可能叫法不同但本质都是读取 ADC_SR 的状态位。组合结果时特别注意 DRL 要右移 4 位因为 12 位数据的低 4 位存放在 DRL 的高位区域。如果直接做ADC_DRH 8 | ADC_DRL换算出的电压值会偏差 16 倍这是 ADC 例程最容易被改坏的地方。参考电压默认接 VDD采集到的数值换算电压用电压 result × 3.3 / 4095例程代码里通常也会给出这条换算语句。4.3 UART 波特率寄存器拆分与示波器验证UART 例程的发送接收逻辑不难难在波特率配置。STM8L101 的波特率寄存器 BRR1 和 BRR2 不是简单的高低位拼接而是把 16 位分频值拆成三段映射。16MHz 主频下跑 9600bps分频值 DIV 16000000 / 9600 ≈ 16670x683对应 BRR1 0x68BRR2 0x30// 初始化 UART9600bps8 数据位无校验 USART_BRR2 0x30; // 分频值位 3:0 放到 BRR2 高四位位 15:12 放到低四位 USART_BRR1 0x68; // 分频值位 11:4 存入 BRR1 USART_CR2 0x0C; // 使能发送和接收分频值拆分的对应关系是DIV 的低 4 位写入 BRR2 的 bit7:4DIV 的 15:12 位写入 BRR2 的 bit3:0中间的 11:4 位写入 BRR1。这样设计是历史原因照抄这个配置没有任何问题但要换其他波特率时必须重新按这个规则拆分不能用常规的高低字节拼接思路去改。改完可以用示波器勾在 TX 引脚上看波形9600bps 每个 bit 宽度约 104μs抓到方波就说明配置正确。串口例程里通信不正常十有八九是 BRR2 的拆分写反了。4.4 SPI 和 I2C 例程的易错点这两个通信外设的例程相对独立SPI 例程要核对主从模式、时钟极性和相位CPOL/CPHA 四组组合是否与外设匹配I2C 例程则要注意地址位宽——7 位还是 10 位地址要在初始化结构体里明确指定否则第一次读写外设就挂在 ACK 上。例程包里提供的通常是轮询方式实现的主机收发这对绝大多数传感器读取场景够用。如果后续要加大数据量再考虑 DMA 和中断的结合但 STM8L101 的 DMA 资源有限要仔细看例程里是否有对应支持。5. 中断向量与低功耗唤醒把 Halt 模式功耗真正压下来5.1 外部中断三步配置DDR、CR2、EXTI_CRx用外部中断把 MCU 从 Halt 模式唤醒是低功耗例程的核心功能。配置外部中断需要 GPIO 和 EXTI 两级配合以 PB0 上升沿唤醒为例先配置 PB0 为带上拉的输入模式再开启该引脚的 EXTI 通道// PB0 外部中断上升沿唤醒 PB_DDR ~0x01; // PB0 设为输入 PB_CR1 | 0x01; // 输入模式 上拉使能 PB_CR2 | 0x01; // 使能 PB0 的外部中断功能 EXTI_CR1 | 0x10; // 配置端口触发沿PB 口对应位段设为上升沿EXTI_CR1 寄存器按端口分组每组两位配置触发方式0b01 表示上升沿、0b10 表示下降沿、0b11 表示双沿。PB 口对应的位段是 bit5:4因此0x10就把这一组设为上升沿。这里有一个容易漏掉的步骤只配置 EXTI_CRx 不置位 GPIO 的 CR2中断永远不会触发。例程里如果遇到按下按键没反应优先检查 PB_CR2 的位置是否被注释掉了。5.2 Halt 与 Active-halt 的功耗边界STM8L101 的低功耗模式不是只有 Halt 一种正确的模式选择能让待机电流有数量级差别同时也决定了哪些外设还能继续工作模式进入方式CPU 状态可用外设典型唤醒源Wait执行 WFI停止全部保持任意中断Halt执行 HALT 指令停止全部关闭外部中断、复位Active-halt先配置唤醒定时器再 HALT停止RTC 或 LSI 定时器定时器自动唤醒、外部中断Halt 模式关闭了所有内部时钟和振荡器功耗最低但只能靠外部事件唤醒适合按键触发或外部传感器信号叫醒的场景。Active-halt 保留一个低速时钟运行定时器适合需要周期性起床采样的应用比如每 10 秒采集一次温度再继续睡。例程里的低功耗 Demo 通常演示这两种模式的切换以及各自唤醒后的状态恢复这是 STM8L101 相对其他系列更有价值的部分——官方标准库对低功耗例程的覆盖并不完整。5.3 唤醒标志残留导致立即复睡的问题进入 Halt 前要清除外设的中断挂起标志否则执行 HALT 指令后的第一条指令又是进入低功耗表现为唤醒失败或者唤醒后立刻又睡回去。正确顺序是触发等待外部事件对应的 EXTI 中断标志位会在醒来瞬间置位中断服务函数内先清标志再执行主流程。清标志的寄存器位是 EXTI_SR1/EXTI_SR2 的对应位// 中断服务函数中执行 if (EXTI_SR1 0x10) { EXTI_SR1 | 0x10; // 软件清中断标志先清再执行业务逻辑 // 处理唤醒事件比如读取传感器或翻转 LED }注意 STM8 的中断标志清法是写 1 清除而不是写 0。例程包里的中断处理函数如果被精简过这个细节很可能被简化掉。另外涉及 Flash 编程的例程在低功耗模式下有额外限制Halt 前如果有未完成的编程操作一定要先等待 BSY 标志清零否则恢复运行后 Flash 进入未知状态表现为主程序跑飞或者读出的数据全是 0xFF。6. 例程验证的两个技巧功耗实测与调试脚本加速6.1 用示波器和采样电阻测 Halt 模式真实电流例程注释里写的电流值是芯片数据手册的典型值实际到板子上总会打折扣。最直接的办法是在电源进入 MCU 的路径上串联一个 10Ω 采样电阻示波器探头测电阻两端压降根据 I V / R 换算出电流。测量 Halt 模式电流时示波器要打到 DC 耦合、最大增益档位因为微安级电流在 10Ω 电阻上只产生几十微伏的压降。更好的做法是用带有积分功能的数字万用表测平均电流因为唤醒瞬间的尖峰电流会拉高瞬时读数但平均电流才是电池续航的关键指标。测量时要从例程包拷贝低功耗例程原封不动地烧录先验证测试链路本身没问题再逐步替换成自己的业务逻辑。6.2 利用 cspy.bat 参数跳过重复烧录流程每次改完代码都要打开 IAR 点下载调试重复操作浪费时间。把前面提到的 cspy.bat 稍作扩展可以在命令行里完成编译后直接烧录并复位运行REM 编译工程 make -f Demo.ewp -j8 REM 通过命令行下载并复位运行 SET CWS_BINC:\IAR Systems\Embedded Workbench 8.40\common\bin %CWS_BIN%\cspy.bat -f Demo\Demo.Debug\Demo.board -f Demo\Demo.Debug\Demo.out --go--go让调试器下载完成后直接全速运行相当于点了 IAR 里的 Debug 再按 F5。这样把编译和烧录合并成一条命令配合脚本做循环回归改一次代码执行一遍对排查 GPIO 翻转、定时器中断这类需要快速验证的问题非常顺手。整套例程配合这个调试习惯从复制工程到跑通外设整个过程可以控制在几分钟内这也是这套 STM8L101 库例程最值回票价的地方。本文还有配套的精品资源点击获取