Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update CEC key handling documentation

Browse Source 
- Describe special cases and flags for TV_POWER
- Update formatting

Bug: 157402294
Test: N/A
Change-Id: I4bb75e935cf16e7b6f3feff2a3f8c2e89f238463
This commit is contained in:
Nathalie Le Clair
2021-02-26 17:10:00 +01:00
parent eaeaf0acac
commit b0d54c04ab
1 changed files with 14 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
services/core/java/com/android/server/hdmi/cec_key_handling.md
View File

@@ -1,36 +1,37 @@
# CEC Key Handling
The mapping of CEC key codes to Android key codes are at
[HdmiCecKeycode](HdmiCecKeycode.java)
The mapping of CEC keycodes to Android keycodes is done at [HdmiCecKeycode](HdmiCecKeycode.java).
# Android TV
Android TV requires special handling of some keys.
Android TV (ATV) requires special handling of some keys.
The general action for key handling is described in the table
The general action for key handling is described in the table below.
| Android Key | TV Panel | OTT | Soundbar |
| ----------- | ----------------- | ------------------- | ------------------- |
| general | Send to active source | handle on device | handle on device |
| POWER | Toggle the device power state | Toggle the OTT power state, TV power state follows | Toggle the soundbar power state, TV power state follows|
| TV_POWER | Toggle the device power state | Toggle the TV power state, OTT power state follows | Toggle the TV power state, soundbar power state follows|
| HOME | Turn on TV, Set active Source to TV, go to home screen | OTP, and go to home screen | OTP, and go to home screen |
| volume keys | Handle on device or send to soundbar | Send to TV or soundbar | Handle on device or send to TV |
| Volume keys | Handle on device or send to soundbar | Send to TV or soundbar | Handle on device or send to TV |
| Other keys | Forward to active source | Handle on device | Handle on device |
Special cases and flags for each key are described below
Special cases and flags per key are described below.
## POWER
## TV_POWER
### TV Panel
TODO
For ATV TV panel devices, TV_POWER is an alias of POWER.
### OTT
### Source Devices (OTT and Soundbar)
TODO
For ATV source devices with POWER_CONTROL_MODE set to none or CEC control disabled, TV_POWER is an alias of POWER.
### Soundbar
For all other source devices, TV_POWER toggles the TV power state and makes the OTT power state follow.
TODO
### Other Devices
For any device that is not connected to a TV via HDMI and not an ATV device, TV_POWER is ignored.