Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

Cảm biến sử dụng nhiều lớp trừu tượng (HAL)

Sensors Multi-HAL là một khung cho phép các HAL cảm biến chạy cùng với các HAL cảm biến khác. Cảm biến Multi-HAL cảm biến tải động các lớp HAL (HAL) cho cảm biến được lưu trữ dưới dạng thư viện động trên phân vùng nhà cung cấp và cung cấp cho họ lệnh gọi lại có thể xử lý các sự kiện đăng, thu nạp và mở khoá chế độ thức. Lớp trừu tượng phần cứng (HAL) của cảm biến là một lớp HAL (HAL) cho cảm biến, được tích hợp thành một đối tượng dùng chung trên phân vùng nhà cung cấp và được sử dụng bởi khung đa HAL. Các HAL phụ này không phụ thuộc vào nhau hoặc phụ thuộc vào mã nhiều-HAL có chứa hàm chính cho quy trình.

Cảm biến Multi-HAL 2.1, có trên các thiết bị chạy Android 11 trở lên là lặp lại của Cảm biến Multi-HAL 2.0 hỗ trợ tải các HAL phụ có thể hiển thị góc bản lề loại cảm biến. Để hỗ trợ loại cảm biến này, HAL phụ phải sử dụng các API HAL phụ được xác định trong Tiêu đề SubHal 2.1.

Đối với các thiết bị chạy Android 13 trở lên sử dụng Sensors AIDL HAL, bạn có thể sử dụng lớp shim nhiều HAL để cho phép nhiều chức năng HAL. Để biết thông tin chi tiết về việc triển khai, xem Sử dụng Lớp trừu tượng phần cứng (HAL) của cảm biến cho cảm biến với lớp trừu tượng phần cứng (HAL) của cảm biến.

Sự khác biệt giữa Sensors Multi-HAL 2 và Sensors HAL 2

Sensors Multi-HAL 2 (Cảm biến đa HAL 2) có trên các thiết bị chạy Android 10 trở lên, giới thiệu một số tính năng trừu tượng dựa trên Sensors HAL 2 để dễ dàng tương tác với các API HAL hơn. Sensors Multi-HAL 2 giới thiệu lớp HalProxy để xử lý việc triển khai giao diện Sensors HAL 2 và giao diện V2_1/SubHal (hoặc V2_0/SubHal) để cho phép HalProxy tương tác với các HAL phụ.

Giao diện ISensorsSubHal khác với giao diện 2.1/ISensors.hal (hoặc 2.0/ISensors.hal) ở những điểm sau:

Phương thức khởi tạo truyền một lớp IHalProxyCallback thay vì hai FMQ và ISensorsCallback.
Các lớp trừu tượng phụ (HAL phụ) phải triển khai chức năng gỡ lỗi để cung cấp tính năng gỡ lỗi trong báo cáo lỗi.
HAL phụ phải triển khai một hàm tên để có thể phân biệt HAL phụ đã tải với các HAL phụ khác.

Sự khác biệt chính giữa Cảm biến Multi-HAL 2 và Cảm biến HAL 2 nằm ở khởi tạo hàm. Thay vì cung cấp FMQ, giao diện IHalProxyCallback cung cấp hai phương thức, một phương thức để đăng sự kiện cảm biến lên khung cảm biến và một phương thức để tạo khoá chế độ thức. Ẩn sâu, Cảm biến Multi-HAL quản lý tất cả các hoạt động tương tác với FMQ để đảm bảo kịp thời phân phối sự kiện cảm biến cho tất cả các HAL phụ. Chúng tôi đặc biệt khuyên các HAL phụ sử dụng Phương thức createScopedWakelock để uỷ quyền gánh nặng của thời gian chờ khoá chế độ thức cho cảm biến Multi-HAL và để tập trung việc sử dụng khóa chế độ thức thành một khóa chế độ thức chung cho toàn bộ Cảm biến Multi-HAL, giúp giảm thiểu việc khoá và mở khoá cuộc gọi.

Sensors Multi-HAL 2 cũng tích hợp sẵn một số tính năng an toàn. Chiến dịch này xử lý trong trường hợp FMQ của cảm biến đã đầy hoặc khung cảm biến Android sẽ khởi động lại và cần đặt lại trạng thái cảm biến. Ngoài ra, khi các sự kiện được đăng lên lớp HalProxy nhưng khung cảm biến không thể chấp nhận các sự kiện ngay lập tức, Sensors Multi-HAL có thể di chuyển các sự kiện đó sang luồng trong nền để cho phép công việc tiếp tục trên tất cả các HAL phụ trong khi chờ đăng các sự kiện.

Mã nguồn và triển khai tham chiếu

Tất cả mã Multi-HAL của cảm biến đều có trong hardware/interfaces/sensors/common/default/2.X/multihal/. Dưới đây là gợi ý về một số tài nguyên.

HalProxy.h: Đối tượng HalProxy được tạo bản sao bởi nhiều HAL của cảm biến và xử lý việc truyền dữ liệu từ các HAL phụ đến khung cảm biến.
HalProxy.cpp: Việc triển khai HalProxy chứa tất cả logic cần thiết để giao tiếp đa điểm giữa các HAL phụ và khung cảm biến.
SubHal.h: Giao diện ISensorsSubHal xác định giao diện mà các HAL phụ phải tuân theo để tương thích với HalProxy. HAL phụ triển khai phương thức khởi tạo để đối tượng HalProxyCallback có thể được sử dụng cho postEvents và createScopedWakelock.

Để triển khai Multi-HAL 2.0, hãy sử dụng phiên bản 2.0 của SubHal.h.
hardware/interfaces/sensors/common/default/2.X/multihal/tests/: Các bài kiểm thử đơn vị này xác minh việc triển khai HalProxy.
hardware/interfaces/sensors/common/default/2.X/multihal/tests/fake_subhal/: Ví dụ về cách triển khai HAL phụ này sử dụng các cảm biến giả để tạo dữ liệu giả. Được dùng để kiểm thử cách nhiều lớp HAL phụ tương tác trên một thiết bị.

Triển khai

Phần này mô tả cách triển khai Lớp trừu tượng phần cứng (HAL) cho cảm biến trong phần sau trường hợp:

Sử dụng Lớp trừu tượng phần cứng (HAL) của cảm biến với lớp trừu tượng phần cứng (HAL) của cảm biến
Triển khai cảm biến Multi-HAL 2.1
Chuyển đổi từ Cảm biến Multi-HAL 2.0 sang Multi-HAL 2.1
Chuyển từ Sensors HAL 2.0
Cổng kết nối từ cảm biến HAL 1.0
Cổng kết nối qua cảm biến Multi-HAL 1.0

Sử dụng lớp HAL (HAL) cho cảm biến với cảm biến AIDL HAL

Để cho phép chức năng nhiều HAL với HAL AIDL của cảm biến, hãy nhập mô-đun lớp đệm nhiều HAL AIDL có trong hardware/interfaces/sensors/aidl/default/multihal/. Mô-đun này xử lý việc chuyển đổi giữa định nghĩa HAL của cảm biến AIDL và HIDL và xác định một trình bao bọc xung quanh giao diện đa HAL được mô tả trong Triển khai cảm biến đa lớp HAL 2.1. Lớp đệm nhiều HAL của AIDL tương thích với các thiết bị triển khai Sensors Multi-HAL 2.1.

Lớp đệm lót AIDL đa HAL cho phép bạn hiển thị thiết bị theo dõi chuyển động đầu và các loại cảm biến IMU trục giới hạn trong lớp trừu tượng phần cứng (HAL) của cảm biến. Để sử dụng các cảm biến này các loại được xác định bằng giao diện AIDL HAL, hãy đặt trường type trong Cấu trúc SensorInfo trong quá trình triển khai getSensorsList_2_1(). Đây là một trường hợp an toàn vì các trường loại cảm biến dựa trên số nguyên của HAL cảm biến AIDL và HIDL không chồng chéo nhau.

Triển khai cảm biến Multi-HAL 2.1

Để triển khai Sensors Multi-HAL 2.1 trên một thiết bị mới, hãy làm theo các bước sau:

Triển khai giao diện ISensorsSubHal như mô tả trong SubHal.h.
Triển khai phương thức sensorsHalGetSubHal_2_1 trong SubHal.h.
Thêm mục tiêu cc_library_shared để tạo HAL phụ mới được triển khai. Khi thêm mục tiêu:
1. Đảm bảo mục tiêu được đẩy đến một vị trí nào đó trên phân vùng của nhà cung cấp thiết bị.
2. Trong tệp cấu hình nằm ở /vendor/etc/sensors/hals.conf, hãy thêm đường dẫn đến thư viện trên một dòng mới. Nếu cần, hãy tạo tệp hals.conf.
Để biết ví dụ về mục nhập Android.bp để tạo thư viện HAL phụ, hãy xem hardware/interfaces/sensors/common/default/2.X/multihal/tests/Android.bp.
Xoá tất cả mục nhập android.hardware.sensors khỏi tệp manifest.xml. Tệp này chứa danh sách các HAL được hỗ trợ trên thiết bị.
Xoá tất cả dịch vụ android.hardware.sensors và service.rc tệp khỏi tệp device.mk và thêm android.hardware.sensors@2.1-service.multihal và android.hardware.sensors@2.1-service.multihal.rc thành PRODUCT_PACKAGES.

Khi khởi động, HalProxy sẽ khởi động, tìm HAL phụ mới triển khai và khởi chạy HAL phụ đó bằng cách gọi sensorsHalGetSubHal_2_1.

Cổng từ Cảm biến Multi-HAL 2.0 sang Multi-HAL 2.1

Để chuyển từ Multi-HAL 2.0 sang Multi-HAL 2.1, hãy thực hiện SubHal giao diện và biên dịch lại HAL phụ của bạn.

Dưới đây là sự khác biệt giữa giao diện SubHal 2.0 và 2.1:

IHalProxyCallback sử dụng các loại được tạo trong phiên bản 2.1 của thông số kỹ thuật ISensors.hal.
Hàm initialize() truyền một IHalProxyCallback mới thay vì hàm từ giao diện SubHal 2.0
HAL phụ phải triển khai getSensorsList_2_1 và injectSensorData_2_1 thay vì getSensorsList và injectSensorData vì các phương thức này sử dụng các loại mới được thêm vào phiên bản 2.1 của quy cách ISensors.hal.
Các lớp trừu tượng phần cứng phụ phải hiển thị sensorsHalGetSubHal_2_1 thay vì sensorsHalGetSubHal cho Multi-HAL để coi chúng là phiên bản 2.1 HAL phụ.

Cổng từ Sensors HAL 2.0

Khi nâng cấp lên Cảm biến Multi-HAL 2.0 từ Cảm biến HAL 2.0, đảm bảo HAL đáp ứng các yêu cầu sau.

Khởi chạy HAL

Sensors HAL 2.0 có một hàm khởi chạy cho phép dịch vụ cảm biến truyền FMQ và lệnh gọi lại cảm biến động. Trong Sensors Multi-HAL 2.0, hàm initialize() sẽ truyền một lệnh gọi lại duy nhất phải được dùng để đăng sự kiện cảm biến, lấy khoá chế độ thức và thông báo về việc kết nối và ngắt kết nối cảm biến động.

Đăng sự kiện cảm biến lên quá trình triển khai Multi-HAL

Thay vì đăng sự kiện cảm biến thông qua FMQ, HAL phụ phải ghi sự kiện cảm biến vào IHalProxyCallback khi có sự kiện cảm biến.

Sự kiện WAKE_UP

Trong Sensors HAL 2.0, HAL có thể quản lý khoá chế độ thức để triển khai. Trong Multi-HAL 2.0 của cảm biến, các HAL phụ cho phép triển khai Multi-HAL để quản lý khoá chế độ thức và có thể yêu cầu khoá chế độ thức bằng cách gọi createScopedWakelock. Bạn phải lấy và chuyển khoá chế độ thức trong phạm vi đã khoá đến postEvents khi đăng sự kiện đánh thức cho quá trình triển khai Multi-HAL.

Cảm biến động

Cảm biến Multi-HAL 2.0 yêu cầu onDynamicSensorsConnected và onDynamicSensorsDisconnected inch IHalProxyCallback được gọi bất cứ khi nào kết nối cảm biến động thay đổi. Các lệnh gọi lại này có sẵn trong con trỏ IHalProxyCallback được cung cấp thông qua hàm initialize().

Cổng từ Sensors HAL 1.0

Khi nâng cấp lên Cảm biến Multi-HAL 2.0 từ Cảm biến HAL 1.0, đảm bảo HAL đáp ứng các yêu cầu sau.

Khởi chạy HAL

Bạn phải hỗ trợ hàm initialize() để thiết lập lệnh gọi lại giữa HAL phụ và việc triển khai Đa HAL.

Hiển thị các cảm biến có sẵn

Trong Cảm biến Multi-HAL 2.0, hàm getSensorsList() phải trả về cùng một trong một lần khởi động thiết bị, ngay cả khi HAL của cảm biến khởi động lại. Điều này cho phép khung cố gắng thiết lập lại kết nối cảm biến nếu máy chủ hệ thống khởi động lại. Giá trị do getSensorsList() trả về có thể thay đổi sau khi thiết bị khởi động lại.

Đăng sự kiện cảm biến lên quá trình triển khai Multi-HAL

Trong Sensors HAL 2.0, thay vì chờ poll() được gọi, HAL phụ phải chủ động ghi các sự kiện cảm biến vào IHalProxyCallback bất cứ khi nào có sự kiện cảm biến.

Sự kiện WAKE_UP

Trong Cảm biến HAL 1.0, HAL có thể quản lý khóa chế độ thức để thực hiện. Trong Multi-HAL 2.0 của cảm biến, các HAL phụ cho phép triển khai Multi-HAL để quản lý khoá chế độ thức và có thể yêu cầu khoá chế độ thức bằng cách gọi createScopedWakelock. Bạn phải thu nạp và truyền khoá chế độ thức có phạm vi khoá cho postEvents khi đăng các sự kiện đánh thức lên triển khai Multi-HAL.

Cảm biến động

Trong Sensors HAL 1.0, cảm biến động được trả về thông qua hàm poll(). Sensors Multi-HAL 2.0 yêu cầu onDynamicSensorsConnected và onDynamicSensorsDisconnected trong IHalProxyCallback được gọi bất cứ khi nào các kết nối cảm biến động thay đổi. Những lệnh gọi lại này là có sẵn như một phần của con trỏ IHalProxyCallback được cung cấp qua hàm initialize().

Cổng từ Sensors Multi-HAL 1.0

Để chuyển một phương thức triển khai hiện có từ Sensors Multi-HAL 1.0, hãy làm theo các bước sau.

Đảm bảo rằng cấu hình HAL của cảm biến nằm tại /vendor/etc/sensors/hals.conf. Quá trình này có thể bao gồm việc di chuyển tệp nằm lúc /system/etc/sensors/hals.conf.
Xoá mọi nội dung tham chiếu đến hardware/hardware.h và hardware/sensors.h vì các nội dung này không được hỗ trợ cho HAL 2.0.
Chuyển các HAL phụ như mô tả trong phần Chuyển từ Sensors Hal 1.0.
Đặt Sensors Multi-HAL 2.0 làm HAL được chỉ định bằng cách làm theo các bước 3 và 4 trong phần Triển khai Sensors Multi-HAL 2.0.

Xác nhận kết quả

Chạy VTS

Khi bạn đã tích hợp một hoặc nhiều HAL phụ với Cảm biến Multi-Hal 2.1, sử dụng Bộ thử nghiệm nhà cung cấp (VTS) để đảm bảo lớp trừu tượng phần cứng (HAL) phụ của bạn việc triển khai đáp ứng tất cả các yêu cầu do giao diện HAL của Cảm biến đặt ra.

Để chỉ chạy các kiểm thử VTS của cảm biến khi VTS được thiết lập trên máy chủ, hãy thực thi các lệnh sau:

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

Nếu bạn đang chạy lớp đệm AIDL Multi-HAL, hãy chạy VtsAidlHalSensorsTargetTest.

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

Chạy kiểm thử đơn vị

Các chương trình kiểm thử đơn vị trong HalProxy_test.cpp kiểm thử HalProxy bằng các HAL phụ giả mạo được tạo bản sao trong chương trình kiểm thử đơn vị và không được tải động. Khi tạo một HAL phụ mới, các kiểm thử này sẽ đóng vai trò là hướng dẫn về cách thêm kiểm thử đơn vị để xác minh rằng HAL phụ mới được triển khai đúng cách.

Để chạy các chương trình kiểm thử, hãy thực thi các lệnh sau:

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

Kiểm thử bằng các HAL phụ giả

Các lớp trừu tượng phụ (HAL) giả là những cách triển khai giả của giao diện ISensorsSubHal. Các HAL phụ hiển thị các danh sách cảm biến khác nhau. Khi cảm biến được kích hoạt, họ định kỳ đăng các sự kiện cảm biến được tạo tự động lên HalProxy dựa trên các khoảng thời gian được chỉ định trong một yêu cầu cảm biến nhất định.

Bạn có thể dùng các HAL phụ giả để kiểm thử cách hoạt động của mã Multi-HAL đầy đủ với các HAL phụ khác được tải vào hệ thống và để nhấn mạnh nhiều khía cạnh của mã Multi-HAL của cảm biến.

Có hai HAL phụ giả mạo tại hardware/interfaces/sensors/common/default/2.X/multihal/tests/fake_subhal/.

Để tạo và đẩy các HAL phụ giả mạo đến một thiết bị, hãy thực hiện các bước sau:

Chạy các lệnh sau để tạo và đẩy 3 HAL phụ giả mạo khác nhau vào thiết bị:

$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

Cập nhật cấu hình HAL cảm biến tại /vendor/etc/sensors/hals.conf bằng các đường dẫn cho các HAL phụ giả mạo.

/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

Khởi động lại HalProxy rồi tải các HAL phụ mới được liệt kê trong cấu hình.
```
adb shell stop
adb shell start
```

Gỡ lỗi

Nhà phát triển có thể gỡ lỗi khung bằng cách sử dụng lệnh lshal. Để yêu cầu đầu ra gỡ lỗi của HAL cảm biến, hãy chạy lệnh sau:

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

Sau đó, thông tin về trạng thái hiện tại của HalProxy và các lớp trừu tượng phần cứng (HAL phụ) của nó đến thiết bị đầu cuối. Dưới đây là ví dụ về kết quả của lệnh cho Đối tượng HalProxy và các lớp HAL phụ giả mạo.

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

Nếu số được chỉ định cho # of events on pending write queue là một số lớn (1000 trở lên), thì điều này cho biết có nhiều sự kiện đang chờ ghi vào khung cảm biến. Điều này cho biết dịch vụ cảm biến đã bị tắc nghẽn hoặc đã gặp sự cố và không xử lý các sự kiện trên cảm biến hoặc một loạt sự kiện cảm biến lớn được đăng tải gần đây từ một HAL phụ.

Nếu số lượt tham chiếu khoá chế độ thức lớn hơn 0, thì tức là HalProxy đã có khoá chế độ thức. Giá trị này chỉ được lớn hơn 0 nếu ScopedWakelock đang được giữ lại một cách có chủ ý hoặc nếu các sự kiện đánh thức đã được gửi đến HalProxy và chưa được khung cảm biến xử lý.

Chỉ số mô tả tệp đã chuyển đến phương thức gỡ lỗi của HalProxy sẽ được chuyển đến mỗi HAL phụ để các nhà phát triển phải triển khai phương thức gỡ lỗi như một phần của Giao diện ISensorsSubHal.