PJLink 投影机控制协议速查(Class 1 命令表)
PJLink提供投影机与显示设备的统一网络控制格式,但“支持PJLink”不意味着所有型号输入列表、待机网络能力或并发连接数都相同。本文依据JBMIA Class 1规范1.04整理基础命令,并将设备接受命令、电源状态与现场画面分开验收。
命令帧:查询也必须保留空格
命令结构为 %、类号、四字符命令、ASCII空格、参数、CR。查询将参数写为?,不是直接把问号贴在命令后。统一使用规范的大写写法,结尾CR为字节0D。
| 操作 | 文本表示(\r代表单个CR字节) | 十六进制 |
|---|---|---|
| 开机 | %1POWR 1\r | 25 31 50 4F 57 52 20 31 0D |
| 查询电源 | %1POWR ?\r | 25 31 50 4F 57 52 20 3F 0D |
| 查询输入 | %1INPT ?\r | 25 31 49 4E 50 54 20 3F 0D |
上表是规范格式的合成示例,未发给真实投影机。%1POWR?缺少空格,不作为本文有效请求。调试工具是否将文字\r转换为CR要另行核对,可切十六进制发送以消除歧义。
关键参数与Class 1命令
| 项目 | 核对值 |
|---|---|
| 通信 | TCP,标准端口4352 |
| 编码与结束 | ASCII,CR结束 |
| 响应 | %1命令=参数后跟CR |
| 无认证欢迎行 | PJLINK 0后跟CR |
| 认证欢迎行 | PJLINK 1 加随机字符串后跟CR |
| 命令 | 参数或查询结果 | 验收注意 |
|---|---|---|
| POWR | 控制0待机、1开机;查询0待机、1开机、2冷却、3预热 | OK不是出画证明 |
| INPT | 类别加输入编号 | 先用INST查询可用列表,不凭另一机型猜HDMI编号 |
| INST | 查询可用输入列表 | Class 1已包含,不能误列为Class 2专属 |
| AVMT | 10/11图像解除/启用静音,20/21音频,30/31同时 | 实际可用组合按机型核验 |
| ERST | 六位:风扇、灯泡、温度、机盖、过滤器、其他 | 0可表示未检出或不支持检测;1警告,2错误 |
| LAMP | 灯泡使用时间与点亮状态 | 不直接等同寿命预测 |
| NAME | 设备名称 | 不能单独当唯一资产身份 |
| INF1 / INF2 / INF0 | 厂商、型号、其他信息 | 保存原字符串与固件条件 |
| CLSS | 支持类号 | 扩展能力仍按版本与型号确认 |
查询时都使用%1命令 ?加CR。PJLink Class 2在基础功能上增加发现和主动状态通知等能力;本文不把未经机型验证的扩展功能写成通用支持清单。
认证与新会话
读取欢迎行后决定是否认证。启用认证时,将本次随机字符串与密码按顺序拼接计算MD5十六进制摘要,按规范置于命令前。不要复用上次连接的随机字符串。认证失败PJLINK ERRA与命令错误ERR1不是同一层结果。
日志对外只保留凭据版本和结果,真实口令及挑战摘要组合应脱敏。完整变更测试及公开演示摘要输入见PJLink密码修改后的认证核对;断网恢复另见重新认证与会话重建记录。
错误响应怎样分流
| 响应 | 规范含义 | 下一步 |
|---|---|---|
| ERR1 | 未定义命令 | 查拼写、类号与支持范围 |
| ERR2 | 参数越界或不适当 | 查可用输入及参数定义 |
| ERR3 | 当前不可接受 | 查电源状态及设备执行前提,不能只认作冷却 |
| ERR4 | 投影机/显示设备故障 | 查询错误状态并对照机型手册 |
收到%1POWR=OK表示请求被接受;随后查询可能仍为3。只有电源状态与目标输入、信源出画条件都满足,才能将开馆标为可展示。见预热与冷却时的重试时间线。
场景联动保留三个检查点
开馆先建立并认证会话,发送一次开机,再按受控频率查询;切源先读取INST,发送支持的编号并回读INPT;关馆先请求待机,再依具体型号冷却及外部断电要求处理供电。不能把统一延时或查询为0直接当作所有设备允许断电的依据。
本页没有真实机型运行记录。可下载预热状态合成夹具及空白记录,将其中机型、固件、原始回包和出画时刻补齐后再形成项目验收。多品牌联动的接口需求可按SoftControl设备对接逐项确认,本文不替代具体版本能力验收。
核对依据
核对日期2026-10-23。本文不声称所引版本为最新版;具体设备支持、网络待机、连接数和耗时均需机型实测。
来源可用性说明:2026-10-23官网维护,规范与英文目录直链GET不可达,网页检索缓存可读。原链接保留作出处,不声称当前可下载。可另核对Epson EB-PU22/PU21系列规格Rev.D §3.4,第67—70页中的POWR、输入和错误状态机型例证;仅适用于该手册列出的型号,不代表已完成现场验证。
相关阅读
留言讨论
评论发布后会被人工复核,违规内容将被删除。
如果发表没有反应,可以前往联系我们告诉我们。