android13/packages/services/Car/cpp/telemetry/cartelemetryd/README.md

65 lines
1.6 KiB
Markdown

# Automotive Telemetry Service
A structured log collection service for CarTelemetryService. See ARCHITECTURE.md to learn internals.
## Useful Commands
**Dumping the service information**
```
adb shell dumpsys android.automotive.telemetry.internal.ICarTelemetryInternal/default
```
**Enabling VERBOSE logs**
```
adb shell setprop log.tag.android.automotive.telemetryd@1.0 V
adb shell setprop log.tag.cartelemetryd_impl_test V
```
**Starting emulator with cold boot**
```
emulator -verbose -show-kernel -selinux permissive -writable-system -no-snapshot -wipe-data
```
**Running the tests**
```
# run a specific test
atest cartelemetryd_impl_test:CarTelemetryInternalImplTest#TestSetListenerReturnsOk
# run all tests
atest cartelemetryd_impl_test
```
## Enabling cartelemetryd
`cartelemertryd` service is by default not included in the final build. To include it on specific
targets, add the following lines in necessary `.mk` files:
```
# Enable Automotive Telemetry Services (cartelemetryd) only on specific devices.
ENABLE_CARTELEMETRY_SERVICE ?= true
```
To find where the service was included, run this from `$ANDROID_BUILD_TOP`:
```
grep -rH --color --exclude-dir='**/.*' --exclude-dir='out' --include='*.mk' \
'ENABLE_CARTELEMETRY_SERVICE' device/ vendor/
```
## Updating cartelemetryd
If AIDL interface were updated, run `m -j` and re-flash.
If implementation were updated, run:
```
m -j android.automotive.telemetryd@1.0
adb root && adb remount && adb push $ANDROID_PRODUCT_OUT/system/bin/android.automotive.telemetryd@1.0 /system/bin && adb shell /system/bin/android.automotive.telemetryd@1.0
Ctrl+C
adb reboot
```