platform_hardware_interfaces/health/2.0/README
Yifan Hong 8ef2335fe0 health 2.0: update readme to uninstall healthd
Test: none
Bug: 77541952

Change-Id: I44191f2d9f4a6d328c0ec96212c2add3b02874ca
2018-04-04 14:25:00 -07:00

117 lines
3.6 KiB
Text

Upgrading from health@1.0 HAL
0. Remove android.hardware.health@1.0* from PRODUCT_PACKAGES
in device/<manufacturer>/<device>/device.mk
1. If the device does not have a vendor-specific libhealthd AND does not
implement storage-related APIs, just do the following:
1.1 (recommended) To remove healthd from the build,
PRODUCT_PACKAGES += android.hardware.health@2.0-service.override
DEVICE_FRAMEWORK_MANIFEST_FILE += \
system/libhidl/vintfdata/manifest_healthd_exclude.xml
1.2 To keep healthd in the build,
PRODUCT_PACKAGES += android.hardware.health@2.0-service
Otherwise, continue to Step 2.
2. Create directory
device/<manufacturer>/<device>/health
3. Create device/<manufacturer>/<device>/health/Android.bp
(or equivalent device/<manufacturer>/<device>/health/Android.mk)
cc_binary {
name: "android.hardware.health@2.0-service.<device>",
init_rc: ["android.hardware.health@2.0-service.<device>.rc"],
proprietary: true,
relative_install_path: "hw",
srcs: [
"HealthService.cpp",
],
cflags: [
"-Wall",
"-Werror",
],
static_libs: [
"android.hardware.health@2.0-impl",
"android.hardware.health@1.0-convert",
"libhealthservice",
"libbatterymonitor",
],
shared_libs: [
"libbase",
"libcutils",
"libhidlbase",
"libhidltransport",
"libutils",
"android.hardware.health@2.0",
],
header_libs: ["libhealthd_headers"],
// Uncomment the following to remove healthd from the build.
// overrides: [
// "healthd",
// ],
}
3.1 (recommended) To remove healthd from the build, keep "overrides"
section, and include the following in device.mk:
DEVICE_FRAMEWORK_MANIFEST_FILE += \
system/libhidl/vintfdata/manifest_healthd_exclude.xml
3.2 To keep healthd in the build, remove "overrides" section.
4. Create device/<manufacturer>/<device>/health/android.hardware.health@2.0-service.<device>.rc
service vendor.health-hal-2-0 /vendor/bin/hw/android.hardware.health@2.0-service.<device>
class hal
user system
group system
5. Create device/<manufacturer>/<device>/health/HealthService.cpp:
#include <health2/service.h>
int main() { return health_service_main(); }
6. libhealthd dependency:
6.1 If the device has a vendor-specific libhealthd.<soc>, add it to static_libs.
6.2 If the device does not have a vendor-specific libhealthd, add the following
lines to HealthService.cpp:
#include <healthd/healthd.h>
void healthd_board_init(struct healthd_config*) {}
int healthd_board_battery_update(struct android::BatteryProperties*) {
// return 0 to log periodic polled battery status to kernel log
return 0;
}
7. Storage related APIs:
7.1 If the device does not implement IHealth.getDiskStats and
IHealth.getStorageInfo, add libstoragehealthdefault to static_libs.
7.2 If the device implements one of these two APIs, add and implement the
following functions in HealthService.cpp:
void get_storage_info(std::vector<struct StorageInfo>& info) {
// ...
}
void get_disk_stats(std::vector<struct DiskStats>& stats) {
// ...
}
8. Update necessary SELinux permissions. For example,
# device/<manufacturer>/<device>/sepolicy/vendor/file_contexts
/vendor/bin/hw/android\.hardware\.health@2\.0-service.<device> u:object_r:hal_health_default_exec:s0
# device/<manufacturer>/<device>/sepolicy/vendor/hal_health_default.te
# Add device specific permissions to hal_health_default domain, especially
# if Step 6.1 or Step 7.2 is done.