Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b0d54c04 authored by Nathalie Le Clair's avatar Nathalie Le Clair
Browse files

Update CEC key handling documentation 

- Describe special cases and flags for TV_POWER
- Update formatting

Bug: 157402294
Test: N/A
Change-Id: I4bb75e935cf16e7b6f3feff2a3f8c2e89f238463
parent eaeaf0ac

services/core/java/com/android/server/hdmi/cec_key_handling.md

+14 −13
Original line number Diff line number Diff line 
# 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.