Passa al contenuto principale

Come integrare con Reach RX MFi

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

Panoramica​

Tutte le revisioni di Reach RX sono compatibili con le app Android tramite Bluetooth Classic; tuttavia, solo la seconda versione di Reach RX, che ha la certificazione MFi, supporta la connessione Bluetooth Classic su dispositivi Apple.

Per verificare se il proprio Reach RX è certificato MFi, controllare quanto segue:

  • la marcatura MFi sulla scatola
  • la marcatura MFi sul fondo del dispositivo
  • le ultime quattro cifre del numero di serie sono superiori a 2414
suggerimento

Imparare a controllare il numero di serie del proprio Reach RX nella guida Come trovare il numero di serie.

Connettere il dispositivo mobile a Reach RX​

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

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

Integrazione con Reach RX​

Dopo aver associato il proprio dispositivo iOS o Android con Reach RX, è 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 RX 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 che inviare correzioni a Reach RX 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 RX MFi come fonte di localizzazione​

Per Reach RX MFi, il modo più semplice per l'integrazione è utilizzarlo come fonte di localizzazione. Il dispositivo su iOS rileverà lo stream di dati da Reach RX e utilizzerà la posizione dallo stream invece che dall'unità GPS interna. Questa tecnica è anche chiamata mock location (posizione fittizia).

Una volta connesso, l'API Core Location standard di iOS inizierà a riportare la posizione del ricevitore Reach RX 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.

note

Per i dispositivi Android, è possibile abilitare l'integrazione senza codice utilizzando la Posizione fittizia di Android e un'applicazione di terze parti come Lefebure. 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 RX 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 impostato lo stream di correzioni sul proprio Reach RX, 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 RX MFi con un'app iOS e si è pronti a inviare l'app per la revisione, contattateci all'indirizzo [email protected] e fornite l'ID del bundle dell'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 l'app con il supporto per Reach RX sull'App Store.