Agente Linux — Funcionamento

Serviço

O agente corre como serviço systemd rds-agent, que arranca a sessão gráfica ao ligar o equipamento.

Operação	Comando
Ver o estado	`systemctl status rds-agent`
Registo em direto	`journalctl -u rds-agent -f`
Reiniciar	`sudo systemctl restart rds-agent`
Parar	`sudo systemctl stop rds-agent`
Arrancar	`sudo systemctl start rds-agent`

A configuração do ecrã está em /root/.config/rds-agent/config.json.

O agente liga-se ao RDS a cada minuto: recebe o modo, o URL inicial, a lista branca, a playlist e o código de acesso, e as ordens do painel.
A partir do painel pode ligar e desligar o ecrã, ajustar o brilho, escurecê-lo em repouso, limpar a cache, reiniciar de imediato ou programar o reinício e pedir capturas de ecrã.
Envia o seu registo, que vê em Painel do dispositivo → Logs.
Comunica o que reproduz: veja Analytics.
Atualiza-se a partir do RDS: veja Atualizar o agente.

Web Kiosk — carrega o URL inicial em ecrã inteiro; só se pode navegar pelos domínios da lista branca.
Playlist — transfere os vídeos e imagens da playlist, verifica cada ficheiro (CRC) e reprodu-los a partir do disco, também sem ligação.
Offline — reproduz conteúdo local e de pens USB; escolhe-se no RDS ou no próprio ecrã (separador Offline).

Sintoma	O que fazer
Ecrã preto ao arrancar	`systemctl status rds-agent`. Se o equipamento tinha o agente Python, confirme que o `kiosk-browser` está desativado.
Não liga ao RDS	No menu, Estado → Testar internet e Testar RDS: indicam a causa (rede, DNS, portal Wi-Fi, relógio, licença, token).
O teste diz que o RDS recusa a chave	No painel, Desbloquear token nesse ecrã, e volte a associá-lo.
Um ficheiro não reproduz	Menu → Conteúdo → Apagar conteúdo descarregado, para que seja transferido de novo.
As alterações do painel não chegam	Aguarde a ligação seguinte (1 minuto no máximo) ou prima Sincronizar agora em Conteúdo.
`dpkg -i` falha com uma lista de pacotes	Instale com `sudo apt install ./rds-agent_….deb`, que resolve as dependências.