Configurations de propriété

Chaque propriété compatible est spécifiée par une configuration de propriété définie via la structure VehiclePropConfig et comporte les champs suivants.

Champ Description
prop

ID de la propriété. Il doit s'agir de l'une des propriétés système définies dans la section Propriétés système compatibles ou d'une propriété du fournisseur. L'ID de propriété est construit à l'aide de l'opérateur OR de bits des champs suivants (de droite à gauche):

  • (0x00000000) 16 bits: identifiant unique compris entre 0x0100 et 0xffff.
  • (0x00000000) 8 bits: types de propriétés qui définit le type de la propriété.
  • (0x00000000) 4 bits: types de zones.
  • (0x00000000) 4 bits: VehiclePropertyGroup> Il s'agit de SYSTEM (0x10000000) ou de VENDOR (0x20000000). Consultez la section Propriétés de fournisseur pour connaître les propriétés que vous pouvez personnaliser.

Exemple :
INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)
access Mode d'accès de la propriété. Doit être défini sur READ, WRITE ou READ_WRITE. Cette valeur doit être égale au mode d'accès défini dans la section Propriétés système compatibles.
changeMode
  • Changer de mode pour la propriété Doit être l'un des suivants : STATIC, ON_CHANGE ou CONTINUOUS. STATIC signifie que la valeur de la propriété ne change jamais après le démarrage du système. ON_CHANGE signifie que le VHAL doit signaler lorsque la valeur change. CONTINUOUS signifie que la valeur de la propriété change en continu et que VHAL doit générer des rapports en fonction du taux d'échantillonnage de l'abonnement.
  • Le mode de modification doit être égal au mode de modification défini dans la section Propriétés système compatibles.
configArray Tableau facultatif contenant une configuration spécifique à la propriété. Ce champ peut être vide.
configString Chaîne facultative contenant la configuration spécifique à la propriété. Ce champ peut être vide.
minSampleRate et maxSampleRate

Fréquence d'échantillonnage minimale et maximale compatible pour la propriété continue. Non utilisé si la propriété n'est pas continue.

Types de propriétés

Définis comme énumérations dans VehiclePropertyType.aidl. Les types de propriétés compatibles sont répertoriés dans le tableau suivant.

Type de propriété Valeur Description
Chaîne 0x00100000 Propriété de chaîne, utilise le champ stringValue dans la valeur de la propriété du véhicule.
BOOLEAN 0x00200000 Propriété booléenne, utilise le premier élément du champ int32Values dans la valeur de la propriété du véhicule. 0 signifie false, None 0 signifie true.
INT32 0x00400000 Propriété entière, utilise le premier élément du champ int32Values dans la valeur de la propriété du véhicule.
INT32_VEC 0x00410000 La propriété Integer[] utilise les éléments du champ int32Values dans la valeur de la propriété du véhicule.
INT64 0x00500000 Propriété Long, utilise le premier élément du champ int64Values dans la valeur de la propriété du véhicule.
INT64_VEC 0x00510000 La propriété Long[] utilise les éléments du champ int64Values dans la valeur de la propriété du véhicule.
FLOAT 0x00600000 Propriété flottante, qui utilise le premier élément du champ floatValues dans la valeur de la propriété de véhicule.
FLOAT_VEC 0x00610000 La propriété Float[] utilise les éléments du champ floatValues dans la valeur de la propriété du véhicule.
BYTES 0x00700000 La propriété byte[] utilise les éléments du champ byteValues dans la valeur de la propriété du véhicule.
MIXTE 0x00e00000 Propriété de type mixte. Toute combinaison de types scalaires ou vectoriels. Le format exact doit être fourni dans le tableau de configuration de la propriété.

Pour les propriétés de type MIXED du fournisseur, configArray doit être formaté selon la structure suivante:

  • configArray[0], 1 indique que la propriété a une valeur de chaîne
  • configArray[1], 1 indique que la propriété a une valeur booléenne
  • configArray[2], 1 indique que la propriété a une valeur entière
  • configArray[3], le nombre indique la taille d'Integer[] dans la propriété
  • configArray[4], 1 indique que la propriété a une valeur Long
  • configArray[5], le nombre indique la taille de Long[] dans la propriété
  • configArray[6], 1 indique que la propriété a une valeur Float
  • configArray[7], le nombre indique la taille de Float[] dans la propriété
  • configArray[8], le nombre indique la taille de l'octet[] dans la propriété.

Par exemple, configArray = {1, 1, 1, 3, 0, 0, 0, 0, 0} indique que la propriété comporte une valeur de chaîne, une valeur booléenne, une valeur entière et un tableau avec trois entiers.

Configuration de l'ID de zone

Chaque configuration de propriété peut également contenir une liste de configurations d'ID de zone. Cette liste est facultative pour les propriétés globales et obligatoire pour les propriétés zonées (propriétés avec plusieurs zones compatibles). Chaque configuration d'identifiant de zone comporte les champs suivants.

Champ Description
areaId ID de cette zone. Consultez la section ID de zone.
minInt32Value et maxInt32Value
  • Valeurs minimale et maximale facultatives pour les propriétés de type INT32. Ignoré pour tous les autres types. Ignoré si les deux valeurs sont égales à 0.
  • Pour une propriété globale, si des valeurs minimales et maximales doivent être définies, une configuration de zone avec l'ID de zone 0 doit être utilisée.
minInt64Value et maxInt64Value
  • Valeurs minimale et maximale facultatives pour les propriétés de type INT64. Ignoré pour tous les autres types. Ignoré si les deux valeurs sont égales à 0.
  • Pour une propriété globale, si des valeurs minimale et maximale doivent être définies, une configuration d'aire avec l'identifiant de zone 0 doit être utilisée.
minFloatValue et maxFloatValue
  • Valeur minimale et maximale facultatives pour les propriétés de type Float. Ignoré pour tous les autres types. Ignoré si les deux valeurs sont égales à 0,0.
  • Pour une propriété globale, si des valeurs minimales et maximales doivent être définies, une configuration de zone avec l'ID de zone 0 doit être utilisée.
(Nouveauté d'Android 14)
supportedEnumValues
  • Liste facultative des valeurs acceptées si la propriété est définie comme une propriété de type énumération. Si ce n'est pas le cas (si la valeur est vide) ou avant Android 14, on considère que toutes les valeurs d'énumération sont acceptées.
  • Pour une propriété globale, si des valeurs d'énumération acceptées doivent être définies, une configuration de zone ayant l'identifiant de zone 0 doit être utilisée.

Types de zones

Définis comme énumérations dans VehicleArea.aidl. Les types de zones pris en charge sont listés ci-dessous.

Type de zone Valeur Description
GÉNÉRAL 0x01000000 Cet établissement est un site international et ne comporte pas plusieurs zones.
WINDOW 0x03000000 Zone basée sur les fenêtres, utilise l'énumération VehicleAreaWindow.
MIRROR 0x04000000 Aire basée sur des miroirs, utilise l'énumération VehicleAreaMirror.
SEAT 0x05000000 Zone basée sur le nombre de sièges, utilise l'énumération VehicleAreaSeat.
DOOR 0x06000000 Zone basée sur les portes, utilise l'énumération VehicleAreaDoor.
ROUE 0x07000000 Zone basée sur les roues, utilise l'énumération VehicleAreaWheel.

Chaque propriété zonée doit utiliser un type d'espace prédéfini. Chaque type d'aire possède un ensemble d'indicateurs définis dans une énumération pour le type d'aire. Par exemple, la zone SEAT définit les énumérations VehicleAreaSeat:

  • ROW_1_LEFT = 0x0001
  • ROW_1_CENTER = 0x0002
  • ROW_1_RIGHT = 0x0004
  • ROW_2_LEFT = 0x0010
  • ROW_2_CENTER = 0x0020
  • ROW_2_RIGHT = 0x0040
  • ROW_3_LEFT = 0x0100
  • ...

ID de zone

Les propriétés zonées sont adressées à l'aide d'ID de zone. Chaque propriété zonée peut prendre en charge un ou plusieurs ID de zone. Un ID de zone se compose d'un ou de plusieurs indicateurs de son énumération respective. Par exemple, une propriété utilisant VehicleAreaSeat peut utiliser les ID de zone suivants:

Article Description
ROW_1_LEFT | ROW_1_RIGHT L'ID de zone s'applique aux deux sièges avant.
ROW_2_LEFT S'applique uniquement au siège arrière gauche.
ROW_2_RIGHT S'applique uniquement au siège arrière droit.

Pour en savoir plus, consultez CVC.