Saltar al contenido principal

Cómo integrar con Reach RX MFi

Esta guía explica cómo integrar los receptores Reach RX con tu aplicación Android o iOS mediante Bluetooth Classic para transmitir la posición en tiempo real.

Resumen​

Todas las revisiones de Reach RX son compatibles con aplicaciones Android a través de Bluetooth Classic; sin embargo, solo la segunda versión de Reach RX, que cuenta con la certificación MFi, admite la conexión Bluetooth Classic en dispositivos Apple.

Para comprobar si tu Reach RX cuenta con la certificación MFi, comprueba lo siguiente:

  • la marca MFi en la caja
  • la marca MFi en la parte inferior del dispositivo
  • las cuatro últimas cifras del número de serie son superiores a 2414
tip

Aprende a comprobar el número de serie de tu Reach RX en la guía Cómo encontrar el número de serie.

Conectar tu dispositivo móvil a Reach RX​

Para conectarte a tu Reach RX, tienes que emparejarlo con tu dispositivo iOS o Android. Haga lo siguiente:

  1. Enciende tu Reach RX.
  2. Ve a la configuración de Bluetooth de tu dispositivo.
  3. Busca Reach RX en la lista de dispositivos disponibles y selecciónalo para iniciar el emparejamiento.
  4. Espera a que se complete el emparejamiento de tu dispositivo con Reach RX.

Integración con Reach RX​

Tras emparejar tu dispositivo iOS o Android con Reach RX, puedes integrarlo para leer la posición de Reach en tiempo real dentro de tu aplicación. El método de integración depende de la revisión de Reach RX y puede hacerse de dos maneras:

Accede directamente al flujo NMEA​

Si quieres más metadatos sobre la posición, la calidad de la posición o el receptor, tendrás que acceder y analizar directamente el flujo NMEA. Esto es posible para ambas plataformas:

  • Para dispositivos iOS, esto se puede hacer utilizando el [Marco de accesorios externos] de Apple(https://developer.apple.com/documentation/externalaccessory/). Usando esta API, puedes tanto leer el flujo NMEA como enviar correcciones al Reach RX MFi. Para leer el flujo NMEA, es necesario utilizar un protocolo especial: com.emlid.nmea**.
  • Para los dispositivos Android, esto se puede hacer utilizando la comunicación Bluetooth estándar a través de Serial Port Profile (SPP) Bluetooth. La API Bluetooth de Android permite acceder directamente al flujo NMEA y enviar correcciones RTK sin necesidad de nombres de protocolo específicos. La API gestiona la conexión y la transferencia de datos.
tip

Obtén más información sobre el flujo NMEA en la especificación NMEA.

Utilizar Reach RX MFi como fuente de localización​

Para Reach RX MFi, la forma más sencilla de integrarlo es utilizarlo como fuente de localización. El dispositivo en iOS detectará el flujo de datos de Reach RX y utilizará la ubicación del flujo en lugar de la unidad GPS interna. Esta técnica también se denomina localización simulada.

Una vez conectado, la [Core Location API] estándar de iOS (https://developer.apple.com/documentation/corelocation) empezará a informar de la ubicación del receptor Reach RX MFi en lugar de la unidad GNSS interna del iPhone o iPad. Si anteriormente te has basado en el marco Core Location, no es necesario ningún desarrollo.

note

Para dispositivos Android, puedes habilitar la integración sin código utilizando Android Mock Location y una aplicación de terceros como Lefebure. Obtén más información en la guía Cómo obtener coordenadas de Reach en dispositivos Android mediante Bluetooth.

Configurar el flujo de correcciones​

Para trabajar en RTK con posicionamiento de alta precisión, deberás proporcionar correcciones RTK al dispositivo. Puedes enviar correcciones a Reach RX de las siguientes maneras:

  • Para dispositivos iOS, puede configurar el flujo de correcciones dentro de la aplicación Emlid Flow y enviarlas a su aplicación en segundo plano.
  • Además, para dispositivos iOS y Android, puedes implementar la funcionalidad de cliente NTRIP dentro de tu aplicación.

Tras configurar el flujo de correcciones en tu Reach RX, la integración está completa.

tip

Consulta el artículo RTK Corrections and NTRIP Casters para obtener más detalles sobre la configuración de un flujo de correcciones enviado desde tu dispositivo al receptor.

Antes del lanzamiento de la aplicación​

Si integras tu Reach RX MFi con una aplicación iOS y ya puedes enviar la aplicación para su revisión, contáctanos en developers@emlid.com y proporciónanos tu ID de paquete de aplicaciones. Como fabricante de accesorios, pondremos tu aplicación en la lista blanca.

También te proporcionaremos un PPID accesorio especial para que lo incluya en los metadatos de tu aplicación. Esto debería bastar para que tu aplicación con soporte Reach RX se publique en la App Store.