Firmware

Quem entra, quando e o que fica registrado

Dois programas: MegaControlador, que decide o acesso, e Esp32CamRede, que leva cada evento e cada foto ao servidor. Escrito por Marcelo Reis; HTTPS da câmera acrescentado em 07 e 08/11.

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.h local, 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çãoO que acontece
Porta fechadaSó quando os dois botões estão pressionados e estáveis (filtro contra repique).
Autorizado e não abriuA janela expira em 60 s; três bipes de 200 ms avisam.
Aberta com autorizaçãoAté 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çãoForç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.
FechouEncerra o ciclo, desliga a fechadura e espera a próxima credencial.
O tempo da bobina não é a janela de acesso. A fechadura de armário aguenta só alguns segundos energizada; o firmware tem modo de pulso e modo de manter, e o segundo só vale se o fabricante permitir. Por isso ele sai de fábrica com LOCK_MODE = 0: tudo funciona, menos a saída de potência, até o ensaio da fechadura.

Cores do LED

CorSignifica
Azul, 200 ms a cada 10 sem espera
Cianodigitando o ID; flash de 150 ms ao ler cartão ou digital
Magentadigitando a senha
Verdeliberado, aguardando abrir
Amarelo piscandoporta aberta com autorização
Brancomenus e cadastro
Vermelho fixoerro ou credencial recusada
Vermelho piscando a cada 1 steclado travado
Vermelho piscando rápidoalarme: aberta tempo demais ou sem autorização

Eventos registrados

Tudo que vira linha no histórico.

GrupoTipos
Acessoaccess_granted · access_denied · entry_expired · keypad_locked
Portadoor_opened · door_closed · door_timeout · forced_open
Cadastrouser_enrolled · user_disabled · user_enabled · password_reset · enroll_failed · card_linked · card_unlinked · user_snapshot
Sistemadevice_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.

Da câmera ao servidor

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
AnteriorEletrônicaPróximaServidor e nuvem