设备说明书里的串口指令，怎样整理成可移交的联调样本

把手册里一行控制指令复制到中控配置中，发送成功并不意味着下一位工程师能复现。样本如果缺机型、串口参数、结尾字节和预期回复，交接后依然要从头试。真正可移交的不是一张命令截图，而是有出处、有线上字节、有结果判据的一份记录。

本文给ESC/VP21 指令样本 JSON和本地字节核验脚本。它们依据 Epson 官方文档演示 PWR ON 的编码，但未绑定具体现场机型、未连接任何串口，也不应直接导入生产中控批量执行。

样本先写适用范围

文件里的 target_model 故意标为待核对，execution_allowed 为 false。接手人先到实际机型支持页确认 ESC/VP21、物理接口、手册版本与参数，再建立自己的设备样本。不同 Epson 产品可能支持不同功能，更不能把这个例子当成其他品牌商显的通用指令。

与已有电视 RS232 指令速查不同，本文不新增一份跨品牌码表；只教怎样把某条有官方出处的命令转成能验收的交付材料。旧文中的经验重试间隔也不自动迁入新样本，时间限制必须另查适用手册。

文字、编码和结尾各占一个字段

Epson 对应手册列出 PWR ON，并要求命令尾部附 CR（0Dh）。在 ASCII 编码下，演练的线上字节为：

50 57 52 20 4f 4e 0d

这里的20是空格，0d是结尾回车。把这个十六进制展示串作为普通文字再次发送，线上就会变成“5”“0”“空格”等字符，和原命令不同。JSON 中同时保存 command_text、encoding、terminator_hex 和 tx_hex，脚本重新编码并断言两者一致，能在不接设备时先排除交付材料自身的错误。

回应不能只匹配一个冒号

Epson 说明正常处理后返回冒号，并且异常处理时也可能先输出错误信息、再返回冒号。因此“收到了冒号”不能单独作为开机成功判据。样本保留 error_text、原始响应与后续状态确认，把“处理结束”和“目标已实现”分开。

示例脚本用两组本地文本验证：单独的冒号与包含错误文本的冒号必须区分。它不是完整设备应答解析器，真实串口可能分段到达，读取边界和设备回显要再按协议实现。不要直接把一次 read 返回的内容当成一条完整回复。

给参数、接线和时序补上出处

样本需要记录波特率、数据位、校验、停止位、流控、接口类型与针脚图的手册页。本文不在缺少实际机型时填入某组“通用默认参数”；空白是待核对项，不是默认9600。RS232、TTL电平及不同接头不能只看外观判断，也不应靠随机短接来碰运气。

操作记录另写设备当时状态、执行人、授权窗口、发送与接收时间。开关机、切信源等会影响现场运行，先在获准的测试环境完成；样本 JSON 默认不可执行，是为了避免把教程附件误当现场控制配置。

验收与移交怎么完成

接手人在授权条件下，用已核实参数发送一条命令，保留发送字节与完整回复；再按该机手册的查询方式或现场测试画面确认目标。验证失败时记录原结果，不把“可能是冷却中”直接改成成功。最终将 target_model、手册版本、参数与真实观察补齐，由负责人员确认是否允许用于控制。

文件传给第二位工程师后，先让对方本地跑字节核验，再做设备复现。如果两人编码的字节一致但设备结果不同，继续比较连接、状态和时序；如果字节已经不同，就先修交付样本。这样能把材料错误与设备差异分开，不必反复争论“我这边发的是同一句话”。

常见问题

脚本通过就说明设备兼容吗？ 不说明。它只验证本地命令编码与样本一致，设备型号与运行结果仍未验证。

命令末尾应该加 CRLF 吗？ 本文所引 Epson 页面要求 CR。若具体设备手册不同，应按对应文档建立另一份样本，不能无依据额外加字节。

能把这份样本当下载即用配置吗？ 不能。附件明确禁用执行，现场机型、串口参数、授权与回应判据补齐后才可另行核验。

核对依据

核对日：2026-10-23。Epson ESC/VP21 命令表用于命令及CR；Epson 协议说明用于异常文本与冒号的区别。样本未完成任何真实设备联调。