bermuda

Trilateração BLE das Bermudas

• Rastreie dispositivos bluetooth por área (sala) no HomeAssistant, usando dispositivos ESPHome bluetooth_proxy.

• (eventualmente) Triangule as posições dos dispositivos! Tipo, em um mapa. Talvez.

O que faz:

Bermuda tem como objetivo permitir que você rastreie qualquer dispositivo bluetooth e faça com que o Homeassistant lhe diga onde esse dispositivo está em sua casa. O único hardware extra que você precisa são dispositivos esp32 executando esphome que atuam como proxies bluetooth. Alternativamente, os dispositivos Shelly Plus também podem executar esta função.

• A localização do dispositivo com base na área (ou seja, presença na sala no nível do dispositivo) está funcionando razoavelmente bem.
• Cria sensores de área e distância para dispositivos que você escolher
• Suporta dispositivos iBeacon, incluindo aqueles com endereços MAC aleatórios (como telefones Android executando o aplicativo HA Companion)
• Suporta IRK (chaves resolvíveis) por meio do componente principal do dispositivo BLE privado. Assim que o seu dispositivo iOS (ou Android!) estiver configurado no dispositivo BLE privado, ele também receberá automaticamente sensores das Bermudas!
• Cria entidades device_tracker para dispositivos escolhidos, que podem ser vinculadas a "Pessoas" para rastreamento residencial/não residencial
• Configurações configuráveis ​​para nível de referência rssi, atenuação ambiental, raio máximo de rastreamento
• Fornece um dump json/yaml abrangente de dispositivos e suas distâncias de cada receptor Bluetooth, por meio do serviço bermuda.dump_devices .

O que você precisa:

• Um ou mais dispositivos que fornecem informações de proxy Bluetooth para HA usando o componente bluetooth_proxy do esphome. Gosto das placas D1-Mini32 porque são baratas e fáceis de implantar. Os dispositivos proxy bluetooth Shelly Plus funcionam bem. Apenas dispositivos Bluetooth com suporte nativo são suportados, o que significa que não há suporte atual ou planejado para dispositivos MQTT, etc.

• USB Bluetooth em seu host HA não é ideal, pois não registra a data e hora dos pacotes de anúncios. No entanto, ele pode ser usado para rastreamento simples "Casa/Não Casa", e o suporte à distância da área está ativado atualmente.

• Alguns dispositivos Bluetooth BLE que você deseja rastrear. Relógios inteligentes, blocos de farol, termômetros, etc.

• Instale Bermudas via HACS:

Documentação e ajuda - o Wiki

Consulte o Wiki para obter mais informações sobre como funciona e como configurar as Bermudas para sua casa.

Capturas de tela

Após a instalação, a integração deverá ficar visível em Configurações, Dispositivos e Serviços

Pressione o botão CONFIGURE para ver a caixa de diálogo de configuração. Na parte inferior há um campo onde você pode inserir/listar quaisquer dispositivos Bluetooth que o sistema possa ver. A escolha de dispositivos irá adicioná-los à lista de dispositivos configurados e criar entidades de sensores para eles. Consulte Como funcionam as configurações? para mais informações.

A escolha da tela do dispositivo mostra os sensores atuais e outras informações. Observe que existem sensores extras na seção “não mostrado” que estão desabilitados por padrão (a captura de tela mostra vários deles já habilitados). Você pode editar as propriedades deles para habilitá-los para dados mais detalhados sobre a localização do seu dispositivo. No entanto, isso se destina principalmente à solução de problemas ou ao desenvolvimento.

As informações do sensor também incluem atributos de nome e id da área, endereços MAC relevantes, etc.

Em Configurações, Pessoas, você pode definir qualquer dispositivo Bermuda para rastrear o status de casa/ausente de qualquer pessoa/usuário.

Perguntas frequentes

Veja o FAQ no Wiki!

FAZER / Ideias

• Passar a realizar atualizações ao receber anúncios, em vez de pesquisas periódicas (não, intervalos funcionam melhor)
• "Resolver" a aproximação em tempo real de distâncias entre proxy usando Desigualdade Triangular
• Resolva as coordenadas x/y de todos os scanners e proxies (!)
• Algum tipo de mapa, basta escolher dois proxies como um vetor do eixo x e ir
• Configuração para definir localizações absolutas de dois proxies
• Apoie alguma forma de "fixar" mais de dois proxies/tags e não quebre.
• Uma interface para definir Áreas em relação aos proxies fixados
• Experimente alguns desses algoritmos para melhorar a precisão (matemática demais para mim!). Particularmente ponderando distâncias mais curtas mais altas e talvez a impressão digital de similaridade de cosseno, possivelmente contra beacons fixos, bem como para suavizar as flutuações ambientais de rssi.

Dicas de hackers

Quer melhorar isso? Incrível! Tenha em mente que esta é minha primeira integração de HA e sou muito mais administrador de sistemas grisalho do que programador, então se onde estou fazendo coisas estúpidas, eu realmente gostaria de receber algumas melhorias!

Você pode começar usando o serviço bermuda.dump_devices para examinar o estado interno.

Usando o serviço bermuda.dump_devices

Basta chamar o serviço bermuda.dump_devices para obter um despejo completo das estruturas de dados internas que as bermudas usam para rastrear e calcular seu estado. Isso pode ser útil para descobrir o que está acontecendo e solucionar problemas, ou para usar se você tiver uma necessidade muito personalizada que pode ser resolvida com sensores de modelo, etc.

Se chamado sem parâmetros, o serviço retornará todos os dados. Estão disponíveis parâmetros que permitem limitar ou reformatar os dados resultantes para facilitar o trabalho. Em particular, o parâmetro addresses é útil para retornar apenas dados relevantes para um ou mais endereços MAC (ou UUIDs de iBeacon). Veja as informações sobre parâmetros na página Services do assistente inicial, em Developer Tools .

Importante: Se você decidir usar os resultados desta chamada para seus próprios modelos, etc., tenha em mente que o formato pode mudar em qualquer versão e não será necessariamente considerado uma "mudança significativa". Isso ocorre porque a estrutura é usada internamente, em vez de ser uma API publicada. Dito isto, serão feitos esforços para indicar nas notas de lançamento se os campos da estrutura serão renomeados ou movidos, mas não para adicionar novos itens.

Arte Anterior

As integrações bluetooth_tracker e ble_tracker são construídas apenas para fornecer uma determinação "casa/não casa" e não fazem localização baseada em "Área". (nota: “Zonas” são locais fora de casa, enquanto “Áreas” são quartos/áreas dentro de casa). Eu queria ser livre para experimentar isso de maneiras que talvez não se adequassem ao núcleo, mas espero que pelo menos parte disso possa encontrar um lugar na base de código principal um dia.

O script "monitor" usa Pis independentes para coletar dados do Bluetooth e, em seguida, transferi-los para o MQTT. Ele não usa os recursos bluetooth_proxy que considero o futuro da rede bluetooth doméstica (bem, é para minha casa, de qualquer maneira!).

ESPrescência parece legal, mas não quero dedicar meus nós ao uso não-esphome e, novamente, ele não aproveita os recursos de proxy bluetooth agora no HA. Provavelmente estou reinventando bastante a roda do ESPrescense.

Instalação

Definitivamente use a interface HACS! Depois de instalar o HACS, vá para Integrations , clique no menu de almôndegas no canto superior direito e escolha Custom Repositories . Cole agittins/bermuda no campo Repository e escolha Integration para a Category . Clique em Add .

Agora você deve ser capaz de adicionar a integração Bermuda BLE Trilateration . Depois de fazer isso, você precisa reiniciar o Homeassistant e, em Settings , Devices & Services escolher Add Integration e procurar Bermuda BLE Trilateration . É possível que ele detecte automaticamente para você apenas percebendo dispositivos Bluetooth próximos.

Depois que a integração for adicionada, você precisará configurar seus dispositivos clicando em Configure em Devices and Services , Bermuda BLE Trilateration .

Na caixa de diálogo Configuration , você pode escolher quais dispositivos Bluetooth deseja que a integração rastreie.

As instruções abaixo são as notas genéricas do modelo:

1. Usando a ferramenta de sua escolha, abra o diretório (pasta) para sua configuração de HA (onde você encontra configuration.yaml ).
2. Se você não tiver um diretório (pasta) custom_components lá, será necessário criá-lo.
3. No diretório custom_components (pasta) crie uma nova pasta chamada bermuda .
4. Baixe todos os arquivos do diretório custom_components/bermuda/ (pasta) neste repositório.
5. Coloque os arquivos que você baixou no novo diretório (pasta) que você criou.
6. Reinicie o Assistente Doméstico
7. Na UI do HA vá em "Configuração" -> "Integrações" clique em "+" e pesquise "Bermuda BLE Trilateration"

Contribuições são bem-vindas!

Se você quiser contribuir para isso, leia as diretrizes de contribuição

Créditos

Este projeto foi gerado a partir do modelo Cookiecutter de componente personalizado do Home Assistant do @ oncleben31.

O modelo de código foi retirado principalmente do modelo de integração_blueprint do @Ludeeus Guia do usuário do Cookiecutter **

---