一、工具定位
LEDToolH是一套面向海佳彩亮LED 显示屏控制系统的专业配置与运维客户端,用于完成从「点亮一块屏」到「日常维护一块屏」的全链路工作:
| 环节 | 覆盖内容 |
| 点屏 | 箱体排布、网口连线、分辨率计算、灯板走线配置 |
| 调效果 | 亮度、色温、Gamma、色彩标准、护眼、节能 |
| 校色 | 屏体校正、拼缝校正、低灰/亮色度/多灰阶校正、校正文件管理 |
| 运维 | 接收卡状态监测、误码率检测、开路侦测、一键换卡、固件升级 |
| 保障 | 网口备份(主备切换)、定时开关机、除湿、配电柜与传感器配置 |
软件采用 Electron 桌面架构,底层调用海康自有原生库(LEDRecvCard、configDLL6619、HCNetSDK 等)直接与发送卡/接收卡通信,不经过浏览器。该工具同样适用于海康威视的LED控制系统调式。
二、安装与运行
安装包
压缩包内含两个安装程序,按需二选一:
| 文件 | 语言 | 大小 |
LEDToolSetupV2.3.0.55build260305_ZH.exe |
中文 | 约 135 MB |
LEDToolSetupV2.3.0.55build260305_EN.exe |
英文 | 约 135 MB |
安装要点
- 默认安装路径:
C:\Program Files\LEDToolHA\client\
- 安装过程会附带安装 WinPcap(网络抓包驱动)。误码率检测与网络压力测试功能依赖它,不要跳过,否则相关检测项无法使用。
- 安装完成后,程序在
C:\Program Files\LEDToolHA\下生成client(程序本体)与userData(运行日志)两个目录。
运行环境要求
- Windows 64 位系统
- 与 LED 屏控制器(发送卡)处于同一局域网,且网络互通
- 首次运行会自动向服务端检测新版本;软件默认开启自动更新提醒
三、界面结构
顶部为菜单区,菜单按「配置 → 控制 → 优化 → 运维」的业务顺序分为四组:
| 一级菜单 | 二级菜单 | 作用 |
| 屏幕配置 | 点屏配置 | 箱体排布与网口连线,生成并下发点屏配置 |
| 接收卡配置 | 回读/下发接收卡参数,配置灯板与箱体 | |
| 画面控制 | 信源管理 | 输入源与输出窗口管理(分辨率、缩放、裁剪、音频) |
| 内容控制 | 窗口、图文、视频素材编辑与播放 | |
| 显示优化 | 显示效果 | 亮度、色温、Gamma、色彩标准、节能与护眼 |
| 校正 | 屏体与拼缝校正,校正文件的上传导出 | |
| 设备运维 | 屏幕运维 | 接收卡状态监测、误码检测、换卡与升级 |
| 备份 | 网口备份与主备切换 | |
| 配置 | 设备级配置(网络、传感器、配电柜、定时计划等) | |
| 维护与安全 | 维护模式与安全相关设置 |
重要提示:菜单中「画面控制 / 显示优化 / 设备运维」三组仅在 在线工程 下可见;切换到 离线工程 时这三组会自动隐藏,仅保留「屏幕配置」下的点屏与接收卡配置。
四、核心模块说明
1. 点屏配置(screenConfiguration)
负责把物理箱体「摆」到屏幕画布上。
主要功能
- 屏幕箱体库:管理箱体配置文件,可从云端加载、从文件加载、从屏幕区域加载,或新增箱体
- 画布排布:拖拽画布、左键放置箱体、长按左键拖拽创建阵列、右键或 ESC 结束
- 网口连线:按发送卡网口逐条建立箱体走线,可指定网口连线方向(U 型 / Z 型)
- 创建规模:一次性生成整墙行列结构,适合规则屏
- 箱体微调:箱体旋转(含旋转微调)、走线反序、反扫、转置、多折
- 接收卡自测:纯色 / 灰阶渐变 / 线条三种测试图,用于点亮验证
画布操作快捷方式
| 操作 | 方式 |
| 缩放 | Ctrl + 鼠标滚轮 |
| 拖动画布 | 长按鼠标右键或中键拖动 |
| 放置单个箱体 | 左键单击 |
| 创建阵列 | 长按左键拖拽 |
| 创建连线 | 长按左键拖拽;Shift + 点击起点与终点 |
| 结束当前操作 | 右键 / ESC |
保存前软件会强校验:箱体是否构成完整矩形、连线是否全部完成、坐标是否越界、分辨率是否在设备能力范围内、灯板序列号是否正确。任一项不通过都会给出明确提示,不会静默保存。
2. 接收卡配置(dataConfiguration)
处理接收卡底层参数与灯板/箱体配置文件生成。
主要功能
| 功能 | 说明 |
| 回读 / 导入 / 导出 | 读取接收卡当前参数,或导出为配置文件供备份、复制使用 |
| 参数配置 | 时序参数、效果参数、高级参数(性能、行译码、灰度、Gamma、消隐、电流增益等) |
| 智能点屏 | 以灯珠像素为单位适配模组硬件参数,无配置文件时点亮模组的兜底手段 |
| 箱体构造 | 以模组为单位重排数据,适配物理布局,支持带载变化与级联 |
| 数据组交换 | 带载不变前提下按数据组重排,解决画面错位 |
| 模组交换 & 级联 | 以模组为最小单位改排布顺序,适配所有带载变化场景 |
| 描点 | 按大屏实际显示逐点描出灯位(有灯描点、无灯空点),用于异形/抽行灯板 |
| RGB 调整 | 红绿蓝三通道分别测试并填入结果,修正偏色 |
| 视芯工具 | 高级芯片参数调试(时序/效果/高级参数面板) |
| 平替芯片对照表 | 不同驱动 IC 之间的替代关系查询 |
| 接收卡调试 | 基础配置 / IC 配置 / 用户配置 / 独立配置 / 通用配置 / 驱动 IC 配置 / 开路侦测配置,含 DMA 读取与监测 |
| 点屏环境一键部署 | 自动完成控制器侧(帧频、分辨率、开窗、1×1 屏幕下发)与 PC 侧(复制模式、100% 缩放)准备 |
离线模式:无设备在线时也可进入离线模式制作配置文件,需登录并选择产品型号与接收卡型号,离线制作的文件可导出到本地或屏幕箱体。
3. 信源管理(输入输出管理)
| 分区 | 可调项 |
| 输入管理 | 源列表、输入分辨率、帧率、位深(8Bit/10Bit)、色彩空间/采样、色域、量化范围、动态范围 |
| 输出管理 | 输出宽高、输出预览、缩放模式(点对点 / 全屏缩放)、画面裁剪(自由 / 约束比例)、帧频自适应 |
| 音频 | 音量开关与大小 |
| 3D 处理 | 左右图像合一、上下图像合一、左右眼交替、发射器延时、左右眼优先 |
| 多屏同步 | 信号源列表、同步锁定、相位偏移(角度 / 分数 / 行数 / 像素) |
| 其他 | 回读画面(抓图)、U 盘播放开关 |
4. 内容控制
编辑与调度屏幕内容。
- 窗口管理:新增 / 显示 / 隐藏 / 锁定 / 置顶 / 置底、窗口手动调节与快速设置
- 素材:视频与图片导入,支持列表轮巡、单素材轮巡、播放时长、轮巡方式、切换间隔、画面契合度
- 图文:字体、字号、行间距、对齐方式、字色、背景色、背景图
- 测试图:纯色、灰阶渐变、线条,用于现场快速验屏
5. 显示效果(displayEffect)
| 维度 | 可调项 |
| 亮度 | 自动调节 / 手动调节、亮度数值 |
| 视觉 | 护眼模式、动态节能、热力补偿(可导入热力补偿文件) |
| 色彩标准 | 常规、文稿、广告、视讯、HDR、影院、会议、安防、DCI 影院、自定义 |
| 色域 | BT.2020(鲜艳)、BT.709(淡雅)、DCI-P3(柔和)、sRGB(通用)、标准色域、目标色域、实际色域 |
| 色温 | 暖 / 冷 / 标准 自定义调节 |
| Gamma | Gamma 系数、Gamma 表(图表 / 表格视图)、对比度(弱/中/强) |
| 低灰优化 | 超低灰控制、灰度优化、起始亮度等级、起始亮度值 |
| 文件 | 导入色彩文件、添加色彩文件、恢复预设 |
6. 校正(adjust)
| 校正类型 | 适用 |
| 屏幕校正 | 整屏色差补偿 |
| 拼缝校正 | 箱体之间的接缝色差 |
| 低灰校正 | 低灰度区域的偏色 |
| 亮色度校正 | 高亮度区域的色偏 |
| 多灰阶校正 | 多级灰阶整体校准 |
配套能力:显示灯板、灯板加载、文件校正、手动校正、上传校正文件、导出校正数据与校正文件、云端加载校正文件、快速定位、屏幕检测、异常详情查看。
手动调节系数为累乘关系:原始系数 a,第一次调 1.2,第二次调 1.1,最终为 a × 1.2 × 1.1。 清空校正数据会导致显示异常,操作前会二次确认。
7. 屏幕运维(screenOperation)
设备健康监测与故障处理的主入口。
| 功能 | 说明 |
| 屏幕运行状态 | 接收卡在线状态、异常设备与异常类型(接收卡掉线、温度异常、电压异常、电源模组异常、接收卡连接异常) |
| 接收卡详情 | 序列号、类型、版本、位置、寄存器地址、控制器类型与版本、网口地址 |
| 可维可测 | 误码率统计、误码详情、网口累计/新增误码、清零 |
| 网口使用率 | 网口状态、带载模式(标准带载 / 迷你带载) |
| 网络压力测试 | 对全屏接收卡压测,输出误码率报告(建议 30 秒,测试期间屏幕会显示异常) |
| 开路侦测 | 检测坏灯导致的十字架现象;修灯时需关闭开路侦测 |
| 一键换卡 | 换卡后一键补回配置 |
| 差异展示 | 屏参差异展示、程序差异展示,快速区分同屏内配置不同的接收卡 |
| 升级 | 接收卡程序升级、整机升级、在线 / 离线两种方式 |
| 导出 | 接收卡配置、接收卡程序、可维可测数据、热力补偿、色彩文件(均仅支持单卡导出) |
| 定位 | 异常定位、接收卡位置查询 |
8. 备份(backup)
保障链路可用性的关键功能。
- 网口备份:指定主网口与备份网口,主链路故障时切至备卡
- 设备备份:主设备与备份设备绑定,支持「切换主备」与「强制切换至备卡」
- 约束:备卡所绑定的子设备必须已添加到同一屏幕,否则无法建立绑定
9. 配置(configuration)
设备级配置项,涵盖:
| 分类 | 内容 |
| 系统 | 系统配置、串口配置、用户管理、网络、信号配置、个性化、工作模式、带载模式、存储管理 |
| 传感 | 传感器配置、外接传感器、多功能卡信息、通道 ID |
| 环境 | 箱体/屏幕电压检测、温度检测、环境温湿度检测、发送卡温度检测、自动除湿(按地区湿度档位) |
| 电源 | 配电柜开关与状态、电源通路、定时开关机、自动休眠、亮度降低时间 |
| 亮度 | 自动亮度配置、光感 / 人体感知、亮度策略表(线性 / 阶梯调节)、光口配置、维护模式 |
| 屏幕 | 级联和自拼接(屏幕级联、屏幕自拼接) |
| 计划 | 定时计划(定时开关机)、OSD 提示时间 |
10. 维护与安全
维护模式下的本地屏 / 对端屏维护,安全策略与权限相关设置。
11. 工具箱
| 工具 | 用途 |
| 云端文件检索 | 常规检索(灯板订单号、箱体序列号、灯板型号、序列号等)、高级检索(驱动型号、产品型号)、灯板配置检索、接收卡升级包检索、三方灯板配置检索 |
| 参数对比及同步 | 型号版本信息对比、参数同步下发 |
| 驱动 IC 在线选择 | 按驱动型号选择 IC 并纳入云端检索 |
| 本地配置文件解析 | 解析本地配置文件内容 |
| 设备修复 | 在线修复 / 离线修复,支持使用升级包修复 |
| 测试工具 / 造图测试工具 | 现场测试与画面生成 |
云端检索文件名规则:关键字 + 空格 + 关键字,最多 6 个关键字,每个至少 3 个字符,且严格区分大小写。
五、设备与工程管理
工程的两种类型
| 类型 | 说明 |
| 在线工程 | 连接真实设备,全部功能可用 |
| 离线工程(演示工程) | 无设备,菜单精简,用于配置文件的离线制作与学习 |
工程可导入 / 导出,工程名称长度上限 64 字符。
添加设备的三种方式
| 方式 | 适用场景 |
| 在线发现 | 设备与本机在同一局域网,自动扫描并列出 |
| 批量导入 | 已知一批设备的 IP、端口、ID 与密钥,导入模板为 Excel |
| 手动添加 | 已知单台设备的 IP、端口、ID 与密钥 |
设备列表支持的操作
重命名、删除、刷新、重启、重置、升级、日志导出、修改登录信息、修改网络参数、重置密码、激活设备、导入/导出密码文件、解绑云账户。
任务中心
批量下发类操作(批量激活、修改设备网络、设备重启/重置/升级、获取设备日志)都会进入任务队列,支持暂停、继续、删除、失败重试,并可查看每条任务的配置详情与下发结果。
六、常见提示与处理思路
软件报错信息普遍带有明确的处理指引,典型的几类:
| 场景 | 提示要点 |
| 自测图开启时操作 | 先关闭自测图再操作 |
| 屏幕校正未完成时操作 | 等待屏幕校正完成 |
| 发送卡与箱体连线不符 | 检查并正确配置客户端上的连线 |
| 接收卡相关操作失败 | 检查接收卡是否在线、配置文件是否正常 |
| 灯板类异常 | 检查灯板安装与接触是否良好 |
| 需要解锁 | 先解锁屏幕再操作 |
| 分辨率超限 | 减少单网口带载的接收卡个数 |
| 存在完全被覆盖的箱体 | 画布重叠,确认是否删除后保存 |
| 箱体未组成完整矩形 | 调整排布使其构成矩形 |
| 驱动 IC 与接收卡程序不匹配 | 更换匹配的配置文件 |
七、数据与文件位置
| 位置 | 内容 |
C:\Program Files\LEDToolHA\client\ |
程序本体(含原生 DLL、芯片库、离线服务器) |
C:\Program Files\LEDToolHA\client\LSfile\ |
接收卡芯片配置文件(pm_*.dat) |
C:\Program Files\LEDToolHA\userData\log\ |
运行日志 |
%APPDATA%\LEDTool\logs\ |
应用级日志 |
C:\Program Files\LEDToolHA\client\WidgetLayout\ |
界面布局配置 |
备份建议:接收卡配置文件、校正文件、色彩文件属于现场关键资产,每次点屏或换卡后都应导出留档;日常可配合「备份」模块的网口备份做链路冗余。
八、一点使用提示
先看屏幕能力再动手:分辨率、带载、级联能力都受设备型号限制,配置前先用「屏幕运维」确认设备状态,避免反复试错。
无配置文件时优先用「智能点屏」:比手工描点效率高得多。
点屏配置保存前一定看完提示:软件会逐条列出不合法项,按提示改比强行保存后再排查快得多。
修灯前先关开路侦测,否则会干扰坏灯定位。
网络压力测试期间不要操作 Web 端,软件本身也会给出该警告。







参与评论请先登录
请 登录 或 注册 后发表评论。