设备资源配置、保存与重启
MySQL 连接时,设备配置保存到 SysResourceModel.Value;未连接时,沿用同一套资源字段和窗口,保存到本地 SQLite 配置库。保存本地设备不会请求 RC 重启服务。查询“怎么配置”不授权新增资源、导入覆盖、保存、删除或远端重启;先确认当前任务允许的设备、数据库和外部影响范围。
资源怎样进入列表和主显示区见Engine 设备装配。本页覆盖通用终端/设备资源,不替代物理相机、客户项目或具体硬件参数契约。
设备与终端已接入的关键配置入口通过 ServiceAuthorization 使用 Common 动作策略,默认要求应用管理员。动作分别为设备配置 device.configure、终端名称配置 service.configure、创建终端 service.create、创建设备 device.create 和删除资源 resource.delete;设备和终端资源通常使用 Code,无 Code 的通用资源路径回退到 resource: 加资源 ID,创建终端使用服务类型身份。打开窗口和执行提交分别检查;事务属性窗口通过 Submitting 在复制回原配置前拒绝撤权后的提交,PG/Spectrum 的独立配置草稿在真正 Apply 前检查。
这些检查保护实际接入的界面/命令和提交入口,不把通用 Save()、DAO 或任意直接配置赋值变成全产品统一授权拦截。原有公开保存接口继续承担持久化与通知;宿主新增业务入口时仍应在副作用前请求对应动作,并保留数据库、远端服务、Windows 权限及设备许可各自的边界。
注册中心默认参数、节点令牌与设备状态见RC 注册契约。
无 MySQL 时创建相机与许可证
- 点击设备控制面板标题栏的 +(添加/配置设备),进入管理员服务配置,在列表空白处右键并选择 Camera。可选已有终端,或选择 新建服务配置并添加设备,依次填写终端与设备配置;空本地库也有此入口。此操作沿用管理员权限要求,标题栏齿轮用于管理已有控制项的显示与分组。
- 在物理相机管理中创建相机,或者扫描后从结果列表创建,并配置 Camera ID、型号、模式及物理相机绑定。
- 从许可证管理导入已有许可证。许可证记录保存在本地;同一相机续期仍保留原有物理配置。SDK 需要的
.lic文件继续通过原有导出入口写入程序使用的lincense目录,原生校验规则不变。 - 新建的本地相机默认优先本地连接,打开相机后可在本机拍照;流程可使用现有 MQTT 开始节点连接“相机取图”和结束节点,见离线执行边界。
配置库不保存测试结果或图像,也不自动把远端设备搬到本地。校准模板、算法模板和需要远端服务的硬件功能不因设备配置可离线编辑而自动具备离线执行能力。
物理光谱仪管理也使用本地资源和许可证存储:未连接 MySQL 时可以注册、查看和续期本地记录,相同 SN 的相机许可证不会被光谱仪许可证覆盖。管理窗口与设备编辑窗口固定使用打开时的存储,导入或续期过程中连接变化不会改写另一库。在线下载许可证本身仍需要访问许可证服务。
资源与配置身份
设备树右侧的属性操作由通用命令生成器依据命令元数据生成,按设备与连接、校准与校正、采集与显示、数据与日志、服务与维护归类。不同设备使用同一套紧凑按钮布局和更新窗口主题规则,仅显示自身拥有的命令;按钮显示操作名称,说明保留在工具提示和无障碍帮助文本中。修改配置和删除来自基类元数据;重启服务通过设备右键菜单执行,文件存储参数在“修改配置”中编辑。没有命令的分类不显示。页面不会因展示按钮而自动执行设备操作。
设备卡片或上下文菜单中的 属性 会把同一设备页放入专用窗口外壳,显示设备名称、Code 和带留白的内容边界;管理员服务配置中的右侧详情仍使用其自身面板外壳。两种入口复用命令与设备行为,但不会把独立窗口的留白写进设备控件后再重复叠加。
| 对象/字段 | 含义 |
|---|---|
SysResourceModel.Id / Pid | 数据库资源身份及父终端关系,不是服务类型编号 |
SysResourceModel.Type | ServiceTypes 编号,用于查工厂和服务类型字典 |
Code / Name | 运行身份与显示名称;不要只按相同名称判断同一设备 |
Value | 具体 Config* 的 JSON |
SendTopic / SubscribeTopic | 通信主题;资源可见并不证明主题、token或远端服务有效 |
DeviceService<T> 构造时用 TryDeserializeConfig<T> 建立默认对象,再用 JSON 填充,JSON 的 null 值被忽略。空文本或解析异常会返回默认配置;异常写日志,不阻止对象构造。随后以资源列覆盖 Config.Code / Config.Name。因此“配置页能打开”不能证明旧 JSON 成功恢复,看到默认值时先保留原始 Value 并查反序列化日志,不要直接保存覆盖证据。
创建终端与创建设备
TypeService 的创建入口打开 CreateType,实际创建的是根终端资源;TerminalService 的创建入口打开 CreateTerminal,实际创建的是终端下的设备。不要按窗口类名猜数据库层级。
设备配置窗口默认显示设备平铺列表,可切换到“服务配置 → 设备”视图。旧配置中的类型视图会转为服务配置视图,已保存的服务或设备视图偏好继续生效。顶部 创建设备 按钮位于 物理相机管理 前面,与列表空白处的右键菜单共用创建流程和管理员权限检查:按服务类型选择 在某服务添加设备,或通过 新建服务配置并添加设备 创建;已有服务配置的右键 创建 直接添加其下设备。没有已有设备的类型也保留创建入口。右侧服务详情显示服务名称、代码和 修改配置 按钮。点击 修改配置 可编辑服务名称。从左侧树或设备平铺列表选择设备可查看设备详情,删除通过对应项的右键菜单执行。类型菜单使用程序的多语言资源,已有服务和设备名称沿用用户配置,类型字典、资源 Type、Code 和通信主题不会因显示语言或列表层级变化而改写。
CreateType根据类型字典设置 Type,构造带服务类型、终端 Code 和 RCName 的 CMD/STATUS 主题,插入根资源后加入终端集合,再请求按类型重启。CreateTerminal以终端 Type 找工厂,传入DeviceServiceCreateContext(Code, Name, SendTopic, SubscribeTopic);工厂建立 Config,保存子资源 JSON,再创建运行实例并加入集合。- 新建支持本地后端的设备优先使用本地。已有本机显示配置的设备 Code 沿用保存的选择;新建 PG 和独立滤色轮的本地偏好也保存在本机显示配置中。支持本地后端且有自动连接选项的新设备默认关闭自动连接,既有设备按原配置加载。
- 单独新建设备在保存前查找可用的相机许可证并默认填入 SN;相机、校准设备和光谱仪不自动填写,由用户自行配置。候选必须是相机许可证(
LiceType=0)、SN 和许可证内容非空,且许可证内容可解析、型号非空、内容中的到期时间晚于当前时间;不只依据数据库expired元数据。默认选择到期时间最晚的一份,到期时间相同则按 SN 忽略大小写排序,以保持选择稳定;不依赖物理相机是否已配置或选中。本地终端只查询本地许可证。没有可用许可证时保持原配置,已有显式 SN 不覆盖。该许可证默认值只在单独创建设备时写入。首次创建唯一物理相机的初始化另行覆盖数据库预置设备:直接用物理相机 Code 补齐普通设备的空 SN,以及相机/校正的空 CameraCode,不依赖许可证是否已导入;已有绑定和光谱仪保持不变。签名与硬件授权仍由原生驱动在运行时验证。 - 新建设备默认按类型命名,例如
Camera,名称已被当前已加载设备使用时依次取首个可用的Camera1、Camera2。设备名称可以手工填写,设备 Code 使用独立的标识规则。手工提交时,CreateType检查当前类型的终端 Code,CreateTerminal检查已加载设备 Code。该检查覆盖当前进程中的设备。 - 数据库插入、构建设备、加入集合和请求远端重启没有统一事务回滚。创建后异常时先定位失败阶段,不能直接重复创建。
创建后的服务重启使用终端的服务类型、终端 Code 和新设备 Code;本地设备跳过远端重启,并刷新显示面板。
编辑、保存与远端应用
DeviceService<T>.Config 是运行对象持有的配置,不是天然的待保存副本。MQTTDeviceService<T> 的 DeviceCode、收发 Topic 和 ServiceToken 直接读取它持有的 Config;例如 MQTTSMU 构造时接收 DeviceSMU.Config 的同一引用。直接修改这个共享对象,后续取值即可变化,不以 Save() 为内存生效开关。但字段变化不证明新主题已经订阅、配置已持久化或远端设备已经应用,通信状态仍按消息契约核对。
Save() 的基类流程不调用 LoadServices() 或重建显示区,默认 OnConfigChanged() 为空;具体设备可覆盖或订阅通知。不能承诺保存后所有运行对象自动重建,也不能统一建议“再重载一次”——重载对旧对象及集合的影响见运行装配。事务属性窗口的工作副本与提交边界仍只在属性契约维护,不把直接改 Config 的语义套到所有编辑窗口。
通用 DeviceService<T> 的顺序是:
| 阶段 | 代码行为 | 不能据此推断 |
|---|---|---|
| 编辑对象 | 控件修改传入 Config;具体窗口决定直接编辑或事务副本 | 关闭一定撤销、字段变化已经落盘 |
SaveConfig() | 将 Config 的 Code/Name/JSON 写入该对象所属的配置库 | 没抛异常就一定更新了目标行 |
RestartRCService() | MySQL 设备按 Type/Pid 查服务与终端并请求 RC 重启;本地设备跳过 | 远端已经重启或应用新配置 |
| 本地通知 | OnConfigChanged(),再发 ConfigChanged | 各设备全部对象已经重建或硬件已健康 |
直接 SQL 修改 t_scgd_sys_resource 不调用上述保存、重启和通知流程,也不会自动更新已经载入的 Config。已存在的设备对象稍后执行 SaveConfig(),还可能把旧 Code/Name/JSON 覆盖回数据库。核验 SQL 修改时应分别确认目标行与实际使用该配置的运行对象;不能把数据库写入成功当成界面刷新或远端生效。
上述步骤不是 MySQL 与远端服务的分布式事务。后续阶段出错不会自动回滚已经成功的数据库更新;顺序中抛异常会阻止更后的通知。
RC 的三参数 RestartServices 是 void 包装,丢弃 TryRestartServices 的结果。RC 未连接或无可用 token 时内部返回 false;可以发送时也是异步发布并稍后查询,不等待设备应用完成。因此保存方法返回、通知发生、设备在线和参数生效必须分别取证。
设备右键“重启服务”的 RefreshCommand 实际调用 Save(),也会尝试把当前 Config 写入数据库,不是只读刷新。不要把设备级与终端级操作视为相同范围。
服务配置右键 编辑 只提供 Name 的工作副本;确认后更新资源名称及原 JSON 中的 Name,并同步列表与详情标题。Code、Type、Pid、通信主题、ServiceToken 和其它 JSON 字段保持原值,不请求服务重启。取消或关闭编辑窗口不提交名称;保存失败恢复原资源名称和 JSON,运行配置名称保持原值。
终端右键 重启服务 调用 TerminalService.Save():将 Config 的 Name、Code 和 JSON 交给 SysResourceDao.Save,MySQL 终端随后按 Config.ServiceType.ToString() 请求重启,未传终端 Code;本地终端跳过远端重启。CreateType 新建 Config 没有设置该 ServiceType,加载终端也只覆盖 Code/Name,不以资源 Type 同步它。需要核对实际配置和请求目标,不能声称只重启当前终端。
导入、导出与删除
| 操作 | 通用实现及限制 |
|---|---|
导出 .config | 将当前 Config JSON 写入选定文件;不包含设备树、数据库关系或硬件校准全量备份,分享前检查敏感字段 |
导入 .config | 读取并反序列化为具体 T,复制到现有 Config 后调用 Save();可能改变身份/主题并请求远端重启,不是预览 |
| 文件存储配置 | 相机、光谱仪、算法和校准的 FileServerCfg 在“修改配置”中编辑,随设备配置一起提交和保存;参数及旧 JSON 格式保持兼容,保存仍走设备原有流程 |
| 删除设备 | 确认后移出树,物理删除该资源行,再移出 DeviceServices;尝试按本次 GetDisplayControl() 返回值移除显示项,最后调用 Dispose。没有通用软删除、子资源级联或整轮回滚保证 |
| 删除终端 | 删除直接子资源行和终端行并移出终端集合;不能推断递归删除全部后代或立即清理所有旧设备/窗口引用 |
删除显示项依赖返回同一个已登记实例,并非按设备 Code 查找。例如 DeviceSMU.GetDisplayControl() 每次创建新的 DisplaySMU(this),删除时拿到新实例不能据此保证原显示项已移除。删除中途任一步抛异常也会阻止后续清理,不恢复先前已完成的移树或数据库删除。
调用 Dispose 不等于释放通信:通用 DeviceService.Dispose() 只调用 GC.SuppressFinalize,不会自动执行 GetMQTTService()?.Dispose();DeviceSMU 也没有覆盖这个方法。MQTTServiceBase.Dispose() 才负责自身 Processing 退订、计时器及待处理记录清理,派生通信类另加的事件仍要核对其解绑实现。因此不能从“设备已删”推断所有通信回调、显示缓存或已打开窗口均已失效。
具体 Device* 可以覆盖上述方法,操作前应核对实际类型。PropertyGrid 的编辑会话、确定与关闭语义只在属性契约维护;按钮是否可用不扩大 AI 的执行授权。
定位与验证
保存/创建失败时,分别记录:当前数据库和目标资源 ID/Type/Pid/Code、旧 Value 备份、编辑模式、数据库阶段结果、RC 连接与重启请求、设备端最终状态。只读诊断可以审查代码、脱敏日志与既有记录;不要通过改 Code、清库、重新导入或点击“重启服务”试探。
创建、保存与重启需在隔离环境核对旧 JSON 恢复、坏 JSON 保留证据、缺失目标行、RC 离线和后续阶段失败。分别确认数据库已提交、远端已生效和真实设备动作。
不访问真实数据库或操作设备。
验证共享 Config 的即时取值,以及删除设备时显示实例和通信订阅释放。
