1. 项目概述用ESP8266打造你的专属语音键盘你有没有想过对着手机说句话电脑上就能自动打出文字这听起来像是科幻电影里的场景但其实用我们手边常见的几块开发板就能轻松实现。今天要分享的就是一个我亲手搭建的“WiFi语音转文本键盘”项目。它的核心思路非常巧妙用手机App识别你的语音并转换成文字然后通过WiFi发送给一个微型无线模块ESP8266最后再由一块Teensy LC开发板模拟成USB键盘将这些文字“敲”进你的电脑。整个过程完全离线吗不语音识别部分依赖手机端的在线服务如Google Speech-to-Text API但硬件间的通信是独立的局域网。这恰恰是它的优势所在——你不需要给电脑安装任何驱动或软件只要电脑有USB口这个“语音键盘”就能即插即用。它非常适合需要快速录入大量文字的场景比如写稿、记录会议纪要或者为一些不方便使用传统键盘的场合提供无障碍输入支持。实现这个项目的关键硬件是ESP8266和Teensy LC。ESP8266大家应该不陌生这颗性价比超高的WiFi芯片在这里扮演着无线热点的角色负责接收手机发来的文本。而Teensy LC则是一个强大的微控制器以其出色的USB HID人机接口设备如键盘、鼠标模拟能力著称负责将收到的文本转化为键盘按键信号。整个项目的代码量不大但涉及了无线通信、串口数据转发和HID设备模拟等多个嵌入式开发的经典环节是一个绝佳的练手项目。2. 核心硬件选型与设计思路解析2.1 为什么是ESP8266 Teensy LC的组合在构思这个项目时硬件选型是第一步也是最关键的一步。我们需要一个能创建WiFi热点的模块和一个能模拟USB键盘的微控制器。市面上方案很多为什么最终锁定ESP8266和Teensy LC呢首先看无线部分。ESP8266几乎是物联网项目的“标配”原因无他成本极低、资料丰富、社区活跃。它内置了完整的TCP/IP协议栈可以非常方便地设置为接入点AP模式让手机直接连接省去了连接路由器的麻烦使得整个设备可以独立工作。虽然ESP32功能更强大但在这个只需要简单WiFi热点的场景下ESP8266完全够用且更省电、更便宜。然后是键盘模拟部分。这是整个项目的“执行终端”。常见的Arduino Uno/Leonardo虽然也能通过Keyboard库模拟键盘但其USB HID功能相对基础且在同时处理串口通信和USB模拟时可能会遇到一些兼容性问题。Teensy LC则不同它基于ARM Cortex-M0内核原生支持强大的USB HID功能稳定性极高。PJRCTeensy制造商提供的USB API非常完善可以轻松模拟键盘、鼠标、游戏手柄等多种设备。更重要的是Teensy LC有多个硬件串口Serial我们可以用一个专有的串口如Serial2与ESP8266通信完全不影响其作为USB设备与电脑的交互架构清晰又稳定。这个组合的分工非常明确ESP8266专攻网络Teensy LC专攻人机交互。两者通过串口UART这个简单、可靠、低速的协议进行通信完美解耦。这种“各司其职”的设计不仅降低了单个芯片的负担和编程复杂度也使得后期调试和维护变得非常容易——网络出问题就查ESP8266打字出问题就查Teensy。2.2 系统架构与数据流剖析理解了硬件选型我们再来看看整个系统是如何协同工作的。数据流是项目的生命线清晰的数据流意味着稳定的系统。整个系统的数据流向是一个清晰的单向链条语音 - 手机App - WiFi - ESP8266 - 串口 - Teensy LC - USB - 电脑。语音采集与识别端手机用户点击手机App的录音按钮App调用手机系统集成的语音识别服务通常是Google或厂商的语音识别API。这个服务将麦克风采集的音频流上传至云端识别成文本后返回给App。这里有一个关键点语音识别的准确性和速度取决于网络质量和云端服务这部分是我们项目不可控的但也是技术最成熟、效果最好的部分我们直接“拿来主义”。无线传输中继站ESP8266ESP8266被编程为一个简单的TCP服务器。它创建了一个名为“ESP-8266”的WiFi热点并在端口8080上监听。手机App作为TCP客户端连接上这个热点后再连接到192.168.4.1:8080这个服务器地址。一旦连接建立App就把识别好的文本字符串通过TCP Socket发送过来。ESP8266的程序逻辑极其简单从网络端口读取数据然后原封不动地写入它的硬件串口Serial。它不关心数据内容只负责转发。键盘指令执行器Teensy LCTeensy LC通过其第二个硬件串口Serial2监听ESP8266发来的数据。只要串口缓冲区有数据它就立刻读取一个字节然后调用Keyboard.write()函数将这个字节作为一次按键动作发送给电脑。电脑操作系统会将其识别为一个标准USB键盘的输入。这里的精妙之处在于Keyboard.write()函数会自动处理大小写、标点符号等我们发送原始的ASCII字符即可无需关心复杂的按键码Keycode组合。这种架构的优势在于低耦合和高容错。每个环节独立你可以单独升级或替换某一部分。例如未来想把语音识别换成离线的只需要修改手机App想增加蓝牙连接可以换掉ESP8266模块而Teensy LC端的代码几乎不用动。3. 硬件连接与电路搭建详解纸上谈兵终觉浅接下来我们进入实战环节把硬件实实在在地连起来。正确的电路连接是项目成功的基础尤其是ESP8266这种对电压极其敏感的芯片接错线瞬间就可能“烟消云散”。3.1 ESP8266的编程电路搭建在烧录程序到ESP8266之前我们需要先搭建一个临时的编程电路。ESP8266-01模块没有内置USB转串口芯片所以必须借助外部的USB转TTL串口工具。所需材料清单ESP8266-01模块 x1USB转TTL串口模块必须支持3.3V电平 x1面包板 x1杜邦线母对母若干连接步骤与原理请严格按照下表进行连接并理解每一根线的作用ESP8266-01引脚连接至 USB转TTL模块作用与说明VCC3.3V供电生命线绝对禁止接5VGNDGND共地确保电压参考点一致。GPIO0GND关键拉低此引脚使ESP8266进入固件烧录模式。RST悬空或通过按钮接GND复位引脚正常运行时接高电平模块内部已上拉烧录时无需连接。如需手动复位可短暂接地。CH_PD (EN)3.3V芯片使能高电平有效必须接高。TXRXESP8266的发送端接串口工具的接收端。RXTXESP8266的接收端接串口工具的发送端。注意电压是重中之重市面上很多USB转TTL模块默认输出是5V务必确认你的模块有独立的3.3V输出引脚并且将其跳线帽或开关设置为3.3V模式。用万用表测量一下VCC引脚电压是3.3V再连接这是保护ESP8266的唯一方法。连接好之后在给模块上电前最后检查一遍GPIO0是否已接地VCC是否是3.3V确认无误后再将USB转TTL模块插入电脑。3.2 Teensy LC与ESP8266的最终系统连接烧录完程序后GPIO0就不再需要接地了可以悬空ESP8266将进入正常运行模式。现在我们需要搭建最终的工作电路将ESP8266和Teensy LC连接起来。最终系统连接表ESP8266-01引脚连接至 Teensy LC引脚作用与说明VCC3.3V 电源供电。可以从Teensy LC的3.3V引脚取电但需注意Teensy LC的3.3V稳压器输出电流可能有限约250mA。对于稳定运行强烈建议为ESP8266提供独立的3.3V电源如AMS1117-3.3模块。GNDGND共地必须连接否则通信无法进行。TXRX2 (引脚9)ESP8266发送数据Teensy LC的串口2接收。RX悬空或接Teensy LC的GND关键安全措施Teensy LC的逻辑电平是5V其TX2引脚10引脚输出也是5V直接连接会损坏ESP8266的RX引脚耐压3.3V。因此绝对不要连接RX线。如果担心引脚悬空引入噪声可以将其通过一个1kΩ电阻接地。关于供电的实操心得 我在测试中发现当ESP8266作为热点并保持TCP连接时瞬时电流可能会达到200mA以上。虽然Teensy LC的3.3V引脚在静态时能提供这个电流但在两者同时工作且USB供电可能不稳的情况下容易导致ESP8266重启或工作异常。我的解决方案是使用一块微型3.3V稳压模块直接从USB 5V取电给ESP8266供电彻底解决电源问题。整个系统的供电拓扑就变成了USB口 - 5V - 一路给Teensy LC另一路经稳压模块给ESP8266。两者GND相连。4. 固件开发ESP8266与Teensy LC编程精讲硬件连好了接下来就是给它们注入“灵魂”。代码虽然不长但每一行都有其用意。4.1 ESP8266固件搭建微型TCP服务器我们将使用Arduino IDE开发ESP8266。首先确保已安装ESP8266开发板支持包。#include ESP8266WiFi.h // 1. 定义热点名称和密码 const char *ssid MyVoiceKB; // 建议改个自己独有的名字 const char *password 12345678; // 密码至少8位 WiFiServer server(8080); // 在端口8080创建服务器对象 void setup() { Serial.begin(115200); // 初始化串口用于调试和与Teensy通信 delay(100); // 短暂延时让串口稳定 // 2. 启动软接入点Soft-AP Serial.print(正在创建热点: ); Serial.println(ssid); bool apResult WiFi.softAP(ssid, password); if (!apResult) { Serial.println(热点创建失败); while(1); // 停止运行 } // 3. 获取并打印AP的IP地址默认是192.168.4.1 IPAddress myIP WiFi.softAPIP(); Serial.print(热点IP地址: ); Serial.println(myIP); Serial.print(热点MAC地址: ); Serial.println(WiFi.softAPmacAddress()); // 4. 启动TCP服务器 server.begin(); Serial.println(TCP服务器已在端口 8080 启动); } void loop() { // 5. 监听是否有新的客户端连接 WiFiClient client server.available(); if (client) { Serial.println(有新的客户端连接); // 6. 保持连接只要客户端还连着 while (client.connected()) { // 7. 检查客户端是否有数据发送过来 if (client.available()) { char c client.read(); // 读取一个字节 Serial.write(c); // 将字节通过串口转发给Teensy LC // 这里也可以加入调试信息如 Serial.print(收到: ); Serial.println(c); } } // 8. 客户端断开连接 client.stop(); Serial.println(客户端断开连接); } }代码关键点解析WiFi.softAP(ssid, password): 这是将ESP8266设置为热点的核心函数。它会分配一个默认的IP192.168.4.1给自身。server.begin(): 启动TCP服务器开始监听指定端口。server.available(): 非阻塞地检查是否有新的客户端连接请求。如果有则返回一个WiFiClient对象。client.available()和client.read(): 在连接保持期间循环检查并读取客户端发送过来的每一个字节。Serial.write(c):核心操作。将网络收到的每一个字符通过硬件串口TX/RX引脚发送出去。Teensy LC就在另一端等着这些数据。烧录注意事项 在Arduino IDE中选择开发板为“Generic ESP8266 Module”正确选择端口。烧录时务必确保ESP8266的GPIO0引脚接地进入下载模式。烧录成功后断开GPIO0与GND的连接按一下RST键复位模块就会运行新程序。4.2 Teensy LC固件高效的串口转发键盘Teensy LC的代码更加简洁其核心思想就是“串口接收 - 键盘输出”。void setup() { // 初始化与ESP8266通信的串口2波特率必须与ESP8266的Serial.begin设置一致 Serial2.begin(115200); // 可选初始化用于调试的USB串口在Arduino串口监视器中查看 // Serial.begin(9600); } void loop() { // 检查串口2是否有数据可读 if (Serial2.available() 0) { // 读取一个字节 char incomingChar Serial2.read(); // 可选将收到的字符通过USB串口打印出来用于调试 // Serial.print(incomingChar); // 核心操作将字符作为按键发送给电脑 Keyboard.write(incomingChar); // 微小延时避免处理过快导致某些系统丢键尤其是快速发送长句时 delay(1); } }代码关键点与避坑指南Serial2.begin(115200): 这里使用的是Teensy LC的硬件串口2其RX引脚是9TX引脚是10。波特率必须与ESP8266程序中Serial.begin(115200)的设定完全一致。Keyboard.write(): 这是Teensy USB HID库提供的函数它模拟的是按下并释放一个键。对于字母、数字、常用标点直接传入对应的char类型即可。它比Keyboard.press()和Keyboard.release()的组合更简单。波特率稳定性115200是比较高的波特率确保连接线可靠避免干扰。如果发现数据传输中丢字或乱码可以尝试在Serial2.begin()后加一个delay(100)或者将波特率降至9600或57600进行测试。Teensy USB类型设置在Arduino IDE中选择Tools - USB Type -Keyboard Mouse Joystick或至少包含Keyboard的选项。这是Teensy能模拟键盘的前提。如果选错电脑将无法识别为键盘。烧录Teensy LC非常简单用USB线连接电脑在IDE中选择正确的板卡Teensy LC和端口点击上传即可。Teensy的烧录器非常智能通常会自动完成。5. 手机App开发与配置实战硬件和固件都准备好了现在需要打造一个“遥控器”——手机App。我们使用MIT App Inventor 2这是一个图形化的在线开发工具无需编写传统代码通过拖拽组件和逻辑块即可完成App开发非常适合快速原型制作。5.1 界面设计与组件布局创建项目访问MIT App Inventor官网登录后创建一个新项目命名为VoiceToTextKeyboard。拖拽组件从左侧的“Palette”中将以下组件拖到中间的“Viewer”手机屏幕上TextBox文本框用于显示识别出的文本也可以手动输入。将其Hint属性设为“识别文本将显示在这里...”。Button按钮拖三个。分别修改其Text属性为“连接WiFi”、“开始录音”、“发送文本”。SpeechRecognizer语音识别器在“Media”抽屉里。这是一个非可视组件拖到屏幕上任意位置即可。ClientSocket客户端套接字我们需要一个扩展组件来实现TCP连接。点击“Extension” - “Import Extension”输入以下URL导入https://github.com/barreeeiroo/ClientSocketAI2/raw/master/ClientSocket.aix。导入成功后在“Palette”的“Extension”抽屉里找到ClientSocket组件拖到屏幕上。界面布局大致排列如下顶部一个“连接WiFi”按钮中间一个大文本框下方并排“开始录音”和“发送文本”两个按钮。你可以使用HorizontalArrangement和VerticalArrangement来让布局更整齐。5.2 逻辑块编程连接、识别与发送切换到“Blocks”编程视图。我们将用逻辑块实现以下功能功能一连接ESP8266热点当“连接WiFi”按钮被点击时设置ClientSocket的服务器地址为192.168.4.1ESP8266热点的默认IP。设置服务器端口为8080与ESP8266代码中WiFiServer server(8080)一致。调用ClientSocket.Connect块。功能二语音识别当“开始录音”按钮被点击时调用SpeechRecognizer.GetText块。这会触发手机系统的语音识别界面。当SpeechRecognizer.AfterGettingText事件被触发时即识别完成将事件附带的result参数设置给TextBox的Text属性。这样识别出的文字就显示在文本框里了。功能三发送文本当“发送文本”按钮被点击时获取TextBox的Text属性即要发送的文字。调用ClientSocket.SendData块将文本内容发送出去。核心逻辑块示意图文字描述当 Button_Connect 被点击 设置 ClientSocket.ServerAddress 为 “192.168.4.1” 设置 ClientSocket.ServerPort 为 8080 执行 ClientSocket.Connect 当 Button_Record 被点击 执行 SpeechRecognizer.GetText 当 SpeechRecognizer.AfterGettingText (result) 设置 TextBox.Text 为 result 当 Button_Send 被点击 执行 ClientSocket.SendData (数据: TextBox.Text)注意事项与调试技巧网络权限App需要网络权限。在“Designer”视图的“Screen1”属性中确保Internet权限被勾选。首次连接确保手机已手动连接到ESP8266创建的热点“MyVoiceKB”。连接反馈可以添加一个Label组件在ClientSocket.Connected和ClientSocket.ErrorOccurred事件中更新其文本显示连接状态便于调试。数据格式SendData发送的是字符串。ESP8266程序是一个字节一个字节读取的所以中文字符可能会被拆成多个字节发送需要ESP8266和Teensy程序做相应处理本例默认处理英文。若要支持中文需要在App端将字符串转为UTF-8字节数组发送并在Teensy端进行复杂解析这属于进阶内容。完成设计后点击“Build” - “App (provide QR code for .apk)”生成一个二维码。用安卓手机扫描这个二维码下载并安装APK文件。安装时系统可能会提示“来自未知来源”需要在设置中允许安装未知来源的应用。6. 系统集成测试与深度优化指南所有部件准备就绪现在进入激动人心的联调测试阶段。这个过程是发现问题、理解系统运作的最佳时机。6.1 完整测试流程与问题排查上电与网络检查给整个系统供电通过USB连接电脑或电源。等待几秒用手机打开WiFi设置搜索是否存在名为“MyVoiceKB”的热点。如果找不到检查ESP8266是否供电正常LED是否闪烁固件是否烧录成功。连接该热点密码为“12345678”。App连接测试打开手机上的“VoiceToTextKeyboard” App。点击“连接WiFi”按钮。如果App没有报错如连接超时、无法连接等并且ESP8266的串口监视器需在烧录程序前打开打印出“有新的客户端连接”则表明TCP连接成功。常见问题1连接失败。检查IP和端口是否正确检查手机是否真的连接到了ESP8266的热点而不是其他同名网络检查ESP8266的服务器程序是否正常运行可尝试重启ESP8266。语音识别测试点击App的“开始录音”按钮允许麦克风权限。对着手机说一段话例如“Hello world”。查看App的文本框中是否出现了识别出的文字。这一步依赖手机网络和谷歌语音识别服务在安静环境下效果较好。端到端输入测试在电脑上打开一个文本编辑器如记事本、VS Code将光标置于输入框。在App中点击“发送文本”按钮。观察电脑文本编辑器中是否出现了App文本框中的文字。常见问题2电脑上输入乱码或重复字符。这通常是波特率不匹配或串口通信干扰所致。首先确认ESP8266的Serial.begin(115200)和Teensy LC的Serial2.begin(115200)完全一致。其次检查连接线是否过长或接触不良。可以在Teensy代码中加入调试语句将Serial2.read()到的字节通过Serial.println(incomingChar, HEX)以十六进制形式打印到Arduino串口监视器看收到的数据是否正确。压力与稳定性测试尝试发送较长的句子。测试连续快速发送。断开手机WiFi重连看系统是否能恢复。6.2 性能优化与功能扩展思路基础功能跑通后我们可以从以下几个方面进行优化和扩展让它变得更实用、更强大增加本地文本缓存与队列问题目前如果快速连续点击“发送”或者网络稍有延迟可能会导致字符顺序错乱或丢失。优化在Teensy LC端建立一个环形缓冲区Ring Buffer。ESP8266发来的数据先存入缓冲区loop()函数再从缓冲区顺序取出并执行Keyboard.write()。这能有效平滑数据流防止丢包。引入协议与指令控制问题现在只能发送纯文本无法实现“回车”、“删除”、“快捷键”等复杂操作。扩展定义简单的通信协议。例如在App端用特殊字符作为指令前缀。当Teensy收到“\n”时执行Keyboard.press(KEY_RETURN)收到“[DEL]”时执行Keyboard.press(KEY_BACKSPACE)。这样就能通过语音实现“换行”、“删除上一个词”等高级功能。改善供电与便携性问题目前需要USB线连接电脑供电不便携。优化可以使用一个移动电源充电宝为整个系统供电。将Teensy LC、ESP8266和一个3.3V稳压模块集成到一个小型PCB或洞洞板上再用一个手机充电宝供电就可以做成一个完全独立的、可随身携带的语音键盘设备。尝试离线语音识别挑战当前方案依赖网络。可以研究在手机端集成离线语音识别引擎如PocketSphinx或者使用具备更强处理能力的开发板如ESP32-S3带AI加速本地运行轻量级语音识别模型。这将是质的飞跃但难度和成本也显著增加。这个项目从构思到实现打通了“语音-无线-硬件-输入”的完整链条。它不仅仅是一个有趣的玩具更是一个理解物联网设备间通信、嵌入式系统开发、以及软硬件协同的绝佳范例。希望这份详细的指南能帮助你成功复现并启发你做出更有创意的改进。
ESP8266+Teensy LC打造离线语音键盘：从原理到实践
发布时间：2026/6/3 0:11:24
1. 项目概述用ESP8266打造你的专属语音键盘你有没有想过对着手机说句话电脑上就能自动打出文字这听起来像是科幻电影里的场景但其实用我们手边常见的几块开发板就能轻松实现。今天要分享的就是一个我亲手搭建的“WiFi语音转文本键盘”项目。它的核心思路非常巧妙用手机App识别你的语音并转换成文字然后通过WiFi发送给一个微型无线模块ESP8266最后再由一块Teensy LC开发板模拟成USB键盘将这些文字“敲”进你的电脑。整个过程完全离线吗不语音识别部分依赖手机端的在线服务如Google Speech-to-Text API但硬件间的通信是独立的局域网。这恰恰是它的优势所在——你不需要给电脑安装任何驱动或软件只要电脑有USB口这个“语音键盘”就能即插即用。它非常适合需要快速录入大量文字的场景比如写稿、记录会议纪要或者为一些不方便使用传统键盘的场合提供无障碍输入支持。实现这个项目的关键硬件是ESP8266和Teensy LC。ESP8266大家应该不陌生这颗性价比超高的WiFi芯片在这里扮演着无线热点的角色负责接收手机发来的文本。而Teensy LC则是一个强大的微控制器以其出色的USB HID人机接口设备如键盘、鼠标模拟能力著称负责将收到的文本转化为键盘按键信号。整个项目的代码量不大但涉及了无线通信、串口数据转发和HID设备模拟等多个嵌入式开发的经典环节是一个绝佳的练手项目。2. 核心硬件选型与设计思路解析2.1 为什么是ESP8266 Teensy LC的组合在构思这个项目时硬件选型是第一步也是最关键的一步。我们需要一个能创建WiFi热点的模块和一个能模拟USB键盘的微控制器。市面上方案很多为什么最终锁定ESP8266和Teensy LC呢首先看无线部分。ESP8266几乎是物联网项目的“标配”原因无他成本极低、资料丰富、社区活跃。它内置了完整的TCP/IP协议栈可以非常方便地设置为接入点AP模式让手机直接连接省去了连接路由器的麻烦使得整个设备可以独立工作。虽然ESP32功能更强大但在这个只需要简单WiFi热点的场景下ESP8266完全够用且更省电、更便宜。然后是键盘模拟部分。这是整个项目的“执行终端”。常见的Arduino Uno/Leonardo虽然也能通过Keyboard库模拟键盘但其USB HID功能相对基础且在同时处理串口通信和USB模拟时可能会遇到一些兼容性问题。Teensy LC则不同它基于ARM Cortex-M0内核原生支持强大的USB HID功能稳定性极高。PJRCTeensy制造商提供的USB API非常完善可以轻松模拟键盘、鼠标、游戏手柄等多种设备。更重要的是Teensy LC有多个硬件串口Serial我们可以用一个专有的串口如Serial2与ESP8266通信完全不影响其作为USB设备与电脑的交互架构清晰又稳定。这个组合的分工非常明确ESP8266专攻网络Teensy LC专攻人机交互。两者通过串口UART这个简单、可靠、低速的协议进行通信完美解耦。这种“各司其职”的设计不仅降低了单个芯片的负担和编程复杂度也使得后期调试和维护变得非常容易——网络出问题就查ESP8266打字出问题就查Teensy。2.2 系统架构与数据流剖析理解了硬件选型我们再来看看整个系统是如何协同工作的。数据流是项目的生命线清晰的数据流意味着稳定的系统。整个系统的数据流向是一个清晰的单向链条语音 - 手机App - WiFi - ESP8266 - 串口 - Teensy LC - USB - 电脑。语音采集与识别端手机用户点击手机App的录音按钮App调用手机系统集成的语音识别服务通常是Google或厂商的语音识别API。这个服务将麦克风采集的音频流上传至云端识别成文本后返回给App。这里有一个关键点语音识别的准确性和速度取决于网络质量和云端服务这部分是我们项目不可控的但也是技术最成熟、效果最好的部分我们直接“拿来主义”。无线传输中继站ESP8266ESP8266被编程为一个简单的TCP服务器。它创建了一个名为“ESP-8266”的WiFi热点并在端口8080上监听。手机App作为TCP客户端连接上这个热点后再连接到192.168.4.1:8080这个服务器地址。一旦连接建立App就把识别好的文本字符串通过TCP Socket发送过来。ESP8266的程序逻辑极其简单从网络端口读取数据然后原封不动地写入它的硬件串口Serial。它不关心数据内容只负责转发。键盘指令执行器Teensy LCTeensy LC通过其第二个硬件串口Serial2监听ESP8266发来的数据。只要串口缓冲区有数据它就立刻读取一个字节然后调用Keyboard.write()函数将这个字节作为一次按键动作发送给电脑。电脑操作系统会将其识别为一个标准USB键盘的输入。这里的精妙之处在于Keyboard.write()函数会自动处理大小写、标点符号等我们发送原始的ASCII字符即可无需关心复杂的按键码Keycode组合。这种架构的优势在于低耦合和高容错。每个环节独立你可以单独升级或替换某一部分。例如未来想把语音识别换成离线的只需要修改手机App想增加蓝牙连接可以换掉ESP8266模块而Teensy LC端的代码几乎不用动。3. 硬件连接与电路搭建详解纸上谈兵终觉浅接下来我们进入实战环节把硬件实实在在地连起来。正确的电路连接是项目成功的基础尤其是ESP8266这种对电压极其敏感的芯片接错线瞬间就可能“烟消云散”。3.1 ESP8266的编程电路搭建在烧录程序到ESP8266之前我们需要先搭建一个临时的编程电路。ESP8266-01模块没有内置USB转串口芯片所以必须借助外部的USB转TTL串口工具。所需材料清单ESP8266-01模块 x1USB转TTL串口模块必须支持3.3V电平 x1面包板 x1杜邦线母对母若干连接步骤与原理请严格按照下表进行连接并理解每一根线的作用ESP8266-01引脚连接至 USB转TTL模块作用与说明VCC3.3V供电生命线绝对禁止接5VGNDGND共地确保电压参考点一致。GPIO0GND关键拉低此引脚使ESP8266进入固件烧录模式。RST悬空或通过按钮接GND复位引脚正常运行时接高电平模块内部已上拉烧录时无需连接。如需手动复位可短暂接地。CH_PD (EN)3.3V芯片使能高电平有效必须接高。TXRXESP8266的发送端接串口工具的接收端。RXTXESP8266的接收端接串口工具的发送端。注意电压是重中之重市面上很多USB转TTL模块默认输出是5V务必确认你的模块有独立的3.3V输出引脚并且将其跳线帽或开关设置为3.3V模式。用万用表测量一下VCC引脚电压是3.3V再连接这是保护ESP8266的唯一方法。连接好之后在给模块上电前最后检查一遍GPIO0是否已接地VCC是否是3.3V确认无误后再将USB转TTL模块插入电脑。3.2 Teensy LC与ESP8266的最终系统连接烧录完程序后GPIO0就不再需要接地了可以悬空ESP8266将进入正常运行模式。现在我们需要搭建最终的工作电路将ESP8266和Teensy LC连接起来。最终系统连接表ESP8266-01引脚连接至 Teensy LC引脚作用与说明VCC3.3V 电源供电。可以从Teensy LC的3.3V引脚取电但需注意Teensy LC的3.3V稳压器输出电流可能有限约250mA。对于稳定运行强烈建议为ESP8266提供独立的3.3V电源如AMS1117-3.3模块。GNDGND共地必须连接否则通信无法进行。TXRX2 (引脚9)ESP8266发送数据Teensy LC的串口2接收。RX悬空或接Teensy LC的GND关键安全措施Teensy LC的逻辑电平是5V其TX2引脚10引脚输出也是5V直接连接会损坏ESP8266的RX引脚耐压3.3V。因此绝对不要连接RX线。如果担心引脚悬空引入噪声可以将其通过一个1kΩ电阻接地。关于供电的实操心得 我在测试中发现当ESP8266作为热点并保持TCP连接时瞬时电流可能会达到200mA以上。虽然Teensy LC的3.3V引脚在静态时能提供这个电流但在两者同时工作且USB供电可能不稳的情况下容易导致ESP8266重启或工作异常。我的解决方案是使用一块微型3.3V稳压模块直接从USB 5V取电给ESP8266供电彻底解决电源问题。整个系统的供电拓扑就变成了USB口 - 5V - 一路给Teensy LC另一路经稳压模块给ESP8266。两者GND相连。4. 固件开发ESP8266与Teensy LC编程精讲硬件连好了接下来就是给它们注入“灵魂”。代码虽然不长但每一行都有其用意。4.1 ESP8266固件搭建微型TCP服务器我们将使用Arduino IDE开发ESP8266。首先确保已安装ESP8266开发板支持包。#include ESP8266WiFi.h // 1. 定义热点名称和密码 const char *ssid MyVoiceKB; // 建议改个自己独有的名字 const char *password 12345678; // 密码至少8位 WiFiServer server(8080); // 在端口8080创建服务器对象 void setup() { Serial.begin(115200); // 初始化串口用于调试和与Teensy通信 delay(100); // 短暂延时让串口稳定 // 2. 启动软接入点Soft-AP Serial.print(正在创建热点: ); Serial.println(ssid); bool apResult WiFi.softAP(ssid, password); if (!apResult) { Serial.println(热点创建失败); while(1); // 停止运行 } // 3. 获取并打印AP的IP地址默认是192.168.4.1 IPAddress myIP WiFi.softAPIP(); Serial.print(热点IP地址: ); Serial.println(myIP); Serial.print(热点MAC地址: ); Serial.println(WiFi.softAPmacAddress()); // 4. 启动TCP服务器 server.begin(); Serial.println(TCP服务器已在端口 8080 启动); } void loop() { // 5. 监听是否有新的客户端连接 WiFiClient client server.available(); if (client) { Serial.println(有新的客户端连接); // 6. 保持连接只要客户端还连着 while (client.connected()) { // 7. 检查客户端是否有数据发送过来 if (client.available()) { char c client.read(); // 读取一个字节 Serial.write(c); // 将字节通过串口转发给Teensy LC // 这里也可以加入调试信息如 Serial.print(收到: ); Serial.println(c); } } // 8. 客户端断开连接 client.stop(); Serial.println(客户端断开连接); } }代码关键点解析WiFi.softAP(ssid, password): 这是将ESP8266设置为热点的核心函数。它会分配一个默认的IP192.168.4.1给自身。server.begin(): 启动TCP服务器开始监听指定端口。server.available(): 非阻塞地检查是否有新的客户端连接请求。如果有则返回一个WiFiClient对象。client.available()和client.read(): 在连接保持期间循环检查并读取客户端发送过来的每一个字节。Serial.write(c):核心操作。将网络收到的每一个字符通过硬件串口TX/RX引脚发送出去。Teensy LC就在另一端等着这些数据。烧录注意事项 在Arduino IDE中选择开发板为“Generic ESP8266 Module”正确选择端口。烧录时务必确保ESP8266的GPIO0引脚接地进入下载模式。烧录成功后断开GPIO0与GND的连接按一下RST键复位模块就会运行新程序。4.2 Teensy LC固件高效的串口转发键盘Teensy LC的代码更加简洁其核心思想就是“串口接收 - 键盘输出”。void setup() { // 初始化与ESP8266通信的串口2波特率必须与ESP8266的Serial.begin设置一致 Serial2.begin(115200); // 可选初始化用于调试的USB串口在Arduino串口监视器中查看 // Serial.begin(9600); } void loop() { // 检查串口2是否有数据可读 if (Serial2.available() 0) { // 读取一个字节 char incomingChar Serial2.read(); // 可选将收到的字符通过USB串口打印出来用于调试 // Serial.print(incomingChar); // 核心操作将字符作为按键发送给电脑 Keyboard.write(incomingChar); // 微小延时避免处理过快导致某些系统丢键尤其是快速发送长句时 delay(1); } }代码关键点与避坑指南Serial2.begin(115200): 这里使用的是Teensy LC的硬件串口2其RX引脚是9TX引脚是10。波特率必须与ESP8266程序中Serial.begin(115200)的设定完全一致。Keyboard.write(): 这是Teensy USB HID库提供的函数它模拟的是按下并释放一个键。对于字母、数字、常用标点直接传入对应的char类型即可。它比Keyboard.press()和Keyboard.release()的组合更简单。波特率稳定性115200是比较高的波特率确保连接线可靠避免干扰。如果发现数据传输中丢字或乱码可以尝试在Serial2.begin()后加一个delay(100)或者将波特率降至9600或57600进行测试。Teensy USB类型设置在Arduino IDE中选择Tools - USB Type -Keyboard Mouse Joystick或至少包含Keyboard的选项。这是Teensy能模拟键盘的前提。如果选错电脑将无法识别为键盘。烧录Teensy LC非常简单用USB线连接电脑在IDE中选择正确的板卡Teensy LC和端口点击上传即可。Teensy的烧录器非常智能通常会自动完成。5. 手机App开发与配置实战硬件和固件都准备好了现在需要打造一个“遥控器”——手机App。我们使用MIT App Inventor 2这是一个图形化的在线开发工具无需编写传统代码通过拖拽组件和逻辑块即可完成App开发非常适合快速原型制作。5.1 界面设计与组件布局创建项目访问MIT App Inventor官网登录后创建一个新项目命名为VoiceToTextKeyboard。拖拽组件从左侧的“Palette”中将以下组件拖到中间的“Viewer”手机屏幕上TextBox文本框用于显示识别出的文本也可以手动输入。将其Hint属性设为“识别文本将显示在这里...”。Button按钮拖三个。分别修改其Text属性为“连接WiFi”、“开始录音”、“发送文本”。SpeechRecognizer语音识别器在“Media”抽屉里。这是一个非可视组件拖到屏幕上任意位置即可。ClientSocket客户端套接字我们需要一个扩展组件来实现TCP连接。点击“Extension” - “Import Extension”输入以下URL导入https://github.com/barreeeiroo/ClientSocketAI2/raw/master/ClientSocket.aix。导入成功后在“Palette”的“Extension”抽屉里找到ClientSocket组件拖到屏幕上。界面布局大致排列如下顶部一个“连接WiFi”按钮中间一个大文本框下方并排“开始录音”和“发送文本”两个按钮。你可以使用HorizontalArrangement和VerticalArrangement来让布局更整齐。5.2 逻辑块编程连接、识别与发送切换到“Blocks”编程视图。我们将用逻辑块实现以下功能功能一连接ESP8266热点当“连接WiFi”按钮被点击时设置ClientSocket的服务器地址为192.168.4.1ESP8266热点的默认IP。设置服务器端口为8080与ESP8266代码中WiFiServer server(8080)一致。调用ClientSocket.Connect块。功能二语音识别当“开始录音”按钮被点击时调用SpeechRecognizer.GetText块。这会触发手机系统的语音识别界面。当SpeechRecognizer.AfterGettingText事件被触发时即识别完成将事件附带的result参数设置给TextBox的Text属性。这样识别出的文字就显示在文本框里了。功能三发送文本当“发送文本”按钮被点击时获取TextBox的Text属性即要发送的文字。调用ClientSocket.SendData块将文本内容发送出去。核心逻辑块示意图文字描述当 Button_Connect 被点击 设置 ClientSocket.ServerAddress 为 “192.168.4.1” 设置 ClientSocket.ServerPort 为 8080 执行 ClientSocket.Connect 当 Button_Record 被点击 执行 SpeechRecognizer.GetText 当 SpeechRecognizer.AfterGettingText (result) 设置 TextBox.Text 为 result 当 Button_Send 被点击 执行 ClientSocket.SendData (数据: TextBox.Text)注意事项与调试技巧网络权限App需要网络权限。在“Designer”视图的“Screen1”属性中确保Internet权限被勾选。首次连接确保手机已手动连接到ESP8266创建的热点“MyVoiceKB”。连接反馈可以添加一个Label组件在ClientSocket.Connected和ClientSocket.ErrorOccurred事件中更新其文本显示连接状态便于调试。数据格式SendData发送的是字符串。ESP8266程序是一个字节一个字节读取的所以中文字符可能会被拆成多个字节发送需要ESP8266和Teensy程序做相应处理本例默认处理英文。若要支持中文需要在App端将字符串转为UTF-8字节数组发送并在Teensy端进行复杂解析这属于进阶内容。完成设计后点击“Build” - “App (provide QR code for .apk)”生成一个二维码。用安卓手机扫描这个二维码下载并安装APK文件。安装时系统可能会提示“来自未知来源”需要在设置中允许安装未知来源的应用。6. 系统集成测试与深度优化指南所有部件准备就绪现在进入激动人心的联调测试阶段。这个过程是发现问题、理解系统运作的最佳时机。6.1 完整测试流程与问题排查上电与网络检查给整个系统供电通过USB连接电脑或电源。等待几秒用手机打开WiFi设置搜索是否存在名为“MyVoiceKB”的热点。如果找不到检查ESP8266是否供电正常LED是否闪烁固件是否烧录成功。连接该热点密码为“12345678”。App连接测试打开手机上的“VoiceToTextKeyboard” App。点击“连接WiFi”按钮。如果App没有报错如连接超时、无法连接等并且ESP8266的串口监视器需在烧录程序前打开打印出“有新的客户端连接”则表明TCP连接成功。常见问题1连接失败。检查IP和端口是否正确检查手机是否真的连接到了ESP8266的热点而不是其他同名网络检查ESP8266的服务器程序是否正常运行可尝试重启ESP8266。语音识别测试点击App的“开始录音”按钮允许麦克风权限。对着手机说一段话例如“Hello world”。查看App的文本框中是否出现了识别出的文字。这一步依赖手机网络和谷歌语音识别服务在安静环境下效果较好。端到端输入测试在电脑上打开一个文本编辑器如记事本、VS Code将光标置于输入框。在App中点击“发送文本”按钮。观察电脑文本编辑器中是否出现了App文本框中的文字。常见问题2电脑上输入乱码或重复字符。这通常是波特率不匹配或串口通信干扰所致。首先确认ESP8266的Serial.begin(115200)和Teensy LC的Serial2.begin(115200)完全一致。其次检查连接线是否过长或接触不良。可以在Teensy代码中加入调试语句将Serial2.read()到的字节通过Serial.println(incomingChar, HEX)以十六进制形式打印到Arduino串口监视器看收到的数据是否正确。压力与稳定性测试尝试发送较长的句子。测试连续快速发送。断开手机WiFi重连看系统是否能恢复。6.2 性能优化与功能扩展思路基础功能跑通后我们可以从以下几个方面进行优化和扩展让它变得更实用、更强大增加本地文本缓存与队列问题目前如果快速连续点击“发送”或者网络稍有延迟可能会导致字符顺序错乱或丢失。优化在Teensy LC端建立一个环形缓冲区Ring Buffer。ESP8266发来的数据先存入缓冲区loop()函数再从缓冲区顺序取出并执行Keyboard.write()。这能有效平滑数据流防止丢包。引入协议与指令控制问题现在只能发送纯文本无法实现“回车”、“删除”、“快捷键”等复杂操作。扩展定义简单的通信协议。例如在App端用特殊字符作为指令前缀。当Teensy收到“\n”时执行Keyboard.press(KEY_RETURN)收到“[DEL]”时执行Keyboard.press(KEY_BACKSPACE)。这样就能通过语音实现“换行”、“删除上一个词”等高级功能。改善供电与便携性问题目前需要USB线连接电脑供电不便携。优化可以使用一个移动电源充电宝为整个系统供电。将Teensy LC、ESP8266和一个3.3V稳压模块集成到一个小型PCB或洞洞板上再用一个手机充电宝供电就可以做成一个完全独立的、可随身携带的语音键盘设备。尝试离线语音识别挑战当前方案依赖网络。可以研究在手机端集成离线语音识别引擎如PocketSphinx或者使用具备更强处理能力的开发板如ESP32-S3带AI加速本地运行轻量级语音识别模型。这将是质的飞跃但难度和成本也显著增加。这个项目从构思到实现打通了“语音-无线-硬件-输入”的完整链条。它不仅仅是一个有趣的玩具更是一个理解物联网设备间通信、嵌入式系统开发、以及软硬件协同的绝佳范例。希望这份详细的指南能帮助你成功复现并启发你做出更有创意的改进。
