在浏览器里直接调设备。
串口 · WebUSB · WebSocket · MQTT · Modbus RTU · HART · 自定义协议
![]() AOMaster 4-20 mA / 0-10 V 6 种波形 |
![]() HART 通用仪表调试 PV / SV / TV / QV |
![]() WebSocket JSON / HEX / Modbus 实时曲线 |
![]() MQTT 发布 / 订阅 · QoS 保留消息 · 统计 |
浏览器里的设备调试台,纯静态前端,没有上位机要装、没有后端要起。打开网页、选设备、连上,就能看原始报文、手动发命令、看实时曲线。
一个标签页,一根线,跟设备直接对话。
适用场景
- 临时调一块 Modbus RTU 板子,不想装厂家几百 MB 的上位机
- 进车间带个 HART 调制解调器,笔记本插上就是 HART 调试工具
- 新设备走 WebSocket 或 MQTT,想边看流量边看曲线
- 把链接发给同事,比发
setup.exe省事 - 内部协议没有现成工具,在 自定义设备 页面拖控件搭一个上位机,不用写代码
不适合长时间数据采集、生产监控或 SCADA,这是个调试工具。
| 设备 | 传输 | 默认参数 | 说明 |
|---|---|---|---|
| Modbus RTU | 串口 | 9600 8N1 | 读写保持 / 输入寄存器 |
| HART | 串口 | 1200 8O1 | 设备搜索、通用命令、PV/SV/TV/QV、仪表设置与校正 |
| WebSocket | WebSocket | — | JSON / HEX / Modbus 报文调试 |
| MQTT | MQTT over WS | — | 发布订阅、QoS、保留消息、统计 |
| AOMaster | 串口 | 115200 8N1 | 4-20 mA / 0-10 V 信号源 |
| MicroScope Power | WebUSB | — | 小电流波形采集(硬件 · 固件) |
| 自定义设备 | 串口 / WebSocket / MQTT(画布上的链路卡片) | — | 拖拽画布,控件绑定协议、发送命令;.uidp 工程 |
切换设备时,通讯方式和默认参数会跟着切换。
- 收发调试:毫秒时间戳,HEX / 文本显示切换,暂停滚动,收发字节统计,日志保存为 .txt。
- Modbus RTU:一问一答收发,超时与异常码诊断;寄存器表支持 16 / 32 位整数和 Float32 等多种格式。
- HART:地址扫描、通用命令、PV/SV/TV/QV 轮询,仪表参数设置与输入输出校正;应答超时和响应码诊断,写操作发送前确认。
- 自定义设备:和 FluentHMI Studio 一样的拖拽画布。按钮、开关、滑块、数值显示、仪表盘、指示灯、实时曲线等控件按键值、JSON 路径、HEX 字节或 Modbus 寄存器取值(可加换算表达式),按文本、HEX、JSON 或 Modbus 发命令;串口、TCP(经 WebSocket)、MQTT 链路卡片在画布上配置和连接,可放多张,Modbus 绑定自动轮询;数据接收、数据发送、日志也是卡片。工程存成
.uidp,能在 FluentHMI Studio / PyQt UI Designer 中打开,也能导入它们的工程。 - 实时曲线:多曲线显示,CSV 导入导出。
- 其它:中英文界面、深浅色主题。
首页的"桌面软件"一栏介绍这几款软件,每款都有自己的官网:
| 软件 | 官网 |
|---|---|
| HARTLink Studio · HART 主站与 DD 设备调试 | https://hart.modusignal.cn/(附 HART 知识库) |
| Fluent 串口助手 · 串口调试、协议解析与 AI 控制 | https://serial.modusignal.cn/ |
| FluentHMI Studio · 拖拽做上位机(附 Python 版 PyQt UI Designer) | https://hmi.modusignal.cn/ |
| PageBridge · 原页版式的 PDF 阅读与翻译 | https://pagebridge.modusignal.cn/ |
本站原先的软件介绍页、教程和 HART 知识库已经搬到上面这些站点,旧地址由 _redirects 跳转过去。
开发时不用构建,起一个静态服务即可:
python3 -m http.server 4173用 Chrome / Edge 打开 http://localhost:4173。
构建线上版本:
npm install
npm run build
npm run preview构建脚本是 scripts/build.mjs(基于 esbuild),产物在 _site/。网站部署在 Cloudflare Workers(wrangler.jsonc),构建后运行 npx wrangler deploy;本仓库不发 Release。
| 功能 | 浏览器 |
|---|---|
| 串口(Web Serial) | Chrome / Edge 89+,需要 HTTPS 或 localhost |
| WebUSB | Chrome / Edge,需要 HTTPS 或 localhost |
| WebSocket、MQTT over WebSocket | 现代浏览器均可 |
Firefox 和 Safari 不支持 Web Serial / WebUSB,串口和 WebUSB 设备用不了,其它功能正常。
设备层和传输层分开:加一个新设备通常就是在 src/devices/ 写驱动、在 src/device-registry.js 注册、在 pages/devices/ 加页面。
CONTRIBUTING.md:添加设备的步骤docs/architecture.md:模块分层DESIGN.md:界面设计规范AI.md:各设备的协议约定与实现说明
测试:npm test。
workers/cos-download-proxy/ 是 download.modusignal.cn(HARTLink Studio 安装包与更新清单的下载代理),单独部署。
项目在持续迭代。需要新设备但不方便自己写驱动的,提一个 issue,附上协议文档、报文样例和默认连接参数即可。也欢迎 PR 增加设备或修复驱动。
如果 modusignal 帮你省下了一个下午跟厂家上位机较劲的时间,点个 star 能让更多人看到它。
by 飞起小鹏 · modusignal.cn




