Sensörler Çoklu HAL

Sensör Çoklu HAL'i, sensör HAL'lerinin diğer sensör HAL'leriyle birlikte çalışmasına olanak tanıyan bir çerçevedir. Sensörler Çoklu HAL, tedarikçi bölümünde dinamik kitaplıklar olarak depolanan sensör alt HAL'lerini dinamik olarak yükler ve bunlara, etkinlikleri yayınlama ve uyanma kilidini alma ve bırakma işlemlerini gerçekleştirebilecek bir geri çağırma nesnesi verir. Sensör alt HAL'i, tedarikçi bölümündeki paylaşılan bir nesneye yerleştirilmiş ve çoklu HAL çerçevesi tarafından kullanılan bir sensör HAL'idir. Bu alt HAL'ler birbirine veya işlem için ana işlevi içeren çoklu HAL koduna bağlı değildir.

Android 11 veya sonraki sürümleri çalıştıran cihazlarda kullanılabilen Sensors Multi-HAL 2.1, menteşe açısı sensör türünü gösterebilen alt HAL'lerin yüklenmesini destekleyen Sensors Multi-HAL 2.0'ın bir yinelemesidir. Bu sensör türünü desteklemek için alt HAL'lerin 2.1 SubHal başlığında tanımlanan alt HAL API'lerini kullanması gerekir.

Android 13 veya sonraki sürümleri çalıştıran ve Sensors AIDL HAL kullanan cihazlarda, çoklu HAL özelliğine izin vermek için çoklu HAL shim katmanını kullanabilirsiniz. Uygulama ayrıntıları için Sensors Multi-HAL'i Sensors AIDL HAL ile kullanma başlıklı makaleyi inceleyin.

Sensors Multi-HAL 2 ile Sensors HAL 2 arasındaki fark

Android 10 veya sonraki sürümlerin yüklü olduğu cihazlarda kullanılabilen Sensors Multi-HAL 2, HAL API'leriyle etkileşimi kolaylaştırmak için Sensors HAL 2'nin üzerine çeşitli soyutlamalar ekler. Sensors Multi-HAL 2, Sensors HAL 2 arayüzünün uygulanmasını ve HalProxy'in alt HAL'lerle etkileşim kurmasına olanak tanımak için V2_1/SubHal (veya V2_0/SubHal) arayüzünü yönetmek üzere HalProxy sınıfını kullanıma sunar.

ISensorsSubHal arayüzü, 2.1/ISensors.hal (veya 2.0/ISensors.hal) arayüzünden aşağıdaki yönlerden farklıdır:

  • initialize yöntemi, iki FMQ ve ISensorsCallback yerine bir IHalProxyCallback sınıfı iletir.
  • Alt HAL'ler, hata raporlarında hata ayıklama bilgileri sağlamak için bir hata ayıklama işlevi uygulamalıdır.
  • Yüklenen alt HAL'in diğer alt HAL'lerden ayırt edilebilmesi için alt HAL'lerde bir ad işlevi uygulanmalıdır.

Sensors Multi-HAL 2 ile Sensors HAL 2 arasındaki temel fark, başlatma işlevlerindedir. IHalProxyCallback arayüzü, FMQ'ler yerine iki yöntem sunar: sensör etkinliklerini sensör çerçevesine yayınlamak için bir yöntem ve uyanma kilitleri oluşturmak için bir yöntem. Sensörler Çoklu HAL, tüm alt HAL'ler için sensör etkinliklerinin zamanında yayınlanmasını sağlamak amacıyla FMQ'lerle yapılan tüm etkileşimleri yönetir. Alt HAL'lerin, uyanma kilitlerinin zaman aşımına uğrama yükünü Sensörler Çoklu HAL'ine devretmek ve uyanma kilidi kullanımını Sensörler Çoklu HAL'inin tamamı için tek bir ortak uyanma kilidinde merkezileştirmek amacıyla createScopedWakelock yöntemini kullanması önemle tavsiye edilir. Bu yöntem, kilitleme ve kilit açma çağrılarını en aza indirir.

Sensors Multi-HAL 2'de bazı yerleşik güvenlik özellikleri de bulunur. Sensör FMQ'sinin dolu olduğu veya Android sensör çerçevesinin yeniden başlatıldığı ve sensör durumunun sıfırlanması gerektiği durumları ele alır. Ayrıca, etkinlikler HalProxy sınıfına yayınlandığında ancak sensör çerçevesi etkinlikleri hemen kabul edemediğinde, Sensors Multi-HAL etkinliklerin yayınlanmasını beklerken tüm alt HAL'lerde çalışmaların devam etmesine izin vermek için etkinlikleri bir arka plan iş parçacığına taşıyabilir.

Kaynak kod ve referans uygulama

Tüm Sensörler Çoklu HAL kodu hardware/interfaces/sensors/common/default/2.X/multihal/'te kullanılabilir. Bazı kaynaklara ilişkin ipuçları aşağıda verilmiştir.

  • HalProxy.h: HalProxy nesnesi, Sensörler çoklu HAL tarafından oluşturulur ve alt HAL'lerden sensör çerçevesine veri aktarımını yönetir.
  • HalProxy.cpp: HalProxy'ın uygulanması, alt HAL'ler ile sensör çerçevesi arasındaki iletişimi çoklu hale getirmek için gereken tüm mantığı içerir.

  • SubHal.h: ISensorsSubHal arayüzü, alt HAL'lerin HalProxy ile uyumlu olması için uyması gereken arayüzü tanımlar. Alt HAL, HalProxyCallback nesnesinin postEvents ve createScopedWakelock için kullanılabilmesi amacıyla initialize yöntemini uygular.

    Çoklu HAL 2.0 uygulamaları için SubHal.h'in 2.0 sürümünü kullanın.

  • hardware/interfaces/sensors/common/default/2.X/multihal/tests/: Bu birim testleri, HalProxy uygulamasını doğrular.

  • hardware/interfaces/sensors/common/default/2.X/multihal/tests/fake_subhal/: Bu örnek alt HAL uygulaması, sahte veriler oluşturmak için sahte sensörler kullanır. Birden fazla alt HAL'ın bir cihazda nasıl etkileşimde bulunduğunu test etmek için kullanışlıdır.

Uygulama

Bu bölümde, Sensors Multi-HAL'ın aşağıdaki durumlarda nasıl uygulanacağı açıklanmaktadır:

Sensors Multi-HAL'i Sensors AIDL HAL ile kullanma

Sensörler AIDL HAL ile çoklu HAL özelliğine izin vermek için hardware/interfaces/sensors/aidl/default/multihal/ adresinde bulunan AIDL Çoklu HAL dolgu katmanı modülünü içe aktarın. Modül, AIDL ve HIDL sensör HAL tanımı türleri arasındaki dönüşümü yönetir ve Sensörler Çoklu HAL 2.1'i Uygulama başlıklı makalede açıklanan çoklu HAL arayüzü etrafında bir sarmalayıcı tanımlar. AIDL çoklu HAL dolgu katmanı, Sensors Multi-HAL 2.1'i uygulayan cihazlarla uyumludur.

AIDL çoklu HAL ara katmanı, Sensors AIDL HAL'de baş takibi ve sınırlı eksenli IMU sensör türlerini göstermenize olanak tanır. AIDL HAL arayüzü tarafından tanımlanan bu sensör türlerini kullanmak için getSensorsList_2_1() uygulamasında SensorInfo yapısındaki type alanını ayarlayın. Bu, AIDL ve HIDL sensör HAL'lerinin tam sayı destekli sensör türü alanları çakışmadığı için güvenlidir.

Sensörler Çoklu HAL 2.1'i uygulama

Sensörler Çoklu HAL 2.1'i yeni bir cihaza uygulamak için aşağıdaki adımları uygulayın:

  1. ISensorsSubHal arayüzünü SubHal.h bölümünde açıklandığı şekilde uygulayın.
  2. SubHal.h içinde sensorsHalGetSubHal_2_1 yöntemini uygulayın.

  3. Yeni uygulanan alt HAL'i oluşturmak için bir cc_library_shared hedefi ekleyin. Hedefi eklerken:

    1. Hedefin, cihazın tedarikçi bölümüne bir yere gönderildiğinden emin olun.
    2. /vendor/etc/sensors/hals.conf konumundaki yapılandırma dosyasına, kitaplığın yolunu yeni bir satıra ekleyin. Gerekirse hals.conf dosyasını oluşturun.

    Alt HAL kitaplığı oluşturmaya yönelik örnek bir Android.bp girişi için hardware/interfaces/sensors/common/default/2.X/multihal/tests/Android.bp bölümüne bakın.

  4. Cihazda desteklenen HAL'lerin listesini içeren manifest.xml dosyasından tüm android.hardware.sensors girişlerini kaldırın.

  5. device.mk dosyasından tüm android.hardware.sensors hizmeti ve service.rc dosyalarını kaldırın ve android.hardware.sensors@2.1-service.multihal ile android.hardware.sensors@2.1-service.multihal.rc dosyalarını PRODUCT_PACKAGES dosyasına ekleyin.

HalProxy, önyüklemede başlar, yeni uygulanan alt HAL'i arar ve sensorsHalGetSubHal_2_1 çağrısını yaparak başlatır.

Sensörler Çoklu HAL 2.0'dan Çoklu HAL 2.1'e taşıma

Multi-HAL 2.0'dan Multi-HAL 2.1'e geçiş yapmak için SubHal arayüzünü uygulayın ve alt HAL'inizi yeniden derleyin.

2.0 ve 2.1 SubHal arayüzleri arasındaki farklar şunlardır:

  • IHalProxyCallback, ISensors.hal spesifikasyonunun 2.1 sürümünde oluşturulan türleri kullanır.
  • initialize() işlevi, 2.0 SubHal arayüzündeki yerine yeni bir IHalProxyCallback iletiyor
  • Bu yöntemler ISensors.hal spesifikasyonunun 2.1 sürümünde eklenen yeni türleri kullandığından alt HAL'ler getSensorsList ve injectSensorData yerine getSensorsList_2_1 ve injectSensorData_2_1 yöntemlerini uygulamalıdır.
  • Çoklu HAL'in bunları 2.1 sürümü alt HAL'leri olarak ele alması için alt HAL'lerin sensorsHalGetSubHal yerine sensorsHalGetSubHal_2_1 göstermesi gerekir.

Sensors HAL 2.0'dan bağlantı noktası

Sensors HAL 2.0'dan Sensors Multi-HAL 2.0'a yükseltme yaparken HAL uygulamanızın aşağıdaki koşulları karşıladığından emin olun.

HAL'i başlatma

Sensors HAL 2.0, sensör hizmetinin FMQ'leri ve dinamik sensör geri çağırma işlevini iletmesine olanak tanıyan bir başlatma işlevine sahiptir. Sensors Multi-HAL 2.0'da initialize() işlevi, sensör etkinliklerini yayınlamak, uyanma kilitleri almak ve dinamik sensör bağlantısı ile bağlantı kesme durumlarını bildirmek için kullanılması gereken tek bir geri çağırma işlevi iletir.

Sensör etkinliklerini çoklu HAL uygulamasına gönderme

Alt HAL, sensör etkinlikleri mevcut olduğunda sensör etkinliklerini FMQ üzerinden yayınlamak yerine IHalProxyCallback alanına yazmalıdır.

WAKE_UP etkinlikleri

Sensörler HAL 2.0'da HAL, uygulama için uyanma kilidini yönetebilir. Sensors Multi-HAL 2.0'da alt HAL'ler, Multi-HAL uygulamasının uyanık kalma kilitlerini yönetmesine olanak tanır ve createScopedWakelock çağrılarak bir uyanık kalma kilidinin alınmasını isteyebilir. Çoklu HAL uygulamasına uyanma etkinlikleri gönderilirken kilitli kapsamlı bir uyanma kilidi edinilmeli ve postEvents'e iletilmelidir.

Dinamik sensörler

Sensors Multi-HAL 2.0, dinamik sensör bağlantıları değiştiğinde IHalProxyCallback içindeki onDynamicSensorsConnected ve onDynamicSensorsDisconnected işlevlerinin çağrılmasını gerektirir. Bu geri çağırma işlevleri, initialize() işlevi aracılığıyla sağlanan IHalProxyCallback işaretçisinin bir parçası olarak kullanılabilir.

Sensors HAL 1.0'dan bağlantı noktası

Sensors HAL 1.0'dan Sensors Multi-HAL 2.0'a yükseltme yaparken HAL uygulamanızın aşağıdaki koşulları karşıladığından emin olun.

HAL'i başlatma

Alt HAL ile Çoklu HAL uygulaması arasında geri çağırma oluşturmak için initialize() işlevi desteklenmelidir.

Mevcut sensörleri gösterme

Sensors Multi-HAL 2.0'da getSensorsList() işlevi, tek bir cihazın başlatılması sırasında, sensör HAL'lerinin yeniden başlatılması sırasında bile aynı değeri döndürmelidir. Bu sayede, sistem sunucusu yeniden başlatılırsa çerçevenin sensör bağlantılarını yeniden kurmayı denemesi sağlanır. getSensorsList() tarafından döndürülen değer, cihaz yeniden başlatıldıktan sonra değişebilir.

Sensör etkinliklerini çoklu HAL uygulamasına gönderme

Sensors HAL 2.0'da alt HAL, poll() çağrılmasını beklemek yerine, sensör etkinlikleri mevcut olduğunda proaktif olarak IHalProxyCallback alanına sensör etkinlikleri yazmalıdır.

WAKE_UP etkinlikleri

Sensörler HAL 1.0'da HAL, uygulama için uyanma kilidini yönetebilir. Sensors Multi-HAL 2.0'ta alt HAL'ler, Multi-HAL uygulamasının uyanık kalma kilitlerini yönetmesine olanak tanır ve createScopedWakelock çağrılmasıyla uyanık kalma kilidinin alınmasını isteyebilir. Çoklu HAL uygulamasına uyanma etkinlikleri gönderilirken kilitli kapsamlı bir uyanma kilidi edinilmeli ve postEvents'e iletilmelidir.

Dinamik sensörler

Sensörler HAL 1.0'da dinamik sensörler poll() işlevi aracılığıyla döndürülür. Sensors Multi-HAL 2.0, dinamik sensör bağlantıları değiştiğinde IHalProxyCallback içindeki onDynamicSensorsConnected ve onDynamicSensorsDisconnected işlevlerinin çağrılmasını gerektirir. Bu geri çağırma işlevleri, initialize() işlevi aracılığıyla sağlanan IHalProxyCallback işaretçisinin bir parçası olarak kullanılabilir.

Sensors Multi-HAL 1.0'dan taşıma

Mevcut bir uygulamayı Sensors Multi-HAL 1.0'dan taşımak için aşağıdaki adımları uygulayın.

  1. Sensörler HAL yapılandırmasının /vendor/etc/sensors/hals.conf konumunda bulunduğundan emin olun. Bu işlem, /system/etc/sensors/hals.conf konumundaki dosyanın taşınmasını içerebilir.
  2. HAL 2.0 için desteklenmediğinden hardware/hardware.h ve hardware/sensors.h ile ilgili tüm referansları kaldırın.
  3. Alt HAL'leri Sensors Hal 1.0'dan taşıma bölümünde açıklandığı şekilde taşıyın.
  4. Sensors Multi-HAL 2.0'ı uygulama bölümündeki 3. ve 4. adımları uygulayarak Sensors Multi-HAL 2.0'ı belirlenen HAL olarak ayarlayın.

Doğrulama

VTS'yi çalıştırma

Bir veya daha fazla alt HAL'i Sensors Multi-Hal 2.1 ile entegre ettiğinizde, alt HAL uygulamalarınızın Sensors HAL arayüzü tarafından belirlenen tüm koşulları karşıladığından emin olmak için Satıcı Testi Paketi'ni (VTS) kullanın.

VTS bir ana makinede ayarlandığında yalnızca sensör VTS testlerini çalıştırmak için aşağıdaki komutları yürütün:

vts-tradefed run commandAndExit vts \
    --skip-all-system-status-check \
    --primary-abi-only \
    --skip-preconditions \
    --module VtsHalSensorsV2_0Target && \
  vts-tradefed run commandAndExit vts \
    --skip-all-system-status-check \
    --primary-abi-only \
    --skip-preconditions \
    --module VtsHalSensorsV2_1Target

AIDL Çoklu HAL dolgu katmanını çalıştırıyorsanız VtsAidlHalSensorsTargetTest dosyasını çalıştırın.

vts-tradefed run commandAndExit vts \
    --skip-all-system-status-check \
    --primary-abi-only \
    --skip-preconditions \
    --module VtsAidlHalSensorsTargetTest

Birim testleri çalıştırma

HalProxy_test.cpp içindeki birim testleri, birim testinde örneklendirilen ve dinamik olarak yüklenmeyen sahte alt HAL'leri kullanarak HalProxy'ü test eder. Yeni bir alt HAL oluştururken bu testler, yeni alt HAL'in düzgün şekilde uygulandığını doğrulayan birim testlerinin nasıl ekleneceği konusunda rehber görevi görmelidir.

Testleri çalıştırmak için aşağıdaki komutları yürütün:

cd $ANDROID_BUILD_TOP/hardware/interfaces/sensors/common/default/2.X/multihal/tests
atest

Sahte alt HAL'lerle test etme

Sahte alt HAL'ler, ISensorsSubHal arayüzünün örnek uygulamalarıdır. Alt HAL'ler farklı sensör listeleri gösterir. Sensörler etkinleştirildiğinde, belirli bir sensör isteğinde belirtilen aralıklara göre otomatik olarak oluşturulan sensör etkinliklerini düzenli aralıklarla HalProxy'e gönderir.

Sahte alt HAL'ler, tam Çoklu HAL kodunun sisteme yüklenen diğer alt HAL'lerle nasıl çalıştığını test etmek ve Sensörler Çoklu HAL kodunun çeşitli yönlerini zorlamak için kullanılabilir.

hardware/interfaces/sensors/common/default/2.X/multihal/tests/fake_subhal/ adresinde iki sahte alt HAL mevcuttur.

Sahte alt HAL'leri derleyip bir cihaza göndermek için aşağıdaki adımları uygulayın:

  1. Üç farklı sahte alt HAL'i derleyip cihaza aktarmak için aşağıdaki komutları çalıştırın:

    $ANDROID_BUILD_TOP/hardware/interfaces/sensors/common/default/2.X/multihal/tests/
mma
adb push \
  $ANDROID_BUILD_TOP/out/target/product/<device>/symbols/vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config1.so \
  /vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config1.so
adb push \
  $ANDROID_BUILD_TOP/out/target/product/<device>/symbols/vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config2.so \
  /vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config2.so
adb push \
  $ANDROID_BUILD_TOP/out/target/product/<device>/symbols/vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config3.so \
  /vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config3.so

  2. /vendor/etc/sensors/hals.conf adresindeki sensör HAL yapılandırmasını, sahte alt HAL'lerin yollarıyla güncelleyin.

    /vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config1.so
/vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config2.so
/vendor/lib64/android.hardware.sensors@2.X-fakesubhal-config3.so

  3. HalProxy'ü yeniden başlatın ve yapılandırmada listelenen yeni alt HAL'leri yükleyin.

    adb shell stop
adb shell start

Hata ayıklama

Geliştiriciler, lshal komutunu kullanarak çerçevede hata ayıklama yapabilir. Sensors HAL'in hata ayıklama çıkışını istemek için aşağıdaki komutu çalıştırın:

adb root
adb shell lshal debug android.hardware.sensors@2.1::ISensors/default

Ardından HalProxy ve alt HAL'lerinin mevcut durumu terminale gönderilir. Aşağıda, HalProxy nesnesi ve sahte alt HAL'ler için komut çıkışı örneği verilmiştir.

Internal values:
  Threads are running: true
  Wakelock timeout start time: 200 ms ago
  Wakelock timeout reset time: 73208 ms ago
  Wakelock ref count: 0
  # of events on pending write queue: 0
  # of non-dynamic sensors across all subhals: 8
  # of dynamic sensors across all subhals: 0
SubHals (2):
  Name: FakeSubHal-OnChange
  Debug dump:
Available sensors:
Name: Ambient Temp Sensor
Min delay: 40000
Flags: 2
Name: Light Sensor
Min delay: 200000
Flags: 2
Name: Proximity Sensor
Min delay: 200000
Flags: 3
Name: Relative Humidity Sensor
Min delay: 40000
Flags: 2
  Name: FakeSubHal-OnChange
  Debug dump:
Available sensors:
Name: Ambient Temp Sensor
Min delay: 40000
Flags: 2
Name: Light Sensor
Min delay: 200000
Flags: 2
Name: Proximity Sensor
Min delay: 200000
Flags: 3
Name: Relative Humidity Sensor
Min delay: 40000
Flags: 2

# of events on pending write queue için belirtilen sayı büyükse (1.000 veya daha fazla) sensör çerçevesine yazılmayı bekleyen çok sayıda etkinlik olduğunu gösterir. Bu durum, sensör hizmetinin kilitlendiğini veya kilitlenip kilitlenmediğini, sensör etkinliklerini işlemediğini ya da yakın zamanda bir alt HAL'den büyük bir sensör etkinliği grubu yayınlandığını gösterir.

Uyanık kalma kilidi referans sayısı 0'ten büyükse HalProxy bir uyanık kalma kilidi edinmiştir. Bu değer yalnızca ScopedWakelock kasıtlı olarak tutuluyorsa veya HalProxy'ye uyanma etkinlikleri gönderildiyse ve sensör çerçevesi tarafından işlenmediyse 0'ten büyük olmalıdır.

HalProxy hata ayıklama yöntemine iletilen dosya tanımlayıcısı her alt HAL'e iletilir. Bu nedenle, geliştiricilerin hata ayıklama yöntemini ISensorsSubHal arayüzünün bir parçası olarak uygulamaları gerekir.