ProjectKB
Projects/ProjectKB/ 是键盘背光检测项目包,运行时加载 ProjectKB.dll。它把 FlowEngine、KB/POI 结果、Recipe 判定、背光自动修正、Modbus 触发、MES DLL 和 CSV/summary 留痕串成一条产线流程。
先查什么
| 现象 | 第一检查点 |
|---|---|
Modbus 写 1 后不触发 | 连接状态、IP/端口、holding register、SN 空值策略 |
流程结束寄存器没回 0 | FlowCompleted 是否走到最终回写、异常路径是否提前返回 |
| 输入 SN 被 MES 拦截 | Summary.AutoUploadSN、Summary.Stage、CheckWIP 返回值 |
| Flow 成功但没有键位结果 | 批次内是否有 KB/KB_Raw 和 POI_Y/POI_Y_V2 |
| 某些按键缺失 | POI 名称、宽度、KB 模板键名、KeyScale、KBLVSacle |
| 亮度整体偏移 | KBLVSacle、Recipe 限值、背光自动修正 Q1/Q3 |
| CSV/summary 没生成 | ViewResultManager.Config 保存开关、路径权限、模型名 |
| MES 上传失败 | FunTestDll.dll、FunTestDllConfig.INI、Collect_test 参数 |
manifest
项目身份为 ProjectKB,入口程序集为 ProjectKB.dll。发布版本和最低宿主版本会随交付变化,维护和打包时直接读取 Projects/ProjectKB/ProjectKB.csproj 与 manifest.json,不要在说明页复制一份版本号。
项目同时声明 WinExe,App.xaml.cs 有独立启动入口:初始化配置、授权、日志、主题与语言后,显式加载 ColorVision.Engine.dll,按 Order 执行发现的 IInitializer.InitializeAsync(),再打开 ProjectKBWindow。这不等于免依赖的独立交付;独立运行仍需相应程序集、配置及运行环境。当前 .csproj 的直接项目引用是 Engine/ColorVision.Engine/ColorVision.Engine.csproj;ColorVision.Engine.Templates 是命名空间,不是另一个被引用的项目。
运行链路
ProjectKBWindow 初始化 FlowEngine;选择 Flow 模板时,用模板名调用 RecipeManager.SetCurrentTemplate(Name)。AutoModbusConnect 打开时,窗口启动后连接 Modbus 并订阅 StatusChanged。PLC 把寄存器写为 1 后触发 RunTemplate();SN 为空且启用 IgnoreAutoRunWhenSnEmpty 时,本次自动触发会被忽略并写回 0。Flow 完成后 Processing() 读取 KB/KB_Raw 和 POI_Y/POI_Y_V2,计算每个按键亮度、局部对比度、均匀性和不良点,保存数据库、txt、summary、CSV,最后 Modbus 写回 0,必要时调用 MES Collect_test。
产品 SN 保留原值用于结果、文本内容和 MES;生成测试记录 txt 与生产汇总 txt 的文件名时,使用公共 Windows 文件名规范化规则处理非法字符。执行流程的 Code 继续使用独立时间戳,并与 MySQL 批次、诊断记录和完成回调保持一致。
界面主题
测试工具栏下方与 ARVRPro 共用 ColorVision.UI.Controls.FlowExecutionStatus 紧凑状态栏,普通提示一行、长错误最多两行,状态文字和提示保持相同行高。窄窗口优先显示提示,完整内容通过“详情”查看、选择和复制。管理员自动退出、空 SN 触发忽略和服务重启提示继续显示,MES 返回仍追加到当前提示并在详情内保留原文;控件不解释 MES 返回码,也不改变业务判定、上传及结果持久化。流程完成后停止计时,排队刷新不得覆盖最终状态。
主界面的分隔线、搜索框边框和测试按钮,以及 Recipe、登录和密码窗口的操作按钮,使用 ColorVision.Themes 的主题样式与动态画刷。Recipe 已配置提示在窗口打开期间随黑白主题更新。PASS/FAIL、权限状态和键位图像标记保留原有业务颜色;主题配色不改变检测判定或标记含义。
外部集成
| 通道 | 关键点 |
|---|---|
| Modbus TCP | 默认 host 127.0.0.1、port 502、register 0x00;读到 1 请求触发,回写 0 的分支见下文 |
| MES DLL | 固定从 Plugins/ProjectKB/FunTestDll.dll P/Invoke |
| TCP Socket | 状态栏提供配置入口,当前尚未接入检测启动链 |
寄存器 0 不是检测成功标志:空 SN 触发被忽略时会请求回写,正常 Processing() 到达回写分支时也会请求回写;异常或提前返回可能未到达该分支。窗口不等待 SetRegisterValue(0) 的异步结果,需分别检查 PLC 实际值和本次检测结果。
状态栏“Socket”由 OpenSocketConfigCommand 打开管理员配置编辑器,只编辑 SocketConfig。当前 ProjectKB 初始化和主窗口没有创建 SocketControl,也没有把它的 StatusChanged 绑定到检测流程;启用配置不会自动启动监听。Services/SocketControl.cs 中检查消息包含 # 和 * 的接收代码不能视为已经可用的客户触发协议。
MES 调用约定:CheckWIP(Stage, SN) 在 SN 上传或自动上传 SN 时执行,当前代码把返回 "N" 视为通过;Collect_test(...) 在测试完成且 Summary.UseMes、IsCheckWIP 为 true 时执行,参数含站别、SN、PASS/NG、设备号、线别、工号。
客户 DLL 返回约定变更时,先改 MES 判断,不要先改 Flow 或 Recipe。
结果和判定
KBItemMaster 是单次测试主结果,核心数据包括 SN、批次、模板、每个按键的亮度/色度/局部对比度、平均亮度、最小/最大亮度、亮度均匀性、不良点数量、结果图和最终 PASS/FAIL。
亮度计算链路里有两个容易漏掉的系数:
按键亮度 = POI 亮度 * PixNumber / Area * KeyScale * KBLVSacle背光自动修正由 BacklightAutotuneService.Apply() 处理,使用 Recipe 中的 Q1/Q3 和 sigmoid 斜率。它会保留 raw 值,最终显示和判定要分清 raw 与 adjusted。
ProjectKBWindow.Processing() 按 EnableKeyLvLimit、EnableAvgLvLimit、EnableUniformityLimit、EnableKeyLcLimit 分别启用判定;上下限使用 >= / <=,不是严格大于/小于。均匀性和局部对比度的 Recipe 百分数要除以 100 后比较。整体判定的最小亮度、平均亮度、均匀性通过 BacklightAutotuneService.GetOriginal* 取原始值,最大亮度与局部对比度则读取当前结果;不能把所有指标一概称为修正值判定。
CSV 契约由 KBItemMasterExtensions.SaveCsv() 维护:除固定列外,按 Items 追加键名列;KBCsvDataType.Lv 的动态列导出键位亮度,Lc 导出局部对比度乘 100,两者共享固定汇总字段,限值来自结果携带的 Recipe 快照。当前新生成的数据行中 ColorDifference 和 StrayLight 两列为空,占位字段不代表已完成色差/杂光测量;同表头的既有数据行会保留,不能据此推断所有历史行也为空。排查列内容时核对这个实现,不从表头推断能力。
生产统计与查询记忆
KBProductionStatisticsWindow 的首页、小时产量、天产量、生产会话和检测记录共用一组周期、机种、SN 和结果筛选。界面采用启动恢复窗口及 ARVRPro 结果统计的标题层级、弱边框圆角卡片与浅色/深色配色;ResultStatisticsTheme.xaml 随 KB 程序集编译,不引用宿主或 ARVRPro 的资源文件。筛选组可随窗口宽度换行,“生产信息”入口位于标题右侧。
- 每条
KBItemMaster是一次完整检测。有效产量计入FlowStatus.Completed的记录,同 SN 的重复检测仍逐条计数;流程失败单独显示。 - 同一次软件运行内关闭、重新打开统计窗口,保留周期、日期、机种、SN、结果、标签和页码。软件重启后默认首页、按天、今天、第 1 页及空筛选(机种显示“全部机种”)。
ProjectKBConfig.ProductionStatisticsWindowState标注[JsonIgnore],旧配置中的查询状态不再恢复,关闭统计窗口仅捕获内存状态。这个边界不涉及生产信息配置和数据库中的生产会话、目标产量、检测记录,不会清除历史数据。- 手动查询仍支持按天、按周、按月和全部。按天为所选日期
00:00到次日00:00,按周为周一到下周一,按月为月初到下月初,按KBItemMaster.CreateTime使用包含起点、不含终点的范围;不是滚动最近 24 小时或最近 7 天。 - “今天/本周/本月”按当前周期返回本周期并查询第 1 页,不清空其它筛选;全部模式下日期导航隐藏,快捷按钮显示“全部”。首页图表及各页表格沿用同一组筛选,“今日/本小时产量”是所选范围中落入当前日期/小时的子集。
- 列表及统计查询只投影统计所需字段,避免读取大体积
ItemsJson/压缩载荷;结果详情按需加载。
生产验收需检查现场 Modbus/MES,以及实际统计界面在浅色、深色和最小宽度下的筛选、日期输入与分页。用真实数据核对查询和生产信息修改。
关键配置
| 配置 | 作用 |
|---|---|
TemplateSelectedIndex | 当前 Flow 模板 |
AutoModbusConnect | 窗口打开后是否自动连接 Modbus |
IgnoreAutoRunWhenSnEmpty | 自动触发时 SN 为空是否跳过 |
TryCountMax | Flow 超时最大重试次数 |
KBLVSacle | 键位亮度整体缩放系数,字段名按源码保留 |
SNlocked | SN 上传成功或手动锁定后防止改写 |
Summary.UseMes | 是否启用 MES DLL |
Summary.AutoUploadSN | SN 改变后是否自动调用 CheckWIP |
AppendFalloutSummary | CSV 是否附加失败汇总 |
Recipe 重点看单键亮度、平均亮度、亮度均匀性、局部对比度和背光自动修正。KBLVSacle、Recipe、历史数据解释要一起交付。
本地构建与测试
下列命令只编译和执行本地测试,不上传项目包;会写入本地构建/测试产物。真实 Modbus/MES 烟测另需现场操作授权,测试项目通过不证明生产设备链路已验证。
dotnet build Projects/ProjectKB/ProjectKB.csproj -c Release -p:Platform=x64打包上传(需明确发布授权)
只有用户明确要求发布 ProjectKB 时执行。wrapper 会构建、上传并清理本地 .cvxp,不支持 --no-upload;仅询问构建或诊断不能运行该命令。
.\Scripts\package_project.bat ProjectKB交付包必须包含 FunTestDll.dll、FunTestDllConfig.INI、manifest、项目图标、默认配置,并和现场 Modbus 地址一致。
交付验收
| 验收项 | 通过标准 |
|---|---|
| 项目装载 | 主程序发现项目包,ProjectKBWindow 能打开 |
| Flow/Recipe 对齐 | 选择 KB Flow 后能切到对应 Recipe |
| 手动运行 | 输入 SN 后生成 KBItemMaster 和 PASS/FAIL |
| Modbus 触发 | 寄存器写 1 自动测试,结束写回 0 |
| SN 空值策略 | 空 SN 自动触发被忽略时仍能复位寄存器 |
| MES CheckWIP | 返回 "N" 时 SN 锁定成功 |
| 结果解析 | KB/POI_Y 数据能填充每个键位 |
| 背光自动修正 | raw 和 adjusted 都保留,判定符合 Recipe |
| 输出留痕 | 数据库、txt、summary、<Model>_<yyyyMMdd>.csv 都生成 |
| 交付依赖 | MES DLL、INI、README、CHANGELOG 随包交付 |
