Pular para o conteúdo principal

Drivers de Hardware

Drivers traduzem o hardware BLE físico (antenas/gateways e beacons de diferentes fabricantes) para o modelo interno da plataforma — normalizando leituras de RSSI, mapeamento de bateria e formato de payload. No ION Guard, os drivers não vivem no core: pertencem ao módulo de rastreamento Synapsys (indoor-location), que é distribuído como pacote e não faz parte do repositório do core.

Escopo desta página

O contrato de driver (interface, métodos e drivers concretos como o Minew MG4C) é interno ao módulo Synapsys e reside em app/Modules/IndoorLocation/ — fora da árvore do core. Esta página documenta apenas o que é observável do lado do core (configuração drivers). As assinaturas do contrato de driver devem ser confirmadas na fonte do próprio módulo.

Configuração drivers​

O módulo publica um arquivo de configuração drivers com a seguinte estrutura (chaves confirmadas em tests/Unit/Config/DriversConfigTest.php):

ChaveTipoPropósito
registeredarrayDrivers registrados/disponíveis para o módulo
rssi_calibration_offsetarrayOffsets de calibração de RSSI aplicados por driver/dispositivo
battery_mappingarrayMapeamento de nível de bateria a partir do payload do beacon

A calibração de RSSI conecta-se diretamente ao processo de calibração de rastreamento: os offsets aqui definidos ajustam a distância estimada a partir do sinal recebido.

Estrutura no módulo​

Dentro do módulo, os drivers são organizados em diretórios dedicados (ver Sistema de Módulos):

app/Modules/IndoorLocation/
├── Contracts/    # Interfaces do módulo (inclui o contrato de driver)
├── Drivers/      # Implementações de driver por fabricante
└── config/       # config/drivers.php (registered, rssi_calibration_offset, battery_mapping)

Hardware suportado​

O gateway de campo do Synapsys é o produto Radium (antena BLE→MQTT da Iongrade). O módulo também é compatível com gateways de terceiros — o driver de referência é o Minew MG4C. Detalhes de dispositivos do lado do usuário estão em Antenas e Beacons.

Próximos passos​