Propriétés du véhicule ADAS

Nous avons ajouté les nouvelles propriétés ADAS suivantes à Android 14:

Ces nouvelles fonctionnalités sont illustrées dans la figure suivante.

Fonctionnalités ADAS compatibles

Figure 1 : Fonctionnalités ADAS compatibles

Liste des propriétés

Pour prendre en charge ces nouvelles fonctionnalités, une liste de propriétés est ajoutée à Android 14. Vous les trouverez ci-dessous.

Propriétés
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_DISTANCE

AUTOMATIC_EMERGENCY_BRAKING_ENABLED
AUTOMATIC_EMERGENCY_BRAKING_STATE

BLIND_SPOT_WARNING_ENABLED
BLIND_SPOT_WARNING_STATE

CRUISE_CONTROL_ENABLED
CRUISE_CONTROL_TYPE
CRUISE_CONTROL_STATE
CRUISE_CONTROL_COMMAND
CRUISE_CONTROL_TARGET_SPEED

EMERGENCY_LANE_KEEP_ASSIST_ENABLED
EMERGENCY_LANE_KEEP_ASSIST_STATE
FORWARD_COLLISION_WARNING_ENABLED
FORWARD_COLLISION_WARNING_STATE

HANDS_ON_DETECTION_ENABLED
HANDS_ON_DETECTION_DRIVER_STATE
HANDS_ON_DETECTION_WARNING

LANE_DEPARTURE_WARNING_ENABLED
LANE_DEPARTURE_WARNING_STATE

LANE_KEEP_ASSIST_ENABLED
LANE_KEEP_ASSIST_STATE

LANE_CENTERING_ASSIST_ENABLED
LANE_CENTERING_ASSIST_COMMAND
LANE_CENTERING_ASSIST_STATE

Thèmes de conception

Les thèmes de conception suivants sont appliqués aux nouvelles propriétés.

Propriété Description
ACTIVÉS
  • Propriétés permettant d'indiquer si une fonctionnalité est activée ou désactivée.
  • Propriétés booléennes dans lesquelles true est activé et false est désactivé.
  • Propriétés Read et Write pouvant être implémentées en tant que Read-only.
STATE
  • Propriétés permettant de communiquer l'état de la fonctionnalité via une liste d'états prédéfinis.
  • Propriétés Int32 avec des énumérations définies.
  • Champ OTHER pour assurer la rétrocompatibilité.
  • Propriétés Read-only.
  • Types de zones "Miroir" ou "Global".
  • Utilise les valeurs définies dans ErrorStates.aidl.
  • Utilisez l'API getSupportedEnumValues() dans AreaIdConfig.java.
Divers
  • Propriétés COMMAND pour les éléments géographiques lorsque l'entrée utilisateur est requise.
  • Propriétés WARNING lorsque l'état peut être représenté séparément.
  • Autres propriétés à prendre en charge :
    • Variations des fonctionnalités, le cas échéant
    • Ajustez les paramètres des fonctionnalités, le cas échéant.

Exemples de diagrammes des états

Cette section fournit des diagrammes d'état pour un sous-ensemble des fonctionnalités ADAS compatibles afin de montrer comment les propriétés incluses fonctionnent ensemble. Nous avons fourni des exemples des fonctionnalités suivantes.

  • Freinage d'urgence automatique (AEB)
  • Assistant de centrage de voie (LCA)
  • Détection de la prise en main

Freinage d'urgence automatique

Deux propriétés sont définies pour l'AEB, comme indiqué dans ce tableau.

Propriété Valeurs
AUTOMATIC_EMERGENCY_BRAKING_ENABLED VehiclePropertyType:BOOLEAN

AUTOMATIC_EMERGENCY_BRAKING_STATE

Défini dans AutomaticEmergencyBrakingState.aidl.

VehiclePropertyType:INT32

  • OTHER
  • ENABLED
  • ACTIVATED
  • USER_OVERRIDE
  • ErrorState
  • L'exemple de diagramme des états suivant pour l'AEB inclut les états compatibles définis dans AutomaticEmergencyBrakingState.aidl.

    États de l'AEB définis dans AutomaticEmergencyBrakingState.aidl

    Figure 2. États de l'AEB définis dans AutomaticEmergencyBrakingState.aidl.

    Cette figure fournit un exemple d'AEB lorsque l'état USER_OVERRIDE n'est pas pris en charge. Les états compatibles doivent être spécifiés via l'API getSupportedEnumValues() dans AreaIdConfig.java.

    AEB lorsque l'état de forçage de l'utilisateur n'est pas pris en charge

    Figure 3. AEB lorsque l'état USER_OVERRIDE n'est pas compatible.

    Dans l'exemple d'AEB illustré à la figure 4, l'erreur qui rend l'AEB indisponible est mise en évidence. Cela montre comment les valeurs définies dans ErrorState.aidl doivent être utilisées. Ces erreurs ne génèrent pas d'exception générée par CarPropertyManager. Elles sont plutôt partagées avec les applications de la même manière que toute autre modification apportée à CarPropertyValue.

    Une erreur rend l'AEB indisponible

    Figure 4. L'erreur rend l'AEB indisponible.

    Assistant de centrage dans la voie

    L'assistance au centrage dans la voie (LCA) fournit trois propriétés associées et définies.

    Propriété Valeurs
    LANE_CENTERING_ASSIST_ENABLED VehiclePropertyType:BOOLEAN

    LANE_CENTERING_ASSIST_STATE

    Défini dans LaneCenteringAssistState.aidl

    VehiclePropertyType:INT32

    • OTHER
    • ENABLED
    • ACTIVATION_REQUESTED
    • ACTIVATED
    • USER_OVERRIDE
    • FORCED_DEACTIVATION_WARNING
    • ErrorState

    LANE_CENTERING_ASSIST_COMMAND

    Défini dans LaneCenteringAssistCommand.aidl

    VehiclePropertyType:INT32

    • ACTIVATE
    • DEACTIVATE

    Le diagramme des états suivant illustre la LCA lorsque tous les états définis dans LaneCenteringAssistState.aidl sont compatibles. Les lignes vertes peuvent être une commande lancée à partir de LANE_CENTERING_ASSIST_COMMAND (lorsqu'implémentée) ou lancée via un autre mécanisme dans le véhicule et refléter un changement d'état sur Android Automotive OS (AAOS).

    États de l'assistance au centrage dans la voie définis dans LaneCenteringAssistState.aidl

    Figure 5. États de l'assistance au centrage de voie définis dans LaneCenteringAssistState.aidl.

    Cet exemple de LCA met en évidence une erreur qui rend la LCA indisponible. Cela montre comment utiliser les valeurs définies dans ErrorState.aidl. Ces erreurs n'entraînent pas l'affichage d'une erreur par CarPropertyManager. Elles sont plutôt partagées avec les applications de la même manière que les autres modifications apportées à CarPropertyValue.

     L'erreur entraîne la non-disponibilité de la LCA.

    Figure 6. L'erreur entraîne la non-disponibilité de la LCA.

    Détection de la prise en main

    Ces trois propriétés associées sont définies pour la détection manuelle.

    Propriété Description
    HANDS_ON_DETECTION_ENABLED VehiclePropertyType:BOOLEAN

    HANDS_ON_DETECTION_STATE

    Défini dans HandsOnDetectionDriverState.aidl

    VehiclePropertyType:INT32

    • OTHER
    • HANDS_ON
    • HANDS_OFF
    • ErrorState

    HANDS_ON_DETECTION_WARNING

    Défini dans HandsOnDetectionWarning.aidl

    VehiclePropertyType:INT32

    • OTHER
    • NO_WARNING
    • WARNING
    • ErrorState

    Vous trouverez ci-dessous un exemple de HOD, dans lequel tous les états définis dans HandsOnDetectionDriverState.aidl sont acceptés.

    HOD lorsque tous les états définis dans HandsOnDetectionDriverState.aidl sont compatibles.

    Figure 7. HOD lorsque tous les états définis dans HandsOnDetectionDriverState.aidl sont compatibles.

    En plus de la propriété HANDS_ON_DETECTION_STATE, HOD fournit également une propriété d'avertissement distincte, HANDS_ON_DETECTION_WARNING. Le diagramme des états des valeurs d'avertissement HOD est illustré à la figure 8.

    Valeurs d'avertissement HOD

    Figure 8. HOD lorsque toutes les valeurs définies dans HandsOnDetectionWarning.aidl sont prises en charge.