简介面向单片机开发者的C51平台T9输入法实现资源适合在存储和算力有限的嵌入式设备上构建数字键高效文本输入方案。压缩包共21个文件约116KB包含主程序C源码、词库相关头文件、启动汇编、工程配置文件以及编译输出的HEX、LST、OBJ等可完整复现项目的编译与调试流程便于二次移植。实现覆盖键值映射、动态预测、上下文关联、常用词记忆和词库压缩等关键环节通过数字序列匹配单词显著减少按键次数展示了小内存环境下存储与计算的优化思路。对于想研究嵌入式输入法原理、改进键盘交互体验的开发者这份源码可作为参考框架按项目需求定制词库与按键映射有助于理解T9预测算法在嵌入式环境下的落地方式。资源已有436人学习适合中初级单片机开发者参考学习。1. 在C51单片机上做T9输入法按键少、内存省的嵌入式中文输入方案做工业仪表、门禁终端、对讲机这类设备的朋友应该都有同感界面要支持中文输入但整机既拖不动Linux也没地方放全键盘最后只能靠一块C51单片机加4x4矩阵键盘硬扛。T9输入法在这种场景下几乎是标准答案——9个数字键映射26个字母拼音被折成数字序列查表出候选字按键少、逻辑直接、内存占用可控8位机完全跑得动。这篇笔记把一个可编译可运行的C51 T9输入法工程完整拆开讲按键矩阵怎么扫、输入状态机怎么写、拼音表怎么组织、字模和LCD怎么配合以及我调通过程中踩过的几个坑。适合正在给单片机项目加中文输入、又不想上昂贵触摸方案的开发者。2. T9在C51上的原理与存储选型数字序列替换拼音而不是逐字母输入2.1 T9输入法的本质9个数字键怎么承载26个字母先看T9最核心的映射关系数字键2到9分别对应一组字母按键字母按键字母2ABC6MNO3DEF7PQRS4GHI8TUV5JKL9WXYZ老式手机里那种“按2一次是a按两次是b”的输入方式叫Multi-tap和真正的T9是两回事。T9的思路是每个键只代表一组字母用户把拼音的每个字母对应数字键按一遍系统根据整串数字去字典里猜可能是什么拼音。举例想输入“高”拼音gao对应数字就是4、2、6想输入“好”拼音hao同样也是4、2、6。用户按完426三个键系统无法确定用户想要的是gao还是hao就把两个拼音下的候选字都翻出来高、搞、告、好、浩……用户再用数字键选第几个即可。这就是T9“少按键”的本质它不是把26个字母逐个给用户选而是把字母组映射成数字再用整串数字去匹配拼音集合。一个数字序列对应多个拼音一个拼音又对应多个汉字所以候选字的组织天然是两层结构先按数字序列找拼音再按拼音找汉字。在C51上实现时要注意一个关键差异PC端输入法可以把几十万词条塞进内存8位机上连几千个汉字都要精打细算。所以工程里不会存“数字序列→汉字”这种粗暴映射而是把拼音项和汉字索引分开让同一拼音下的所有同音字共用一个拼音条目。2.2 8位机的存储布局拼音索引、汉字索引、字模三分开C51的资源约束是硬性的标准AT89C52只有8KB程序Flash、256B内部RAMSTC89C52RC稍好但也没质变。一个16x16点阵的汉字字模是32字节3755个GB2312一级汉字光字模就要120KB片内根本放不下。所以这个资源包的做法是把数据拆成三块分别规划存放位置数据内容典型容量存放位置拼音索引表每个合法拼音的T9编码、汉字索引区间约400条4~5KB片内code区汉字索引表每个汉字在字库中的序号3755条约7.5KB片内code区字模库16x16点阵数据3755字约120KB外部SPI Flash或精简子集资源包默认的做法是拼音索引表只收录常用拼音约400个汉字索引表按GB2312顺序排列字模库默认只内置几百个高频汉字用于验证完整字库通过SPI外挂Flash读取。如果你手里的MCU是STC15系列8KB Flash版本可以试着把汉字索引裁剪到2000字左右如果换成STC8系列16KB以上常备字库能塞进去更多。这里有一个选型经验拼音项和汉字索引必须分开。如果按“每个拼音绑一串汉字”存看起来直观但实际上每个汉字都要重复存拼音编码3755个字光编码就多出十几KB。分开之后400个拼音表项共享3755个汉字索引存储量直接降一个数量级查表逻辑也只是多一次跳转而已。字模的问题我一般这样处理验证阶段把几百个高频字的字模直接丢code区编译能过就行量产阶段再上外部Flash。不要一上来就追求全字库先把输入逻辑跑通字模存储是后面的事。3. 键盘矩阵扫描与T9输入状态机从物理按键到数字序列3.1 4x4矩阵扫描为什么读引脚前必须先把端口写1这个工程用的是最常见的4x4矩阵键盘P1口低4位接行线高4位接列线。扫描原理是逐行拉低读列线电平判断哪个按键被按下// key_scan.c #include reg52.h #include intrins.h #define KEY_NONE 0xFF // 返回0~15键值无按键返回KEY_NONE unsigned char matrix_scan(void) { unsigned char row, col, key; for (row 0; row 4; row) { P1 0x0F; // 先让低4位行线全部输出1 P1 ~(0x01 row); // 再把当前行拉低其余行保持高 _nop_(); _nop_(); // 等两拍让电平稳定 col (P1 4) 0x0F; // 读高4位列线 if (col ! 0x0F) { // 有列被拉低说明本行有键按下 for (col 0; col 4; col) { if (((P1 4) (0x01 col)) 0) { key row * 4 col; return key; // 0~15的键值 } } } } return KEY_NONE; }这段代码里最容易翻车的是开头的P1 0x0F。C51的P1口是准双向口读引脚电平之前必须先把对应的输出锁存器写成1内部上拉才会起作用。如果省略这一步读回来的往往是上次输出锁存器的值而不是引脚真实电平表现出来的症状就是按键识别错位、随机跳键。_nop_()是空指令用来等行线电平在RC延迟后稳定。行列转换的键值公式row * 4 col是把物理位置映射成0~15的逻辑编号后面T9状态机用的是这个逻辑编号不是物理坐标方便换键盘布局时只改映射表。但是裸扫描不能直接用按键抖动会让一次按下被识别成多次。常规做法是加一个10ms节拍采样连续两拍读到相同键值才算有效// 消抖状态 unsigned char last_key KEY_NONE; unsigned char key_tick 0; unsigned char key_read(void) { unsigned char k matrix_scan(); if (k ! last_key) { last_key k; // 键值变了重新计时 key_tick 0; return KEY_NONE; // 新状态必须稳定两拍后才上报 } if (k ! KEY_NONE key_tick 2) { key_tick; // 同一键值持续两拍去抖完成 } return (key_tick 2) ? k : KEY_NONE; }key_tick的计数值由调用方的轮询周期决定每10ms调一次两拍就是20ms。这个值不是越大越好太大按键响应迟钝太小滤不掉抖动。按键质量差、触点氧化严重的板子适当加大到3拍普通薄膜键盘2拍足够。注意这里的返回值只在弹起判定后上报一次不会重复触发避免T9状态机把一次按压当成多次数字输入。3.2 T9输入状态机按键序列管理、删除与翻页矩阵键盘扫出来的是0~15的编号接下来要把它翻译成T9的语义。工程里分配数字键2~9作为拼音输入键1作为翻页键*作为删除键#作为确认键0预留做标点或空格。以STC89C52为例键值映射可以做成一张小表// keymap unsigned char key_to_t9(unsigned char key) { // 键盘布局0~9、*、#、A/B/C/D 共16键 // 这里只映射数字和功能键功能键返回专用值 if (key 2 key 9) return key; // 拼音数字键 if (key 0) return KEY_0; if (key 10) return KEY_STAR; // 删除 if (key 11) return KEY_HASH; // 确认 if (key 12) return KEY_PAGE; // 翻页 return KEY_NONE; }T9输入的核心是维护一个数字序列缓冲。用户每按一个数字键就追加进序列每追加一次就重新查表刷新候选。用数组存序列长度限制在6位因为拼音最长的是6个字母如zhuang948264超过上限直接拒绝接收#define MAX_SEQ 6 unsigned char t9_seq[MAX_SEQ]; // 数字序列如 {4,2,6} unsigned char t9_len; unsigned char t9_page; // 当前候选页码 unsigned long t9_code; // 序列合成后的编码见4.1 void t9_add_key(unsigned char key) { if (t9_len MAX_SEQ) { return; // 序列满忽略后续数字键 } t9_seq[t9_len] key; t9_update(); } void t9_update(void) { unsigned char i; unsigned long code 0; for (i 0; i t9_len; i) { code code * 10 t9_seq[i]; // 合成整数编码 } t9_code code; t9_page 0; candidate_search(t9_code); // 查拼音表见第4章 } void t9_backspace(void) { if (t9_len 0) { t9_len--; t9_update(); } }注意t9_code必须用unsigned long。C51的int是16位最大只能表示65535而拼音zhuang的T9编码948264早就溢出了如果图省事用unsigned int输入超过4位的拼音时查表会直接翻车这是这个工程里最容易踩的坑之一后面避坑章节还会展开。t9_update()每次按键变化都重新合成编码并重置页码这样用户在输入过程中随时能看到当前前缀下有哪些候选。删除键调用t9_backspace()退一个数字并刷新手感类似手机输入法。这个状态机没有用中断实现而是放在主循环的10ms节拍里轮询原因很简单C51中断里做查表和LCD刷新会拖垮实时性按键的毫秒级响应完全可以用轮询满足。4. 拼音查表与候选字显示二分查找和LCD上的“一页四字”4.1 拼音表结构排序、T9编码字段、汉字索引区间查表是整个输入法的核心。第2章说过工程用“拼音项汉字索引”的两层结构。拼音表定义如下// pinyin_table.h // 每个拼音项T9编码 该拼音在汉字表中的起始序号和个数 struct pinyin_item { unsigned long code; // T9数字编码如426 unsigned char hanzi_start; // 汉字索引表中的起始序号 unsigned char hanzi_count; // 该拼音下的汉字个数 }; // 汉字索引表每个条目存一个汉字在字库中的序号 // 比如表项值是0x1234表示字模库中第0x1234个字 extern code struct pinyin_item pinyin_tbl[]; extern code unsigned int hanzi_tbl[];表是按code升序排列的这是能用二分查找的前提。工程里把拼音表放在code区因为它是只读常量如果放xdata51的片外RAM访问慢且占用地址空间完全没必要。为什么用unsigned long存code而不是拆成几个unsigned char因为二分查找时直接比较整数比逐位比较快得多代价是每个拼音项4字节。约400个拼音项总共1600字节这个开销值得花。hanzi_start和hanzi_count用unsigned char是因为一个拼音下的同音字最多也就几十个8位足够但如果字库超过256个汉字hanzi_start就需要改成unsigned int。资源包里的精简字库默认254字以内所以这里用的unsigned char移植到全字库时记得换成unsigned int否则汉字索引区间会截断。实际表内容大致是这种形式// pinyin_table.c code struct pinyin_item pinyin_tbl[] { {426, 0, 18}, // 426对应gao/hao共18个同音字 {5426, 18, 12}, // 5426对应jiao/qiao/xiao12个候选 // ... 按code升序排列 };第一个表项{426, 0, 18}的含义是T9编码426的拼音gao和hao在汉字索引表里从序号0开始连续18个位置存着它们的汉字序号。用户按426时这18个字会分页显示。4.2 二分查找与同码连续段先找左边界再往后数有了排序表查找就简单了。但要注意一个边界问题同一个code可能对应多个拼音项426既对应gao也对应hao所以要找到的是“第一个code匹配的项”然后向后遍历所有相同code的项// candidate.c #define PINYIN_MAX 40 // 候选拼音项最大数 unsigned char cand_count; // 当前候选汉字总数 unsigned int cand_hanzi[PINYIN_MAX]; // 当前候选汉字序号 void candidate_search(unsigned long code) { unsigned char l 0, r PINYIN_COUNT - 1, mid; unsigned char k, p; unsigned char start; // 二分查找找到第一个code匹配的拼音项 while (l r) { mid (l r) 1; if (pinyin_tbl[mid].code code) { l mid 1; } else { r mid; } } // 检查找到的位置是不是真的匹配 cand_count 0; for (p l; p PINYIN_COUNT; p) { if (pinyin_tbl[p].code ! code) break; // 相同code已遍历完 start pinyin_tbl[p].hanzi_start; for (k 0; k pinyin_tbl[p].hanzi_count; k) { if (cand_count PINYIN_MAX) return; cand_hanzi[cand_count] hanzi_tbl[start k]; } } }二分查找这里用的是“找左边界”的写法循环条件l r比较时code mid走右边否则走左边最后l落在第一个不小于目标值的位置。找不到时pinyin_tbl[l].code要么大于目标code要么已经越界后面的if判断会拦截掉。候选字全部收集到一个cand_hanzi数组里上限40个。这个数组放data区因为运行时频繁读写。C51的data区总共才128字节40个unsigned int占80字节几乎顶满所以如果你要扩大候选上限建议把部分变量挪到xdata或者缩减到20个候选。实际使用中一个拼音项的同音字很少超过20个40已经留了余量。4.3 候选分页与LCD12864显示一屏四字候选字收集完后要分页显示在LCD12864上。12864一行能显示8个16x16汉字但带序号后一页放4个候选比较稳妥字距清晰手指按数字键选字也不容易看错// display.c #define CAND_PER_PAGE 4 void lcd_show_candidates(unsigned char t9_page) { unsigned char i; unsigned char count; unsigned char offset t9_page * CAND_PER_PAGE; if (cand_count 0) { lcd_puts(0, 0, no match); return; } if (offset cand_count) { t9_page 0; // 页码越界回卷 offset 0; } count cand_count - offset; if (count CAND_PER_PAGE) count CAND_PER_PAGE; lcd_clear_line(0); for (i 0; i count; i) { lcd_put_char(1 i); // 显示候选序号1~4 lcd_put_hanzi(cand_hanzi[offset i]); // 从字模库取字显示 lcd_put_char( ); } lcd_puts(1, 0, pg ); // 第二行显示页码 lcd_put_char(0 t9_page 1); lcd_puts(1, 6, # OK * Del); }lcd_put_hanzi()接收的是汉字在字模库里的序号内部先从字模数组取出32字节点阵数据再按LCD控制器的显存地址写入。取模方式要和驱动匹配资源包统一用纵向取模、字节正序、阴码取模工具里这三个选项对不上显示就会出鬼影——这属于后面避坑章节要说的经典问题。翻页键的逻辑很短每次按翻页键页码加1重新调用lcd_show_candidates()。注意t9_page是在状态机里管理的显示函数只负责画不负责改状态这样LCD刷新慢也不会影响输入状态的一致性。5. 从“能编译”到“能上手”的五个坑现象、原因与解法5.1 读引脚前没写1按键识别乱跳现象矩阵键盘按2识别成6或者按一次出来两个不同键值键位完全对不上。原因C51的P1口是准双向口读引脚电平前如果输出锁存器不是1内部上拉没建立读回来的电平是假的。很多第一次写矩阵键盘的人直接拉低一行就去读结果读到的全是高电平或者不稳定值。解决扫描循环开头先P1 0x0F把低4位行线全部写1再逐行拉低。读列线前加两个_nop_()等电平稳定。这个习惯我从那以后写什么单片机口线都要检查一遍“输入前有没有写1”。5.2 消抖不彻底一次按下冲进来两个数字现象快速连续输入“28”时2被吞掉或者一次按键识别成“22”。原因消抖只做了首次延迟没处理弹起事件。T9状态机用的是边沿触发抖动产生的多次跳变会被当成多次按键。解决用10ms节拍连续采样键值连续两拍相同才上报并且上报后要等按键完全释放才能接受下一键。这个“按下确认释放等待”两段式逻辑缺一不可只做按下确认会漏掉只做释放等待会重复。5.3 T9编码用16位整数存输入超过4位就查不到字现象“zhong”948264、“wang”9264查出来是“no match”但“gao”426正常。中文拼音超过4个字母的几乎全挂。原因C51的int是16位最大65535。用户输入zhong时合成编码948264被截断成某个小数值表里自然找不到。这个坑特别隐蔽因为短拼音都正常只长拼音出错看起来像表的问题。解决合成编码的变量必须用unsigned long拼音表里的code字段同步改unsigned long。如果为了省Flash不用32位也可以把数字序列压缩成3字节BCD但查找比较时要额外写循环代码量上去了不划算。5.4 取模方向和LCD驱动不匹配汉字花屏缺笔画现象LCD12864上汉字左右错位、上下颠倒、笔画缺失像被打乱的马赛克。原因取模工具里“横向取模/纵向取模”和“字节正序/反序”两个参数与LCD控制器的显存排列不一致。字符屏12864还好图形屏的控制器对字节序很敏感参数反了就是乱码。解决资源包统一用“纵向取模、字节正序、阴码”换取模工具时要手动核对这三个选项。验证方法很简单显示一个左右对称的字如“中”再显示“一”和“丨”观察横竖笔画是否完整。每次换LCD型号我都会跑一遍这个自检流程能省出半天调试时间。5.5 字模太大编译报 code array too large现象工程加入完整字模数组后编译直接报错提示程序存储区溢出。原因一级汉字3755个每个16x16字模32字节总计120KB而C51常见型号Flash只有8KB。有人硬塞全字库编译当然过不去。解决资源包默认只内置几百个高频验证字量产版本把完整字模放外部SPI Flash运行时按序号读取。另一个常见做法是先用字频统计把字库裁剪到1500~2000个高频字能覆盖绝大多数日常输入场景Flash够用的话直接放code区。这个裁剪脚本我现在每次做输入法移植都要先跑一遍不跑的后果就是后面生僻字没地方放。6. 进阶玩法联想输入、页码缓存与换个平台时的三条经验拼音候选只能解决单字输入输入“中”之后想打“国”通常做法是加一张词组联想表。资源包里预留了一个可选的联想表结构每个表项存“前字序号后字序号”的配对选中候选后自动把以该字开头的双字词追加到候选末尾。这个表建议按前字序号排序选中一个候选时就近查找避免每次输入都全表扫描。联想表和拼音表一样必须按序排列否则二分查找的前提就没了。页码缓存是另一个值得做的优化。当前候选字超过一页后用户每次翻页都重新调用candidate_search会把整个同码段重新遍历一遍视觉上会闪一下。工程里可以把“当前code对应的候选数组”保留在RAM里翻页只改t9_page光标移动和翻页都用数组下标计算不再触发查表。代价是候选数组多占几十字节RAM但输入手感明显更好中文输入这种高频操作值得花这点内存。移植到STC15、STC8或者STM8平台时有三条经验可以提前避雷。第一键盘扫描和T9状态机是纯逻辑模块除了端口定义外基本不用改移植时优先复用这部分代码第二LCD驱动因控制器差异必须重写但只要字模取模方式保持“纵向取模、字节正序、阴码”不变字模数据就能原样复用第三C51的Keil编译器对局部变量的data区分配很保守换到STM8后用它的编译优化选项速度可以提升不少但堆栈深度要重新评估别在中断里做查表。当初给一套门禁终端做中文输入我把全部字模都塞进code区编译发现差整整2KB放不下最后跑了一晚上字频统计把生僻字全部干掉才勉强挤进去。从那以后我每次给单片机设计输入法都强制自己先定“字库边界”再写查表逻辑字库容量决定索引字段位宽索引位宽决定accept多少候选环环相扣。带着这套代码再做新的平台至少不会在第一轮编译时就翻车希望帮到你。本文还有配套的精品资源点击获取