
在中控系统项目中,投影机是比较常见的受控设备。通过中控触摸屏,操作人员可以完成投影机开关机、信号源切换、画面遮蔽、状态查询等操作。
不同品牌的投影机,原本可能采用各自不同的网络控制指令。为了减少不同品牌设备之间的控制差异,PJLink 提供了一套面向投影机和显示设备的标准化网络控制协议。
对于中控系统开发人员来说,掌握 PJLink,不仅可以实现投影机的基本控制,还可以将不同品牌、不同型号的兼容设备接入统一的控制软件。
本文以 PJLink Class 1 为重点,整理通信参数、常用命令、参数含义、返回格式和实际接入方法,并补充 Class 2 的扩展功能。
一、什么是 PJLink 协议?
PJLink 是由日本商业机器与信息系统产业协会(JBMIA)推动制定的投影机与显示设备控制标准。
它的主要目标是统一不同厂商设备的网络控制方式,让控制软件可以使用相同的命令格式管理支持 PJLink 的投影机和显示设备。
PJLink 主要解决三个方面的问题:
Connection:设备连接与认证流程。
Control:设备控制与状态查询。
Command Format:统一的命令和响应格式。
例如,控制系统需要打开一台投影机,不必分别为每个品牌编写完全不同的开机命令,而是可以向支持 PJLink 的设备发送统一格式的 POWR 命令。
PJLink 目前常见的功能等级包括:
| 类型 | 主要功能 |
|---|---|
| Class 1 | 基础控制、信号源切换、静音、状态查询 |
| Class 2 | 扩展控制、设备搜索、状态主动通知、更多设备信息 |
实际项目中,Class 1 已经能够满足大部分投影机的基础中控需求。对于需要查询输入分辨率、获取设备序列号、监听设备状态变化等功能的项目,可以进一步确认设备是否支持 Class 2。
需要注意:支持 PJLink 不代表设备一定支持全部命令。具体功能应以设备的 PJLink 认证等级、型号说明书和实际响应为准。
二、PJLink 通信参数与连接方式
PJLink 使用 TCP/IP 进行设备控制。
在标准控制架构中,投影机作为 TCP Server,中控主机作为 TCP Client。由中控主机主动建立连接,发送命令,投影机返回对应响应。
1. 常用通信参数
| 参数 | 标准或常用值 |
|---|---|
| 通信方式 | TCP/IP |
| 默认 TCP 端口 | 4352 |
| 默认 UDP 搜索端口 | 4352 |
| 数据格式 | ASCII |
| 命令结束符 | CR(0x0D) |
| 控制角色 | 中控为 Client,投影机为 Server |
| 设备识别 | IP 地址 |
| 设备数量 | 每台设备建立独立 TCP 会话 |
其中,TCP 4352 是 PJLink 标准规定的控制端口。UDP 4352 则用于设备搜索和相关状态通知功能,并不是普通控制命令的默认传输方式。
2. 网络连接示意
中控主机与投影机处于可互通的局域网中即可进行控制。
例如:
中控主机:192.168.110.100
投影机:192.168.110.20
投影机控制端口:4352
中控程序连接:
192.168.110.20:4352
连接成功后,根据设备的认证状态完成认证,再发送 PJLink 命令。
如果需要控制多台投影机,中控程序应分别建立连接,并按照每台设备的 IP 地址维护独立的通信状态。
3. PJLink 是否支持串口控制?
这里需要特别区分。
PJLink 标准定义的是网络控制协议,标准控制方式是 TCP/IP,不是 RS-232 或 RS-485。
一些投影机同时支持 PJLink 网络控制和厂商自定义串口控制,但两者属于不同的控制接口。不能把 PJLink 命令直接当作通用 RS-232 指令使用。
三、PJLink 命令格式
PJLink 使用 ASCII 字符串进行通信。
标准命令格式:
%1命令 参数\r
其中:
| 字段 | 含义 |
|---|---|
% | 命令起始标志 |
1 | PJLink Class 1 |
| 命令 | 固定四个字符 |
| 空格 | 命令与参数之间的分隔符 |
| 参数 | 控制参数或查询参数 |
\r | 回车符,十六进制 0D |
例如:
%1POWR 1\r
表示发送 Class 1 的投影机开机命令。
再例如:
%1POWR ?\r
表示查询投影机电源状态。
需要注意,命令中的空格不能随意省略,结束符也不能直接使用换行符 LF(0A)代替标准 CR(0D)。
1. 命令响应格式
投影机的返回格式通常为:
%1命令=返回参数\r
例如:
%1POWR=1\r
表示当前电源状态为开启。
控制命令成功执行时,常见响应为:
%1POWR=OK\r
这表示命令执行成功,但不等于投影机已经完成预热或进入正常投影状态。
因此,中控系统应当结合后续状态查询判断设备的实际运行状态。
四、PJLink Class 1 常用控制命令
下面整理实际中控项目中最常使用的命令。
1. 投影机电源控制 POWR
POWR 用于控制投影机开机和关机。
| 操作 | 命令 | 参数 |
|---|---|---|
| 开机 | %1POWR 1 | 1 |
| 关机 | %1POWR 0 | 0 |
| 查询电源状态 | %1POWR ? | ? |
电源状态查询返回值:
| 返回值 | 含义 |
|---|---|
| 0 | 待机(Standby) |
| 1 | 开机、光源开启状态 |
| 2 | 冷却中(Cooling) |
| 3 | 预热中(Warm-up) |
示例:
发送:
%1POWR 1\r
成功响应:
%1POWR=OK\r
查询:
%1POWR ?\r
返回:
%1POWR=1\r
表示投影机处于开机状态。
中控开发注意事项:
投影机开机后通常需要一定时间完成预热,关机后也可能需要一段时间进行冷却。
因此,不建议在发送开机指令后立即将设备状态设置为“正常运行”,也不应该在关机命令发送后马上认为设备已经进入待机。
更合理的做法是周期性查询 POWR 状态,根据返回值更新设备状态。
2. 信号源切换 INPT
INPT 用于切换投影机输入信号源。
Class 1 的基本参数格式:
%1INPT 参数\r
常见输入类别:
| 参数范围 | 输入类别 |
|---|---|
| 11~19 | RGB 输入 |
| 21~29 | VIDEO 输入 |
| 31~39 | DIGITAL 输入 |
| 41~49 | STORAGE 输入 |
| 51~59 | NETWORK 输入 |
例如:
%1INPT 11\r
表示切换至 RGB 类别的第一个输入。
%1INPT 31\r
表示切换至 DIGITAL 类别的第一个输入。
%1INPT 32\r
表示切换至 DIGITAL 类别的第二个输入。
这里有一个非常重要的细节:
31 并不在所有投影机上都必然代表 HDMI 1,32 也不一定代表 HDMI 2。
PJLink 使用输入类别和编号进行标准化描述,但实际接口名称、可用编号和输入端口映射需要根据投影机型号确认。
建议先使用 INST 查询设备支持的输入列表,再根据设备手册建立中控界面上的 HDMI、VGA、HDBaseT 等输入源映射。
查询当前输入:
%1INPT ?\r
例如返回:
%1INPT=31\r
表示当前输入为 DIGITAL 类别的第一个输入。
3. 输入源列表查询 INST
INST 用于查询投影机支持的输入源编号。
发送:
%1INST ?\r
设备会返回其支持的输入源列表。
例如:
%1INST=11 21 31 32\r
示例表示设备报告了 11、21、31、32 这些输入编号。
实际返回内容取决于设备具备的输入接口。
在中控软件中,可以在设备初始化阶段查询 INST,并将可用输入源保存到设备配置中。
这样就不必假定所有投影机都有相同数量的 HDMI、VGA 或其他接口。
4. 画面与声音静音 AVMT
AVMT 用于控制投影机的视频静音、音频静音和视音频同时静音。
常用参数如下:
| 参数 | 含义 |
|---|---|
| 10 | 关闭视频静音 |
| 11 | 开启视频静音 |
| 20 | 关闭音频静音 |
| 21 | 开启音频静音 |
| 30 | 关闭视音频静音 |
| 31 | 开启视音频静音 |
常用命令示例:
开启画面遮蔽:
%1AVMT 11\r
取消画面遮蔽:
%1AVMT 10\r
开启音频静音:
%1AVMT 21\r
取消音频静音:
%1AVMT 20\r
同时开启画面和声音静音:
%1AVMT 31\r
同时取消画面和声音静音:
%1AVMT 30\r
查询当前静音状态:
%1AVMT ?\r
需要注意,部分设备不支持独立的视频或音频静音功能。如果设备不支持对应功能,可能返回参数错误 ERR2。
另外,PJLink 中的 AV Mute 不一定等同于投影机遥控器上的所有遮蔽、快门或 Blank 功能,具体表现需要根据设备型号确认。
5. 设备错误状态查询 ERST
ERST 用于查询投影机的错误状态。
发送:
%1ERST ?\r
成功返回格式:
%1ERST=000000\r
返回参数由六个位置组成,依次表示:
| 位置 | 状态类别 |
|---|---|
| 第 1 位 | 风扇错误 |
| 第 2 位 | 灯泡或光源错误 |
| 第 3 位 | 温度错误 |
| 第 4 位 | 机盖打开错误 |
| 第 5 位 | 滤网错误 |
| 第 6 位 | 其他错误 |
每一位的含义:
| 数值 | 含义 |
|---|---|
| 0 | 未检测到错误,或设备没有对应检测功能 |
| 1 | 警告 |
| 2 | 错误 |
例如:
%1ERST=020000\r
表示第二个位置的光源错误状态为 2,即检测到光源错误。
再例如:
%1ERST=001000\r
表示温度错误状态为警告。
在中控系统中,ERST 可以用于设备状态监测、异常提示和运行日志记录。
需要注意,返回值为 000000 不一定代表设备所有硬件都绝对正常,因为部分设备可能不具备某些状态检测功能。
6. 光源使用时间查询 LAMP
LAMP 用于查询灯泡数量、累计使用时间以及光源工作状态。
发送:
%1LAMP ?\r
单灯设备可能返回:
%1LAMP=1234 1\r
其中:
1234:累计使用时间,单位为小时。1:光源开启。0:光源关闭。
对于多灯设备,返回内容可能包含多组时间和状态数据,中间以空格分隔。
例如:
%1LAMP=1234 1 567 0\r
表示两组光源信息:
第一组累计使用 1234 小时,当前开启。
第二组累计使用 567 小时,当前关闭。
注意:激光光源设备和无灯泡设备可能不支持传统灯泡时间查询,不能把 LAMP 返回值直接当作所有投影机的光源寿命数据。
7. 设备名称查询 NAME
NAME 用于获取投影机设置的设备名称。
发送:
%1NAME ?\r
例如:
%1NAME=MeetingRoom_Projector\r
中控系统可以利用该命令读取设备名称,方便多台投影机的设备识别和运行信息展示。
8. 厂商与型号查询 INF1、INF2
这两个命令可以帮助中控软件识别投影机品牌和型号。
查询厂商:
%1INF1 ?\r
示例返回:
%1INF1=Panasonic\r
查询型号:
%1INF2 ?\r
示例返回:
%1INF2=PT-DX820\r
设备实际返回内容由厂商提供。
9. 其他信息查询 INFO
发送:
%1INFO ?\r
该命令用于查询厂商定义的其他信息,具体内容由设备实现决定。
不能将 INFO 的返回内容假定为统一的软件版本格式。
10. PJLink 等级查询 CLSS
发送:
%1CLSS ?\r
返回:
%1CLSS=1\r
或者:
%1CLSS=2\r
可以用来判断设备报告的 PJLink Class 等级。
五、常用命令速查表
以下表格可以作为中控程序开发时的基础命令清单。
| 命令 | 类型 | 参数 / 返回值 | 用途 |
|---|---|---|---|
| POWR | 设置 | 0 / 1 | 关机 / 开机 |
| POWR? | 查询 | 0~3 | 查询电源状态 |
| INPT | 设置 | 11~59 | 切换输入源 |
| INPT? | 查询 | 11~59 | 查询当前输入 |
| INST? | 查询 | 输入编号列表 | 查询可用输入 |
| AVMT | 设置 | 10、11、20、21、30、31 | 画面 / 声音静音 |
| AVMT? | 查询 | 静音状态 | 查询静音状态 |
| ERST? | 查询 | 六位状态码 | 查询错误状态 |
| LAMP? | 查询 | 时间和状态 | 查询光源信息 |
| NAME? | 查询 | 字符串 | 查询设备名称 |
| INF1? | 查询 | 字符串 | 查询厂商 |
| INF2? | 查询 | 字符串 | 查询型号 |
| INFO? | 查询 | 厂商定义 | 查询其他信息 |
| CLSS? | 查询 | 1 / 2 | 查询协议等级 |
表格中的 ? 是命令格式的一部分,实际发送时需要在命令与问号之间保留一个空格。
六、PJLink 常见错误响应
PJLink 使用统一的错误响应代码。
| 返回代码 | 含义 | 常见处理 |
|---|---|---|
| OK | 命令执行成功 | 更新命令执行结果 |
| ERR1 | 不支持该命令 | 检查设备协议等级 |
| ERR2 | 参数错误 | 检查命令参数 |
| ERR3 | 当前时间或状态不允许执行 | 等待设备状态恢复后再查询 |
| ERR4 | 设备发生故障 | 记录异常并提示检查设备 |
例如:
%1POWR=ERR3\r
表示当前状态下无法执行该命令。
需要特别注意:ERR3 并不等同于网络断开,不能直接将设备标记为离线。
对于中控程序,建议分别记录:
TCP 连接失败
TCP 接收超时
PJLink ERR1
PJLink ERR2
PJLink ERR3
PJLink ERR4
设备返回格式异常
这样在现场调试时,可以更快判断是通信问题、参数问题还是设备运行状态问题。
七、PJLink 认证机制
PJLink 支持认证机制。
如果设备启用了 PJLink 密码认证,中控程序建立 TCP 连接后,需要按照协议规定完成认证,之后才能发送正常控制命令。
1. 未启用认证
在设备没有启用认证的情况下,建立 TCP 连接后,设备通常会返回:
PJLINK 0\r
其中 0 表示当前连接不需要认证。
此时可以直接发送 PJLink 命令。
2. 启用认证
启用认证后,设备会返回随机数,中控程序需要根据随机数、密码和规定的哈希算法计算认证数据。
PJLink 2.10 规范中定义了 SHA-256 认证流程,并对随机数、密码和哈希数据的长度作出规定。
需要注意,旧版 PJLink 设备可能采用早期的 MD5 认证方式。新版标准与旧设备的认证流程不能简单混用。
因此,实际开发时应当:
读取设备连接后的认证响应。
判断设备要求的认证等级。
根据对应规范计算认证数据。
完成认证后再发送控制命令。
认证失败时记录原因,不要无限重试密码。
如果设备没有启用认证,不应人为添加认证数据,否则可能导致命令格式错误。
另外,PJLink 的认证并不等同于加密通信。对于网络安全要求较高的项目,仍应通过独立设备网络、访问控制和网络隔离保护控制接口。
八、PJLink Class 2 有哪些扩展功能?
Class 2 在 Class 1 的基础上增加了更多设备管理和控制能力。
常见扩展命令包括:
| 命令 | 功能 |
|---|---|
| SNUM? | 查询设备序列号 |
| SVER? | 查询软件版本 |
| INNM? | 查询输入端口名称 |
| IRES? | 查询当前输入分辨率 |
| RRES? | 查询推荐分辨率 |
| FILT? | 查询滤网使用时间 |
| RLMP? | 查询光源更换型号 |
| RFIL? | 查询滤网更换型号 |
| SVOL | 设置扬声器音量 |
| MVOL | 设置麦克风音量 |
| FREZ | 画面冻结控制 |
| FREZ? | 查询冻结状态 |
Class 2 还增加了设备搜索和状态主动通知等机制。
例如,中控主机可以通过 UDP 广播搜索局域网中的 PJLink 设备,也可以接收设备主动发送的状态变化通知。
但需要注意:设备支持 Class 2,不代表每个 Class 2 扩展命令都一定实现。具体仍应以设备的 PJLink 功能说明为准。
九、中控系统如何实现 PJLink 控制?
在实际中控开发中,不建议将所有 PJLink 命令直接写在按钮事件里。
更合理的方式是把通信、协议、状态和业务逻辑分开。
1. 设备通信层
负责:
TCP 连接管理
IP 地址和端口配置
发送 ASCII 命令
接收设备响应
CR 结束符处理
连接超时和断线重连
2. 协议处理层
负责:
生成 PJLink 命令
解析响应数据
处理认证
识别错误代码
维护 Class 1 和 Class 2 的命令能力
例如,中控界面发送“投影机开机”操作,协议层生成:
%1POWR 1\r
通信层将其发送到目标设备。
3. 设备状态层
建议至少维护以下状态:
| 状态 | 数据来源 |
|---|---|
| 在线状态 | TCP 连接及通信检测 |
| 电源状态 | POWR? |
| 当前信号源 | INPT? |
| 静音状态 | AVMT? |
| 错误状态 | ERST? |
| 光源使用时间 | LAMP? |
对于状态更新,应当区分“最近一次查询结果”和“当前实际状态”。
例如,投影机已经断网,但界面仍显示上一次查询的开机状态,这时不应该继续把设备显示为在线。
4. 控制逻辑层
中控系统可以将 PJLink 命令封装为统一操作:
投影机开机
投影机关机
HDMI 信号切换
画面遮蔽
取消画面遮蔽
查询设备状态
这样上层场景逻辑不必关心具体命令字符串。
例如,执行“会议模式”时,中控可以依次完成:
投影机开机。
等待投影机完成预热。
切换至指定信号源。
查询当前信号源。
更新中控界面的设备状态。
这才是将 PJLink 真正融入中控系统的方式。
十、实际对接时容易遇到的问题
1. 设备支持网络,但不一定支持 PJLink
不能仅凭投影机具有网口就认定它支持 PJLink。
采购或集成前应确认设备的协议支持情况。
2. 输入源编号不一定一致
不同型号的 HDMI、VGA、DVI、HDBaseT 输入编号可能不同。
建议先查询 INST,再按照设备实际接口建立映射表。
3. 开机和关机不是瞬时完成
投影机通常存在预热和冷却过程。
中控应当使用 POWR? 获取实际状态,而不是只根据命令发送成功就更新界面。
4. 认证方式可能存在版本差异
新旧设备可能采用不同认证流程。
开发时要区分 PJLink 版本、认证等级和设备实际实现。
5. 不要频繁发送查询命令
如果中控管理多台投影机,同时高频查询 POWR、INPT、ERST、LAMP,可能造成不必要的网络通信和设备处理压力。
建议根据状态重要程度设置不同的查询周期,并在开关机、输入切换等关键操作后主动查询。
6. 不要把 ERR3 当成离线
ERR3 表示当前操作不可用,不代表 TCP 连接失败。
只有结合连接状态和超时信息,才能判断设备是否真正离线。
十一、总结
PJLink 是投影机与显示设备领域非常实用的一种标准网络控制协议。
通过 PJLink,中控系统可以实现投影机开关机、输入源切换、静音、错误查询、光源信息查询和设备信息读取。
对于中控软件开发而言,真正需要掌握的并不只是命令表,而是完整的通信和状态管理流程:
正确建立 TCP 连接。
正确处理认证流程。
按照标准格式发送命令。
解析设备返回数据。
区分命令执行结果和设备实际状态。
处理超时、错误和断线恢复。
当这些功能被封装成统一的设备控制接口后,不同品牌的 PJLink 兼容投影机就可以纳入同一套中控系统进行管理。
如果你在实际项目中遇到 PJLink 命令、设备认证、输入源编号、状态反馈或不同品牌兼容方面的问题,欢迎在文章下方留言,或者通过邮件联系 IFU。我们会尽量结合具体设备型号和协议资料进行分析与交流。
官方参考资料
JBMIA:《PJLink Specifications Version 2.10》(2024-02-29)
https://pjlink.jbmia.or.jp/english/data_cl2/PJLink_5-1.pdfJBMIA:PJLink 官方介绍
https://pjlink.jbmia.or.jp/pjlink.htmlJBMIA:PJLink 测试工具及测试说明
https://pjlink.jbmia.or.jp/english/
协议说明: 本文命令示例以 PJLink Class 1 标准格式为基础。实际设备支持的命令、输入源编号、认证方式和扩展功能,请以具体型号的官方说明书及 PJLink 兼容性资料为准。