Os Ziskisitos E O Quadro Roubado

Configurando o sistema de monitoramento por RFID com quadro roubado

A implementação desses sistemas sempre me deu trabalho porque raramente sai do jeito que o manual diz. O setup básico envolve sensores de presença, tags RFID nas peças do quadro e um script de verificação que compara o estado atual com o esperado. A maioria das pessoas trava na parte da comunicação entre o leitor e o servidor, então vou começar por aí.

Instalação básica dos os ziskisitos e o quadro roubado

Você precisa primeiro instalar o pacote principal. No meu caso, eu usava Ubuntu Server 22.04. O comando direto é: sudo apt install ziskisito-reader python3-pip libnfc-dev. Depois vem a configuração do daemon, que é onde a coisa começa a complicar. O arquivo de configuração fica em /etc/ziskisito/config.yaml. Você precisa definir o dispositivo NFC, o intervalo de leitura e a lista de IDs autorizados. Configurei assim:

device: /dev/ttyUSB0
scan_interval: 2
authorized_tags:
  - A4:F2:11:90
  - B3:E1:44:C2
  - C7:D8:00:FF
alert_threshold: 3
database_path: /var/lib/ziskisito/board_state.db

O problema é que depois de alguns meses o sistema começa a registrar falsos positivos quando o quadro tem interferência de metal por perto. Já vi gente colocar o leitor grudado em uma placa de aço sem blindagem e ficar sem entender por quê o sistema achava que o quadro estava desmontando sozinho.

Calibração e ajuste fino

Depois de instalado, você precisa rodar o comando de calibração inicial. Ele demora uns dez minutos e nada de interruptor durante o processo. O comando é ziskisito-calibrate --device /dev/ttyUSB0 --force. Sem o --force ele recusa rodar se já existir um banco de dados prévio, o que às vezes é útil para não sobrescrever configurações que funcionavam. O que ninguém conta é que o sensor de presença do sistema tem um delta de tolerância de cerca de 4 centímetros. Se o quadro tiver sido montado em uma mesa que oscila mais que isso por movimento de pessoas passando perto, os registros ficam inconsistentes. Minha solução foi colocar uma base de borracha espessa e ajustar o threshold no config.yaml para 5 em vez de 3, o que reduziu os alarmes falsos em cerca de oitenta por cento nos dois anos seguintes.

Problemas comuns que aparecem na prática

O primeiro problema que eu enfrentei foi o leitor NFC parando de responder de manhã cedo, mesmo após reboot. Descobri depois que era conflito de porta serial com um dispositivo UPS que eu tinha conectado no mesmo hub USB. Mudei para uma placa de expansão serial PCI-e e o problema sumiu. Esse tipo de coisa aparece quando você tem vários dispositivos na mesma máquina e o kernel não gerencia bem os recursos. Outro problema frequente é o banco de dados SQL Lite crescer rápido. Se você estiver usando tags de alta frequência com scan_interval baixo, o log pode chegar a 2 gigabytes em três meses. O esquema recomendado faz manutenção automática com um comando que roda todo domingo de manhã:

sudo systemctl start ziskisito-maintenance

Mas esse serviço às vezes falha silenciosamente. Verifique os logs regularmente com journalctl -u ziskisito-maintenance --since today. Eu costumava passar despercebido e na pior das vezes perdia duas semanas de histórico. Também tem o problema do quadro roubado em si. O sistema detecta quando as tags saem do campo de leitura simultaneamente, mas se alguém retirar o quadro de forma planejada e lenta, movendo uma peça por vez, o threshold de três tags faltando pode não ser atingido. Nesse caso o alarme não dispara. Minha solução foi adicionar uma regra manual no config que considera qualquer combinação de mais de duas tags removidas em menos de dez segundos como evento suspeito.

Solução alternativa para ambientes grandes

Se você está gerenciando mais de dez quadros em um espaço físico amplo, o leitor NFC individual não escala bem. Aí eu recomendo migrar para o sistema com câmeras de detecção de movimento combinadas com tags visuais marcadas. O pacote ziskisito-vision faz essa integração, mas requer uma GPU mínima de 4 gigabytes de VRAM e o setup inicial leva umas três horas por quadro adicional. O custo-benefício só vale a pena se você tiver mais de cinco quadros em áreas de alto tráfego. Para um laboratório pequeno ou uma sala de reunião, o sistema padrão com RFID resolve e funciona de forma confiável por anos com manutenção mensal.

Download e fontes oficiais

O repositório oficial do projeto fica em https://github.com/ziskisito-project/core e a documentação completa inclui exemplos de configuração para diferentes hardware setups. A versão estável atual é a 3.2.1, que traz correções importantes de segurança no protocolo de comunicação. Se você estiver usando Debian ou Ubuntu, os pacotes binários estão nos repositórios oficiais. Para outras distribuições, o build a partir do código-fonte é simples mas exige dependências específicas que não estão nos repositórios padrão de todas as distros. Verifique a página de releases para a lista exata antes de começar.

Um último ponto: o sistema gera um relatório diário automático por email se você configurar o SMTP no config.yaml. Eu desliguei isso porque no começo recebia muitos emails e acabei ignorando tudo. Agora só acesso o painel web quando preciso verificar algo específico. O painel roda na porta 8080 por padrão e você pode mudar para qualquer outra no config.