Propriétés spéciales

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

Propriétés du fournisseur

Pour répondre aux besoins spécifiques des partenaires, le VHAL autorise les propriétés de fournisseurs accessibles uniquement via des API système. Suivez les consignes ci-dessous lorsque vous travaillez avec des propriétés de fournisseurs :

• Essayez toujours d'utiliser d'abord les propriétés système. Les propriétés du fournisseur ne doivent être utilisées qu'en dernier recours, lorsque aucune des propriétés système ne répond à vos exigences.
• Pour éviter la fragmentation de l'écosystème, les propriétés du fournisseur ne doivent pas être utilisées pour répliquer les propriétés du véhicule qui existent déjà dans les VehiclePropertyIds du SDK. Pour en savoir plus, consultez la section 2.5, Exigences pour les applications automobiles du CDD.
• Utilisez les champs suivants pour générer l'ID de propriété :
  • VehiclePropertyGroup:VENDOR groupe FOURNISSEURs n'est utilisé que pour les propriétés de fournisseur.
  • VehicleArea Sélectionnez un type de zone approprié.
  • VehiclePropertyType Sélectionnez le type de données approprié. Le type BYTES permet de transmettre des données brutes, ce qui est suffisant dans la plupart des cas. Envoyer fréquemment du big data via les propriétés des fournisseurs peut ralentir tout l'accès au réseau du véhicule. Faites preuve de prudence lorsque vous ajoutez une charge utile importante.
  • Property ID Choisissez un ID unique sur deux octets pour la propriété du fournisseur. Par exemple, 0x1234.
• Renseignez VehiclePropConfig.configString avec une brève description du fournisseur. . Cela permet aux outils de vérification de validité de signaler la réplication accidentelle de propriétés de véhicule existantes. Par exemple, "Ma propriété personnalisée pour XYZ".
• Accès via CarPropertyManager (pour les composants Java) ou via le libvhalclient (pour les annonces natives). À faire modifier d'autres API pour voitures, car cela pourrait entraîner de futurs problèmes de compatibilité.

Autorisation pour les propriétés du fournisseur

L'autorisation par défaut pour toutes les propriétés de fournisseurs définies est android.car.Car.PERMISSION_VENDOR_EXTENSION. Pour un contrôle plus précis des autorisations, acceptez la propriété SUPPORT_CUSTOMIZE_VENDOR_PERMISSION. Cette propriété STATIC est en lecture seule, et son tableau de configuration spécifie les autorisations pour les propriétés du fournisseur. configArray est défini comme suit (i correspond à un entier commençant à 0):

• configArray[3 * i] propId, l'ID de la propriété du fournisseur.
• configArray[3 * i + 1] : énumération dans VehicleVendorPermission.aidl pour indiquer l'autorisation de lire la valeur de la propriété.
• configArray[3 * i + 2] Enum dans VehicleVendorPermission.aidl pour indiquer l'autorisation d'écrire la valeur de la propriété.

Par exemple, le tableau de configuration suivant configure deux propriétés de fournisseur : vendor_prop_1 et vendor_prop_2, pour disposer des autorisations:

• vendor_prop_1 nécessite android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_SEAT pour la lecture et android.car.hardware.property.VehicleVendorPermission.PERMISSION_SET_CAR_VENDOR_CATEGORY_SEAT pour l'écriture.
• vendor_prop-2 nécessite android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_INFO pour la lecture et n'est pas accessible en écriture pour les applications Android.

configArray = {
  PERMISSION_SET_VENDOR_CATEGORY_SEAT
    vendor_prop_2, PERMISSION_GET_VENDOR_CATEGORY_INFO, PERMISSION_NOT_ACCESSIBLE
}

Les propriétés de fournisseurs qui ne figurent pas dans ce tableau utilisent l'autorisation par défaut du fournisseur. Lorsque PERMISSION_NOT_ACCESSIBLE est sélectionné, les applications Android ne peuvent pas accéder à la propriété. Dans l'exemple, les applications Android ne peuvent pas écrire de valeur pour vendor_prop_2. Seuls les clients VHAL natifs peuvent écrire dans cette propriété.

Systèmes avancés d'aide à la conduite (ADAS)

SIÈGE ET VOLANT

Consultez la section Propriétés du siège et du volant.

CVC

Vous pouvez utiliser le VHAL pour contrôler le système CVC en définissant des propriétés liées au système CVC. La plupart des propriétés CVC sont associées à des zones particulières du véhicule, bien que plusieurs soient des propriétés globales. Voici quelques exemples de propriétés définies :

Pour les propriétés CVC qui dépendent de l'état de l'alimentation du système CVC, elles doivent être listées dans le tableau de configuration HVAC_POWER_ON. Pour obtenir la liste complète des propriétés CVC, recherchez HVAC_* dans VehicleProperty.aidl. Consultez la section Propriétés système compatibles. propriétés.

Règles de mappage des propriétés de CVC de type VehicleArea non GLOBAL sur des ID de zone : Chaque "zone" d'un type VehicleArea spécifique affecté par la propriété doit être incluse dans un ID de zone pour cette propriété. Les contrôleurs de température sont attribués aux sièges qu'ils "influencent le plus", mais chaque siège concerné doit être inclus exactement une fois. L'attribution du siège arrière central à l'AreaID de gauche ou de droite peut sembler arbitraire, Toutefois, si tous les sièges sont inclus dans un seul identifiant de zone, dans la voiture sont toutes exprimées et qu'une manière raisonnable de modifier chaque siège est disponible.

Exemple 1

Une voiture a deux sièges avant (ROW_1_LEFT, ROW_1_RIGHT) et trois sièges arrière (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Il existe deux unités de contrôle de la température, une pour le côté conducteur et une pour le côté passager. Un ensemble d'ID de zone valide pour le mappage HVAC_TEMPERATURE_SET serait un tableau à deux éléments:

• ROW_1_LEFT | ROW_2_LEFT
• ROW_1_RIGHT | ROW_2_CENTER | ROW_2_DROITE

Un autre mappage pour la même configuration matérielle serait le suivant :

• ROW_1_LEFT | ROW_2_CENTER | ROW_2_LEFT
• ROW_1_RIGHT | ROW_2_DROITE

Exemple 2

Une voiture comporte trois rangées de sièges, avec deux sièges à l'avant (ROW_1_LEFT, ROW_1_RIGHT), et trois sièges à la deuxième (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) et troisième rangées (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). Il existe trois unités de contrôle de la température, une pour le côté conducteur, une pour le côté passager et une pour l'arrière. Un moyen raisonnable de mapper HVAC_TEMPERATURE_SET sur des ID de zone est un tableau à trois éléments :

• ROW_1_LEFT
• ROW_1_DROITE
• ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_DROITE

Exemple 3

Une voiture comporte deux sièges avant (ROW_1_LEFT, ROW_1_RIGHT) et trois sièges arrière (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Supposons que la voiture ne prenne en charge HVAC_AUTO_ON que pour les deux sièges avant. Un ensemble valide d'ID de zone pour le système HVAC_AUTO_ON correspondrait d'éléments:

• ROW_1_LEFT | ROW_1_RIGHT

Si HVAC_AUTO_ON disposait de deux unités de contrôle distinctes pour le côté conducteur et le côté passager, un autre mappage serait un tableau à deux éléments :

• ROW_1_LEFT
• ROW_1_RIGHT

INFO_EXTERIOR_DIMENSIONS

Les dimensions extérieures d'un véhicule sont mesurées en millimètres, comme illustré dans la figure 1.

Utilisez les propriétés décrites dans ce tableau pour définir les dimensions extérieures d'un véhicule.

Conformité avec les règles générales de sécurité de l'Union européenne

Si le véhicule doit respecter les exigences du règlement sur la sécurité générale (GSR) de l'Union européenne via Android, la propriété GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT doit être prise en charge. Exemple de cas d'utilisation : GSR-ISA (Intelligent Speed Assist), tel que défini dans l'UE Règlement 2019/2144. Cette propriété est ajoutée dans AIDL VHAL à partir d'Android 13, mais elle est compatible avec Car Service depuis la sortie d'Android 12. Cette propriété est définie en lecture seule propriété d'entier global statique, avec des valeurs possibles définies par Énumération GsrComplianceRequirementType:

Pour prendre en charge cette propriété dans HIDL VHAL (sous Android 12), les fournisseurs doivent coder en dur l'ID de propriété. Par exemple, l'extrait suivant montre comment cela est pris en charge dans le HIDL de référence VHAL DefaultConfig.h:

{
  .config =
      {
          // GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
          .prop = 0x11400F47,
          .access = VehiclePropertyAccess::READ,
          .changeMode = VehiclePropertyChangeMode::STATIC,
      },
  // GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1
  .initialValue = {.int32Values = {1}},
}

Pour prendre en charge cette propriété dans AIDL VHAL (à partir d'Android 13), les fournisseurs peuvent utiliser l'ID de propriété VehicleProperty.h et énumération de GsrComplianceRequirementType.h. Pour comme dans la référence AIDL VHAL DefaultProperties.json:

{
  "property": "VehicleProperty::GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT",
  "defaultValue": {
    "int32Values": [
      "GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1"
    ]
  }
}

Pour lire cette propriété à partir d'une application Android, utilisez CarPropertyManager.getIntProperty

• Sous Android 13 et versions ultérieures, utilisez VehiclePropertyIds.GENERAL_SAFETY_REGULATION_COMPLIANCE comme ID de propriété.
• Sous Android 12, utilisez la valeur codée en dur 0x11400F47 comme ID de propriété. Cette propriété nécessite l'autorisation Car#PERMISSION_CAR_INFO.