Signal Dock

在 Windows x64 版 VS Code 中连接嵌入式设备、查看实时波形、调整设备参数及持续记录 CSV。工作区保存连接设置、命令树、通道属性和画布。

安装与开始

1. 在 VS Code 扩展视图选择 从 VSIX 安装，选择 signal-dock-win32-x64.vsix。需要 VS Code 1.100 或更新版本。
2. 从活动栏打开 Signal Dock，点 运行 Demo。也可从命令面板运行 Signal Dock: 打开工作台。
3. 工作台会自动扫描串口并优先选中唯一的 USB 串口。多个候选设备时在顶部下拉列表中选择。设置波特率与协议后点 连接。数据位、校验、停止位和流控可在连接设置中调整。

工作台

• 顶部切换串口、TCP Client、TCP Server、UDP 或 Demo，以及 RawData、FireWater、JustFloat 解码器。Demo 可生成波形，也可播放包含 CSV 或 JPG 的目录。
• 串口列表会在插拔时刷新，显示设备名称和 COM 号。工作台记住已选设备的硬件标识，系统重新分配 COM 号后可重新识别。
• 拖入控件或点击控件库添加。右键设置通道和命令。标签可复制、锁定、分屏，也可拖到 VS Code 浮动编辑器窗口并使用其置顶开关。
• 在右侧实时通道列表勾选要显示的曲线，也可全选或全不选。多张波形图可从同一区域切换，每张图独立保存通道选择。
• 波形图内滚轮缩放双轴，坐标轴上滚轮只缩放该轴。拖动平移，点击 Auto 恢复自动量程并跟随实时数据。鼠标悬停时，图内显示虚线对应的时间及各通道数值。
• 界面默认按显示刷新节奏合并绘制，可在 视图 → 外观与性能 设置 1–240 FPS 上限。采样速度仍由设备或 Demo 数据源决定。
• 底部查看 RX/TX、Hex、ANSI 样式、编码与发送历史。发送支持换行、重复、文件及命令组。命令模板示例为 set:%.2f,%d 和 FA FB %% FB FA。
• 拖动时间轴回看缓冲区。显示增益和偏置只作用于显示。记录持续写 CSV，文件 → 导出采样 CSV 保存当前缓冲区。设备采样间隔需通过 Δt 配置，带时间列的导出使用名义时间。
• 文件 → 载入配置 / VOFA+ 1.3 可导入扩展自身的备份或 VOFA+ 1.3 的 vnumber: 100 JSON。迁移时，旧独立窗口转换为工作台标签。

自定义扩展

其他 VS Code 扩展可以激活 MYFSillyBa.signal-dock 并调用导出的 registerDecoder(name, factory)。工厂按对端创建解码器，接收可选的 expectedChannels，返回 push(Buffer) 和可选的 flush()。数值帧形状为 {kind: 'sample', values, bytes}，图片帧为 {kind: 'image', id, width, height, format, data, bytes}。注册返回可释放对象。

在可信工作区，从 视图 → 协议和控件扩展 定义 JavaScript 控件。沙箱提供 output、onSamples(callback) 和绑定命令后的 send(params)。原 VOFA+ Qt 插件需要迁移到这些接口。

本地构建

npm ci
npm test
npm run build
npm run package

协议参考 VOFA+ 1.3 文档。工作区和数据流设计参考 Lissio，本扩展独立编写。