Configurations des propriétés

ID de la propriété. Il doit s'agir d'une des propriétés système définies dans VehicleProperty.aidl 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: ID unique compris dans la plage 0x0100 à 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 du fournisseur pour connaître les propriétés que vous pouvez personnaliser.

Par exemple :
INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)

• Modifiez le mode de la propriété. Doit être défini sur 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.
• Pour les propriétés système, cette valeur doit être égale au mode de modification documenté dans VehicleProperty.aidl.

• Valeur minimale et maximale facultative pour les propriétés de type INT64 au démarrage. Doit être 0 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.
• Cette valeur est statique et ne change pas, même si la valeur minimale ou maximale change au moment de l'exécution. Implémentez IVehicle#getMinMaxSupportedValue pour la valeur minimale ou maximale dynamique.

• Liste facultative des valeurs acceptées au démarrage 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 les propriétés globales, si des valeurs d'énumération compatibles doivent être définies, une configuration de zone avec l'ID de zone 0 doit être utilisée.
• Cette valeur est statique et ne change pas, même si les valeurs compatibles changent au moment de l'exécution. Implémentez IVehicle#getSupportedValuesLists pour les valeurs dynamiques acceptées.
• Cela ne s'applique qu'aux propriétés de type énumération. Pour les autres types, ce champ doit être vide. Pour exposer les valeurs acceptées pour d'autres types non énumérés, utilisez IVehicle#getSupportedValuesLists.

• Indique si la fréquence de mise à jour variable est prise en charge. Cette règle ne s'applique qu'aux propriétés continues.
• Si la valeur est true, l'application peut activer le taux de mise à jour variable pour un abonnement afin de ne recevoir des événements de mise à jour de propriété que lorsque la valeur de la propriété change (ce qui traite les propriétés continues comme des propriétés de modification).
• Si tous les abonnés d'une propriété activent le taux de mise à jour variable, la requête d'abonnement à VHAL active le taux de mise à jour variable pour la propriété et VHAL ne doit envoyer des événements de mise à jour de la propriété que lorsque la valeur de la propriété change.
• Si un abonné demande un taux de mise à jour fixe, la requête d'abonnement à VHAL désactive le taux de mise à jour variable pour la propriété et AAOS filtre les événements en double pour les clients qui demandent un taux de mise à jour variable.
• Il est vivement recommandé d'accepter un taux de mise à jour variable pour toutes les propriétés continues autres que le battement de cœur afin d'améliorer les performances, sauf si les données de la propriété sont volumineuses (par exemple, un tableau d'octets de 1 ko) et peuvent occuper une grande quantité de mémoire pour le cache.

• Si la valeur n'est pas null, indique si cette propriété spécifie des valeurs minimales ou maximales acceptées ou une liste de valeurs acceptées.
• Ce champ indique si les API de valeurs acceptées dynamiques (getMinMaxSupportedValue, getSupportedValuesLists, subscribeSupportedValueChange et unsubscribeSupportedValueChange) sont compatibles avec cet ID de propriété et cet ID de zone.
• Si ce n'est pas null, VHAL doit implémenter ces API pour cet ID de propriété et cet ID de zone.
• Si null ou Android 15 ou version antérieure est utilisé, les valeurs dynamiques acceptées pour cet ID de propriété et cet ID de zone ne sont pas prises en charge. Le client doit utiliser les informations sur les valeurs statiques compatibles fournies dans la configuration de la propriété du véhicule.