Passa al contenuto principale

Come integrare con Reach RX2

Questa guida spiega come integrare i ricevitori Reach RX2 con la propria app Android o iOS utilizzando il Bluetooth Classic per lo streaming della posizione in tempo reale.

Panoramica​

Reach RX2 supporta l'integrazione con le app Android e iOS tramite Bluetooth Classic e offre due opzioni in base alla quantità di metadati necessari:

  • Accedere direttamente allo stream NMEA.
  • Utilizzare Reach RX2 come fonte di localizzazione.

Per ulteriori informazioni, consultare le sezioni seguenti.

Connettere il proprio dispositivo mobile a Reach RX2​

Per connettersi al proprio Reach RX2, è necessario associarlo con il proprio dispositivo iOS o Android. Procedere come segue:

  1. Accendere il proprio Reach RX2.
  2. Andare alle impostazioni Bluetooth del proprio dispositivo.
  3. Trovare Reach RX2 nell'elenco dei dispositivi disponibili e selezionarlo per avviare l'associazione.
  4. Attendere che il dispositivo completi l'associazione con Reach RX2.

Integrazione con Reach RX2​

Dopo aver associato il proprio dispositivo iOS o Android con Reach RX2, è possibile integrarlo per leggere la posizione di Reach in tempo reale all'interno della propria app. Il metodo di integrazione dipende dalla revisione di Reach RX2 e può essere eseguito in due modi:

Accedere direttamente allo stream NMEA​

Se si desiderano maggiori metadati sulla posizione, sulla qualità della posizione o sul ricevitore, è necessario accedere ed effettuare il parsing dello stream NMEA direttamente. Questo è possibile per entrambe le piattaforme:

  • Per i dispositivi iOS, è possibile farlo utilizzando il framework External Accessory di Apple. Utilizzando questa API, è possibile sia leggere lo stream NMEA sia inviare correzioni a Reach RX2 MFi. Per leggere lo stream NMEA, è necessario utilizzare un protocollo speciale-com.emlid.nmea.
  • Per i dispositivi Android, questo può essere fatto utilizzando la comunicazione Bluetooth standard tramite il Bluetooth Serial Port Profile (SPP). L'API Bluetooth di Android consente l'accesso diretto allo stream NMEA e l'invio di correzioni RTK senza richiedere nomi di protocollo specifici. L'API gestisce la connessione e il trasferimento dei dati.
suggerimento

Per saperne di più sullo stream NMEA, consultare le specifiche NMEA.

Utilizzare Reach RX2 come fonte di localizzazione​

Grazie al supporto MFi su Reach RX2, il modo più semplice per integrare è utilizzarlo come fonte di localizzazione. Il dispositivo su iOS rileverà il flusso di dati da Reach RX2 e utilizzerà la posizione dallo stream invece dell'unità GPS interna. Questa tecnica è anche chiamata mock location (posizione fittizia).

Una volta connesso, l'API standard di iOS Core Location API inizierà a segnalare la posizione del ricevitore Reach RX2 MFi invece dell'unità GNSS interna dell'iPhone o dell'iPad. Se in precedenza ci si è affidati al framework Core Location, non è necessario alcun sviluppo.

Per i dispositivi Android, è possibile abilitare l'integrazione no-code utilizzando Posizione fittizia di Android. Per saperne di più, consultare la guida Ottenere le coordinate di Reach su dispositivi Android tramite Bluetooth.

Impostazione dello stream di correzioni​

Per lavorare in RTK con un posizionamento ad alta precisione, è necessario fornire correzioni RTK al dispositivo. È possibile inviare le correzioni a Reach RX2 nei seguenti modi:

  • Per i dispositivi iOS, è possibile configurare lo stream di correzioni all'interno dell'app Emlid Flow e inviarle alla propria app in background.
  • In alternativa, sia per i dispositivi iOS che Android, è possibile implementare la funzionalità del client NTRIP all'interno della propria app. In questo caso, è necessario implementare il protocollo com.emlid.corrections, che viene utilizzato per fornire i dati di correzione ai ricevitori Reach. L'implementazione di questo protocollo garantisce la piena compatibilità e un funzionamento affidabile con i dispositivi Reach.

Dopo aver configurato lo stream delle correzioni sul proprio Reach RX2, l'integrazione è completa.

suggerimento

Consultare l'articolo Correzioni RTK e Caster NTRIP per i dettagli sull'impostazione di uno stream di correzioni inviato dal proprio dispositivo al ricevitore.

Prima del rilascio dell'app​

Se si integra il proprio Reach RX2 con un'app iOS e si è pronti a inviare l'app per la revisione, si prega di contattarci all'indirizzo [email protected] e di fornire l'ID del bundle della propria app. In qualità di produttore dell'accessorio, inseriremo l'app nella whitelist.

Forniremo anche uno speciale PPID accessorio da includere nei metadati dell'app. Questo dovrebbe essere sufficiente per pubblicare la propria app con il supporto di Reach RX2 sull'App Store.