Konfiguracje usługi

Każda obsługiwana właściwość jest określana przez konfigurację usługi zdefiniowaną za pomocą struktury VehiclePropConfig i zawiera poniższe pola.

Pole	Opis
prop	Identyfikator usługi. Musi to być jedna z definiowanych właściwości systemowych z Obsługiwanych właściwości systemowych lub właściwość dostawcy. Identyfikator usługi jest tworzony na podstawie funkcji bitowej OR z tych pól (od prawej do lewej): (0x00000000) 16 bitów: unikalny identyfikator z zakresu od 0x0100 do 0xffff. (0x00000000) 8 bitów: Typy usług, które definiują typ usługi. (0x00000000) 4 bity: Typy obszarów. (0x00000000) 4 bity: VehiclePropertyGroup> może to być SYSTEM(0x10000000) lub VENDOR (0x20000000). Właściwości, które możesz dostosować, znajdziesz w sekcji Właściwości dostawcy. Na przykład: INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)
access	Tryb dostępu do usługi. Musi mieć wartość READ, WRITE lub READ_WRITE. Musi być równy trybowi dostępu zdefiniowanemu w Obsługiwanych właściwościach systemu.
changeMode	Zmień tryb usługi. Musi być to jedno z tych wartości: STATIC, ON_CHANGE lub CONTINUOUS. STATIC oznacza, że wartość właściwości nigdy się nie zmienia po uruchomieniu systemu. ON_CHANGE oznacza, że VHAL musi raportować, gdy wartość się zmienia. CONTINUOUS oznacza, że wartość właściwości zmienia się stale i VHAL musi raportować na podstawie częstotliwości próbkowania subskrypcji. Tryb zmiany musi być zgodny z trybem zmiany zdefiniowanym w Obsługiwanych właściwościach systemu.
configArray	Opcjonalny tablica zawierająca konfigurację specyficzną dla usługi. Może być puste.
configString	Opcjonalny ciąg tekstowy zawierający konfigurację specyficzną dla usługi. Może być puste.
minSampleRate i maxSampleRate Minimalna i maksymalna obsługiwana częstotliwość próbkowania w przypadku właściwości ciągłej. Nieużywana, jeśli obiekt nie jest ciągły.

Typy obiektów

Zdefiniowane jako typy zbiorcze w VehiclePropertyType.aidl. Obsługiwane typy właściwości zostały wymienione w tabeli poniżej.

Typ obiektu	Wartość	Opis
CIĄG ZNAKÓW	0x00100000	Właściwość ciągu znaków, która korzysta z pola stringValue w sekcji Wartość właściwości pojazdu.
WARTOŚĆ LOGICZNA	0x00200000	Właściwość logiczna, która używa pierwszego elementu w polu int32Values w wartości właściwości pojazdu. 0 oznacza false, a None 0 – true.
INT32	0x00400000	Właściwość typu liczba całkowita, która używa pierwszego elementu w polu int32Values w wartości właściwości pojazdu.
INT32_VEC	0x00410000	Właściwość Integer[] korzysta z elementów w polu int32Values w wartości właściwości Pojazd.
INT64	0x00500000	Długa właściwość, która używa pierwszego elementu w polu int64Values w wartości właściwości pojazdu.
INT64_VEC	0x00510000	Właściwość Long[] korzysta z elementów w polu int64Values w Właściwości pojazdu.
FLOAT	0x00600000	Właściwość typu float, która używa pierwszego elementu w polu floatValues w wartości właściwości pojazdu.
FLOAT_VEC	0x00610000	Właściwość float[], która korzysta z elementów w polu floatValues w wartości właściwości pojazdu.
BYTES	0x00700000	Właściwość byte[], która korzysta z elementów w polu byteValues w Wartości właściwości Pojazd.
MIESZANE STYLE	0x00e00000	Obiekt typu mieszanego. dowolna kombinacja typów skalarnych lub wektorowych. W tablicy config w konfiguracji usługi musi być podany dokładny format. W przypadku właściwości typu MIXED dostawcy parametr configArray musi mieć taki format: configArray[0], 1 wskazuje, że właściwość ma wartość String. configArray[1], 1 oznacza, że właściwość ma wartość logiczną configArray[2], 1 wskazuje, że właściwość ma wartość całkowitą configSlate[3], liczba wskazuje rozmiar liczby całkowitej[] we właściwości. configArray[4], 1 oznacza, że właściwość ma wartość Long configArray[5], liczba oznacza rozmiar tablicy Long[] w danej usłudze configArray[6], 1 wskazuje, że właściwość ma wartość typu Float configArray[7], liczba wskazuje rozmiar obiektu Float[] w właściwości configtablica[8], liczba wskazuje rozmiar bajta[] we właściwości. Na przykład configArray = {1, 1, 1, 3, 0, 0, 0, 0, 0} wskazuje, że właściwość ma wartość ciągu znaków, wartość logiczną, wartość całkowitą i tablicę z 3 wartościami całkowitymi.

Konfiguracja identyfikatora obszaru

Każda konfiguracja usługi może też zawierać listę konfiguracji identyfikatorów obszaru. Ta lista jest opcjonalna w przypadku usług globalnych i wymagana w przypadku usług strefowych (usług z wieloma obsługiwanymi obszarami). Każda konfiguracja identyfikatora obszaru zawiera te pola.

Pole	Opis
areaId	Identyfikator tego obszaru. Zobacz identyfikatory obszarów.
minInt32Value i maxInt32Value	Opcjonalna minimalna i maksymalna wartość właściwości typu INT32. Pozostałe typy są ignorowane. Ignorowana, jeśli oba mają wartość 0. Jeśli w usłudze globalnej trzeba określić wartość minimalną i maksymalną, należy użyć jednej konfiguracji obszaru o identyfikatorze obszaru 0.
minInt64Value i maxInt64Value	Opcjonalna wartość minimalna i maksymalna dla właściwości typu INT64. Ignorowane w przypadku wszystkich innych typów. Jeśli obie wartości są równe 0, właściwość jest ignorowana. W przypadku właściwości globalnej, jeśli trzeba zdefiniować minimalną i maksymalną wartość, należy użyć jednej konfiguracji obszaru z identyfikatorem obszaru 0.
minFloatValue i maxFloatValue	Opcjonalna minimalna i maksymalna wartość właściwości typu Float. Ignorowane w przypadku wszystkich innych typów. Ignorowana, jeśli obydwie wartości mają wartość 0,0. W przypadku właściwości globalnej, jeśli trzeba zdefiniować wartość minimalną i maksymalną, należy użyć jednej konfiguracji obszaru z identyfikatorem obszaru 0.
(nowość w Androidzie 14) supportedEnumValues	Opcjonalna lista obsługiwanych wartości, jeśli właściwość jest zdefiniowana jako właściwość typu wyliczenia. Jeśli nie jest określony (pusty) lub jeśli jest starsza niż Android 14, przyjmuje się, że obsługiwane są wszystkie wartości enumeracji. W przypadku usługi globalnej, jeśli trzeba zdefiniować obsługiwane wartości wyliczenia, należy użyć jednej konfiguracji obszaru z identyfikatorem obszaru 0.

Typy obszarów

Zdefiniowane jako typy zbiorcze w VehicleArea.aidl. Obsługiwane typy obszarów są wymienione poniżej.

Typ obszaru	Wartość	Opis
GLOBAL	0x01000000	To jest usługa globalna i nie obejmuje wielu obszarów.
OKNO	0x03000000	Obszar na podstawie okien, używa enum VehicleAreaWindow.
MIRROR	0x04000000	Obszar oparty na lustrach, używa enum VehicleAreaMirror.
SEAT	0x05000000	Obszar na podstawie miejsc, używa enum VehicleAreaSeat.
DZWONEK	0x06000000	Obszar na podstawie drzwi, używa enum VehicleAreaDoor.
KOŁO	0x07000000	Obszar na podstawie kół, korzysta z wyliczenia VehicleAreaWheel.

Każda strefa w danej usłudze musi używać zdefiniowanego wstępnie typu obszaru. Każdy typ obszaru ma zestaw flag bitowych zdefiniowanych w enumeracji dla tego typu. Na przykład obszar SEAT definiuje wyliczenia VehicleAreaSeat:

• ROW_1_LEFT = 0x0001
• ROW_1_CENTER = 0x0002
• ROW_1_RIGHT = 0x0004
• ROW_2_LEFT = 0x0010
• ROW_2_CENTER = 0x0020
• ROW_2_RIGHT = 0x0040
• ROW_3_LEFT = 0x0100
• ...

Identyfikatory obszarów

Właściwości z podziałem na strefy są adresowane za pomocą identyfikatorów obszarów. Każda usługa z podziałem na strefy może obsługiwać co najmniej 1 identyfikator obszaru. Identyfikator obszaru składa się z co najmniej 1 flagi z odpowiedniego wyliczenia. Na przykład usługa korzystająca z usługi VehicleAreaSeat może używać tych identyfikatorów obszaru:

Produkt	Opis
ROW_1_LEFT | ROW_1_RIGHT	Identyfikator obszaru dotyczy obu miejsc z przodu.
ROW_2_LEFT	Dotyczy tylko lewego tylnego siedzenia.
ROW_2_RIGHT	Dotyczy tylko prawego tylnego siedzenia.

Więcej informacji znajdziesz w artykule Ogrzewanie, wentylacja i klimatyzacja.