Types de capteurs

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette section décrit les axes des capteurs, les capteurs de base et les capteurs composites (activité, attitude, non étalonné et interaction).

Axes des capteurs

Les valeurs d'événement des capteurs de nombreux capteurs sont exprimées dans un frame spécifique qui est statique par rapport à l'appareil.

Axes des appareils mobiles

L'API Sensor n'est relative qu'à l'orientation naturelle de l'écran (les axes ne sont pas permutés lorsque l'orientation de l'écran de l'appareil change).

Figure 1 : Système de coordonnées (par rapport à un appareil mobile) utilisé par l'API Sensor

Essieux automobiles

Dans les implémentations Android Automotive, les axes sont définis par rapport au châssis de la carrosserie du véhicule. L'origine du cadre de référence du véhicule est le centre de l'essieu arrière. Le cadre de référence du véhicule est orienté de sorte que:

• L'axe X pointe vers la droite et se trouve sur un plan horizontal, perpendiculaire au plan de symétrie du véhicule.
• L'axe Y est orienté vers l'avant et se trouve sur un plan horizontal.

Figure 2. Système de coordonnées (par rapport à un appareil automobile) utilisé par l'API Sensor

Le cadre de référence du véhicule est un système de coordonnées à main droite. Par conséquent, l'axe Z pointe vers le haut.

L'axe Z du cadre de référence est aligné sur la gravité, ce qui signifie que les axes X et Y sont tous deux horizontaux. Par conséquent, l'axe Y ne passe pas toujours par l'essieu avant.

Capteurs de base

Les types de capteurs de base sont nommés d'après les capteurs physiques qu'ils représentent. Ces capteurs transmettent les données d'un seul capteur physique (contrairement aux capteurs composites qui génèrent des données à partir d'autres capteurs). Voici quelques exemples de types de capteurs de base:

• SENSOR_TYPE_ACCELEROMETER
• SENSOR_TYPE_GYROSCOPE
• SENSOR_TYPE_MAGNETOMETER

Toutefois, les capteurs de base ne sont pas identiques à leur capteur physique sous-jacent et ne doivent pas être confondus avec celui-ci. Les données d'un capteur de base ne sont pas la sortie brute du capteur physique, car des corrections (telles que la compensation du biais et la compensation de la température) sont appliquées.

Par exemple, les caractéristiques d'un capteur de base peuvent être différentes de celles de son capteur physique sous-jacent dans les cas d'utilisation suivants:

• Un chip de gyroscope dont la plage de biais est de 1 deg/s.
  • Après le calibrage en usine, la compensation de la température et la compensation du biais sont appliquées.Le biais réel du capteur Android est alors réduit, peut-être à un point où le biais est garanti en dessous de 0, 01 deg/s.
  • Dans cette situation, nous disons que le capteur Android présente un biais inférieur à 0,01 deg/s, même si la fiche technique du capteur sous-jacent indique 1 deg/s.
• Baromètre avec une consommation d'énergie de 100 µW.
  • Étant donné que les données générées doivent être transportées de la puce au SoC, le coût énergétique réel pour collecter les données du capteur Android du baromètre peut être beaucoup plus élevé, par exemple 1 000 µW.
  • Dans ce cas, nous disons que le capteur Android a une consommation d'énergie de 1 000 µW, même si la consommation d'énergie mesurée aux broches du chip baromètre est de 100 µW.
• Un magnétomètre qui consomme 100 µW lors de la calibration, mais consomme plus lors de la calibration.
  • Sa routine de calibrage peut nécessiter l'activation du gyroscope, qui consomme 5 000 µW, et l'exécution d'un algorithme, qui coûte 900 µW supplémentaires.
  • Dans ce cas, nous disons que la consommation d'énergie maximale du capteur Android (magnétomètre) est de 6 000 µW.
  • Dans ce cas, la consommation d'énergie moyenne est la mesure la plus utile, et c'est ce qui est indiqué dans les caractéristiques statiques du capteur via le HAL.

Accéléromètre

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ACCELEROMETER) renvoie un capteur de réveil

Un capteur d'accéléromètre indique l'accélération de l'appareil sur les trois axes du capteur. L'accélération mesurée comprend à la fois l'accélération physique (changement de vitesse) et la gravité. La mesure est indiquée dans les champs x, y et z de sensors_event_t.acceleration.

Toutes les valeurs sont exprimées en unités SI (m/s²) et mesurent l'accélération de l'appareil moins la force de gravité sur les trois axes du capteur.

Voici quelques exemples:

• La norme de (x, y, z) doit être proche de 0 en chute libre.
• Lorsque l'appareil est posé à plat sur une table et qu'il est poussé sur son côté gauche vers la droite, la valeur d'accélération x est positive.
• Lorsque l'appareil est posé à plat sur une table, la valeur d'accélération le long de l'axe Z est de +9,81 alo, ce qui correspond à l'accélération de l'appareil (0 m/s²) moins la force de gravité (-9,81 m/s²).
• Lorsque l'appareil est posé à plat sur une table et qu'il est poussé vers le ciel, la valeur d'accélération est supérieure à +9,81, ce qui correspond à l'accélération de l'appareil (+A m/s²) moins la force de gravité (-9,81 m/s²).

Les mesures sont calibrées à l'aide des éléments suivants:

• Compensation de température
• Calibration du biais en ligne
• Calibrage de l'échelle en ligne

Le calibrage du biais et de l'échelle ne doit être mis à jour que lorsque le capteur est désactivé, afin d'éviter de provoquer des sauts de valeurs pendant le streaming.

L'accéléromètre indique également la précision attendue pour ses mesures via sensors_event_t.acceleration.status. Pour en savoir plus sur les valeurs possibles de ce champ, consultez les constantes SENSOR_STATUS_* de SensorManager.

Température ambiante

Reporting-mode: On-change

getDefaultSensor(SENSOR_TYPE_AMBIENT_TEMPERATURE) renvoie un capteur de réveil

Ce capteur fournit la température ambiante (de la pièce) en degrés Celsius.

Capteur de champ magnétique

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_MAGNETIC_FIELD) renvoie un capteur de réveil

SENSOR_TYPE_GEOMAGNETIC_FIELD == SENSOR_TYPE_MAGNETIC_FIELD

Un capteur de champ magnétique (également appelé magnétomètre) indique le champ magnétique ambiant, mesuré le long des trois axes du capteur.

La mesure est indiquée dans les champs x, y et z de sensors_event_t.magnetic, et toutes les valeurs sont exprimées en micro-Tesla (uT).

Le magnétomètre indique également la précision attendue pour ses mesures via sensors_event_t.magnetic.status. Pour en savoir plus sur les valeurs possibles de ce champ, consultez les constantes SENSOR_STATUS_* de SensorManager.

Les mesures sont calibrées à l'aide des éléments suivants:

• Compensation de température
• Calibrage en usine (ou en ligne) du fer doux
• Calibrage en ligne de l'équipement de ferronnerie

Gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GYROSCOPE) renvoie un capteur de réveil

Un capteur de gyroscope indique la vitesse de rotation de l'appareil autour des trois axes du capteur.

La rotation est positive dans le sens inverse des aiguilles d'une montre (règle de la main droite). Autrement dit, un observateur regardant un appareil positionné à l'origine depuis un point positif sur les axes X, Y ou Z indiquerait une rotation positive si l'appareil semble tourner dans le sens inverse des aiguilles d'une montre. Notez qu'il s'agit de la définition mathématique standard de la rotation positive et qu'elle ne correspond pas à la définition aérospatiale du roulis.

La mesure est indiquée dans les champs x, y et z de sensors_event_t.gyro. Toutes les valeurs sont exprimées en radians par seconde (rad/s).

Les mesures sont calibrées à l'aide des éléments suivants:

• Compensation de température
• Compensation de la mise à l'échelle en usine (ou en ligne)
• Calibrage du biais en ligne (pour éliminer la dérive)

Le gyroscope indique également la précision qu'il attend pour ses mesures via sensors_event_t.gyro.status. Pour en savoir plus sur les valeurs possibles de ce champ, consultez les constantes SENSOR_STATUS_* de SensorManager.

Le gyroscope ne peut pas être émulé en fonction des magnétomètres et des accéléromètres, car cela réduirait sa cohérence et sa réactivité locales. Il doit être basé sur un chip de gyroscope standard.

Fréquence cardiaque

Reporting-mode: On-change

getDefaultSensor(SENSOR_TYPE_HEART_RATE) renvoie un capteur de réveil

Un capteur de fréquence cardiaque indique la fréquence cardiaque actuelle de la personne qui touche l'appareil.

La fréquence cardiaque actuelle en battements par minute (BPM) est indiquée dans sensors_event_t.heart_rate.bpm, et l'état du capteur est indiqué dans sensors_event_t.heart_rate.status. Pour en savoir plus sur les valeurs possibles de ce champ, consultez les constantes SENSOR_STATUS_* de SensorManager. Plus précisément, lors de la première activation, sauf si l'appareil est connu pour ne pas être sur le corps, le champ d'état du premier événement doit être défini sur SENSOR_STATUS_UNRELIABLE. Étant donné que ce capteur est activé en cas de modification, les événements sont générés uniquement lorsque heart_rate.bpm ou heart_rate.status ont changé depuis le dernier événement. Les événements ne sont pas générés plus d'une fois toutes les sampling_period.

sensor_t.requiredPermission est toujours SENSOR_PERMISSION_BODY_SENSORS.

Léger

Reporting-mode: On-change

getDefaultSensor(SENSOR_TYPE_LIGHT) renvoie un capteur de réveil

Un capteur de luminosité indique l'éclairage actuel en unités SI de lux.

La mesure est indiquée dans sensors_event_t.light.

Proximité

Reporting-mode: On-change

Généralement défini comme un capteur de réveil

getDefaultSensor(SENSOR_TYPE_PROXIMITY) renvoie un capteur de réveil

Un capteur de proximité indique la distance entre le capteur et la surface visible la plus proche.

Jusqu'à Android 4.4, les capteurs de proximité étaient toujours des capteurs de réveil, qui réveillaient le SoC lorsqu'ils détectaient un changement de proximité. Après Android 4.4, nous vous recommandons d'implémenter d'abord la version de réveil de ce capteur, car c'est celle qui permet d'allumer et d'éteindre l'écran lors des appels téléphoniques.

La mesure est indiquée en centimètres dans sensors_event_t.distance. Notez que certains capteurs de proximité n'acceptent qu'une mesure binaire "proche" ou "loin". Dans ce cas, le capteur indique sa valeur sensor_t.maxRange dans l'état "loin" et une valeur inférieure à sensor_t.maxRange dans l'état "proche".

Pression

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_PRESSURE) renvoie un capteur de réveil

Un capteur de pression (également appelé baromètre) indique la pression atmosphérique en hectopascals (hPa).

Les mesures sont calibrées à l'aide de

• Compensation de température
• Calibrage du biais d'usine
• Calibrage à l'échelle de l'usine

Le baromètre est souvent utilisé pour estimer les changements d'altitude. Pour estimer l'altitude absolue, la pression au niveau de la mer (qui varie en fonction de la météo) doit être utilisée comme référence.

Humidité relative

Reporting-mode: On-change

getDefaultSensor(SENSOR_TYPE_RELATIVE_HUMIDITY) renvoie un capteur de réveil

Un capteur d'humidité relative mesure l'humidité relative de l'air ambiant et renvoie une valeur en pourcentage.

Types de capteurs composites

Un capteur composite génère des données en traitant et/ou en fusionnant les données d'un ou de plusieurs capteurs physiques. (Tout capteur qui n'est pas un capteur de base est appelé capteur composite.) Voici quelques exemples de capteurs composites:

• Détecteur de pas et mouvement important, qui sont généralement basés sur un accéléromètre, mais peuvent également être basés sur d'autres capteurs, si la consommation d'énergie et la précision sont acceptables.
• Vecteur de rotation du jeu, basé sur un accéléromètre et un gyroscope.
• Gyroscope non étalonné, qui est semblable au capteur de base du gyroscope, mais dont le calibrage du biais est indiqué séparément au lieu d'être corrigé dans la mesure.

Comme pour les capteurs de base, les caractéristiques des capteurs composites proviennent des caractéristiques de leurs données finales. Par exemple, la consommation d'énergie d'un vecteur de rotation de jeu est probablement égale à la somme des consommations d'énergie de la puce d'accéléromètre, de la puce de gyroscope, de la puce qui traite les données et des bus qui transportent les données. Autre exemple : la dérive d'un vecteur de rotation de jeu dépend autant de la qualité de l'algorithme d'étalonnage que des caractéristiques physiques du capteur.

Le tableau suivant répertorie les types de capteurs composites disponibles. Chaque capteur composite s'appuie sur les données d'un ou de plusieurs capteurs physiques. Évitez de choisir d'autres capteurs physiques sous-jacents pour obtenir des résultats approximatifs, car ils offrent une mauvaise expérience utilisateur.

Type de capteur	Catégorie	Capteurs physiques sous-jacents	Mode de création de rapports
Vecteur de rotation du jeu	Attitude	Accéléromètre, gyroscope, NE DOIT PAS UTILISER de magnétomètre	Continu
Vecteur de rotation géomagnétique	Attitude	Accéléromètre, magnétomètre, NE PAS UTILISER le gyroscope	Continu
Geste de balayage	Interaction	Indéterminé	One-shot
Paramètre Gravity	Attitude	Accéléromètre, gyroscope (si présent) ou magnétomètre (si le gyroscope n'est pas présent)	Continu
Gyroscope non étalonné	Non étalonné	Gyroscope	Continu
Accélération linéaire	Activité	Accéléromètre, gyroscope (si présent) ou magnétomètre (si gyroscope non présent)	Continu
Champ magnétique non étalonné	Non étalonné	Magnétomètre	Continu
Orientation (obsolète)	Attitude	Accéléromètre, magnétomètre, gyroscope (le cas échéant)	Continu
Geste de prise en main	Interaction	Indéterminé	One-shot
Vecteur de rotation	Attitude	Accéléromètre, magnétomètre, gyroscope	Continu
Mouvement important	Activité	Accéléromètre (ou autre, à condition qu'il consomme très peu d'énergie)	One-shot
Compteur de pas	Activité	Accéléromètre	Lors d'un changement
Détecteur de pas	Activité	Accéléromètre	Spécial
Détecteur d'inclinaison	Activité	Accéléromètre	Spécial
Geste de réveil	Interaction	Indéterminé	One-shot

= Capteur basse consommation

Capteurs composites d'activité

Accélération linéaire

Capteurs physiques sous-jacents: accéléromètre et (si présent) gyroscope (ou magnétomètre si le gyroscope n'est pas présent)

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_LINEAR_ACCELERATION) renvoie un capteur de réveil

Un capteur d'accélération linéaire indique l'accélération linéaire de l'appareil dans le cadre du capteur, sans inclure la gravité.

Conceptuellement, la sortie correspond à la sortie de l'accéléromètre moins la sortie du capteur de gravité. Il est indiqué en m/s^2 dans les champs x, y et z de sensors_event_t.acceleration.

Les lectures sur tous les axes doivent être proches de 0 lorsque l'appareil est immobile.

Si l'appareil est équipé d'un gyroscope, le capteur d'accélération linéaire doit utiliser le gyroscope et l'accéléromètre comme entrée.

Si l'appareil ne dispose pas de gyroscope, le capteur d'accélération linéaire doit utiliser l'accéléromètre et le magnétomètre comme entrée.

Mouvement important

Capteur physique sous-jacent: accéléromètre (ou un autre, à condition qu'il consomme peu d'énergie)

Reporting-mode: One-shot

Faible consommation d'énergie

N'implémentez que la version de réveil de ce capteur.

getDefaultSensor(SENSOR_TYPE_SIGNIFICANT_MOTION) renvoie un capteur de réveil

Un détecteur de mouvement important se déclenche lorsqu'il détecte un mouvement important: un mouvement qui peut entraîner un changement de l'emplacement de l'utilisateur.

Voici quelques exemples de motions importantes:

• À pied ou à vélo
• Assis dans une voiture, un autocar ou un train en mouvement

Exemples de situations qui ne déclenchent pas de mouvement important:

• Téléphone dans la poche et personne immobile
• Le téléphone est posé sur une table qui tremble un peu en raison du trafic ou d'un lave-linge à proximité

De manière générale, le détecteur de mouvement important est utilisé pour réduire la consommation d'énergie de la détermination de l'emplacement. Lorsque les algorithmes de localisation détectent que l'appareil est statique, ils peuvent passer en mode basse consommation, où ils s'appuient sur un mouvement important pour réveiller l'appareil lorsque l'utilisateur change de position.

Ce capteur doit être à faible consommation d'énergie. Il effectue un compromis sur la consommation d'énergie, ce qui peut entraîner un petit nombre de faux négatifs. Cela s'explique par plusieurs raisons:

• L'objectif de ce capteur est d'économiser de l'énergie.
• Déclencher un événement lorsque l'utilisateur ne bouge pas (faux positif) est coûteux en termes d'énergie. Il est donc préférable de l'éviter.
• Le fait de ne pas déclencher d'événement lorsque l'utilisateur se déplace (faux négatif) est acceptable tant qu'il n'est pas répété. Si l'utilisateur marche depuis 10 secondes, il n'est pas acceptable de ne pas déclencher d'événement dans ces 10 secondes.

Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Détecteur de pas

Capteur physique sous-jacent: accéléromètre (+ éventuellement d'autres, à condition que la puissance soit faible)

Mode de création de rapports: spécifique (un événement par étape effectuée)

Faible consommation d'énergie

getDefaultSensor(SENSOR_TYPE_STEP_DETECTOR) renvoie un capteur de réveil

Un détecteur de pas génère un événement chaque fois qu'un pas est effectué par l'utilisateur.

L'horodatage de l'événement sensors_event_t.timestamp correspond au moment où le pied touche le sol, ce qui génère une forte variation d'accélération.

Par rapport au compteur de pas, le détecteur de pas doit avoir une latence plus faible (moins de deux secondes). Le détecteur de pas et le compteur de pas détectent lorsque l'utilisateur marche, court et monte les escaliers. Elles ne doivent pas se déclencher lorsque l'utilisateur fait du vélo, conduit ou se trouve dans d'autres véhicules.

Ce capteur doit être à faible consommation d'énergie. Autrement dit, si la détection de pas ne peut pas être effectuée au niveau matériel, ce capteur ne doit pas être défini. Plus particulièrement, lorsque le détecteur de pas est activé et que l'accéléromètre ne l'est pas, seules les étapes doivent déclencher des interruptions (et non chaque lecture de l'accéléromètre).

sampling_period_ns n'a aucun impact sur les détecteurs de pas.

Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Podomètre

Capteur physique sous-jacent: accéléromètre (+ éventuellement d'autres, à condition que la puissance soit faible)

Reporting-mode: On-change

Faible consommation d'énergie

getDefaultSensor(SENSOR_TYPE_STEP_COUNTER) renvoie un capteur de réveil

Un compteur de pas indique le nombre de pas effectués par l'utilisateur depuis le dernier redémarrage lorsqu'il est activé.

La mesure est indiquée sous la forme d'un uint64_t dans sensors_event_t.step_counter et n'est réinitialisée à zéro que lors d'un redémarrage du système.

Le code temporel de l'événement est défini sur l'heure à laquelle la dernière étape de cet événement a été effectuée.

Consultez le type de capteur Détecteur de pas pour connaître la signification de l'heure d'un pas.

Par rapport au détecteur de pas, le compteur de pas peut avoir une latence plus élevée (jusqu'à 10 secondes). Grâce à cette latence, ce capteur offre une grande précision. Le nombre de pas après une journée complète de mesures doit se situer dans les 10% du nombre de pas réel. Le détecteur de pas et le compteur de pas détectent lorsque l'utilisateur marche, court et monte les escaliers. Ils ne doivent pas se déclencher lorsque l'utilisateur fait du vélo, conduit ou se trouve dans d'autres véhicules.

Le matériel doit s'assurer que le nombre de pas interne ne déborde jamais. La taille minimale du compteur interne du matériel doit être de 16 bits. En cas de débordement imminent (au maximum toutes les étapes 2^16), le SoC peut être réveillé pour que le pilote puisse effectuer la maintenance du compteur.

Comme indiqué dans la section Interaction, lorsque ce capteur fonctionne, il ne doit pas perturber les autres capteurs, en particulier l'accéléromètre, qui peut très bien être utilisé.

Si un appareil particulier ne prend pas en charge ces modes de fonctionnement, ce type de capteur ne doit pas être signalé par le HAL. Autrement dit, il n'est pas acceptable d'"émuler" ce capteur dans le HAL.

Ce capteur doit être à faible consommation d'énergie. Autrement dit, si la détection de pas ne peut pas être effectuée au niveau matériel, ce capteur ne doit pas être défini. En particulier, lorsque le compteur de pas est activé et que l'accéléromètre ne l'est pas, seules les étapes doivent déclencher des interruptions (et non les données de l'accéléromètre).

Détecteur d'inclinaison

Capteur physique sous-jacent: accéléromètre (+ éventuellement d'autres, à condition que la puissance soit faible)

Reporting-mode: Special

Faible consommation d'énergie

N'implémentez que la version de réveil de ce capteur.

getDefaultSensor(SENSOR_TYPE_TILT_DETECTOR) renvoie un capteur de réveil

Un détecteur d'inclinaison génère un événement chaque fois qu'un événement d'inclinaison est détecté.

Un événement d'inclinaison est défini par la direction de la gravité moyenne sur une période de deux secondes qui change d'au moins 35 degrés depuis l'activation ou le dernier événement généré par le capteur. Voici l'algorithme:

• reference_estimated_gravity = moyenne des mesures de l'accéléromètre au cours de la première seconde après l'activation ou gravité estimée lorsque le dernier événement d'inclinaison a été généré.
• current_estimated_gravity = moyenne des mesures de l'accéléromètre au cours des deux dernières secondes.
• Déclenchement lorsque angle(reference_estimated_gravity, current_estimated_gravity) > 35 degrees

Les fortes accélérations sans changement d'orientation du téléphone ne doivent pas déclencher d'événement d'inclinaison. Par exemple, un virage serré ou une forte accélération en conduisant une voiture ne doit pas déclencher d'événement d'inclinaison, même si l'angle de l'accélération moyenne peut varier de plus de 35 degrés. En règle générale, ce capteur n'est implémenté qu'à l'aide d'un accéléromètre. D'autres capteurs peuvent également être utilisés s'ils n'augmentent pas de manière significative la consommation d'énergie. Il s'agit d'un capteur basse consommation qui doit permettre au SoC de passer en mode suspension. N'émulez pas ce capteur dans le HAL. Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Capteurs composites d'attitude

Vecteur de rotation

Capteurs physiques sous-jacents: accéléromètre, magnétomètre et gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ROTATION_VECTOR) renvoie un capteur de réveil

Un capteur de vecteur de rotation indique l'orientation de l'appareil par rapport au repère de coordonnées Est-Nord-Haut. Il est généralement obtenu par l'intégration des mesures de l'accéléromètre, du gyroscope et du magnétomètre. Le système de coordonnées est défini comme une base orthonormale directe, où:

• X pointe vers l'est et est tangentiel au sol.
• L'axe Y pointe vers le nord et est tangentiel au sol.
• L'axe Z pointe vers le ciel et est perpendiculaire au sol.

L'orientation du téléphone est représentée par la rotation nécessaire pour aligner les coordonnées Est-Nord-Haut sur les coordonnées du téléphone. Autrement dit, appliquer la rotation au cadre mondial (X,Y,Z) les alignerait sur les coordonnées du téléphone (x,y,z).

La rotation peut être considérée comme une rotation du téléphone d'un angle théta autour d'un axe rot_axis pour passer de l'orientation de référence (alignée est-nord-haut) de l'appareil à l'orientation actuelle de l'appareil. La rotation est encodée sous la forme des quatre composantes x, y, z et w sans unité d'un quaternion unitaire:

• sensors_event_t.data[0] = rot_axis.x*sin(theta/2)
• sensors_event_t.data[1] = rot_axis.y*sin(theta/2)
• sensors_event_t.data[2] = rot_axis.z*sin(theta/2)
• sensors_event_t.data[3] = cos(theta/2)

Où :

• Les champs x, y et z de rot_axis sont les coordonnées est-nord-haut d'un vecteur de longueur unitaire représentant l'axe de rotation.
• theta est l'angle de rotation.

Le quaternion est un quaternion unitaire: il doit avoir une norme 1. Si vous ne le faites pas, le comportement des clients sera erratique.

De plus, ce capteur indique une précision d'orientation estimée:

sensors_event_t.data[4] = estimated_accuracy (en radians)

L'erreur de cap doit être inférieure à estimated_accuracy 95% du temps. Ce capteur doit utiliser un gyroscope comme entrée principale pour le changement d'orientation.

Ce capteur utilise également l'entrée de l'accéléromètre et du magnétomètre pour compenser la dérive du gyroscope. Il ne peut pas être implémenté en utilisant uniquement l'accéléromètre et le magnétomètre.

Vecteur de rotation du jeu

Capteurs physiques sous-jacents: accéléromètre et gyroscope (sans magnétomètre)

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GAME_ROTATION_VECTOR) renvoie un capteur de réveil

Un capteur de vecteur de rotation de jeu est semblable à un capteur de vecteur de rotation, mais n'utilise pas le champ géomagnétique. Par conséquent, l'axe Y ne pointe pas vers le nord, mais vers une autre référence. Cette référence peut dériver du même ordre de grandeur que le gyroscope autour de l'axe Z.

Pour savoir comment définir sensors_event_t.data[0-3], consultez le capteur Vecteur de rotation. Ce capteur ne signale pas une précision d'orientation estimée : sensors_event_t.data[4] est réservé et doit être défini sur 0.

Dans l'idéal, un téléphone qui a été pivoté et remis dans la même orientation réelle doit indiquer le même vecteur de rotation du jeu.

Ce capteur doit être basé sur un gyroscope et un accéléromètre. Il ne peut pas utiliser le magnétomètre comme entrée, sauf indirectement, via l'estimation du biais du gyroscope.

Gravity

Capteurs physiques sous-jacents: accéléromètre et (si présent) gyroscope (ou magnétomètre si le gyroscope n'est pas présent)

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GRAVITY) renvoie un capteur de réveil

Un capteur de gravité indique la direction et l'intensité de la gravité dans les coordonnées de l'appareil.

Les composantes du vecteur de gravité sont indiquées en m/s^2 dans les champs x, y et z de sensors_event_t.acceleration.

Lorsque l'appareil est au repos, la sortie du capteur de gravité doit être identique à celle de l'accéléromètre. Sur Terre, la magnitude est d'environ 9,8 m/s².

Si l'appareil est équipé d'un gyroscope, le capteur de gravité doit utiliser le gyroscope et l'accéléromètre comme entrée.

Si l'appareil ne dispose pas de gyroscope, le capteur de gravité doit utiliser l'accéléromètre et le magnétomètre comme entrée.

Vecteur de rotation géomagnétique

Capteurs physiques sous-jacents: accéléromètre et magnétomètre (pas de gyroscope)

Reporting-mode: Continuous

Faible consommation d'énergie

getDefaultSensor(SENSOR_TYPE_GEOMAGNETIC_ROTATION_VECTOR) renvoie un capteur de réveil

Un vecteur de rotation géomagnétique est semblable à un capteur de vecteur de rotation, mais utilise un magnétomètre et non un gyroscope.

Ce capteur doit être basé sur un magnétomètre. Il ne peut pas être implémenté à l'aide d'un gyroscope, et l'entrée du gyroscope ne peut pas être utilisée par ce capteur.

Pour savoir comment définir sensors_event_t.data[0-4], consultez le capteur Vecteur de rotation.

Tout comme pour le capteur de vecteur de rotation, l'erreur de cap doit être inférieure à la précision estimée (sensors_event_t.data[4]) 95% du temps.

Ce capteur doit être à faible consommation d'énergie. Il doit donc être implémenté en matériel.

Orientation (obsolète)

Capteurs physiques sous-jacents: accéléromètre, magnétomètre et (le cas échéant) gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ORIENTATION) renvoie un capteur de réveil

Remarque:Il s'agit d'un ancien type de capteur qui a été abandonné dans le SDK Android. Il a été remplacé par le capteur de vecteur de rotation, qui est plus clairement défini. Utilisez le capteur de vecteur de rotation plutôt que le capteur d'orientation dans la mesure du possible.

Un capteur d'orientation indique l'attitude de l'appareil. Les mesures sont indiquées en degrés dans les champs x, y et z de sensors_event_t.orientation:

• sensors_event_t.orientation.x: azimut, angle entre la direction du nord magnétique et l'axe Y, autour de l'axe Z (0<=azimuth<360). 0=Nord, 90=Est, 180=Sud, 270=Ouest.
• sensors_event_t.orientation.y: inclinaison, rotation autour de l'axe X (-180<=pitch<=180), avec des valeurs positives lorsque l'axe Z se déplace vers l'axe Y.
• sensors_event_t.orientation.z: roll, rotation autour de l'axe Y (-90<=roll<=90), avec des valeurs positives lorsque l'axe X se déplace vers l'axe Z.

Veuillez noter que, pour des raisons historiques, l'angle de roulis est positif dans le sens des aiguilles d'une montre. (Mathématiquement parlant, il doit être positif dans le sens antihoraire):

Cette définition diffère de celle de l'inclinaison, du tangage et du roulis utilisés dans l'aviation, où l'axe X est le long du côté long de l'avion (de la queue au nez).

Le capteur d'orientation indique également la précision attendue pour ses mesures via sensors_event_t.orientation.status. Pour en savoir plus sur les valeurs possibles de ce champ, consultez les constantes SENSOR_STATUS_* de SensorManager.

Capteurs non étalonnés

Les capteurs non étalonnés fournissent des résultats plus bruts et peuvent inclure des biais, mais ils contiennent également moins de "à-coups" dus aux corrections appliquées lors de l'étalonnage. Certaines applications peuvent préférer ces résultats non étalonnés, car ils sont plus fluides et plus fiables. Par exemple, si une application tente de réaliser sa propre fusion de capteurs, l'introduction de calibrages peut en fait fausser les résultats.

Accéléromètre non étalonné

Capteur physique sous-jacent: accéléromètre

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ACCELEROMETER_UNCALIBRATED) renvoie un capteur de réveil

Un capteur d'accéléromètre non étalonné indique l'accélération de l'appareil sur les trois axes du capteur sans correction de biais (le biais d'usine et la compensation de température sont appliqués aux mesures non étalonnées), ainsi qu'une estimation du biais. Toutes les valeurs sont exprimées en unités SI (m/s^2) et sont indiquées dans les champs de sensors_event_t.uncalibrated_accelerometer:

• x_uncalib: accélération (sans compensation de biais) sur l'axe X
• y_uncalib: accélération (sans compensation de biais) sur l'axe Y
• z_uncalib: accélération (sans compensation de biais) sur l'axe Z
• x_bias: biais estimé sur l'axe X
• y_bias: biais estimé sur l'axe Y
• z_bias: biais estimé le long de l'axe Z

Gyroscope non étalonné

Capteur physique sous-jacent: gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GYROSCOPE_UNCALIBRATED) renvoie un capteur de réveil

Un gyroscope non étalonné indique la vitesse de rotation autour des axes du capteur sans y appliquer de compensation de biais, ainsi qu'une estimation du biais. Toutes les valeurs sont exprimées en radians/seconde et sont indiquées dans les champs de sensors_event_t.uncalibrated_gyro:

• x_uncalib: vitesse angulaire (sans compensation de dérive) autour de l'axe X
• y_uncalib: vitesse angulaire (sans compensation de dérive) autour de l'axe Y
• z_uncalib: vitesse angulaire (sans compensation de dérive) autour de l'axe Z
• x_bias: dérive estimée autour de l'axe X
• y_bias: dérive estimée autour de l'axe Y
• z_bias: dérive estimée autour de l'axe Z

Conceptuellement, la mesure non calibrée est la somme de la mesure calibrée et de l'estimation du biais: _uncalibrated = _calibrated + _bias.

Les valeurs x_bias, y_bias et z_bias devraient sauter dès que l'estimation du biais change, et elles devraient être stables le reste du temps.

Pour en savoir plus sur le système de coordonnées utilisé, consultez la définition du capteur gyroscope.

Le calibrage d'usine et la compensation de température doivent être appliqués aux mesures. De plus, l'estimation de la dérive du gyroscope doit être implémentée afin que des estimations raisonnables puissent être signalées dans x_bias, y_bias et z_bias. Si l'implémentation ne peut pas estimer la dérive, ce capteur ne doit pas être implémenté.

Si ce capteur est présent, le capteur gyroscopique correspondant doit également l'être, et les deux capteurs doivent partager les mêmes valeurs sensor_t.name et sensor_t.vendor.

Champ magnétique non étalonné

Capteur physique sous-jacent: magnétomètre

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_MAGNETIC_FIELD_UNCALIBRATED) renvoie un capteur de réveil

Un capteur de champ magnétique non étalonné indique le champ magnétique ambiant ainsi qu'une estimation de l'étalonnage du fer dur. Toutes les valeurs sont exprimées en micro-Tesla (uT) et sont indiquées dans les champs de sensors_event_t.uncalibrated_magnetic:

• x_uncalib: champ magnétique (sans compensation du fer dur) le long de l'axe X
• y_uncalib: champ magnétique (sans compensation du fer dur) le long de l'axe Y
• z_uncalib: champ magnétique (sans compensation du fer dur) le long de l'axe Z
• x_bias: biais estimé de l'aimant permanent sur l'axe X
• y_bias: biais estimé du fer permanent le long de l'axe Y
• z_bias: biais estimé de l'aimant permanent le long de l'axe Z

Conceptuellement, la mesure non calibrée est la somme de la mesure calibrée et de l'estimation du biais: _uncalibrated = _calibrated + _bias.

Le magnétomètre non étalonné permet aux algorithmes de niveau supérieur de gérer une mauvaise estimation du fer ferreux. Les valeurs x_bias, y_bias et z_bias devraient augmenter dès que l'estimation du matériel physique change, et elles devraient être stables le reste du temps.

Le calibrage du fer doux et la compensation de température doivent être appliqués aux mesures. De plus, une estimation matérielle doit être implémentée pour que des estimations raisonnables puissent être signalées dans x_bias, y_bias et z_bias. Si l'implémentation ne peut pas estimer le biais, ce capteur ne doit pas être implémenté.

Si ce capteur est présent, le capteur de champ magnétique correspondant doit également l'être, et les deux capteurs doivent partager les mêmes valeurs sensor_t.name et sensor_t.vendor.

Angle de la charnière

Reporting-mode: On-change

getDefaultSensor(SENSOR_TYPE_HINGE_ANGLE) renvoie un capteur de réveil

Un capteur d'angle de charnière mesure l'angle, en degrés, entre deux parties intégrantes de l'appareil. Le mouvement d'une charnière mesuré par ce type de capteur devrait modifier les façons dont l'utilisateur peut interagir avec l'appareil, par exemple en ouvrant ou en révélant un écran.

Capteurs composites d'interaction

Certains capteurs sont principalement utilisés pour détecter les interactions avec l'utilisateur. Nous ne définissons pas la manière dont ces capteurs doivent être implémentés, mais ils doivent être à faible consommation d'énergie. Il incombe au fabricant de l'appareil de vérifier leur qualité en termes d'expérience utilisateur.

Geste de réveil

Capteurs physiques sous-jacents: non défini (tout élément à faible consommation d'énergie)

Reporting-mode: One-shot

Faible consommation d'énergie

N'implémentez que la version de réveil de ce capteur.

getDefaultSensor(SENSOR_TYPE_WAKE_GESTURE) renvoie un capteur de réveil

Un capteur de geste de réveil permet de réveiller l'appareil en fonction d'un mouvement spécifique à l'appareil. Lorsque ce capteur se déclenche, l'appareil se comporte comme si le bouton Marche/Arrêt avait été enfoncé, ce qui allume l'écran. Ce comportement (allumer l'écran lorsque ce capteur se déclenche) peut être désactivé par l'utilisateur dans les paramètres de l'appareil. Les modifications apportées aux paramètres n'ont aucune incidence sur le comportement du capteur, mais uniquement sur le fait que le framework allume l'écran lorsqu'il se déclenche. Le geste à détecter n'est pas spécifié et peut être choisi par le fabricant de l'appareil.

Ce capteur doit être à faible consommation d'énergie, car il est susceptible d'être activé 24h/24, 7j/7.

Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Geste de prise en main

Capteurs physiques sous-jacents: non défini (tout élément à faible consommation d'énergie)

Reporting-mode: One-shot

Faible consommation d'énergie

N'implémentez que la version de réveil de ce capteur.

getDefaultSensor(SENSOR_TYPE_PICK_UP_GESTURE) renvoie un capteur de réveil

Un capteur de geste de prise en main se déclenche lorsque l'appareil est pris en main, quel que soit l'endroit où il se trouvait auparavant (bureau, poche, sac).

Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Geste Glance

Capteurs physiques sous-jacents: non défini (tout élément à faible consommation d'énergie)

Reporting-mode: One-shot

Faible consommation d'énergie

N'implémentez que la version de réveil de ce capteur.

getDefaultSensor(SENSOR_TYPE_GLANCE_GESTURE) renvoie un capteur de réveil

Un capteur de geste de regard permet d'allumer brièvement l'écran pour permettre à l'utilisateur de jeter un coup d'œil sur le contenu à l'écran en fonction d'un mouvement spécifique. Lorsque ce capteur se déclenche, l'appareil allume l'écran momentanément pour permettre à l'utilisateur de consulter des notifications ou d'autres contenus, tandis que l'appareil reste verrouillé dans un état non interactif (en veille). L'écran s'éteint ensuite. Ce comportement (allumage bref de l'écran lorsque ce capteur se déclenche) peut être désactivé par l'utilisateur dans les paramètres de l'appareil. Les modifications apportées aux paramètres n'ont aucun impact sur le comportement du capteur, mais uniquement sur le fait que le framework allume brièvement l'écran lorsqu'il se déclenche. Le geste à détecter n'est pas spécifié et peut être choisi par le fabricant de l'appareil.

Ce capteur doit être à faible consommation d'énergie, car il est susceptible d'être activé 24h/24, 7j/7. Chaque événement de capteur signale 1 dans sensors_event_t.data[0].

Capteurs IMU à axes limités

Disponibles à partir d'Android 13, les capteurs IMU à axes limités sont des capteurs compatibles avec les cas d'utilisation où les trois axes (x, y, z) ne sont pas tous disponibles. Les types d'IMU standards dans Android (comme SENSOR_TYPE_ACCELEROMETER et SENSOR_TYPE_GYROSCOPE) supposent que les trois axes sont compatibles. Toutefois, tous les facteurs de forme et tous les appareils ne sont pas compatibles avec les accéléromètres et les gyroscopes à trois axes.

Accéléromètre à axes limités

Capteurs physiques sous-jacents: accéléromètre

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ACCELEROMETER_LIMITED_AXES) renvoie un capteur de réveil

Un capteur d'accéléromètre à axes limités est équivalent à TYPE_ACCELEROMETER, mais prend en charge les cas où un ou deux axes ne sont pas pris en charge.

Les trois dernières valeurs d'événement du capteur signalées par le capteur indiquent si la valeur d'accélération pour les axes x, y et z est prise en charge. Une valeur 1.0 indique que l'axe est compatible, et une valeur 0 indique qu'il ne l'est pas. Les fabricants d'appareils identifient les axes compatibles au moment de la compilation, et les valeurs ne changent pas pendant l'exécution.

Les fabricants d'appareils doivent définir les valeurs d'accélération pour les axes inutilisés sur 0, au lieu de valeurs non définies.

Axes limités du gyroscope

Capteurs physiques sous-jacents: gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GYROSCOPE_LIMITED_AXES) renvoie un capteur de réveil

Un capteur d'axes limités du gyroscope est équivalent à TYPE_GYROSCOPE, mais prend en charge les cas où un ou deux axes ne sont pas compatibles.

Les trois dernières valeurs d'événement du capteur signalées par le capteur indiquent si la valeur de vitesse angulaire pour les axes X, Y et Z est prise en charge. Une valeur 1.0 indique que l'axe est compatible, et une valeur 0 indique qu'il ne l'est pas. Les fabricants d'appareils identifient les axes compatibles au moment de la compilation, et les valeurs ne changent pas pendant l'exécution.

Les fabricants d'appareils doivent définir les valeurs de vitesse angulaire pour les axes inutilisés sur 0.

Axes limités de l'accéléromètre non étalonnés

Capteurs physiques sous-jacents: accéléromètre

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_ACCELEROMETER_LIMITED_AXES_UNCALIBRATED) renvoie un capteur de réveil

Un capteur non étalonné à axes limités d'accéléromètre est équivalent à TYPE_ACCELEROMETER_UNCALIBRATED, mais prend en charge les cas où un ou deux axes ne sont pas pris en charge.

Les trois dernières valeurs d'événement du capteur signalées par le capteur indiquent si les valeurs d'accélération et de biais pour les axes x, y et z sont prises en charge. Une valeur 1.0 indique que l'axe est compatible, et une valeur 0 indique qu'il ne l'est pas. Les fabricants d'appareils identifient les axes compatibles au moment de la compilation, et les valeurs ne changent pas pendant l'exécution.

Les fabricants d'appareils doivent définir les valeurs d'accélération et de biais pour les axes inutilisés sur 0.

Axes limités du gyroscope non étalonnés

Capteurs physiques sous-jacents: gyroscope

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_GYROSCOPE_LIMITED_AXES_UNCALIBRATED) renvoie un capteur de réveil

Un capteur non étalonné à axes limités du gyroscope est équivalent à TYPE_GYROSCOPE_UNCALIBRATED, mais prend en charge les cas où un ou deux axes ne sont pas pris en charge.

Les trois dernières valeurs d'événement du capteur signalées par le capteur indiquent si les valeurs de vitesse angulaire et de dérive pour les axes X, Y et Z sont prises en charge. Une valeur 1.0 indique que l'axe est compatible, et une valeur 0 indique qu'il ne l'est pas. Les fabricants d'appareils identifient les axes compatibles au moment de la compilation, et les valeurs ne changent pas pendant l'exécution.

Les fabricants d'appareils doivent définir les valeurs de vitesse angulaire et de dérive pour les axes inutilisés sur 0.

IMU à axes limités composite

Capteurs physiques sous-jacents: toute combinaison d'accéléromètre à trois axes, de gyroscope à trois axes, d'accéléromètre à trois axes non étalonné et de gyroscope à trois axes non étalonné.

Reporting-mode: Continuous

Un capteur IMU à axes limités composite est équivalent à un capteur IMU à axes limités, mais au lieu d'être compatible avec le HAL, il convertit les données du capteur à trois axes en variantes à axes limités équivalentes. Ces capteurs composites ne sont activés que pour les appareils automobiles.

Le tableau suivant présente un exemple de conversion d'un accéléromètre à trois axes standard en accéléromètre à axes limités composite.

Valeurs SensorEvent pour SENSOR_TYPE_ACCELEROMETER	Exemple d'événement SensorEvent SENSOR_TYPE_ACCELEROMETER	Composite SENSOR_TYPE_ACCELEROMETER_LIMITED_AXES SensorEvent
values[0]	-0,065	-0,065
valeurs[1]	0,078	0,078
values[2]	9,808	9,808
values[3]	N/A	1.0
valeurs[4]	N/A	1.0
valeurs[5]	N/A	1.0

Capteurs automobiles

Capteurs pour les cas d'utilisation automobiles

Titre

Capteurs physiques sous-jacents: toute combinaison de GPS, de magnétomètre, d'accéléromètre et de gyroscope.

Reporting-mode: Continuous

getDefaultSensor(SENSOR_TYPE_HEADING) renvoie un capteur de réveil

Disponible à partir d'Android 13, un capteur de cap mesure la direction dans laquelle l'appareil pointe par rapport au nord géographique en degrés. Le capteur de cap comprend deux valeurs SensorEvent. L'une pour l'orientation de l'appareil mesurée et l'autre pour l'exactitude de la valeur d'orientation fournie.

Les valeurs d'orientation signalées par ce capteur doivent être comprises entre 0.0 (inclus) et 360.0 (exclu), 0 indiquant le nord, 90 l'est, 180 le sud et 270 l'ouest.

La précision de ce capteur est définie à 68 % de confiance. Si la distribution sous-jacente est normale gaussienne, la précision est d'un écart type. Par exemple, si le capteur de cap renvoie une valeur de cap de 60 degrés et une valeur de précision de 10 degrés, il y a 68 % de chances que le cap réel soit compris entre 50 degrés et 70 degrés.