设备维护

文档版本：v1.0
最后更新：2026-06-11
适用范围：设备型号维护、设备导入、设备配置、设备详情排查

菜单入口

功能	菜单路径
设备型号	设备管理 -> 设备型号管理
NN号	设备管理 -> NN号管理
设备管理	设备管理 -> 设备管理
打印任务	打印管理 -> 打印任务

设备型号

进入 设备管理 -> 设备型号管理，创建设备型号并维护型号基础能力。

常用字段：

字段	说明
型号编码	型号唯一标识，设备、固件包、业务配置都会引用
型号名称	后台展示名称，便于运营与实施识别
设备类别	区分标签打印机、票据打印机等设备类型
固件文件最大限制	用于限制固件包上传大小，避免超过设备或升级链路可承载范围
打印文件大小限制	用于限制设备上传打印文件大小，也会影响图片打印、文生图结果下发前的压缩目标
默认标签	设备未单独设置标签或输出图片大小时使用；生成图片时默认按标签宽高乘以 8 计算像素宽高

默认标签示例：标签宽度为 50mm、高度为 30mm，未设置输出图片大小时，平台可按 400 x 240 像素生成图片。

NN号

NN号用于区分同一设备型号下不同主控、模组或固件分支。它常用于：

• 固件包按型号、固件类型、NN号归档。
• 固件升级任务按 NN号过滤可升级设备。
• 设备上报状态后，平台识别设备当前固件分支。
• 同型号不同硬件批次使用不同升级包时避免误升级。

建议命名规则保持稳定，例如 P5802_MAIN_A、P5802_MODULE_B，并在固件包、升级任务、设备状态中保持一致。

型号功能配置

在设备型号行点击 功能配置，配置该型号支持的云端能力。

常见功能：

功能	配置内容	用途
文本生图	选择文生图业务	设备 Pull text_to_image 时决定使用哪个业务生成图片
标签打印热词(ASR)	选择热词类型、ASR 服务类型、ASR 模型名称	设备语音转标签时提供热词、模型与识别服务配置
文本生成标签	选择标签生成相关业务	设备上报文本后由云端生成标签图片或 PRN

设备管理

进入 设备管理 -> 设备管理，可以新增设备、查询设备、批量导入设备并查看设备状态。

新增设备

新增设备时至少确认：

字段	说明
SN	设备唯一序列号，设备 Bootstrap 与 MQTT 主题都会使用
设备型号	决定设备能力、默认标签、文件限制与功能配置
设备名称	后台展示名称
默认标签	可覆盖型号默认标签；为空时使用型号默认标签
打印队列最长保存时间	控制任务在设备队列中最长保留多久
打印任务有效期	控制任务超过有效时间后是否继续允许设备拉取或打印

批量导入设备

设备管理页面可通过 下载模板 获取导入模板。实施时建议按以下方式处理：

1. 先在后台创建并确认设备型号。
2. 下载设备导入模板。
3. 按模板填写 SN、型号、设备名称、租户、标签、队列时间等字段。
4. 导入前检查 SN 唯一性和型号编码是否存在。
5. 导入后按 SN 搜索抽查设备详情。

控制按钮

设备列表或详情中的控制按钮用于远程操作设备，实际按钮以页面权限和设备在线状态为准。常见能力包括：

操作	用途
测试打印	验证设备打印链路、文件下载和回执上报
下发图片打印	从后台选择或上传图片，压缩成设备支持宽高后下发
下发 PRN 文件	直接下发设备支持的打印指令文件
清除打印队列	清理设备未完成或已过期的待打印任务
重启或控制设备	用于远程运维和设备状态恢复
查看密钥	获取设备接入密钥，模拟调试时使用，必须脱敏保存

设备密钥

在设备列表或设备详情中查看设备密钥，用于设备端 Bootstrap、模拟器联调或问题排查。密钥不得在工单、聊天记录或公开文档中明文传播。

打印队列与有效期

设备打印队列相关配置用于控制任务生命周期：

配置	作用
打印队列最长保存时间	设备暂时离线或忙碌时，任务可在队列中等待的最长时间
打印任务有效期	任务超过有效期后不再建议继续打印，避免旧业务单据被误打印
清除打印队列	手动清理异常堆积任务，适合设备换纸、重连、误下发后的恢复

设备详情

设备详情通常用于排查设备接入和业务链路，可重点查看：

• 基础信息：SN、型号、租户、设备名称、标签。
• 在线状态：在线/离线、最后心跳、最后上报时间。
• 固件信息：当前固件版本、固件类型、NN号。
• 扩展配置：设备语言、文生图业务、标签配置等。
• 接入密钥：用于调试，展示和截图时必须脱敏。
• 打印队列和任务：查看待打印、打印中、成功、失败、过期任务。
• 设备状态：电量、纸张、错误码、警告码、网络状态等。

设备维护完成后，可继续配置 文生图功能配置。