跳转至内容

博客

2 主题 2 帖子

博主的博文

此版块可通过开放社交网络使用标识符 博客@www.byteohm.com 关注

  • RS232 串口键盘:让只有串口的设备直接「打字」进电脑

    1
    0 赞同
    1 帖子
    17 浏览
    A
    电子秤只有一个 DB9 口,检测仪只会往串口吐 ASCII,老 PLC 的日志只能在串口助手的窗口里滚动。可这些数据最后都要落到 Excel 的一列、网页的一个输入框、ERP 的单号栏里——那些地方只认键盘。 这块小板子补的就是这一段:串口来什么字符,电脑上就打出什么字符,光标停在哪就打到哪。它替代的是 CH9329 这类固定协议的串口转 HID 芯片,区别在于协议、节奏、字符映射都可以按现场调。 [image: RS232 串口键盘的接线与供电] 一、它是什么 项 说明 输入 RS232(TXD / RXD / GND),默认 9600 8N1、无流控 输出 USB HID 键盘,插上即用、免驱 主控 CH32X033F8P6 供电 USB 5V,或端子 +12V 脚接 5~30V,二选一 形态 板载 USB-A 公头,直接插在电脑的 USB 口上;也可以配一条延长线放到桌面 固件 支持 USB 在线升级,不用拆壳、不用接调试排针 对外只有两个口:一头是 4 针端子(接设备),一头是 USB-A 公头(插电脑)。中间是电平转换和一颗单片机,信号路径很短:设备的 RS232 → 电平转换 → 单片机 → USB 键盘 → 电脑。 二、几个用起来才发现的差别 1. 一个字符都不丢 设备发数据是一口气灌过来的,电脑那头却只能一个字一个字地敲,中间的落差必须有人接住。这板子把落差全接在自己身上:先把数据收下来排队,再按电脑能接受的速度一个个送出去。 实测:一次性灌 456 个字符,屏幕上就是 456 个,一个不少;连续输出时速度稳定,中间没有掉字。 2. 大小写不会被 CapsLock 带翻 物理键盘上 CapsLock 亮着按 A 出的是 a。本设备会读主机下发的键盘灯状态,CapsLock 开着时就对字母键取反 Shift——不管 CapsLock 什么状态,设备发 ABC,屏幕上就是 ABC。只动 a–z,!@#$ 这类符号键不受影响。 3. 一个字符 2 ms USB 键盘每 1 ms 被电脑问一次「有没有键按下」。一个字符必须占两次回答——按下、松手,否则电脑会以为这个键一直没松开——所以上限就是 2 ms/字符,约 500 字符/秒。 这个节奏不是靠延时凑出来的:上一帧被取走,下一帧才发。真机抓包实测 1.998 ms/字符(456 个字符用了 910.9 ms),已经贴着理论极限。 4. 能把睡着的电脑叫醒 PC 睡下之后串口又来数据,设备会主动驱动一次 resume 把 PC 叫醒,醒来那段字照常打完。用在没人值守的工位、夜间自动出单的产线上很实用。 前提只有一个:Windows 设备管理器里勾上「允许此设备唤醒计算机」。设备本身不睡——数据源是串口,一停就丢字节。 5. 一颗灯看懂串口 板上那颗灯就是个信号灯,接在串口线上,不归程序管: 现象 含义 灭 串口线上没有数据,这是默认状态 不规律地闪 设备正在往串口发数据 插上 USB、但对面没发数据的时候,它也是灭的——所以这颗灯不能用来看「USB 通没通」。它的用处是接线和排障:让设备发一行,灯闪了说明信号确实进到板子上了;灯不闪,问题就在接线或者波特率那头。 6. 能在线升级 现场要改波特率、改键位,发个新固件过来,插一次 USB 就能刷,不用拆壳、不用接调试排针。升级途中断过电也不要紧,重新上电还能再刷一次。 三、接线与供电 端子是 4 针,认信号名比认脚号靠谱(不同批次的端子脚序可能不同,以板上丝印为准)。接线只有一条规矩:收发交叉——本板收的那根,接设备发的那根;本板发的那根,接设备收的那根。 端子丝印 接设备的 方向 说明 RXD 设备的 TXD 设备 → 板 设备往外发数据的那根,必接 TXD 设备的 RXD 板 → 设备 板子回发 ACK / 日志时才接,可选 GND 设备的 GND — 两边共地,必接 +12V 电源正极 供电 5~30V 最少三根线就能跑:RXD、GND,加一路供电。 设备那头是 DB9 的话:3 脚是它的 TXD(接本板 RXD),2 脚是它的 RXD(接本板 TXD),5 脚是 GND。 供电有两种接法 只插 USB:电脑的 5V 直接给板子供电,适合桌面调试、临时接一台机器。 只接端子 +12V:用设备自带的那路 5~30V 供电,USB 只走数据。适合设备本身有电源、不想再多插一根线的现场。 两路同时接也没问题,板上做了隔离,不会互相倒灌。 一个要提醒的点:板上是线性稳压,输入电压越高,它自己发热越大。12V 输入时耗散约 0.2 W,摸上去微温;如果长期接 24V 以上,装壳前先摸一下稳压器的温度。整板 3.3V 侧电流约 25 mA,对设备那路电源的带载要求不高。 四、第一次用,五步 接线:设备 TXD → 端子 RXD,GND → GND,再给一路供电。(要回发 ACK 才把设备 RXD 接到端子 TXD。) 插 USB:设备管理器里多出一个键盘设备;随便敲两下能出字,说明枚举成功。 把光标放好:打开记事本,或者点进 Excel 的单元格、网页的输入框。 让设备发一行:电子秤按「打印」,仪器手动触发,或者拿 USB-TTL 从另一台电脑发一句 Hello。指示灯会跟着闪几下,屏幕上应当逐字出现 Hello,行尾自动回车。 验一下大小写(可选但值得):打开 CapsLock 再发一次 Hello,仍然应该是 Hello 而不是 hELLO。 五、能打出哪些字符 类别 说明 英文、数字、标点 可打印的 ASCII 字符全部支持,包括空格和所有符号 控制字符 制表符、退格、回车、换行、Esc、Del 都支持 换行 收到「回车 + 换行」只回车一次,不会多空一行 打不出 中文、emoji、图片、二进制数据 也就是说:ASCII 文本一个字符不漏;中文、图片这类内容本来就不是键盘能表达的东西。如果对端发的不是文本,而是「每个字节对应一个按键」的自定义协议,也能按你的字节表出键,这种要单独对一下表。 六、参数速查 参数 默认值 备注 串口 9600 / 8N1 / 无流控 必须与设备侧一致;其它波特率可另配 行尾判定 收到回车换行,或停顿 20 ms 设备不发换行时靠停顿切行 缓冲 可吸收约 4 秒的连续数据 9600 bps 的速度下 输出速度 约 2 ms/字符(约 500 字符/秒) 上限由 USB 键盘的节奏决定 设备身份 标准 HID 键盘,产品名 STREAM_KEYBOARD_R1 免驱,不用装任何东西 固件版本 v1.02 可在线升级 七、出问题先看这张表 现象 先查什么 一个字都不出 让设备发一行,看指示灯闪不闪:不闪,查接线(RXD 有没有接到设备 TXD、有没有共地)和波特率;闪了,查 USB 有没有被认成键盘、光标在不在输入框里 出乱码 对端不是 9600 8N1;或对端在发二进制,而这是文本模式 偶尔丢字 对端是不是在满速连着灌数据 字母大小写全反 主机的 CapsLock 指示和屏幕上的状态是否一致 少打或多打回车 对端的行尾是单回车、单换行,还是回车加换行 打字被截断、黏在一起 对端字符之间停顿太久,一行被切成了两段 指示灯一直不亮 串口线上确实没信号:设备没在发,或收发没交叉、没共地 八、能按需定制 项 说明 波特率 默认 9600,其它速率可另配 键盘布局 目标系统是德语、法语、西班牙语等布局时,字符表要跟着换 自定义协议 对端发「每字节一个键」的二进制协议,而不是文本 线束与接口 端子插头、线长、DB9 转接,按现场做 用下来最省事的地方其实是「不需要装任何东西」:不管目标是记事本、Excel、浏览器里的表单,还是车间那套只能键盘录入的老 ERP,设备只管打字,宿主软件完全不用改。 有接线对不上的、或者想要某种特殊映射的,在下面留言。
  • 0 赞同
    1 帖子
    60 浏览
    A
    「加个图形化编程页麻烦吗?」 这是 10 月 20 日中午我收到的一句话。当时的回答是:不麻烦,但得先看清手里有什么——因为图形化编辑器最容易做成的样子,是画得挺好看、生成出来的脚本跑不了。 两天之后,它长这样:块可以拖、可以拼、能撤销、能复制粘贴、能按 Ctrl 滚轮缩放,切回文本模式看到的就是块生成的规范化脚本,编译、校验、保存、烧录全部复用原来的链路。 [image: 键鼠助手 5.0 的图形化编程界面:左侧宏目录,右侧块画布] 成品:左边是宏目录,右边是块画布。中间那段 当 … 执行 是容器块,条件由值块拼成(count 小于 3 且 鼠标是否按下 1),下面跟着延时、赋值、移动、点击,最后一段是自定义函数 on_timer1 的定义块。 这篇文章记录这两天的实际过程:做了哪些决定、踩了哪些坑、时间花在哪。文末有一张按开发日志回填的时间账。 一、先别写代码,先盘点 动手之前先回答一个问题:这个「Lua 宏」到底是不是 Lua。 盘完的结论是——不是。它是一个封闭的小 DSL,解析器同时支持两套方言: Lua 风格(对外文档化的语法):local x = v、if..then..elseif..else..end、while..do..end、for i=a,b,step..do..end、function f(p)..end、do..end、return、break、-- 注释; 遗留 BASIC 风格(老脚本兼容):If/Then/EndIf、While/Wend、For/Next、Sub/End Sub、Dim、Goto、Rem、Call、Exit Sub。 内置能力面是两张静态表:15 条命令 + 9 个函数,每条都带分类、参数模式、参数种类、参数个数上下限、说明文本。 这个盘点值钱的地方在于它直接给出了方案:块调色板不用手写,可以从命令表派生;而唯一的缺口是 AST → 文本生成器(unparser),得新写。 盘点还顺手圈出一条红线:内置函数的编号是编译器按命令表声明顺序写进字节码的 uint16 操作数,只能在表末尾追加,不能插入或删除。所以图形化这一层绝不能碰编译链路,它只能是「块树 → 文本 → 原有 parser/compiler」的上面一层。 一个决定性的判断:图形化只是入口,不是新引擎。这个边界守住了,后面所有工作都只在一个 UI 模块里发生,设备端字节码、VM、函数编号零改动。 二、第二条决断:不塞 Web 引擎 做块编辑器最省事的路是塞一个 Web 引擎进去,跑现成的 Blockly。这条路被否掉了,理由很实际: 安装包会凭空涨几十兆,启动慢一截; 多一个运行时的版本问题(Qt WebEngine 的 Chromium 更新、显卡驱动兼容); 复制粘贴、字体渲染、高分屏缩放全部隔着两层,和原生控件的行为对不齐。 于是决定:原生 Qt 自绘,视觉和几何照 Blockly 移植。代价是每一根连接齿、每一段圆角都要自己算;收益是这套东西完全可控——后来做缩放时,「所有几何都在逻辑坐标里」这件事能成立,正是因为画布是我自己的。 三、布局和绘制必须分开 一开始是很朴素的一层:一个函数量尺寸、一个函数画。很快就撞墙了——插入线要落点、命中测试要知道点到哪个参数、内嵌的编辑框要贴到某个字段上,这些全都要「尺寸从哪来」。 所以最终分成三层: 层 职责 为什么不合并 block_render_info 纯几何与文案,算出一棵布局树 命中测试、插入线、内嵌控件几何全都复用它,不能只有绘制时才存在 block_drawer 只按布局树画,不改任何状态 绘制无副作用,缩放时才能只换一个变换矩阵 block_render_constants 齿高、圆角、行高、内衬这些形状常量 改一版视觉只动一处 撞墙的具体形态是「凹凸连接件不吻合」:上一版齿的曲率半径和缺口对不上,块叠起来有一条白缝。最后是对着参考实现的源码逐段校正几何参数才解决——这也是第一天晚上 20:25 那条日志的由来。 右侧的块目录直接复用了同一套绘制代码,所以「面板里长什么样」和「拖进画布后长什么样」不会有第二份实现: [image: 右侧块目录:每个条目就是一个缩小的块,带参数名与说明] 块目录的条目不是截图,也不是另画的示意图——它调用的是画布那套 block_render_info + block_drawer,只是画在一个小画布上。 四、真相只能有一个 命令表原本只有一个 displayName,那是文本模式里真实可键入的调用名,不能改。但块面上要显示中文名,右侧目录也要中文名。 一开始的写法是在块的渲染里硬编码一套中文。这套东西立刻就脱轨了:同一个命令,块面上叫「按下按键」,目录里叫「按下」,诊断里又叫「按键按下」。改一处,另两处不知道。 改成:命令表上加一个 chineseName,块面、目录、提示共用;文本模式继续用 displayName。一处声明,三处消费。 同样的思路后来用在表达式上,而且更极端: 槽里的文本是唯一真相,AST 是它的一次投影,槽文本变了才重建; 拖一个值块进来,是替换子树,不是往字符串里追加。 第二条是血的教训。最早为了省事,「把函数拖进条件槽」实现成往槽的文本里拼字符串,结果 a + 1 拖两次变成 a + 1 + 1,而且撤销回去再看,表达式树已经和文本对不上了。结构化之后这类问题整类消失:拖拽只发生在树的两颗子树之间,文本只是它的输出。 五、剪贴板:不要用文本当中间格式 Ctrl+C / Ctrl+V 的第一版想法很自然:把选中的块生成脚本文本,粘贴时再解析回来。这条路走不通,因为文本层丢了信息: 「可选参数槽未启用」和「槽里是空的」在文本里长得一样; if 分支的启用状态、被折叠的分支,文本表达不了; 往返一次,块的类型信息(哪一段是用户子程序调用、哪一段是自定义函数)就退化成函数名。 于是剪贴板走的是「整棵块树序列化」:自定义 MIME 类型 application/x-kma-blocks,内容是 JSON,带格式版本号。同时副带一份等价脚本文本——这样粘到记事本里也讲得清,从纯文本粘回来时走 parser 兜底,至少不会丢得莫名其妙。 一个可以复用的结论:块的复制粘贴不要走「块 → 文本 → 块」。文本是给人看的产物,不是传输格式。 六、那圈看不见的选中框 多选本身不难:按住 Ctrl 点一下切换选中,选中集合是个保序去重的数组,主选中恒等于第一个(粘贴位置、调色板新块都跟着它)。真正的坑在「看不见」。 选中框最初用的是主题的高亮色。逻辑上完全正确——主题换肤自动跟随。但在浅色主题下,那个高亮是淡蓝的 1px 细线,压在蓝色的块体上,肉眼几乎无法分辨。用户反馈是「按了 Ctrl 点,不知道有没有选中」。 最后改成固定配色:外圈琥珀 3px,内圈深棕 1px 做内衬,深浅主题下都压得住。教训是主题色不等于可见色,选中这种强反馈的视觉不要交给定主题去决定。 七、缩放:所有几何只能有一套坐标系 这是整个两天里最值得写的一段。 缩放最直觉的做法是「把所有尺寸都乘一下系数」。这么做会在三个地方同时崩:命中测试、拖拽落点、内嵌编辑框的位置。因为一旦有两套坐标,任何一处忘了换算,就是「看着点在 A 上、选中了 B」。 所以定了一条规矩:布局、命中、拖拽,全部在逻辑坐标里算;缩放只作用在两个入口——绘制的 QPainter::scale(),和把鼠标位置换算成逻辑坐标的那一个函数。这条规矩守住之后,缩放本身变得很简单。 真正难的是那些「看起来该跟着缩,但其实不能缩」的东西: 布局宽度取视口宽度,且与缩放无关。这条是「真缩放」和「只改字号」的分界线。如果布局宽度写成「视口宽 ÷ zoom」,那缩放只是在改字号,块永远不会横向溢出,也就永远不需要横向滚动; 内嵌的输入框和下拉框是子控件,不缩放。所以既要按缩放换算它们的位置和尺寸,又要按缩放调字号,两处都得乘; 滚动条的单位是逻辑像素。滚到一半改变缩放时,要先记住「当前视口顶端的逻辑坐标」,重排之后按这个锚点恢复,否则内容会突然跳走。 滚轮以光标为锚点缩放,也是同一个套路:算出光标下的逻辑点,缩放后反解出新的滚动偏移,让那个点停在原地。 再加两条写进代码注释的自我约束: 布局逻辑宽度有下限(560),窗口极窄时不至于把块挤成一条竖线; 缩放范围 40%~300%,一格 1.15 倍。连续滚动是乘方关系,所以是平滑的,一格一档也不会跳。 八、两个让我半夜还在查的 bug 1. 300% 缩回 100% 直接崩:0xC00000FD 现象是必崩:放大到 300% 再缩回 100%,进程退出码 0xC00000FD——栈溢出。 原因很朴素:refreshLayout() 末尾调了 resize(),而 resize() 会同步回调 resizeEvent,回调里又调 refreshLayout()。放大时内容尺寸单调增长,递归很快就耗尽了栈。 修法是加一个重入闸(refreshing_),进入布局就先置位、退出再复位,回调进来直接返回。 值得说的是为什么它没被测出来:早期的截图测试窗口尺寸是固定的,缩放也只在同一个尺寸内做,递归深度刚好没到阈值。是「在真实窗口里来回缩」这个动作把它逼出来的,不是断言。 2. 一个测试程序完全没有输出 另一个更折磨人:新写的缩放测试程序一启动就死,连 main 第一行的 printf 都没有。 排查绕了很久,最后是靠「第一行都没打印」这个线索反推的——不是逻辑崩,是进程在第一次输出之前就没了。罪魁是这一行: std::setvbuf(stdout, nullptr, _IOLBF, 0); 想把 stdout 改成行缓冲,size 传了 0。这在 MSVC 的 CRT 里会直接把进程打死。给一个真实缓冲区就好了。 记录下来是因为这条非常有欺骗性:现象是「程序什么都不做就退出」,看起来像链接错了、像静态初始化崩了、像 Qt 插件找不到,唯独不像一行日志相关的调用。 九、回归测试搬回仓库 这套东西的正确性没法靠眼睛看——块的几何、命中、嵌入、撤销,随便改一行都可能悄悄坏掉。之前这些验证散在构建目录下的临时程序里,改一次代码要手工找一遍入口。 这次把它们收进仓库,做成一件可重复的事: 一份用例清单是唯一真相(类型 | 可执行文件 | 模式 | 最少断言数 | 参数形式 | 说明),两个平台的脚本共读同一份; 三种类型:断言型(12 个,判定依据)、冒烟型(7 个,只要求不崩)、截图型(8 个,默认不跑,出图人工比对); 最少断言数是必需的防御:模式名写错会走到默认分支静默返回 0,看起来「通过」,其实是没跑; 两个平台各一个脚本,退出码统一:0 全通过 / 1 有用例失败 / 2 环境或构建失败。失败不中断,最后统一汇总。 跑通的结果是 19 通过 / 0 失败 / 8 跳过,截图模式 8/8 出了 18 张图。 跨平台脚本这部分,坑比功能代码还多: 坑 表现 处置 批处理文件存成 UTF-8 中文 Windows 上按系统代码页逐行解析,行边界错乱,报「xxx 不是内部或外部命令」 存成 ANSI/GBK 用 for /f 读 UTF-8 清单 中文重配对把分隔符吞掉,整行被静默跳过(用例凭空少三条) 先按 UTF-8 读、只取纯 ASCII 列,生成工作清单 用 find 计数 PATH 里装了 GNU find,/c 被当成 C 盘递归扫描,CPU 打满 计数交给专用脚本 shell 里 kill -0 判存活 僵尸进程仍然返回成功,每条用例都等满超时 改判进程状态里的 Z 十、148 处硬编码文案 最后一件收尾的事:英文界面下,块编辑器整片是中文。因为绘制层是命名空间里的自由函数,没有 QObject,拿不到 tr(),所以文案全是硬编码字面量。 处置分两步: 造一个只有 tr() 的壳类(Q_DECLARE_TR_FUNCTIONS),上下文固定,调用点统一写 BlockText::tr(...)。148 处字面量批量替换,只换函数名,跨行拼接的参数原样保留;替换前先确认这些字面量没有一处参与比较、持久化或生成脚本——否则翻译会让脚本跟着变语言。 重扫翻译文件、补齐译文、重新生成 .qm。结果是两边各 478 条、0 条未完成。 顺带发现两件事值得写下来: 旧翻译文件严重滞后,中文界面此前有一部分实际显示的是英文(表格列名、设备类型这些)。这次一并补上; 提取工具必须一次给全量源目录。只对单个目录跑,工具会把其余 478 条判成「已废弃」直接删掉——我被清空过两次,靠备份才恢复。这是那种「操作成功、结果正确、数据没了」的典型。 十一、时间账 下面这张表是按开发日志的推进节点回填的,不是秒表计时,误差大概在半小时量级。所谓「一轮」= 一次完整的改→编→验证→截图确认。 日期 时段 内容 轮数 10-20 12:35 起约 45 分钟 盘点 DSL、定边界、确认唯一缺口 — 10-20 下午约 4.5 小时 块模型 / 文档 / 画布 / 页面 + AST 转文本 1 10-20 傍晚约 2.5 小时 视觉移植:C 形嘴部、齿形吻合、块上直改 3 10-20 晚间约 2.5 小时 渲染层按参考源码逐段校正、拖动、撤销重做 3 10-21 上午约 2 小时 表达式结构化:值块、且/或/非、取负、拖放替换 5 10-21 中午约 3.5 小时 对齐、分隔条、右栏分类、形态开关、值块选中 5 10-21 下午约 2.5 小时 定位、右键分流、死按钮、图标定稿 4 10-21 晚间约 3.5 小时 剪贴板、多选、缩放 3 10-21 21:00–22:30 回归整合 + 两个平台的一键脚本 1 10-21 22:30–23:10 文案翻译收尾 1 合计 两个工作日,净投入约 24 小时 约 25 轮 产出的体量:33 个文件、+10617 / −539 行。其中纯功能代码大概占七成,剩下是测试、翻译资源和文档。 如果把时间按性质拆开,比例大概是这样: 类别 占比 具体是什么 写功能 ~55% 模型、布局、绘制、交互、表达式 排障 ~20% 栈溢出、隐式共享深拷贝、坐标没换算 构建与验证 ~15% 编译、跑回归、看截图、来回缩 测试与文案 ~10% 用例、脚本、翻译 十二、回头看 真正花时间的从来不是「把块画出来」。画块是第一天的下午就完成的事。 耗时间的是三件事: 坐标系。只要有两套坐标,就一定会有一处忘了换算。把它压到一套,缩放从「到处乘以系数」变成了两个入口的改动。 真相只有一个。块的文案、槽的文本、剪贴板的格式,每一处都有「省事的双份实现」诱惑,而每一处双份最后都脱轨了。 验证要能重复。改一行就可能悄悄坏掉的模块,靠眼睛看是靠不住的;把验证做成一条命令,才有勇气去动第二十五轮。 至于「两天」这个数字——它更像两天 × 大约十二小时,中间还有不少时间花在等编译和重跑回归上。真要说有什么经验,是那条最初的红线救了整件事:图形化只是入口,不碰编译链路。守住这条线,才敢在两天里迭代二十五轮。 本文涉及客户名称、内部路径、内网地址与版本标识的细节已做脱敏处理。