TofuTrans 串口协议转换网关
TofuTrans 将外部控制设备的 TSER 串口指令转换为 TJSON 网络消息，并将 Tofu6 的目标信息沿原链路返回。本资料介绍板卡接口、接线方式和配套网页的配置及维护操作。
硬件 A4.8-JLC｜50 × 55 mm 四层板｜双面贴装｜STM32H743VIT6 主控｜LAN8720A 以太网
功能介绍
通信链路：外部设备或电脑 ⇄ TTL1 / TSER ⇄ TofuTrans ⇄ TCP / TJSON ⇄ Tofu6。
当前 2.0.1 固件支持 AI 模式、点选及波门跟踪、显示模式和 VISCA / PELCO-D / VISCAIR 透传转换。网页提供串口与网络配置、收发计数、实际回传状态、日志查看和网络升级。
接口与接线
J1 电源：1 = +12V，2 = GND。
J2 ETH1：1 = TX-，2 = TX+，3 = RX-，4 = RX+。板端是 4 针以太网接口，需按引脚转接到网口。
J4 / J7 / J8 对应 TTL1 / TTL2 / TTL3：1 = GND，2 = TX，3 = RX。
J5 RS485：1 = GND，2 = A，3 = B。
J9 RS422：1 = TX+，2 = TX-，3 = RX+，4 = RX-，5 = GND。
J6 SWD：1 = 3V3，2 = SWDIO，3 = SWCLK，4 = GND，5 = NRST。
引脚均按 PCB 焊盘编号列示。接外部 3.3V TTL 设备时，对方 TX 接 TTL1 的 RX，对方 RX 接 TTL1 的 TX，GND 共地。
本说明的 2.0.1 固件使用 TTL1 / UART1；TTL2、TTL3、RS485 和 RS422 的协议及通道使用需配套固件支持。
首次登录
1. 接线并供电，将电脑配置为与板卡同一网段，例如 192.168.1.100 / 255.255.255.0，避免 IP 冲突。
2. 浏览器打开 http://192.168.1.218/。初始用户名 admin，初始密码 12345678。
3. 忘记板卡 IP 时，使用 TofuTrans 搜索工具查找。搜索工具可发现同一二层局域网中的板卡；网页访问仍需电脑具有正确路由或同网段 IP。
配置串口和网络
4. 在“协议与串口配置”设置 TSER、波特率和地址。默认 9600 / 8N1 / 地址 1；支持 9600、19200、38400、57600、115200，地址范围 1-15。点击“保存串口配置”后立即生效。
5. 根据控制对象选择“TSER 透传目标”：可见光选 VISCA，云台选 PELCO-D，红外选 VISCAIR。出厂默认可见光 VISCA，控制云台前需改为“云台 · PELCO-D”。
6. 在“板卡静态 IP”修改板卡自身地址。默认 IP 为 192.168.1.218，子网掩码 255.255.255.0，网关 192.168.1.1。点击“保存网络并重启”后，用新 IP 重新访问。
7. 在“Tofu6 连接配置”填写目标设备地址，默认 192.168.1.211:8089，启用自动连接，点击“保存并重新连接”。板卡自身 IP 与 Tofu6 的目标 IP 是两项独立设置。
查看通信与实际回传
网页可查看串口及 TJSON 收发计数、校验错误、超时、不支持次数，以及设备实际回传的水平角、俯仰角、AI 工作模式和可见光倍率。
网页 LED1 表示 Tofu6 的 TJSON TCP 已连接。LED2 在收到有效 TSER 帧后点亮，3 秒无有效数据后熄灭，表示通信活动，并非 TTL 物理插线检测。
串口成功应答表示网关已校验并送达网络端，不能单凭应答判断机械动作完成，应结合实际回传状态确认。
日志 账号和网络升级
日志：在“接收数据打印”选择全部帧、仅 TJSON 或仅串口 TSER，可暂停滚动、清空显示并导出日志。板内保留最近 64 帧，每帧最多预览 768 字节；网页最多保留 500 条，不作永久存储。
账号：输入当前密码、新用户名及新密码，点击“保存账号”，然后重新登录。用户名支持字母、数字、下划线和短横线；新密码为 8-63 字节。
升级：在“网络升级”选择适用于 TofuTrans 的 .tfw 包，点击“上传并升级”。上传完成且校验通过后重启安装，保留 IP、串口配置和账号；升级成功后重新登录。上传中断或校验失败，可重新上传。
使用范围：图像二进制按长度接收并跳过，不解析、不保存。网页操作依据现有 2.0.1 工程；A4.8 首板的硬件适配、晶振起振和整机功能仍需实机验证。