Comment intégrer avec Reach RX2
Ce guide explique comment intégrer les récepteurs Reach RX2 avec votre application Android ou iOS en utilisant Bluetooth Classic pour la diffusion de position en temps réel.
Vue d'ensemble
Reach RX2 prend en charge l'intégration avec les applications Android et iOS via Bluetooth Classic et offre deux options basées sur la quantité de métadonnées dont vous avez besoin :
- Accéder directement au flux NMEA.
- Utiliser Reach RX2 comme source de localisation.
En savoir plus dans les sections ci-dessous.
Connectez votre appareil mobile à Reach RX2
Pour vous connecter à votre Reach RX2, vous devez l'appairer avec votre appareil iOS ou Android. Faites comme suit :
- Allumez votre Reach RX2.
- Allez dans les paramètres Bluetooth de votre appareil.
- Trouvez Reach RX2 dans la liste des appareils disponibles et sélectionnez-le pour commencer l'appairage.
- Attendez que votre appareil termine l'appairage avec Reach RX2.
Intégration avec Reach RX2
Après avoir appairé votre appareil iOS ou Android avec Reach RX2, vous pouvez l'intégrer pour lire la position de Reach en temps réel dans votre application. La méthode d'intégration dépend de la révision de Reach RX2 et peut être réalisée de deux manières :
Accéder directement au flux NMEA
Si vous souhaitez plus de métadonnées sur la position, la qualité de la position ou le récepteur, vous devrez accéder et analyser directement le flux NMEA. Cela est possible pour les deux plateformes :
- Pour les appareils iOS, cela peut être fait en utilisant le framework External Accessory d'Apple. En utilisant cette API, vous pouvez lire le flux NMEA et envoyer des corrections à Reach RX2 MFi. Pour lire le flux NMEA, vous devez utiliser un protocole spécial - com.emlid.nmea.
- Pour les appareils Android, cela peut être fait en utilisant la communication Bluetooth standard via le profil de port série Bluetooth (SPP). L'API Bluetooth d'Android permet l'accès direct au flux NMEA et l'envoi de corrections RTK sans nécessiter de noms de protocole spécifiques. L'API gère la connexion et le transfert de données.
Pour en savoir plus sur le flux NMEA, consultez la spécification NMEA.
Utiliser Reach RX2 comme source de localisation
Grâce à la prise en charge MFi sur Reach RX2, le moyen le plus simple de s'intégrer est de l'utiliser comme source de localisation. L'appareil sur iOS détectera le flux de données de Reach RX2 et utilisera la localisation du flux au lieu de l'unité GPS interne. Cette technique est également appelée emplacement fictif.
Une fois connecté, le standard iOS Core Location API commencera à signaler la localisation du récepteur Reach RX2 MFi au lieu de l'unité GNSS interne de l'iPhone ou de l'iPad. Si vous vous appuyiez auparavant sur le framework Core Location, aucun développement n'est requis.
Pour les appareils Android, vous pouvez activer l'intégration sans code en utilisant l'Emplacement fictif d'Android. En savoir plus dans le guide Obtenir les coordonnées de Reach sur les appareils Android via Bluetooth.
Configuration du flux de corrections
Pour travailler en RTK avec un positionnement de haute précision, vous devrez fournir des corrections RTK à l'appareil. Vous pouvez envoyer des corrections à Reach RX2 de la manière suivante :
- Pour les appareils iOS, vous pouvez configurer le flux de corrections dans l'application Emlid Flow et les envoyer à votre application en arrière-plan.
- Alternativement pour les appareils iOS et Android, vous pouvez implémenter la fonctionnalité du client NTRIP à l'intérieur de votre application. Dans ce cas, vous devez implémenter le protocole com.emlid.corrections, utilisé pour fournir les données de correction aux récepteurs Reach. L'implémentation de ce protocole garantit une compatibilité totale et un fonctionnement fiable avec les appareils Reach.
Après avoir configuré le flux de corrections sur votre Reach RX2, l'intégration est terminée.
Reportez-vous à l'article Corrections RTK et diffuseurs NTRIP pour plus de détails sur la configuration d'un flux de corrections envoyé de votre appareil au récepteur.
Avant la publication de l'application
Si vous intégrez votre Reach RX2 avec une application iOS et que vous êtes prêt à nous envoyer l'application pour que nous l'examinions, veuillez nous contacter à l'adresse [email protected] et nous fournir votre identifiant de bundle d'application. En tant que fabricant d'accessoires, nous mettrons votre application sur liste blanche.
Nous vous fournirons également un PPID d'accessoire spécial à inclure dans les métadonnées de votre application. Cela devrait être suffisant pour publier votre application avec le support Reach RX2 sur l'App Store.