Visao Geral
O driver 4Drivers PJ Link Projector controla qualquer projetor ou display compativel com o padrao PJ Link Class 1 (JBMIA) atraves de rede IP, sem depender de comandos proprietarios de fabricante. Ele implementa o protocolo oficial documentado em pjlink.jbmia.or.jp.
- Liga/desliga o projetor e monitora o estado real de energia (Desligado, Aquecendo, Ligado, Resfriando)
- Seleciona entradas de video pelas 5 classes oficiais do protocolo: RGB, Video, Digital (HDMI/DVI), Storage (USB) e Network
- Le periodicamente horas de lampada, status de erro, mute e outras informacoes do equipamento
- Suporta autenticacao PJ Link (MD5) quando a seguranca esta ativa no projetor
- Mantem a conexao TCP viva com um keep alive configuravel, evitando o timeout de 30s do protocolo
- Envia comandos crus PJ Link para funcoes nao mapeadas na interface do driver
- Inclui sistema de licenciamento/trial e integracao opcional com DriverCentral
O PJ Link e um padrao aberto: qualquer projetor ou display que anuncie compatibilidade com "PJLink Class 1" pode ser controlado por este driver, independente do fabricante.
Requisitos
- Projetor ou display com PJ Link Class 1 habilitado no menu de rede do equipamento (em muitos modelos essa opcao vem desativada de fabrica)
- Projetor e controlador Control4 na mesma rede/VLAN, com a porta TCP 4352 liberada (ou a porta customizada configurada no projetor)
- IP fixo (ou reserva DHCP) configurado no projetor
- Senha PJ Link do projetor em maos, caso a seguranca esteja ativada no equipamento
Propriedades
PJ Link Settings
| Propriedade | Tipo | Padrao | Descricao |
|---|
| IP | Texto | — | Endereco IP do projetor na rede |
| TCP Port | Numero | 4352 | Porta TCP do protocolo PJ Link. So altere se o projetor usar uma porta customizada |
| PJLink Password | Senha | — | Senha PJ Link do projetor. Deixe vazio se a seguranca estiver desativada no equipamento |
| Keep Alive Interval-Seconds | Numero (10-25) | 20 | Intervalo do query POWR ? usado como keep alive. O protocolo PJ Link derruba a conexao apos 30s sem trafego |
| Command Delay-Milliseconds | Numero (200-2500) | 300 | Intervalo minimo entre comandos enviados em sequencia |
Status (somente leitura)
| Propriedade | Origem (comando PJ Link) | Descricao |
|---|
| IP Conn Status | — | Estado da conexao TCP: Conectado, Desconectado, erro de autenticacao, etc. |
| Power Status | POWR ? | Desligado, Aquecendo (Warm-up), Ligado ou Resfriando (Cooling) |
| Input Status | INPT ? | Codigo da entrada de video selecionada no momento |
| Mute Status | AVMT ? | 11=video mudo, 21=audio mudo, 31=video e audio mudos, 30=sem mute |
| Lamp Hours | LAMP ? | Horas acumuladas de uso da(s) lampada(s) |
| Error Status | ERST ? | Status de fan, lampada, temperatura, tampa, filtro e outros erros |
| Projector Name | NAME ? | Nome configurado no proprio projetor |
| Manufacturer | INF1 ? | Fabricante informado pelo equipamento |
| Product Name | INF2 ? | Nome do produto/modelo informado pelo equipamento |
| Other Info | INFO ? | Informacoes livres adicionais do fabricante |
| PJ Link Class | CLSS ? | Classe PJ Link suportada pelo equipamento (este driver implementa Class 1) |
| Available Inputs | INST ? | Lista dos codigos de entrada realmente suportados por aquele projetor especifico |
| Controller MAC Address | — | MAC do controlador Control4, usado internamente na validacao de licenca |
As informacoes de fabricante, modelo, classe e lista de entradas (INF1/INF2/INFO/CLSS/INST) sao consultadas uma unica vez por conexao, ao conectar. Erro, lampada e mute sao atualizados a cada 5 ciclos do keep alive (por padrao, a cada ~100 segundos) para nao sobrecarregar o projetor com polling desnecessario. Use a acao Refresh Status para forcar uma atualizacao imediata de tudo.
Navigation (fora do padrao PJ Link)
| Propriedade | Tipo | Descricao |
|---|
| Cmd UP | Texto | Comando cru enviado quando o proxy solicitar UP (cima) |
| Cmd DOWN | Texto | Comando cru enviado quando o proxy solicitar DOWN (baixo) |
| Cmd ENTER | Texto | Comando cru enviado quando o proxy solicitar ENTER |
| Cmd CANCEL | Texto | Comando cru enviado quando o proxy solicitar CANCEL |
O protocolo PJ Link Class 1 nao define comandos de navegacao de menu (OSD). Esses quatro campos existem apenas para o caso do fabricante do seu projetor ter uma extensao proprietaria de comando para navegar no menu. Deixe em branco se nao souber ou se o projetor nao suportar — o driver nao trava nem gera erro, apenas ignora o comando.
Ajustes de Imagem (fora do padrao PJ Link)
| Propriedade | Tipo | Descricao |
|---|
| Cmd Brightness Up | Texto | Comando cru enviado quando o proxy solicitar aumento de brilho |
| Cmd Brightness Down | Texto | Comando cru enviado quando o proxy solicitar reducao de brilho |
| Cmd Contrast Up | Texto | Comando cru enviado quando o proxy solicitar aumento de contraste |
| Cmd Contrast Down | Texto | Comando cru enviado quando o proxy solicitar reducao de contraste |
Assim como a navegacao de menu, brilho e contraste tambem nao fazem parte do protocolo PJ Link Class 1 — a especificacao oficial nao define nenhum comando de ajuste de imagem. Preencha esses campos apenas se o fabricante do seu projetor tiver uma extensao proprietaria para isso. Deixe em branco caso contrario.
Driver License
| Propriedade | Tipo | Padrao | Descricao |
|---|
| License Key | Texto | Trial | Chave de licenca fornecida pela 4Drivers. Use Trial para avaliacao |
| Validation | Texto | auto | Status da licenca — preenchido automaticamente (somente leitura) |
| Developers Use | Senha | — | Reservado para uso da 4Drivers (superdebug) |
Driver Info
| Propriedade | Tipo | Padrao | Descricao |
|---|
| Debug Mode | Lista | Off | Print exibe mensagens de operacao no log do Composer (conexao, erros, comandos de alto nivel). O conteudo real trafegado na rede (TX/RX) so aparece com o modo restrito de desenvolvedor ativo |
| Driver Version | Texto | — | Versao instalada do driver (somente leitura) |
Conexoes de Video
O PJ Link define 5 classes oficiais de entrada de video (comando INPT, capitulo 4.3 da especificacao). O driver expoe uma conexao para cada classe, ja mapeada para o codigo PJ Link correspondente:
| ID da conexao | Nome | Classe PJ Link | Codigo INPT |
|---|
| 1000 | RGB 1 | RGB (1) | 11 |
| 1001 | RGB 2 | RGB (1) | 12 |
| 1002 | Digital 1 (HDMI) | Digital (3) | 31 |
| 1003 | Digital 2 (HDMI) | Digital (3) | 32 |
| 1004 | Video (Composto) | Video (2) | 21 |
| 1005 | Network | Network (5) | 51 |
| 1006 | Storage | Storage (4) | 41 |
Conecte cada entrada fisica do seu projetor (na aba Connections do Composer) a uma dessas conexoes conforme o tipo de sinal. A propriedade Available Inputs mostra quais codigos aquele projetor especifico realmente suporta — use-a para confirmar o mapeamento.
Actions
| Acao | Descricao |
|---|
| Power ON | Envia %1POWR 1 — liga o projetor |
| Power OFF | Envia %1POWR 0 — desliga o projetor |
| Refresh Status | Forca a consulta imediata de todos os status: energia, entrada, erro, lampada, nome, mute, fabricante, modelo, classe e lista de entradas |
| Send Command | Envia um comando PJ Link cru digitado manualmente, ex: %1POWR 1. Util para comandos de extensao do fabricante nao cobertos pelo driver |
Commands (programaveis)
| Comando | Parametro | Descricao |
|---|
| Power | Acao: ON / OFF | Liga ou desliga o projetor |
| Select Input | Input: 1000-1006 | Seleciona a entrada de video pelo ID da conexao (ver tabela de Conexoes de Video) |
| Send Command | Command: texto | Envia um comando PJ Link cru, igual a action Send Command |
Autenticacao PJ Link
Se o projetor tiver a seguranca PJ Link ativada, ele envia um desafio aleatorio ao conectar. O driver calcula automaticamente o hash MD5 (numero aleatorio + senha) e o envia junto dos comandos seguintes, conforme o capitulo 5 da especificacao.
- Preencha a propriedade PJLink Password com a senha configurada no projetor
- Se a seguranca estiver desativada no equipamento, deixe o campo vazio
- Se a senha estiver incorreta, a propriedade IP Conn Status exibe "Erro de autenticacao (senha invalida)"
Conexao e Keep Alive
O PJ Link opera exclusivamente por TCP/IP (nao existe versao serial do protocolo). O equipamento derruba a conexao apos 30 segundos sem trafego. Para evitar isso, o driver envia um POWR ? periodico (propriedade Keep Alive Interval-Seconds, padrao 20s), que serve tanto de keep alive quanto de atualizacao do status de energia.
- O driver envia comandos assim que o socket TCP conecta, sem esperar confirmacao adicional do handshake PJ Link — isso evita que o driver fique "travado" caso o equipamento nao responda ao protocolo exatamente como esperado
- Se a conexao cair, o driver tenta reconectar automaticamente a cada 5 segundos
- Comandos enviados antes da conexao abrir ficam em fila e sao despachados assim que o socket conecta
Configuracao Passo a Passo
1 — Habilitar PJ Link no projetor
- No menu de rede do projetor, ative a opcao PJLink (nome pode variar por fabricante)
- Anote o IP do projetor e, se aplicavel, a senha PJ Link configurada
2 — Adicionar o driver ao projeto
- Copie
4Drivers_PJLink_Projector.c4z para a pasta de drivers do Composer
Windows: C:\Users\[usuario]\Documents\Control4\Drivers\
- No Composer Pro, busque por PJ Link Projector e arraste o driver para a sala do projetor
3 — Configurar a rede
- Abra a aba Properties do driver
- Preencha IP com o endereco do projetor
- Confirme a TCP Port (4352 e o padrao do protocolo — so altere se o projetor usar outra)
- Se o projetor tiver seguranca PJ Link ativa, preencha PJLink Password
- Salve (File > Save) e observe a propriedade IP Conn Status mudar para Conectado
4 — Conectar as entradas de video
- Na aba Connections, ligue cada fonte de video (Blu-ray, Apple TV, etc.) a uma das conexoes RGB, Digital (HDMI), Video, Network ou Storage do driver, de acordo com o tipo de entrada fisica do projetor
- Confira a propriedade Available Inputs para validar quais entradas o projetor realmente reporta suportar
5 — Testar
- Nas Actions, clique em Power ON e confirme que Power Status muda para Aquecendo e depois Ligado
- Teste a troca de entrada pela programacao ou pelo comando Select Input
- Clique em Refresh Status e confira se Lamp Hours, Error Status, Manufacturer e Product Name foram preenchidos
Se nada acontecer ao ligar/desligar, confirme que o PJLink esta realmente habilitado no menu do projetor e que a porta 4352 nao esta bloqueada por firewall entre o controlador e o projetor.
6 — Finalizar
- Certifique-se de que Debug Mode esta em
Off
- Salve e publique o projeto
Configuracao concluida. O driver mantera a conexao ativa via keep alive e atualizara os status automaticamente.
Resolucao de Problemas
| Problema | Solucao |
|---|
| IP Conn Status fica "Desconectado" | Confirme o IP e a porta TCP do projetor, verifique se o PJLink esta habilitado no menu de rede do equipamento e se nao ha firewall bloqueando a porta 4352 |
| "Erro de autenticacao (senha invalida)" | Confira a senha PJ Link cadastrada no projetor e reescreva na propriedade PJLink Password |
| Comando de entrada nao troca o video | Verifique na propriedade Available Inputs se aquele codigo realmente existe no projetor. Confirme o mapeamento da conexao usada em Connections |
| Lamp Hours / Error Status nunca atualizam | Esses campos sao lidos a cada ~100s por padrao. Use a acao Refresh Status para forcar a atualizacao imediata |
| UP/DOWN/ENTER/CANCEL nao fazem nada | Esperado: o PJ Link Class 1 nao define navegacao de menu. Preencha os campos Cmd UP/DOWN/ENTER/CANCEL com o comando proprietario do fabricante, se existir |
Informacoes Tecnicas
| Item | Valor |
|---|
| Protocolo | PJ Link Class 1 (JBMIA) — pjlink.jbmia.or.jp |
| Transporte | TCP/IP, porta padrao 4352 (apenas rede — PJ Link nao define versao serial) |
| Formato de comando | %1CCCC PARAM<CR> / resposta %1CCCC=VALOR<CR> |
| Autenticacao | Desafio aleatorio + MD5(random+senha), quando a seguranca do projetor esta ativa |
| Keep alive | POWR ? periodico (padrao 20s) para evitar o timeout de 30s do protocolo |
| Persistencia | Dados de licenca/trial em PersistData — sobrevivem ao reboot do controlador |
Change Log
| Versao | Data | Alteracoes |
|---|
| 1051 | 01/08/2026 | Adicionados campos de comando cru para ajuste de imagem (Brightness/Contrast) e variaveis internas para os dados lidos do projetor |
| 1050 | 01/08/2026 | Versao Inicial |
