Les capteurs Android permettent aux applications d'accéder aux capteurs physiques sous-jacents d'un appareil mobile. Il s'agit d'appareils virtuels fournissant des données, définis par sensors.h, la couche d'abstraction matérielle (HAL) des capteurs.
Que sont les capteurs Android ?
Les capteurs Android sont des appareils virtuels qui fournissent des données provenant d'un ensemble de capteurs physiques : accéléromètres, gyroscopes, magnétomètres, baromètre, capteurs d'humidité, de pression, de luminosité, de proximité et de fréquence cardiaque.
La liste des appareils physiques fournissant des données n'inclut pas la caméra, le capteur d'empreinte digitale, le micro ni l'écran tactile. Ces appareils disposent de leur propre mécanisme de création de rapports. La séparation est arbitraire, mais en général, les capteurs Android fournissent des données à faible bande passante. Par exemple, "100 Hz x 3 canaux" pour un accéléromètre, "25 Hz x 8 MP x 3 canaux" pour une caméra ou "44 kHz x 1 canal" pour un micro.
Android ne définit pas la manière dont les différents capteurs physiques sont connectés au système sur puce (SoC).
- Les puces des capteurs sont souvent connectées au SoC via un hub de capteurs, ce qui permet une surveillance et un traitement des données à faible consommation d'énergie.
- Le circuit intégré inter-intégré (I2C) ou l'interface périphérique série (SPI) sont souvent utilisés comme mécanisme de transport.
- Pour réduire la consommation d'énergie, certaines architectures sont hiérarchiques. Un traitement minimal est effectué dans le circuit intégré spécifique à l'application (ASIC, comme la détection de mouvement sur la puce de l'accéléromètre), et un traitement plus important est effectué dans un microcontrôleur (comme la détection de pas dans un hub de capteurs).
- Il appartient au fabricant de l'appareil de choisir une architecture en fonction des caractéristiques de précision, de puissance, de prix et de taille du package. Pour en savoir plus, consultez Pile de capteurs.
- Les capacités de traitement par lot sont un élément important à prendre en compte pour l'optimisation de la consommation d'énergie. Pour en savoir plus, consultez la section Traitement par lot.
Chaque capteur Android possède un "type" qui représente son comportement et les données qu'il fournit.
- Les types de capteurs Android officiels sont définis dans sensors.h sous les noms SENSOR_TYPE_…
- La grande majorité des capteurs ont un type officiel.
- Ces types sont décrits dans le SDK Android.
- Le comportement des capteurs avec ces types est testé dans la suite de tests de compatibilité (CTS) Android.
- Si un fabricant intègre un nouveau type de capteur sur un appareil Android, il peut définir son propre type temporaire pour y faire référence.
- Ces types ne sont pas documentés. Il est donc peu probable que les développeurs d'applications les utilisent, soit parce qu'ils ne les connaissent pas, soit parce qu'ils savent qu'ils sont rarement présents (uniquement sur certains appareils de ce fabricant spécifique).
- Ils ne sont pas testés par la suite CTS.
- Une fois qu'Android aura défini un type de capteur officiel pour ce type de capteur, les fabricants devront cesser d'utiliser leur propre type temporaire et utiliser le type officiel à la place. Le capteur sera ainsi utilisé par un plus grand nombre de développeurs d'applications.
- La liste de tous les capteurs présents sur l'appareil est fournie par l'implémentation HAL.
- Il peut y avoir plusieurs capteurs du même type. Par exemple, deux capteurs de proximité ou deux accéléromètres.
- La grande majorité des applications ne demandent qu'un seul capteur d'un type donné. Par exemple, une application qui demande l'accéléromètre par défaut obtient le premier accéléromètre de la liste.
- Les capteurs sont souvent définis par des paires wake-up et non-wake-up. Les deux capteurs partagent le même type, mais diffèrent par leur caractéristique de réveil.
Les capteurs Android fournissent des données sous la forme d'une série d'événements de capteur.
Chaque événement contient les éléments suivants :
- un handle du capteur qui l'a généré.
- Code temporel auquel l'événement a été détecté ou mesuré, basé sur
SystemClock.elapsedRealtimeNanos() - et certaines données
L'interprétation des données signalées dépend du type de capteur. Consultez les définitions des types de capteurs pour en savoir plus sur les données signalées pour chaque type de capteur.
Documentation existante
Destiné aux développeurs
- Présentation
- Documentation de référence du SDK
- Stack Overflow et sites Web de tutoriels
- Comme la documentation sur les capteurs était parfois insuffisante, les développeurs se sont tournés vers des sites de questions/réponses comme Stack Overflow pour trouver des réponses.
- Il existe également des sites Web de tutoriels, mais ils ne couvrent pas les dernières fonctionnalités telles que les vecteurs de regroupement, de mouvement significatif et de rotation du jeu.
- Les réponses fournies ne sont pas toujours correctes et indiquent où une documentation supplémentaire est nécessaire.
Ciblé sur les fabricants
- Présentation
- Cette page Capteurs et ses sous-pages.
- Couche d'abstraction matérielle (HAL)
- /platform/hardware/libhardware/+/android16-release/include/hardware/sensors.h
- Également appelé "sensors.h"
- Source de référence. Premier document à mettre à jour lorsque de nouvelles fonctionnalités sont développées.
- CDD (Compatibility Definition Document) Android
- /compatibility/android-cdd.pdf
- Consultez les sections relatives aux capteurs.
- Le CDD est souple. Par conséquent, le respect des exigences du CDD ne suffit pas à garantir des capteurs de haute qualité.