O princípio
Acesso nunca depende de rede, computador ou internet.
O Mega valida a digital e a senha localmente, contra os cadastros gravados na própria memória. Se o Wi-Fi cair, o servidor sair do ar ou a câmera travar, a porta continua abrindo para quem tem direito. A rede serve para auditoria e administração, nunca como condição para abrir.
Cadastro e credenciais
Pessoas
- Até 100 cadastros na vida da instalação, IDs 001 a 100, automáticos.
- Um ID nunca é reutilizado, nem de pessoa desativada.
- Cada pessoa tem uma digital, uma senha de 6 dígitos e, se quiser, um cartão RFID.
- No teclado o login é ID + senha: o ID (1 a 3 dígitos) e #, depois a senha e #.
- Desativar não apaga: reativar devolve o mesmo ID, senha e digital.
Administrador
- Senha de 10 dígitos definida no
Config.hlocal, fora do repositório. - Menu: cadastrar, desativar, reativar, vincular cartão e remover cartão.
- Cadastro lê a digital duas vezes (tirando o dedo entre as leituras) e pede a senha duas vezes; só grava se as duas credenciais forem válidas.
- Digital repetida é recusada, mesmo de pessoa inativa. Senhas podem se repetir entre IDs, porque o ID vem antes.
Como as senhas ficam guardadas
Os cadastros ficam na EEPROM do Mega, 100 registros de 31 bytes com uma área de diário para gravação segura. A senha não é guardada: guarda-se o SHA-256 dela, truncado em 16 bytes, com um sal de 4 bytes por registro. As digitais ficam dentro do leitor. Nenhum evento enviado carrega senha ou modelo de digital.
Teclas: # confirma, * limpa, D cancela e volta. Uma senha pela metade não impede de usar a digital. Na 5ª falha seguida o teclado trava por 60 s.
Os cartões (MIFARE, lidos pelo RC522) ficam numa área própria da EEPROM: o UID do cartão e uma soma de conferência por cadastro.
A porta e seus tempos
| Situação | O que acontece |
|---|---|
| Porta fechada | Só quando os dois botões estão pressionados e estáveis (filtro contra repique). |
| Autorizado e não abriu | A janela expira em 60 s; três bipes de 200 ms avisam. |
| Aberta com autorização | Até 5 min sem aviso. Depois, vermelho piscando, "Feche a porta" no LCD e um bipe de 250 ms a cada 2 s até fechar. |
| Aberta sem autorização | Forçada, ou já aberta quando o sistema ligou: vermelho piscando e bipe rápido (250 ms ligado, 250 ms desligado) até fechar. Gera evento crítico. |
| Fechou | Encerra o ciclo, desliga a fechadura e espera a próxima credencial. |
LOCK_MODE = 0: tudo funciona, menos a saída de potência, até o ensaio da fechadura.Cores do LED
| Cor | Significa |
|---|---|
| Azul, 200 ms a cada 10 s | em espera |
| Ciano | digitando o ID; flash de 150 ms ao ler cartão ou digital |
| Magenta | digitando a senha |
| Verde | liberado, aguardando abrir |
| Amarelo piscando | porta aberta com autorização |
| Branco | menus e cadastro |
| Vermelho fixo | erro ou credencial recusada |
| Vermelho piscando a cada 1 s | teclado travado |
| Vermelho piscando rápido | alarme: aberta tempo demais ou sem autorização |
Eventos registrados
Tudo que vira linha no histórico.
| Grupo | Tipos |
|---|---|
| Acesso | access_granted · access_denied · entry_expired · keypad_locked |
| Porta | door_opened · door_closed · door_timeout · forced_open |
| Cadastro | user_enrolled · user_disabled · user_enabled · password_reset · enroll_failed · card_linked · card_unlinked · user_snapshot |
| Sistema | device_boot · storage_error · admin_login |
Cada evento leva um identificador formado pelo aparelho, pela sessão do Mega e por um contador, o método (digital, senha, cartão, administrador, sistema), o ID da pessoa quando conhecido e o horário. Sem relógio sincronizado o evento sai só com o tempo desde que o Mega ligou: nenhuma data é inventada.
Do Mega à câmera
Uma conversa serial com conferência e confirmação.
- Serial a 38400 bps, com divisor de tensão no sentido Mega → câmera.
- Cada quadro leva um CRC-16/CCITT: quadro corrompido é descartado e reenviado.
- O Mega guarda até 16 eventos e só tira um da fila depois que a câmera confirma. A câmera guarda até 8 e só tira depois que o servidor confirma.
- Prova de frescor da foto. Depois de capturar, a câmera pede ao Mega uma resposta que só vale para aquele evento e por pouco tempo. Sem ela, o evento segue sem foto: uma foto velha nunca é anexada a um acesso novo.
- Fila cheia descarta o mais novo e conta a perda, que aparece no painel. A fila mora em RAM: um reinício perde o que estava pendente, limite aceito para a demonstração.
Da câmera ao servidor
- Wi-Fi de 2,4 GHz sem economia de energia (com ela, a câmera deixava de receber pacotes).
- Relógio por NTP; se a internet não alcança os servidores de hora, usa a hora que o próprio servidor devolve.
- Sinal de vida a cada 10 s com o tamanho da fila e os contadores de perda; busca de comandos a cada 3 s.
- Rejeição definitiva (o mesmo item recusado 5 vezes em 30 s com rede estável) descarta o item e conta. Chave errada ou servidor fora do ar mantêm o item na fila.
- HTTPS quando o endereço começa com
https://: a câmera confere o certificado contra as raízes ISRG X1 e X2 da Let's Encrypt gravadas no firmware e mantém a conexão aberta entre pedidos, para não renegociar a cada 3 s. - Atualização do próprio firmware pelo Wi-Fi e regravação do Mega pela rede, protegidas por senha e por assinatura do arquivo.
Testes
O repositório tem mais de 200 testes automáticos: o servidor inteiro, a máquina de estados do Mega em C++ com relógio simulado, os trechos de rede da câmera compilados com dublês do hardware, o protocolo serial, o armazenamento na EEPROM e simulações no Wokwi (teclado, LED e fechadura, porta aberta, senha errada). Os dois programas compilam com o core AVR 1.8.8 e o core ESP32 3.3.12. A validação em hardware é o próximo passo.
python3 -m unittest discover -s tests -v