Skip to content

About

浏览器端工业设备调试平台:串口、WebUSB、WebSocket、MQTT、Modbus RTU、HART 与自定义协议。

Topics

Resources

Contributing

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

modusignal

在浏览器里直接调设备。
串口 · WebUSB · WebSocket · MQTT · Modbus RTU · HART · 自定义协议

在线使用 License Stars Issues Last commit

中文 · English · 立即使用 → · 请求设备

modusignal 演示

AOMaster
AOMaster
4-20 mA / 0-10 V
6 种波形
HART
HART
通用仪表调试
PV / SV / TV / QV
WebSocket
WebSocket
JSON / HEX / Modbus
实时曲线
MQTT
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/ 加页面。

测试:npm test。

workers/cos-download-proxy/ 是 download.modusignal.cn(HARTLink Studio 安装包与更新清单的下载代理),单独部署。

参与

项目在持续迭代。需要新设备但不方便自己写驱动的,提一个 issue,附上协议文档、报文样例和默认连接参数即可。也欢迎 PR 增加设备或修复驱动。

许可证

Apache License 2.0。

如果 modusignal 帮你省下了一个下午跟厂家上位机较劲的时间,点个 star 能让更多人看到它。


by 飞起小鹏 · modusignal.cn

About

浏览器端工业设备调试平台:串口、WebUSB、WebSocket、MQTT、Modbus RTU、HART 与自定义协议。

Topics

Resources

Contributing

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages