适用系统：Windows 10 / 11（64 位） 大小：11.2 MB 环境：无需安装，无需 Python，解压即用 更新：2026-10-31
| 文件名 | 光源控制器上位机_v2.0.zip（内含 光源控制器上位机.exe 单文件程序 + 上位机使用说明.md 完整说明书） |
|---|---|
| SHA-256 | 4187597f25f6864fbeb1e6c3e48fc99b35cdd321a826f4908451da3150eecb1c |
| 配套硬件 | STM32F103C8 视觉光源控制器（4 路通道，RS232，115200 8N1）；其它说这套 ASCII 协议的设备也能直接用 |
一、这是什么
配合 视觉光源控制器使用的 PC 端调试工具。它把海康机器视觉光源的 ASCII 通讯协议做成了可视化界面：拖动滑条调亮度、切换常亮/触发/频闪三种模式、配置去抖与延时、设置定时开关与连闪参数，并且能实时读取每一路的触发输入电平、输出电平和通道电流。
所有参数改动由固件在 500ms 后合并写入设备 Flash，断电不丢；界面右下角的通讯日志完整记录每一条收发报文，可以保存下来做问题定位。程序内置两份文档：帮助按钮是精简版使用说明，协议按钮是全部命令速查表，不需要另外翻 PDF。
二、功能一览
| 板块 | 能做什么 |
|---|---|
| 通道控制 | 4 路独立开关（总闸）、亮度 0~255 滑条、常亮 / 触发 / 频闪模式切换，回包自动回填界面 |
| 触发设置 | 去抖时间（0~1000ms）、触发延时（0~1000ms）、输入电平反转、当前输入电平实时读取 |
| IO 设置 | 输出电平反转、信号源选择（on 常通 / in 外部触发 / timer 定时 / off 强制关）、当前输出电平读取 |
| 定时设置 | 点亮时长与熄灭间隔，单位微秒（4~8 位数字，量程到 30000000us） |
| Burst 设置 | 连闪次数（1~1023）、频闪触发源（软件 / 外部信号）、触发边沿（上升 / 下降）、软触发按钮 |
| 风扇 / 电流 | 散热风扇开、关、状态回读；4 路通道电流采样回读（原始 mV + 自定义换算系数得 mA），支持 1 秒自动刷新 |
| 系统管理 | 立即保存参数到 Flash、恢复出厂设置、读取通道数量 |
| 手动命令 | 直接输入任意协议字符串发送，方便验证新命令和抓包 |
三、界面截图
四、快速上手
- 解压到任意目录（不要只双击压缩包里的 exe 运行，先解压出来），双击
光源控制器上位机.exe。 - 接好设备的 RS232 或 USB 转串口线，装好 CH340 / CP2102 驱动，点界面上的刷新，选择对应 COM 口，波特率保持
115200，点连接。 - 连接成功后程序会自动发
SZ#读通道数。先在光源通道控制里勾上某一路的“开启”（这是通道总闸，关掉后任何模式都不亮），拖亮度滑条后点设置亮度，灯应当就亮了。 - 要做频闪：把该通道模式选成频闪，信号源（IO 设置里的 SM）选
in，Burst 页把触发源（SV）设为in，再设连闪次数 SR 与间隔 SP，然后拉一次触发端子或点软触发。
更多细节——触发时序、面板三态（oFF / --H / --L）的含义、电流换算系数怎么标定、以及一张按现象索引的排障表——都在包里的 上位机使用说明.md。
五、通讯协议速查
主机发送格式：S<功能符>[通道字母+数据]…#，全 ASCII；设备回包没有起始符和结束符，例如 SLA0100# 回 LA0100。数据字段定宽 4 位十进制，前导零不能省（只有 SO / SP 放宽到 4~8 位）。本机 4 路：A=CH1、B=CH2、C=CH3、D=CH4。
| 功能符 | 作用 | 示例 |
|---|---|---|
| L | 亮度 0000~0255 | SLA0128# → LA0128 |
| W | 通道总闸 0000=开 0001=关（数值和直觉相反） | SWA0000# → WA0000 |
| T | 模式 0 常亮 / 1 触发 / 2 频闪（不带字母=4 路统一） | STA0002# → TA0002 |
| G / H | 触发去抖 / 触发延时，单位 ms，上限 1000 | SGA0100# → GA0100 |
| I / J | 输入电平反转 / 只读当前输入逻辑电平（已含极性） | SJA# → JA0001 |
| K / M / N | 输出电平反转 / 信号源 on·in·timer·off / 只读当前输出电平 | SMA0001# → MA0001 |
| O / P | 点亮时长 / 熄灭间隔，单位 us（4~8 位数字） | SOA0600# → OA0600 |
| R / V / Y | 连闪次数 1~1023 / 频闪触发源 软件·外部 / 触发边沿 上升·下降 | SVA0001# → VA0001 |
| X | 软触发一次 | SXA0001# → XA0001 |
| F | 散热风扇（全局，本项目自定义）0001=开 0000=关 | SF0001# → F0001 |
| Q | 通道电流采样，只读（本项目自定义），回的是采样引脚电压 mV | SQABCD# → QA0123B0456C0789D3300 |
| Z / U | 读通道数 / 0000 立即存 Flash·0001 恢复出厂 | SZ# → Z0004 |
参数非法时回 <功能符><通道>XXXX 且该条命令不执行；量程越界不报错，固件限幅后回“实际生效值”。
六、常见问题
| 现象 | 怎么办 |
|---|---|
| 双击 exe 一两秒才出窗口 | 正常。单文件版每次启动都要解包到临时目录，不是卡死 |
| Windows 提示“已保护你的电脑”／杀软报警 | 程序未做代码签名，属正常提示，确认来源后点“仍要运行”即可 |
| 双击后完全没反应 | 程序无控制台，崩溃信息会写到 %TEMP%光源控制器上位机.error.log，先看这个文件 |
| 串口列表是空的 | 装 CH340 / CP2102 驱动，插拔一次后点“刷新” |
| 设了亮度灯不亮 | 按优先级查：通道“开启”总闸 → 信号源 SM 是否为 off → 触发/频闪模式下有没有有效触发（看 SJ 电平）→ 亮度是否为 0 |
| 频闪拉端子不闪 | 频闪的外部边沿要过 SV 这道门，SVx0000（software）时只认软触发，改成 SVx0001 |
| 电流读数看不懂 | 固件回的是采样引脚电压 mV，不是 mA，需要在“通道电流监测”里按实测标定填换算系数；灯灭时 0~3mV 跳动是 ADC 噪声本底 |
七、关于“网站提醒”功能
程序支持在启动时从本站拉取一行提醒字幕显示在最底部状态栏。公开下载包里不含 notice_config.json（里面有接口密钥，只随内部版本发放），所以下载版不会发起任何网络请求，其余功能完全不受影响。需要这个功能的用户，把配置文件放在 exe 同目录即可开启。
八、版本记录
- v2.0（2026-10-31）：打包为免安装单文件 exe；新增散热风扇与 4 路通道电流读取（自定义
SF/SQ命令）；新增内置“协议”速查窗口；网站提醒改为状态栏单行字幕；触发模式与面板三态语义对齐固件；SO / SP 数字字段放宽到 4~8 位。 - v1.x：4 通道亮度与开关、三种模式、触发/IO/定时/Burst 参数面板、手动命令与通讯日志。
使用问题、协议扩展需求，欢迎在本文下方留言。