Skip to content

ProjectKB ​

Projects/ProjectKB/ 是键盘背光检测项目包,运行时加载 ProjectKB.dll。它把 FlowEngine、KB/POI 结果、Recipe 判定、背光自动修正、Modbus 触发、MES DLL 和 CSV/summary 留痕串成一条产线流程。

先查什么 ​

现象第一检查点
Modbus 写 1 后不触发连接状态、IP/端口、holding register、SN 空值策略
流程结束寄存器没回 0FlowCompleted 是否走到最终回写、异常路径是否提前返回
输入 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。

亮度计算链路里有两个容易漏掉的系数:

text
按键亮度 = 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 为空是否跳过
TryCountMaxFlow 超时最大重试次数
KBLVSacle键位亮度整体缩放系数,字段名按源码保留
SNlockedSN 上传成功或手动锁定后防止改写
Summary.UseMes是否启用 MES DLL
Summary.AutoUploadSNSN 改变后是否自动调用 CheckWIP
AppendFalloutSummaryCSV 是否附加失败汇总

Recipe 重点看单键亮度、平均亮度、亮度均匀性、局部对比度和背光自动修正。KBLVSacle、Recipe、历史数据解释要一起交付。

本地构建与测试 ​

下列命令只编译和执行本地测试,不上传项目包;会写入本地构建/测试产物。真实 Modbus/MES 烟测另需现场操作授权,测试项目通过不证明生产设备链路已验证。

powershell
dotnet build Projects/ProjectKB/ProjectKB.csproj -c Release -p:Platform=x64

打包上传(需明确发布授权) ​

只有用户明确要求发布 ProjectKB 时执行。wrapper 会构建、上传并清理本地 .cvxp,不支持 --no-upload;仅询问构建或诊断不能运行该命令。

powershell
.\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 随包交付

基于 MIT License 发布。