Integrità del sistema Android

Android 13 include android.hardware.health AIDL HAL, una conversione da health@2.1 HAL. Questo nuovo HAL presenta i seguenti vantaggi:

  • Rimuovere le API inutilizzate relative al caricabatterie
  • Rimuovi StorageAttribute non utilizzati e i campi correlati
  • Supporta la ricarica con la base di ricarica.

Android 11 include android.hardware.health HAL 2.1, un aggiornamento della versione secondaria di health@2.0 HAL. Questo nuovo HAL presenta i seguenti vantaggi:

  • Separazione più chiara tra il framework e il codice del fornitore.
  • Maggiore libertà per la personalizzazione del fornitore nei report sulle informazioni sanitarie.
  • Informazioni più complete sullo stato del dispositivo, non solo sulla batteria.

La documentazione per l'implementazione di Health 2.1 HAL è disponibile in questa pagina come riferimento.

Requisiti

Questa sezione contiene i requisiti per Android 11, 12 e 13 o versioni successive.

Dispositivi con Android 11 e Android 12

I dispositivi lanciati con Android 11 e 12 devono fornire l'HAL 2.1 o l'HAL AIDL. I dispositivi che non vengono lanciati con Android 11 o 12, ma che prevedono di aggiornare l'immagine del fornitore alla versione 5 (rilasciata in Android 11) o 6 (rilasciata in Android 12) della matrice di compatibilità del framework di destinazione, devono rimuovere le implementazioni HAL 2.0 esistenti e fornire l'HAL 2.1 o l'HAL AIDL. I dispositivi che non vengono lanciati con Android 11 e che non prevedono di aggiornare l'immagine del fornitore sono inoltre consigliati per fornire HAL 2.1 o AIDL.

AOSP include più librerie di assistenza progettate per aiutarti a implementare l'HAL 2.1 e la transizione dalle vecchie HAL HIDL.

Dispositivi con Android 13 e versioni successive

I dispositivi lanciati con Android 13 devono fornire l'HAL AIDL (e non devono fornire l'HAL HIDL). I dispositivi che non vengono lanciati con Android 13, ma che prevedono di aggiornare l'immagine del fornitore alla versione 7 della matrice di compatibilità del framework target (rilasciata in Android 13) devono rimuovere le implementazioni HIDL HAL esistenti e fornire l'HAL AIDL. È consigliabile fornire l'HAL AIDL anche per i dispositivi che non vengono lanciati con Android 13 e che non prevedono di aggiornare l'immagine del fornitore.

AOSP include più librerie di assistenza progettate per aiutarti a implementare l'HAL AIDL e la transizione dai vecchi HAL HIDL.

Terminologia

Di seguito sono riportati i termini che devi conoscere prima di leggere il resto della documentazione sullo stato del sistema Android:

health@2.1
Abbreviazione di android.hardware.health@2.1. La versione 1 dell'HIDL per la salute è stata rilasciata in Android 11.
health AIDL HAL
Abbreviazione di android.hardware.health. La versione 1 dell'HAL AIDL per la salute è stata rilasciata in Android 13.
caricabatterie
File eseguibile in esecuzione in modalità di ricarica off che mostra l'animazione di ricarica dello smartphone.
recovery
Eseguibile in esecuzione in modalità di ripristino che deve recuperare le informazioni sulla batteria.
storaged
Demone che recupera le informazioni di archiviazione e le fornisce al framework.

Salute in Android 11 e 12

In Android 11 e 12, il componente di integrità funziona come descritto nel seguente diagramma:

[system]
    | getService()
    V
[health@2.1-service]
        | getService(stub=true)
        V
[      health@2.0-impl-2.1-<device>.so      ]
        |                                  | (device-dependent linkage)
        V                                  V
+---------Helper libs for impl--------+   [libhealthd.device]
| [libhealthloop (uevent, wakealarm)] |
| [libhealth2impl (IHealth impl)    ] |
| [libbatterymonitor (battery)      ] |
+-------------------------------------+

Per le altre modalità:

[       charger          ]
    | getService()      |  (legacy code path)
    V                   +-------------------------------------------------+
[health@2.1-service]                                                      |
        | getService(stub=true)                                           |
        V                                                                 |
[      health@2.0-impl-2.1-<device>.so      ]                             |
        |                                  | (device-dependent linkage)   |
        V                                  V                              |
+---------Helper libs for impl--------+   [libhealthd.device]             |
| [libhealthloop (uevent, wakealarm)] |                                   |
| [libhealth2impl (IHealth impl)    ] | <---------------------------------+
| [libbatterymonitor (battery)      ] |
+-------------------------------------+

[recovery]
        | getService() w/o hwservicemanager
        V
[      health@2.0-impl-2.1-<device>.so      ]
        |                                  | (device-dependent linkage)
        V                                  V
+---------Helper libs for impl--------+   [libhealthd.device]
| [libhealthloop (uevent, wakealarm)] |
| [libhealth2impl (IHealth impl)    ] |
| [libbatterymonitor (battery)      ] |
+-------------------------------------+

Per le diverse modalità, consulta il seguente diagramma semplificato:

Infrastruttura HIDL HAL 2.1 per la salute

Figura 1. Infrastruttura HIDL HAL 2.1 per la salute.

Salute in Android 13

In Android 13 viene introdotto l'HAL AIDL per la salute. La Figura 2 mostra in dettaglio il funzionamento del componente salute:

Infrastruttura HAL AIDL per la salute

Figura 2. Infrastruttura HAL AIDL per la salute.

Interfaccia HIDL HAL 2.1

L'HAL health@2.1 supporta la ricarica in modalità spenta e fornisce maggiori informazioni sulla batteria.

L'interfaccia principale, IHealth, fornisce le seguenti funzioni aggiuntive

  • getHealthConfig: per recuperare la configurazione di questo HAL
  • getHealthInfo_2_1: un upgrade della versione secondaria a getHealthInfo
  • shouldKeepScreenOn: per determinare se lo schermo deve rimanere acceso in modalità caricatore

Inoltre, l'implementazione di @2.1::IHealth è necessaria per supportare @2.1::IHealthInfoCallback per le relative funzioni registerCallback e unregisterCallback. La nuova interfaccia di callback restituisce informazioni sullo stato al client utilizzando la funzione healthInfoChanged_2_1 anziché la funzione healthInfoChanged ereditata.

Una nuova struttura, @2.1::HealthInfo, viene restituita utilizzando i callback e getHealthInfo_2_1. Questa struttura contiene informazioni aggiuntive sullo stato del dispositivo disponibili tramite l'HAL health@2.0, tra cui:

  • Livello di capacità della batteria
  • Tempo di ricarica della batteria fino al completamento (in secondi)
  • Capacità di progettazione della batteria a carica completa (in μAh)

La Figura 3 mostra un diagramma UML delle classi utili per l'implementazione dell'HAL health:

Diagramma UML di Health 2.1 HAL

Figura 3. Diagramma UML di Health HAL 2.1.

Per informazioni sull'implementazione del servizio Salute 2.1, vedi Implementazione di Health 2.1.

Versione 1 dell'interfaccia HAL AIDL

Questa sezione contiene informazioni sulla versione 1 dell'interfaccia HAL AIDL.

Modifiche alle API

L'HAL AIDL versione 1 supporta API simili all'HAL HIDL 2.1. Rispetto all'interfaccia HIDL 2.1, nell'API sono state apportate le seguenti modifiche:

  • Le API relative al caricabatterie introdotte in HIDL HAL 2.1 non vengono trasferite ad AIDL HAL. Poiché la funzionalità di ricarica in modalità spenta è presente solo nella partizione /vendor, le API sull'interfaccia fornitore non sono necessarie. Per implementare correttamente la ricarica in modalità spenta, consulta Caricabatterie.
  • Il tipo StorageAttribute e i campi correlati vengono rimossi perché non sono utilizzati.
  • chargerDockOnline viene aggiunto a HealthInfo per supportare la ricarica della base.

Implementazione

La Figura 4 mostra un diagramma UML delle classi utili per l'implementazione dell'HAL AIDL per la salute:

Diagramma UML di Health AIDL HAL

Figura 4. Diagramma UML di Health AIDL HAL.

Per informazioni sull'implementazione del servizio AIDL per la salute, vedi Implementare l'HAL AIDL per la salute.

Ripristino

Android 13 supporta Binder nel ripristino. L'installazione del servizio AIDL Health per il ripristino consente l'esecuzione in modalità di ripristino.

Per informazioni sull'installazione del servizio AIDL per la salute nel ripristino, vedi quanto segue:

Caricabatterie

La funzionalità di ricarica in modalità spenta viene spostata da /system a /vendor. Per i dispositivi lanciati con Android 13, se supportano la ricarica in modalità spenta, il binario del servizio HAL deve supportare la modalità di ricarica. Per farlo, consulta Implementazione del caricabatterie.

Proprietà di sistema del caricatore

Le proprietà ro.charger.* non sono più leggibili dal binario charger in /vendor. Se sul tuo dispositivo sono impostate proprietà di sistema ro.charger.*, consulta le proprietà di sistema per il caricabatterie.