1. 项目缘起与整体方案拆解按键一按短信就发到手机上OLED 屏同步显示发送状态——这个需求听起来简单但真动手做坑比想象中多。我最近刚把一套STM32 Air780E的方案跑通核心功能就是本地按键触发通过 Air780E 模组发送一条中文短信同时用一块OLED屏把当前状态待机、发送中、成功、失败实时显示出来。整套东西成本不到五十块但涉及的知识点横跨单片机 GPIO 控制、I2C 驱动 OLED、UART 串口通信、AT 指令交互、PDU 编码转换五个层面非常适合拿来练手也适合做毕业设计或者物联网终端类项目的通信子模块。先说清楚这套方案适合谁看。如果你已经会用 Keil 或者 VSCode CMake 建 STM32 工程能点亮一颗 LED那这篇文章你基本能全程跟下来。如果你连 GPIO 都没配过建议先把点灯和串口收发搞定再回来不然中间 PDU 编码那块会让你很痛苦。我下面会把每个环节的“为什么这么做”讲透包括参数怎么算、坑在哪里、怎么排查尽量让你少走弯路。整体架构其实很清晰STM32 作为主控负责按键扫描、OLED 显示刷新、以及通过 UART 向 Air780E 发送 AT 指令。Air780E 是合宙推出的一款 4G Cat.1 模组支持全网通走的是标准 AT 指令集发短信、打电话、上网都行。OLED 我用的是 0.96 寸 I2C 接口的 SSD1306四针那种接线简单HAL 库驱动代码网上一抓一大把。按键就是最普通的轻触开关一端接 GPIO一端接 GND配上内部上拉或者外部上拉电阻。为什么选 Air780E 而不是别的模组几个原因。第一它支持 Cat.1功耗和成本比 Cat.4 低不少发短信这种低速业务完全够用。第二AT 指令集比较规范中文短信走 PDU 模式文档写得还算清楚。第三供电范围宽3.4V 到 4.2V 都能工作直接用锂电池或者稳压到 3.8V 都行。第四封装是 LCC LGA焊接难度中等打样贴片也方便。相比之下某些老款 2G 模组虽然便宜但网络覆盖在部分地区已经不行了Cat.1 是更稳妥的选择。OLED 选 I2C 而不是 SPI主要是省 IO。STM32F103C8T6 这种片子 IO 本来就不富裕I2C 只占两个脚SPI 要占四到五个。而且 0.96 寸屏刷新率要求不高I2C 400kHz 完全够用。这里有个细节市面上有些 0.9 寸 OLED 对 I2C 时序兼容性不好上电后不亮或者花屏后面我会专门讲怎么排查。供电部分要单独提一句。Air780E 在发射瞬间电流能冲到 2A 左右虽然时间很短但如果你用 STM32 板子上的 3.3V LDO 直接给它供电大概率会复位或者死机。我的做法是单独一路 DC-DC 或者锂电直接供模组STM32 和 OLED 走另一路 3.3V两边共地。这个坑我踩过当时模组一注册网络STM32 就重启查了半天才发现是电源跌落。2. 核心细节解析与实操要点2.1 Air780E 的 AT 指令交互逻辑Air780E 上电后默认波特率通常是 115200但有些固件版本是 9600这个要拿文档确认。我建议先用 USB 转 TTL 工具单独把模组连到电脑上用串口助手手动发几条 AT 指令确认模组能正常响应再接到 STM32 上。这一步能帮你排除掉一半的硬件问题。发中文短信的核心难点在PDU 编码。为什么不用 Text 模式因为 Text 模式发中文会乱码而且不同运营商对 Text 模式的支持不一致。PDU 模式是二进制编码把短信中心号码、目标号码、短信内容、编码方式全部打包成一串十六进制字符通过ATCMGS发送。具体流程是先发ATCMGF0设置 PDU 模式。再发ATCSCSGSM设置字符集。然后发ATCMGSlength其中 length 是 PDU 数据长度不包括短信中心号码部分的长度具体算法后面讲。等待模组返回提示符。发送 PDU 字符串最后以CtrlZ0x1A结尾。模组返回CMGS: mr表示发送成功CMS ERROR表示失败。PDU 编码里中文要用UCS2编码也就是把每个汉字转成 Unicode 码点再按大端序排成十六进制。比如“你好”两个字的 Unicode 是 4F60 和 597DUCS2 编码后就是4F60597D。短信内容部分的长度按字节算一个汉字占两个字节。整个 PDU 串的结构是这样的短信中心号码长度 短信中心号码 第一字节 目标号码长度 目标号码 协议标识 数据编码 有效期 用户数据长度 用户数据。其中第一字节通常是11或者01表示短信类型和是否要状态报告。目标号码要做奇偶位交换比如号码13800138000交换后变成3108108300F0末尾补 F 凑成偶数位。我写了一个 Python 小工具来验证 PDU 编码是否正确先把号码和内容输进去生成 PDU 串再手动用串口助手发出去确认手机能收到。这个工具后来被我移植到 STM32 上用 C 语言重写了一遍。下面是一个简化的 C 语言 PDU 编码函数框架// 将单个汉字转换为 UCS2 十六进制字符串 void unicode_to_ucs2(uint16_t unicode, char *out) { sprintf(out, %04X, unicode); } // 目标号码奇偶交换 void swap_phone_number(const char *src, char *dst) { int len strlen(src); int i; for (i 0; i len; i 2) { if (i 1 len) { dst[i] src[i 1]; dst[i 1] src[i]; } else { dst[i] F; dst[i 1] src[i]; } } dst[i] \0; }实际项目中我建议把 PDU 编码做成一个独立模块输入是目标号码和 UTF-8 或者 GBK 编码的中文串输出是完整的 PDU 十六进制字符串。STM32 上资源有限不要用动态内存全部用静态数组长度按最大短信长度算。一条短信最多 70 个汉字UCS2 编码下 140 字节PDU 串最长大概 300 多个字符开个 512 字节的 buffer 足够了。2.2 OLED 显示驱动的关键参数OLED 用 SSD1306 驱动芯片I2C 地址通常是 0x78 或者 0x7A取决于 SA0 引脚接法。我手上这块是 0x78。初始化序列比较长但 HAL 库的 I2C 发送函数封装好之后就是一堆寄存器写入。关键寄存器包括0xAE关闭显示0xD5设置时钟分频0xA8设置多路复用率0xD3设置显示偏移0x40设置起始行0x8D电荷泵设置必须发0x14开启否则屏幕不亮0x20内存寻址模式通常用0x02页模式0xA1段重映射0xC8COM 扫描方向0xDACOM 硬件配置0x81对比度设置0xD9预充电周期0xDBVCOMH 电压0xA4全局显示开启0xA6正常显示非反色0xAF开启显示这一串发完屏幕才会亮。很多人卡在“OLED 不亮”八成是电荷泵没开或者 I2C 地址搞错了。我建议先用 I2C 扫描程序确认设备地址再逐条发初始化指令用逻辑分析仪抓波形看有没有 ACK。显示中文需要取模。我用的是 PCtoLCD2002 这个工具设置成“阴码、逐列式、顺向、C51 格式”生成的字模数组直接放到代码里。16x16 的汉字一个字占 32 字节显示的时候按页写入。OLED 的显存是 128x64 位分成 8 页每页 128 字节。写一个汉字要跨两页因为 16 像素高正好占两页。这个计算要搞清楚不然显示出来是上下颠倒或者错位的。状态显示我设计了四个界面待机显示“Ready”发送中显示“Sending...”成功显示“OK”失败显示“Error”。每次状态切换先清屏再写新内容。清屏就是把显存全部写 0用memset搞定然后一次性通过 I2C 发出去。这里注意 I2C 传输速度400kHz 下刷一屏 1024 字节大概 20 多毫秒肉眼看不出来闪烁。2.3 按键消抖与状态机设计按键用 GPIO 输入模式我配的是上拉输入按键按下时读到低电平。机械按键抖动时间通常在 5ms 到 20ms 之间所以消抖延时取 20ms 比较稳妥。但直接用HAL_Delay会阻塞整个系统OLED 刷新和串口接收都会停。更好的做法是用定时器做一个 1ms 的 tick在 tick 中断里做按键扫描和状态机推进。我的状态机设计是这样的状态说明触发条件动作IDLE待机上电初始化完成OLED 显示 ReadyKEY_PRESSED按键按下检测到低电平并消抖OLED 显示 Sending...SENDING发送中开始发送 AT 指令等待模组响应SUCCESS发送成功收到 CMGSOLED 显示 OK3 秒后回 IDLEERROR发送失败收到 CMS ERROR 或超时OLED 显示 Error3 秒后回 IDLE状态机的好处是逻辑清晰不会因为串口阻塞导致按键无响应。串口接收我用的是中断 环形缓冲区每收到一个字节就存进 buffer主循环里解析。Air780E 的响应有时候会分多次到达所以不能指望一次HAL_UART_Receive就能收全必须用超时机制判断一帧结束。3. 实操过程与核心环节实现3.1 硬件接线与供电方案先把接线说清楚这是最容易出错的地方。STM32F103C8T6 最小系统板一块Air780E 开发板一块0.96 寸 I2C OLED 一块轻触按键一个AMS1117-3.3 稳压模块两个或者一个 DC-DC 加一个 LDO。接线表如下STM32 引脚连接对象说明PA9 (USART1_TX)Air780E RXD交叉连接PA10 (USART1_RX)Air780E TXD交叉连接PB6 (I2C1_SCL)OLED SCL加上拉电阻 4.7kPB7 (I2C1_SDA)OLED SDA加上拉电阻 4.7kPA0按键一端按键另一端接 GND3.3VOLED VCC单独 LDO 供电GND所有模块 GND共地Air780E 的供电单独走一路输入 5V 经过 DC-DC 降到 3.8V输出能力至少 2A。我试过用 AMS1117 直接供结果模组一搜网就重启后来换了一个 3A 的 DC-DC 模块才稳定。OLED 和 STM32 共用另一路 3.3V电流需求小AMS1117 够了。串口电平要注意Air780E 的 UART 是 1.8V 或者 3.3V 电平具体看模组版本。我手上这块是 3.3V直接和 STM32 对接没问题。如果是 1.8V 版本中间要加电平转换不然通信会不稳定甚至烧端口。3.2 STM32 工程配置与串口驱动我用的是 STM32CubeMX 生成初始化代码然后移植到 VSCode CMake 环境。如果你用 Keil流程差不多只是工程文件格式不同。关键配置项系统时钟72MHz外部晶振 8MHz。USART1115200 波特率8 数据位1 停止位无校验开启接收中断。I2C1400kHz7 位地址模式。TIM21ms 中断用于系统 tick 和按键扫描。GPIOPA0 上拉输入PB6/PB7 复用开漏。串口接收中断里我把收到的字节存入环形缓冲区#define RX_BUFFER_SIZE 512 uint8_t rx_buffer[RX_BUFFER_SIZE]; volatile uint16_t rx_head 0; volatile uint16_t rx_tail 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { rx_buffer[rx_head] rx_byte; rx_head (rx_head 1) % RX_BUFFER_SIZE; HAL_UART_Receive_IT(huart1, rx_byte, 1); } }主循环里定期检查缓冲区解析 AT 响应。解析的时候不要用strstr直接找因为缓冲区是环形的字符串可能跨边界。我的做法是先把数据拷贝到一个线性 buffer再做字符串匹配。3.3 PDU 编码的完整实现与验证PDU 编码我单独写了一个模块核心函数是build_pdu()输入目标号码和中文串输出 PDU 十六进制字符串。中文串我统一用 UTF-8 存储编码时先转成 Unicode 码点再转 UCS2。STM32 上没有标准库做 UTF-8 转 Unicode我手写了一个简单的转换函数因为常用汉字都在 BMP 平面三字节 UTF-8 足够覆盖。// UTF-8 三字节转 Unicode uint16_t utf8_to_unicode(const uint8_t *utf8) { return ((utf8[0] 0x0F) 12) | ((utf8[1] 0x3F) 6) | (utf8[2] 0x3F); }短信中心号码我直接写死在代码里用ATCSCA?查一次记下来就行。中国移动的短信中心号码通常是8613800XXX500其中 XXX 是区号。这个号码也要做 PDU 编码格式和目标号码一样。PDU 长度计算有个坑ATCMGS后面的长度参数是 PDU 串去掉短信中心号码部分之后的字节数。比如完整 PDU 串是0891683108200505F011000B813108108300F00008AA0C4F60597D其中08是短信中心号码长度后面 8 个字节是短信中心号码再后面的11开始才是要计算长度的部分。这个长度是十六进制字符串长度除以 2因为每两个字符代表一个字节。我实测下来一条 70 个汉字的短信PDU 串长度大概 300 多个字符ATCMGS后面的长度参数在 150 左右。这个数值不对的话模组会返回CMS ERROR: 500表示参数错误。3.4 OLED 显示刷新与状态同步OLED 驱动我移植的是网上常见的 SSD1306 库但做了一些裁剪只保留 I2C 写入和基本绘图功能。显示中文用取模数组每个状态对应一个数组。状态切换的时候先调用OLED_Clear()再调用OLED_ShowChinese()写入新内容最后OLED_Refresh()一次性刷到屏幕。刷新时机很关键。如果在串口发送过程中刷屏I2C 和 UART 会抢 CPU 时间导致 AT 指令发送延迟。我的做法是在状态机进入新状态时刷一次屏发送过程中不刷新。这样既保证了显示同步又不影响通信时序。实测下来从按键按下到 OLED 显示“Sending...”延迟大概 30ms肉眼感觉不到。从模组返回CMGS到 OLED 显示“OK”延迟大概 50ms因为要等串口数据收全再解析。整体体验很流畅。4. 常见问题与排查技巧实录4.1 模组不响应 AT 指令这是最常见的问题原因通常有三个波特率不对、串口线接反、供电不足。排查步骤用 USB 转 TTL 工具单独连模组发AT看有没有OK返回。如果没有换波特率试9600、115200、57600 都试一遍。检查 TX 和 RX 是不是交叉连接。STM32 的 TX 接模组的 RXSTM32 的 RX 接模组的 TX这个别搞反。测模组供电电压发射瞬间不能低于 3.4V。如果跌落严重换更大电流的电源。我遇到过一种情况模组能响应AT但一发ATCMGS就重启。后来发现是电源走线太细发射瞬间压降太大。换粗线并加 1000uF 电容后解决。4.2 OLED 不亮或者花屏OLED 不亮先查 I2C 地址。用下面这段代码扫描for (uint8_t addr 1; addr 128; addr) { if (HAL_I2C_IsDeviceReady(hi2c1, addr 1, 1, 10) HAL_OK) { printf(Found device at 0x%02X\n, addr); } }如果扫不到任何地址检查 SCL 和 SDA 有没有接反上拉电阻有没有焊。如果扫到 0x78 但屏幕不亮检查初始化序列里电荷泵那条0x8D, 0x14有没有发。花屏通常是显存写入错位检查页地址和列地址的设置。0.9 寸 OLED 对 I2C 时序要求比较苛刻有些批次上电后需要延时 100ms 再发初始化指令。我在初始化函数开头加了HAL_Delay(100)问题解决。4.3 短信发送失败错误码解析模组返回CMS ERROR的时候后面会跟一个错误码。常见错误码和处理方法错误码含义处理方法500参数错误检查 PDU 长度和格式501短信中心号码无效用 ATCSCA? 查询并重设502目标号码无效检查号码格式是否带国家码503模组未注册网络等待 CREG 返回 1 或 5504短信内容过长拆分短信或缩短内容515模组忙延时重试我遇到最多的是 500 和 503。500 基本都是 PDU 编码问题用在线 PDU 编码工具对比一下就能找到差异。503 是网络没注册好上电后要等ATCREG?返回CREG: 0,1或者CREG: 0,5才能发短信。4.4 按键误触发与响应迟钝按键误触发通常是消抖没做好。我一开始用 10ms 消抖偶尔还是会连发。后来改成 20ms并且在状态机里加了“发送中忽略按键”的逻辑问题解决。响应迟钝一般是主循环里有阻塞操作比如HAL_Delay或者长时间的 I2C 传输。把延时改成非阻塞的 tick 计数响应速度明显提升。还有一个细节按键按下后如果手指没松开状态机会一直停在 KEY_PRESSED。我的做法是检测到按下后等按键释放再进入 SENDING 状态这样避免重复触发。4.5 串口数据收不全或乱码串口收不全先查波特率误差。STM32 的 USART 波特率寄存器计算有误差72MHz 下 115200 的误差大概 0.16%可以接受。如果误差太大换晶振或者用更高的系统时钟。乱码通常是电平不匹配用示波器看波形高电平是不是 3.3V。如果模组是 1.8V 电平必须加转换电路。环形缓冲区大小也要注意。Air780E 返回CMGS的时候前面可能还有一堆CREG、CGREG的主动上报如果缓冲区太小会覆盖掉关键数据。我开到 512 字节实测够用。5. 项目扩展与个人经验补充这套东西跑通之后扩展空间很大。比如把按键换成定时器触发做成定时上报或者加一个 DHT11 温湿度传感器把数据通过短信发出去再或者接一个继电器用短信远程控制开关。OLED 显示也可以做得更丰富加个图标、进度条什么的。我个人在实际操作中的体会是PDU 编码这块一定要先用工具验证不要凭感觉写。我一开始自己算长度发出去总是报 500后来用在线工具生成 PDU 串对比发现是短信中心号码的长度算错了。还有电源千万别省模组发射瞬间的电流冲击比你想象的大电源不稳后面全是玄学问题。另外Air780E 的固件版本不同AT 指令行为可能有差异。我建议拿到模组第一件事就是发ATCGMR查固件版本然后去官网下对应的 AT 指令手册。不要拿旧版本文档套新固件有些指令参数变了查半天查不出来。最后分享一个小技巧调试阶段可以在 OLED 上显示串口收到的原始数据这样不用接电脑就能看到模组返回了什么。我加了一个调试模式按键长按进入屏幕上滚动显示最近收到的 64 个字符排查问题非常方便。这个功能后来成了我所有串口项目的标配。