Arduino轻量级ITA-2编码库：RTTY通信的Baudot码状态机实现

1. 项目概述BaudotCode 是一款专为 Arduino 平台设计的轻量级 ITA-2International Telegraph Alphabet No. 2编码/解码库核心目标是支撑无线电传RTTY, Radio Teletype通信协议在嵌入式系统中的低成本、低资源实现。该库并非通用字符编码工具而是严格遵循 1930 年代由 Émile Baudot 提出、后经 CCIR现 ITU-R标准化的 5 位二进制编码体系——即 ITA-2其本质是一种状态机驱动的双字符集切换编码方案而非现代 Unicode 或 ASCII 的单字符集映射。在 RTTY 实际应用中发送端需将 ASCII 字符流转换为符合 ITA-2 规范的 5 位符号序列并通过 FSK频移键控调制后经射频链路发射接收端则需完成逆向过程从串行比特流中恢复 5 位符号依据当前模式Letters / Figures查表还原为可读字符并正确处理模式切换控制符。BaudotCode 库正是为此类端到端信号处理流程提供底层符号级抽象屏蔽了 ITA-2 编码表的硬编码复杂性与模式状态管理逻辑使开发者能聚焦于物理层UART/FSK 调制器和应用层消息协议的设计。该库已在 Arduino UnoATmega328P、NanoATmega328P及 Mega 2560 Rev3ATmega2560上完成硬件验证内存占用极低编译后静态代码体积约 1.2–1.8 KB运行时 RAM 消耗不足 50 字节不含用户缓冲区完全适配资源受限的 8 位 MCU 场景。1.1 ITA-2 编码原理与工程约束ITA-2 的根本特性在于其双态字符集架构仅用 5 位32 种组合无法覆盖全部字母、数字、标点及控制符故采用两个独立的 32 元素查找表——Letters 表含 A–Z、空格、CR、LF、BEL 等与 Figures 表含 0–9、$、/、-、?、:、;、(、)、、、、、.、,、# 等。两表通过专用控制码动态切换BAUDOT_LETTERS0b11111切换至 Letters 模式BAUDOT_FIGURES0b11011切换至 Figures 模式此设计带来关键工程约束任意字符的编码结果依赖于当前模式状态。例如字符A在 Letters 模式下编码为0b00011而在 Figures 模式下该码字对应-同理3仅在 Figures 模式下有效其编码为0b10011若在 Letters 模式下发送该码字接收端将解析为无意义符号或触发错误。因此RTTY 协议栈必须维护一个全局模式寄存器并在字符类型变更时主动插入控制码。BaudotCode 库通过getMode()/setMode()/ModeChanged()三函数构成的状态机接口将这一底层状态管理逻辑封装为可预测的 API避免开发者手动跟踪模式跳变导致的解码错乱——这是区别于简单查表库的核心价值。2. 核心 API 详解与工程化使用库以CBaudot.h头文件声明主类BAUDOT提供全部功能。以下按实际开发流程梳理关键 API结合硬件交互上下文说明参数含义与典型误用场景。2.1 类实例化与初始化#include CBaudot.h BAUDOT Baudot; // 全局实例构造函数自动初始化为 Letters 模式工程要点BAUDOT类无显式构造参数其内部状态变量如currentMode在实例化时被初始化为true即 Letters 模式。此设计符合 RTTY 通信惯例——消息起始默认处于 Letters 模式无需首帧发送BAUDOT_LETTERS控制码。2.2 模式状态管理 API函数签名返回值参数说明工程用途与注意事项bool getMode()true Letters,false Figures无只读访问当前解码模式。在接收端解析循环中应首先调用以确定后续Decode()使用的查表索引。注意此函数不改变状态。void setMode(bool mode)voidmode:true强制设为 Lettersfalse强制设为 Figures强制同步模式状态。典型场景接收端检测到BAUDOT_LETTERS/BAUDOT_FIGURES后需立即调用setMode(true/false)更新内部状态确保后续字符解析正确。严禁在未确认控制码有效性时调用。bool ModeChanged()true 模式刚切换,false 未变无模式切换事件检测器。返回true仅当本次调用与上次调用之间发生过模式变更即setMode()被执行且新旧值不同。发送端关键函数在准备发送新字符前先调用ModeChanged()若返回true则必须在字符前插入对应的BAUDOT_LETTERS或BAUDOT_FIGURES控制码再发送字符本身。典型发送逻辑伪代码void sendRTTYChar(char c) { bool isLetter Baudot.isLetter(c); if (isLetter ! Baudot.getMode()) { // 目标字符类型与当前模式不匹配 Baudot.setMode(isLetter); // 同步本地状态 if (Baudot.ModeChanged()) { // 确认状态已切换 uint8_t ctrlCode isLetter ? BAUDOT_LETTERS : BAUDOT_FIGURES; send5BitSymbol(ctrlCode); // 物理层发送控制码 } } uint8_t encoded Baudot.Encode(c); // 获取字符编码 send5BitSymbol(encoded); // 物理层发送字符码 }2.3 字符类型判定与编解码 API函数签名返回值参数说明工程用途与注意事项bool isLetter(char c)true 属于 Letters 表,false 属于 Figures 表c: 待判定 ASCII 字符字符分类预判。输入A~Z、 、\r、\n、\a返回true输入0~9、$、/、-、?等返回false。注意对非法字符如返回false但Encode()对其返回0无效码需应用层过滤。int Encode(char c)5 位编码值0–31或-1错误c: 待编码 ASCII 字符正向编码。根据c的类型通过isLetter()判定及当前getMode()状态返回对应 ITA-2 码字。关键限制若c不在当前模式的有效字符集中返回-1。例如在 Figures 模式下调用Encode(A)将返回-1因A仅存在于 Letters 表。char Decode(int code)解码字符或控制码code: 5 位整数0–31智能解码推荐。自动识别BAUDOT_LETTERS/BAUDOT_FIGURES控制码并触发setMode()同时更新内部状态。返回code对应的字符如0b00011→A或控制码本身如0b11111→0b11111。接收端首选接口简化状态管理。char Decode(int code, bool mode)解码字符code: 5 位整数,mode:trueLetters 查表,falseFigures 查表强制模式解码调试用。绕过内部状态机直接按指定模式查表。仅用于测试或已知模式确定的场景如解析固定格式的信令帧生产环境应优先使用单参数Decode()。编码表关键映射摘录Letters 模式Code (bin)Figures 模式Code (bin)A00011-00011B11001?110013—1001110011CR01000CR01000LF00010LF00010SP00100SP00100LETTERS11111FIGURES110112.4 控制符号常量定义库通过#define提供标准控制码宏确保代码可读性与跨平台兼容性#define BAUDOT_LETTERS 0b11111 // 切换至 Letters 模式 #define BAUDOT_FIGURES 0b11011 // 切换至 Figures 模式 #define BAUDOT_CR 0b01000 // 回车 (Carriage Return) #define BAUDOT_LF 0b00010 // 换行 (Line Feed) #define BAUDOT_SP 0b00100 // 空格 (Space)硬件交互提示RTTY 物理层通常要求控制码与数据码以相同波特率如 45.45 Bd发送且需满足“空号”Mark与“传号”Space电平定义。Arduino 通过 UART 或 GPIO 模拟 FSK 时需确保send5BitSymbol()函数严格遵循 ITA-2 的起始位-5数据位-停止位时序并正确映射 Mark/Space 到频率偏移如 2125 Hz / 2295 Hz。3. 硬件集成与典型应用示例3.1 RTTY 发送端完整实现基于 HardwareSerial以下示例展示如何将 BaudotCode 与 Arduino UART 集成构建一个完整的 RTTY 文本发送器。假设使用Serial1Mega或SoftwareSerialUno/Nano连接 FSK 调制器#include CBaudot.h #include HardwareSerial.h BAUDOT Baudot; HardwareSerial* rttyPort Serial1; // 或 SoftwareSerial 实例 // RTTY 物理层发送函数发送 5 位码字含起始/停止位 void send5BitSymbol(uint8_t code) { // ITA-2 标准时序1 起始位Space, 0 5 数据位LSB first 1.5 停止位Mark, 1 // 此处简化为 1 起始 5 数据 1 停止实际需按 FSK 调制器要求调整 rttyPort-write(0x00); // 起始位 (Space) for (int i 0; i 5; i) { uint8_t bit (code i) 0x01; // LSB first rttyPort-write(bit ? 0xFF : 0x00); // Mark/Space 电平 } rttyPort-write(0xFF); // 停止位 (Mark) } void setup() { Serial.begin(9600); rttyPort-begin(45); // RTTY 波特率 45.45 Bd → 设为 45 近似 Serial.println(RTTY Transmitter Ready); } void loop() { if (Serial.available()) { String msg Serial.readStringUntil(\n); msg.trim(); if (!msg.length()) return; Serial.print(Sending: ); Serial.println(msg); // 发送前重置为 Letters 模式RTTY 惯例 Baudot.setMode(true); Baudot.ModeChanged(); // 清除历史状态 for (int i 0; i msg.length(); i) { char c msg[i]; if (Baudot.isLetter(c)) { // 字母/控制符直接编码 int enc Baudot.Encode(c); if (enc 0) send5BitSymbol(enc); } else { // 数字/符号需确保 Figures 模式 if (!Baudot.getMode()) { Baudot.setMode(false); if (Baudot.ModeChanged()) send5BitSymbol(BAUDOT_FIGURES); } int enc Baudot.Encode(c); if (enc 0) send5BitSymbol(enc); } } // 发送结束可选发送 CRLF send5BitSymbol(BAUDOT_CR); send5BitSymbol(BAUDOT_LF); delay(1000); } }3.2 RTTY 接收端状态机实现中断驱动接收端需从 UART 流中提取 5 位符号此处以HardwareSerial的available()轮询为例实际项目建议用外部中断捕获 FSK 解调后的 TTL 电平跳变#include CBaudot.h #include HardwareSerial.h BAUDOT Baudot; HardwareSerial* rttyPort Serial1; volatile uint8_t rxBuffer[64]; volatile uint8_t rxIndex 0; // 模拟 FSK 解调假设 rttyPort 已配置为 45 Bd接收 5 位符号无校验 void readRTTYSymbol() { if (rttyPort-available() 5) { // 等待 5 位数据 uint8_t symbol 0; for (int i 0; i 5; i) { uint8_t bit rttyPort-read() ? 1 : 0; // 读取一位需根据实际电平定义修正 symbol | (bit i); // LSB first } // 解码并处理 char decoded Baudot.Decode(symbol); if (decoded BAUDOT_LETTERS || decoded BAUDOT_FIGURES) { // 控制码状态已由 Decode() 自动更新 Serial.print([MODE] ); Serial.println(Baudot.getMode() ? LETTERS : FIGURES); } else if (decoded \r) { Serial.println(); } else if (decoded \n) { // 忽略或处理 } else { Serial.print(decoded); } } } void setup() { Serial.begin(9600); rttyPort-begin(45); Serial.println(RTTY Receiver Ready); } void loop() { readRTTYSymbol(); delay(10); // 防抖 }4. 源码结构与关键实现逻辑解析BaudotCode 库源码精简 200 行核心逻辑集中于CBaudot.cpp。其设计体现嵌入式开发的典型权衡以空间换时间用静态查表规避运行时计算。4.1 编码表数据结构库定义两个const uint8_t数组分别存储 Letters 和 Figures 模式的字符到码字映射正向表及码字到字符映射反向表// Letters 模式ASCII 字符 → ITA-2 码字正向表 static const uint8_t lettersToCode[128] { [0] 0, [1] 0, /* ... */ [A] 0b00011, [B] 0b11001, /* ... */ [\r] 0b01000, [\n] 0b00010 }; // Figures 模式ASCII 字符 → ITA-2 码字正向表 static const uint8_t figuresToCode[128] { [0] 0b10011, [1] 0b10000, /* ... */ [?] 0b11001, [-] 0b00011, /* ... */ }; // 双模式ITA-2 码字 → ASCII 字符反向表Letters 模式 static const char codeToLetters[32] { [0b00000] \0, [0b00001] \0, /* ... */ [0b00011] A, [0b11001] B, /* ... */ [0b01000] \r }; // 双模式ITA-2 码字 → ASCII 字符反向表Figures 模式 static const char codeToFigures[32] { [0b00000] \0, /* ... */ [0b00011] -, [0b11001] ?, /* ... */ };内存优化技巧数组索引直接使用 ASCII 值0–127虽有空间浪费非打印字符占位但换取 O(1) 查表速度且总静态内存增加不足 256 字节。4.2Encode()函数执行流程int BAUDOT::Encode(char c) { if (c 0 || c 128) return -1; // ASCII 范围检查 uint8_t code; if (isLetter(c)) { code lettersToCode[(uint8_t)c]; // Letters 表查表 } else { code figuresToCode[(uint8_t)c]; // Figures 表查表 } return (code 32) ? code : -1; // 有效码字为 0–31 }4.3Decode()函数状态机逻辑单参数Decode(int code)是状态管理核心char BAUDOT::Decode(int code) { if (code 0 || code 31) return \0; // 无效码字 // 检测控制码并更新模式 if (code BAUDOT_LETTERS) { setMode(true); return (char)code; // 返回控制码本身 } else if (code BAUDOT_FIGURES) { setMode(false); return (char)code; } // 根据当前模式查反向表 if (currentMode) { return codeToLetters[code]; } else { return codeToFigures[code]; } }setMode()内部维护lastMode变量ModeChanged()通过比对currentMode与lastMode并更新lastMode实现事件检测确保每次切换仅触发一次。5. 调试技巧与常见问题排查5.1 典型故障现象与根因现象可能根因解决方案接收端输出乱码如A显示为-发送端未在数字前插入BAUDOT_FIGURES或接收端Decode()未正确识别控制码检查发送逻辑中ModeChanged()调用位置用逻辑分析仪抓取 UART 波形确认控制码是否发出接收端卡死在某字符Decode()输入超出 0–31 范围的码字如噪声干扰在Decode()前增加范围校验或在物理层添加奇偶校验/曼彻斯特编码Encode()对合法字符返回-1字符不在预定义表中如小写字母aRTTY 严格区分大小写所有输入需转为大写toupper()后再编码模式切换延迟如连续数字后跟字母仍显示为符号ModeChanged()调用时机错误未在每次字符发送前检查严格遵循“发送前检查→必要时发控制码→发字符”三步流程5.2 硬件级验证方法逻辑分析仪抓包配置分析仪为 45 Bd UART 协议解码观察发送波形中BAUDOT_FIGURES0b11011是否出现在数字序列前BAUDOT_LETTERS0b11111是否出现在字母序列前。LED 指示模式在setMode()中添加 LED 闪烁如 Letters 模式亮绿灯Figures 模式亮红灯直观验证状态切换。查表一致性测试编写测试用例遍历isLetter()返回true的所有字符验证Encode()结果与 ITA-2 标准表一致。6. 扩展应用场景与进阶集成6.1 与 FreeRTOS 任务协同在资源更丰富的平台如 ESP32可将 RTTY 收发封装为独立任务利用队列解耦#include freertos/FreeRTOS.h #include freertos/queue.h #include CBaudot.h BAUDOT Baudot; QueueHandle_t rttyTxQueue; void rttyTransmitTask(void* pvParameters) { uint8_t symbol; while (1) { if (xQueueReceive(rttyTxQueue, symbol, portMAX_DELAY) pdPASS) { send5BitSymbol(symbol); // 物理层发送 } } } void sendRTTYString(const char* str) { Baudot.setMode(true); Baudot.ModeChanged(); for (int i 0; str[i]; i) { char c toupper(str[i]); if (Baudot.isLetter(c)) { if (!Baudot.getMode()) { Baudot.setMode(true); if (Baudot.ModeChanged()) xQueueSend(rttyTxQueue, BAUDOT_LETTERS, 0); } uint8_t enc Baudot.Encode(c); if (enc ! -1) xQueueSend(rttyTxQueue, enc, 0); } else { if (Baudot.getMode()) { Baudot.setMode(false); if (Baudot.ModeChanged()) xQueueSend(rttyTxQueue, BAUDOT_FIGURES, 0); } uint8_t enc Baudot.Encode(c); if (enc ! -1) xQueueSend(rttyTxQueue, enc, 0); } } }6.2 与传感器数据融合将温湿度传感器读数格式化为 RTTY 报文#include DHT.h DHT dht(DHTPIN, DHTTYPE); void sendSensorReport() { float h dht.readHumidity(); float t dht.readTemperature(); char buffer[32]; snprintf(buffer, sizeof(buffer), TEMP:%.1fC HUM:%.1f%%, t, h); sendRTTYString(buffer); // 复用前述发送函数 }此类应用凸显 BaudotCode 的核心价值将底层编码细节封装为sendRTTYString()这一语义清晰的接口使应用逻辑与通信协议栈彻底解耦。BaudotCode 库的简洁性恰是其在业余无线电与教学场景中不可替代的优势——它不试图替代完整的 RTTY 协议栈而是精准解决 ITA-2 编解码这一特定痛点让工程师能用不到 20 行核心代码便在 ATmega328P 上实现符合 CCIR-476 标准的可靠文本传输。