Pular para o conteúdo principal

Como fazer a integração com o Reach RX2

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

Visão geral​

O Reach RX2 suporta a integração com aplicativos Android e iOS via Bluetooth Classic e oferece duas opções com base na quantidade de metadados que você precisa:

  • Acesse o fluxo NMEA diretamente.
  • Use o Reach RX2 como uma fonte de localização.

Saiba mais nas seções abaixo.

Conecte seu dispositivo móvel ao Reach RX2​

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

  1. Ligue o Reach RX2.
  2. Acesse as configurações de Bluetooth do seu dispositivo.
  3. Encontre o Reach RX2 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 RX2.

Integração com o Reach RX2​

Depois de emparelhar seu dispositivo iOS ou Android com o Reach RX2, 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 RX2 e pode ser feito de duas maneiras:

Acesse o fluxo NMEA diretamente​

Se você quiser mais metadados sobre a posição, a qualidade da posição ou o receptor, você precisará acessar e analisar diretamente o stream NMEA. 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 RX2 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.
dica

Saiba mais sobre o fluxo NMEA na [especificação NMEA] (./nmea-specification.mdx).

Use o Reach RX2 como uma fonte de localização​

Devido ao suporte MFi no Reach RX2, 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 RX2 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 RX2 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.

Para dispositivos Android, você pode ativar a integração sem código usando o Android Mock Location. 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 RX2 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. Nesse caso, você precisa implementar o protocolo com.emlid.corrections, que é usado para fornecer dados de correção aos receptores do Reach. A implementação desse protocolo garante total compatibilidade e operação confiável com os dispositivos Reach.

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

dica

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 RX2 a um aplicativo iOS e estiver pronto para enviar o aplicativo para análise, entre em contato conosco pelo e-mail [email protected] 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 RX2 seja publicado na App Store.