Pular para o conteúdo principal

Como fazer a integração com o Reach RX MFi

Este guia explica como integrar os receptores Reach RX com seu aplicativo Android ou iOS usando o Bluetooth Classic para transmissão de posição em tempo real.

Visão geral​

Todas as revisões do Reach RX são compatíveis com aplicativos Android via Bluetooth Classic; no entanto, apenas a segunda versão do Reach RX, que tem certificação MFi, é compatível com a conexão Bluetooth Classic em dispositivos Apple.

Para verificar se o Reach RX tem certificação MFi, verifique o seguinte:

  • a marcação MFi na caixa
  • a marcação MFi na parte inferior do dispositivo
  • os últimos quatro números do número de série são superiores a 2414
tip

Saiba como verificar o número de série de seu Reach RX no guia [Como encontrar o número de série] (../troubleshooting/how-to-find-sn.mdx).

Conecte seu dispositivo móvel ao Reach RX​

Para se conectar ao Reach RX, você precisa emparelhá-lo com seu dispositivo iOS ou Android. Proceda da seguinte forma:

  1. Ligue o Reach RX.
  2. Acesse as configurações de Bluetooth do seu dispositivo.
  3. Encontre o Reach RX na lista de dispositivos disponíveis e selecione-o para iniciar o emparelhamento.
  4. Aguarde até que seu dispositivo conclua o emparelhamento com o Reach RX.

Integração com o Reach RX​

Depois de emparelhar seu dispositivo iOS ou Android com o Reach RX, você pode integrá-lo para ler a posição do Reach em tempo real em seu aplicativo. O método de integração depende da revisão do Reach RX e pode ser feito de duas maneiras:

Acesse o fluxo NMEA diretamente​

If you want more metadata about the position, the position quality, or the receiver, you will need to access and parse the NMEA stream directly. Isso é possível para ambas as plataformas:

  • Para dispositivos iOS, isso pode ser feito usando a [External Accessory framework] da Apple (https://developer.apple.com/documentation/externalaccessory/). Usando essa API, você pode ler o fluxo NMEA e enviar correções para o Reach RX MFi. Para ler o fluxo NMEA, você precisa usar um protocolo especial: com.emlid.nmea.
  • Para dispositivos Android, isso pode ser feito usando a comunicação Bluetooth padrão via Bluetooth Serial Port Profile (SPP). A API Bluetooth do Android permite o acesso direto ao fluxo NMEA e o envio de correções RTK sem a necessidade de nomes de protocolos específicos. A API lida com a conexão e a transferência de dados.
tip

Saiba mais sobre o fluxo NMEA na [especificação NMEA] (https://docs.emlid.com/reachrx/developer-resources/nmea-specification/).

Use o Reach RX MFi como uma fonte de localização​

Para o Reach RX MFi, a maneira mais fácil de integrar é usá-lo como a fonte de localização. O dispositivo no iOS detectará o fluxo de dados do Reach RX e usará a localização do fluxo em vez da unidade GPS interna. Essa técnica também é chamada de localização simulada.

Uma vez conectado, a [Core Location API] padrão do iOS (https://developer.apple.com/documentation/corelocation) começará a informar a localização do receptor Reach RX MFi em vez da unidade GNSS interna do iPhone ou iPad. Se você se baseou anteriormente no framework Core Location, nenhum desenvolvimento será necessário.

note

Para dispositivos Android, você pode ativar a integração sem código usando o Android Mock Location e um aplicativo de terceiros, como o Lefebure. Saiba mais no guia [Obtendo coordenadas do Reach em dispositivos Android via Bluetooth] (../../integration/mock-location).

Configuração do fluxo de correções​

Para trabalhar em RTK com posicionamento de alta precisão, você precisará fornecer correções de RTK ao dispositivo. Você pode enviar correções para o Reach RX das seguintes maneiras:

  • Para dispositivos iOS, você pode configurar o fluxo de correções no aplicativo Emlid Flow e enviá-las para o seu aplicativo em segundo plano.
  • Como alternativa para dispositivos iOS e Android, você pode implementar a funcionalidade do cliente NTRIP dentro do seu aplicativo.

Depois de configurar o fluxo de correções em seu Reach RX, a integração estará concluída.

tip

Consulte o artigo [Correções RTK and NTRIP Casters] (rtk-corrections-and-casters.mdx) para obter detalhes sobre a configuração de um fluxo de correções enviado do seu dispositivo para o receptor.

Antes do lançamento do aplicativo​

Se você integrar o Reach RX MFi a um aplicativo iOS e estiver pronto para enviar o aplicativo para análise, entre em contato conosco pelo e-mail developers@emlid.com e forneça o ID do pacote de aplicativos. Como fabricante do acessório, colocaremos seu aplicativo na lista de permissões.

Também forneceremos a você um PPID acessório especial para incluir nos metadados do seu aplicativo. Isso deve ser suficiente para que seu aplicativo com o suporte do Reach RX seja publicado na App Store.