Sensori

I sensori Android consentono alle applicazioni di accedere ai sensori fisici sottostanti di un dispositivo mobile. Sono dispositivi virtuali che forniscono dati definiti da sensors.h , il sensore Hardware Abstraction Layer (HAL).

Cosa sono i sensori Android?

I sensori Android sono dispositivi virtuali che forniscono dati provenienti da un insieme di sensori fisici: accelerometri, giroscopi, magnetometri, barometro, sensori di umidità, pressione, luce, prossimità e frequenza cardiaca.

Non inclusi nell'elenco dei dispositivi fisici che forniscono dati sono fotocamera, sensore di impronte digitali, microfono e touch screen. Questi dispositivi hanno un proprio meccanismo di segnalazione; la separazione è arbitraria, ma in generale i sensori Android forniscono dati di larghezza di banda inferiore. Ad esempio, "100 Hz x 3 canali" per un accelerometro rispetto a "25 Hz x 8 MP x 3 canali" per una fotocamera o "44 kHz x 1 canale" per un microfono.

Android non definisce come i diversi sensori fisici siano collegati al system on chip (SoC).

• Spesso, i chip dei sensori sono collegati al SoC tramite un hub di sensori , consentendo il monitoraggio e l'elaborazione dei dati a bassa potenza.
• Spesso come meccanismo di trasporto viene utilizzato il circuito inter-integrato (I2C) o l'interfaccia periferica seriale (SPI).
• Per ridurre il consumo energetico, alcune architetture sono gerarchiche, con alcune elaborazioni minime eseguite nel circuito integrato specifico dell'applicazione (ASIC, come il rilevamento del movimento sul chip dell'accelerometro), e di più in un microcontrollore (come il rilevamento dei passi in un hub di sensori ).
• Spetta al produttore del dispositivo scegliere un'architettura basata su precisione, potenza, prezzo e dimensioni del pacchetto. Per ulteriori informazioni, vedere Stack di sensori .
• Le capacità di dosaggio sono una considerazione importante per l'ottimizzazione della potenza. Vedere Batch per ulteriori informazioni.

Ogni sensore Android ha un "tipo" che rappresenta come si comporta il sensore e quali dati fornisce.

• I tipi di sensori Android ufficiali sono definiti in sensori.h sotto i nomi SENSOR_TYPE_...
  • La stragrande maggioranza dei sensori ha un tipo di sensore ufficiale.
  • Questi tipi sono documentati nell'SDK di Android.
  • Il comportamento dei sensori con questi tipi viene testato in Android Compatibility Test Suite (CTS).
• Se un produttore integra un nuovo tipo di sensore su un dispositivo Android, il produttore può definire il proprio tipo temporaneo per farvi riferimento.
  • Questi tipi non sono documentati, quindi è improbabile che gli sviluppatori di applicazioni li utilizzino, perché non li conoscono o perché sanno che sono presenti raramente (solo su alcuni dispositivi di questo specifico produttore).
  • Non sono testati da CTS.
  • Una volta che Android ha definito un tipo di sensore ufficiale per questo tipo di sensore, i produttori devono smettere di utilizzare il proprio tipo temporaneo e utilizzare invece il tipo ufficiale. In questo modo, il sensore sarà utilizzato da più sviluppatori di applicazioni.
• L'elenco di tutti i sensori presenti sul dispositivo è riportato dall'implementazione HAL.
  • Possono esserci più sensori dello stesso tipo. Ad esempio, due sensori di prossimità o due accelerometri.
  • La stragrande maggioranza delle applicazioni richiede un solo sensore di un determinato tipo. Ad esempio, un'applicazione che richiede l'accelerometro predefinito otterrà il primo accelerometro nell'elenco.
  • I sensori sono spesso definiti da coppie sveglia e non sveglia , entrambi i sensori condividono lo stesso tipo, ma differiscono per la loro caratteristica di sveglia.

I sensori Android forniscono dati come una serie di eventi del sensore.

Ogni evento contiene:

• una maniglia al sensore che l'ha generata
• il timestamp in cui l'evento è stato rilevato o misurato, in base a SystemClock.elapsedRealtimeNanos()
• e alcuni dati

L'interpretazione dei dati riportati dipende dal tipo di sensore. Vedere le definizioni del tipo di sensore per i dettagli sui dati riportati per ciascun tipo di sensore.

Documentazione esistente

Rivolto agli sviluppatori

• Panoramica
  • https://developer.android.com/guide/topics/sensors/sensors_overview.html
• Riferimento SDK
  • https://developer.android.com/reference/android/hardware/SensorManager
  • https://developer.android.com/reference/android/hardware/SensorEventListener
  • https://developer.android.com/reference/android/hardware/SensorEvent
  • https://developer.android.com/reference/android/hardware/Sensor
• Stack Overflow e siti Web di tutorial
  • Poiché la documentazione dei sensori a volte mancava, gli sviluppatori hanno fatto ricorso a siti Web di domande e risposte come Stack Overflow per trovare risposte.
  • Esistono anche alcuni siti Web di tutorial, ma non coprono le ultime funzionalità come batch, movimenti significativi e vettori di rotazione del gioco.
  • Le risposte laggiù non sono sempre corrette e mostrano dove è necessaria più documentazione.

Rivolto ai produttori

• Panoramica
  • Questa pagina Sensori e le sue sottopagine.
• Livello di astrazione hardware (HAL)
  • /platform/hardware/libhardware/+/master/include/hardware/sensors.h
  • Conosciuto anche come "sensors.h"
  • La fonte della verità. Primo documento da aggiornare quando vengono sviluppate nuove funzionalità.
• CDD Android (documento di definizione della compatibilità)
  • /compatibilità/cdd-android.pdf
  • Vedere le sezioni relative ai sensori.
  • Il CDD è indulgente, quindi soddisfare i requisiti CDD non è sufficiente per garantire sensori di alta qualità.