Strukturreferenz „vehicle_hw_device“

Definition in Zeile 1640 der Datei vehicle.h .

Debug-Status für die Fahrzeug-HAL ausdrucken Dieser wird vom Fahrzeugnetzwerkdienst aufgerufen und in den Dump des Dienstes aufgenommen.

Der übergebene Dateideskriptor kann verwendet werden, um mit dprintf() oder write() Debug-Text zu schreiben. Der Text sollte nur in ASCII-Codierung vorliegen.

Leistungsanforderungen:

Dies muss ein nicht blockierender Aufruf sein. Die HAL sollte nach 1 ms von diesem Aufruf zurückkehren, muss aber nach 10 ms von diesem Aufruf zurückkehren. Bei diesem Aufruf dürfen keine Deadlocks auftreten, da er jederzeit aufgerufen werden kann. Alle verwendeten Synchronisierungsprimitive (z. B. Mutex-Sperren oder Semaphoren) sollten mit einem Zeitlimit erworben werden.

Definition in Zeile 1744 der Datei vehicle.h .

Rufen Sie sofort einen Wert für die Fahrzeugeigenschaft ab. Die Daten sollten korrekt zugeordnet werden. Der Aufrufer der API IST DER EIGENTÜMER des Datenfelds. Der Aufrufer legt „data->prop“, „data->value_type“ und optional den Zonenwert für die zonenspezifische Property fest. Bei der HAL-Implementierung müssen jedoch alle Einträge bei der Rückgabe korrekt ausgefüllt werden. Für den Zeigertyp sollte die HAL-Implementierung den erforderlichen Speicher zuweisen. Der Aufrufer ist dafür verantwortlich, release_memory_from_get aufzurufen, damit die HAL den zugewiesenen Speicher freigeben kann. Für das Attribut vom Typ „VEHICLE_PROP_CHANGE_MODE_STATIC“ sollte „get“ immer denselben Wert zurückgeben. Für den Property-Typ „VEHICLE_PROP_CHANGE_MODE_ON_CHANGE“ sollte der aktuelle Wert zurückgegeben werden. Wenn noch keine Daten verfügbar sind, was in der Anfangsphase vorkommen kann, sollte dieser Aufruf sofort mit dem Fehlercode -EAGAIN zurückgegeben werden.

Definition in Zeile 1681 der Datei vehicle.h .

Nach dem Aufruf von „open on device“ sollte der Nutzer Callbacks für Ereignis- und Fehlerfunktionen registrieren.

Definition in Zeile 1646 der Datei vehicle.h .

Alle verfügbaren Properties auflisten Die Liste wird in „list“ zurückgegeben.

Parameter

Anzahl_Unterkünfte

Anzahl der Unterkünfte im zurückgegebenen Array.

Returns

Array von Property-Konfigurationen, die von diesem Auto unterstützt werden. Die zurückgegebenen Daten sind konstant und können vom Aufrufer nicht geändert werden. Die HAL-Implementierung sollte diesen Speicherplatz bis zur Veröffentlichung der HAL beibehalten, um ein erneutes Kopieren zu vermeiden.

Definition in Zeile 1663 der Datei vehicle.h .

Vor dem Aufruf von „close“ sollte der Nutzer die registrierten Callback-Funktionen löschen. Wenn der Aufruf von unsubscribe() für alle Properties nicht vor release() erfolgt, wird die Kündigung der Properties von release() selbst durchgeführt.

Definition in Zeile 1654 der Datei vehicle.h .

Gibt den Speicher frei, der den Daten im vorherigen Get-Aufruf zugewiesen wurde. Der Get-Aufruf für Byte oder String umfasst die Zuweisung des erforderlichen Speichers aus der Vehicle HAL. Der vom Vehicle HAL zugewiesene Arbeitsspeicher sollte zur Sicherheit vom Vehicle HAL freigegeben werden. Der Vehicle Network Service ruft diese Funktion auf, wenn die Daten aus dem Vehicle HAL nicht mehr erforderlich sind. Die Vehicle HAL-Implementierung sollte nur Mitglieder von „vehicle_prop_value_t“ wie „data->str_value.data“ oder „data->bytes_value.data“ freigeben, aber nicht die Daten selbst, da diese vom Vehicle Network Service zugewiesen werden. Sobald der Speicher freigegeben wurde, sollte der entsprechende Zeiger von der Fahrzeug-HAL auf NULL gesetzt werden.

Definition in Zeile 1693 der Datei vehicle.h .

Legen Sie einen Wert für die Fahrzeugeigenschaft fest. Die Daten müssen korrekt zugewiesen sein und dürfen nicht NULL sein. Der Aufrufer der API ist Inhaber des Datenfelds. Der Zeitstempel der Daten wird beim Festlegen ignoriert. Für das Festlegen einiger Properties muss der Anfangsstatus verfügbar sein. Je nach Fahrzeug-HAL sind diese anfänglichen Daten nach der Initialisierung möglicherweise für kurze Zeit nicht verfügbar. In diesem Fall kann set call wie get call den Wert -EAGAIN zurückgeben. Bei einer Property mit separater Ein-/Aus-Steuerung kann die Einstellung fehlschlagen, wenn die Property nicht eingeschaltet ist. In diesem Fall sollte hal den Fehler -ESHUTDOWN zurückgeben.

Definition in Zeile 1706 der Datei vehicle.h .

Ereignisse abonnieren Je nach Ausgabe von „list_properties“ ist für die Property Folgendes zu tun: a) „on-change“: „sample_rate“ sollte auf „0“ festgelegt werden. b) „supports frequency“: „sample_rate“ sollte von „min_sample_rate“ auf „max_sample_rate“ festgelegt werden. Bei Eigenschaften vom Typ „Bei Änderung“ sendet der Fahrzeugnetzwerkdienst einen weiteren Abruf, um den ursprünglichen Status zu prüfen. Daher muss bei der Implementierung der Vehicle HAL kein Anfangsstatus für Eigenschaften vom Typ „on-change“ gesendet werden.

Parameter

Gerät
prop
sample_rate
Zonen	Alle abonnierten Zonen für eine Property mit Zonen. Kann für Properties ohne Zonen ignoriert werden. „0“ bedeutet, dass alle Zonen unterstützt werden, nicht, dass keine Zone unterstützt wird.

Definition in Zeile 1723 der Datei vehicle.h .

Abo für eine Property kündigen

Definition in Zeile 1727 der Datei vehicle.h