This function was not document, add it. Also clarify cec_adap_s_phys_addr, explaining that the PA comes from the EDID.
Signed-off-by: Hans Verkuil <[email protected]> --- Documentation/driver-api/media/cec-core.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Documentation/driver-api/media/cec-core.rst b/Documentation/driver-api/media/cec-core.rst index f1ffdec388f3..10927833992c 100644 --- a/Documentation/driver-api/media/cec-core.rst +++ b/Documentation/driver-api/media/cec-core.rst @@ -437,7 +437,8 @@ transmitted, otherwise just queue it and return. .. c:function:: void cec_s_phys_addr(struct cec_adapter *adap, u16 phys_addr, bool block); -Change the physical address. This function will set adap->phys_addr and +Change the physical address. Use cec_s_phys_addr() to set the Physical Address +as read from an EDID. This function will set adap->phys_addr and send an event if it has changed. If cec_s_log_addrs() has been called and the physical address has become valid, then the CEC framework will start claiming the logical addresses. If block is true, then this function won't @@ -449,6 +450,13 @@ then the CEC adapter will be disabled. If you change a valid physical address to another valid physical address, then this function will first set the address to CEC_PHYS_ADDR_INVALID before enabling the new physical address. +.. c:function:: + void cec_phys_addr_invalidate(struct cec_adapter *adap); + +Invalidates the Physical Address when the EDID was lost, e.g. if the HDMI +cable was unplugged. Do not use this to report an invalid Physical Address +that you read from an EDID, use cec_s_phys_addr() for that. + .. c:function:: void cec_s_phys_addr_from_edid(struct cec_adapter *adap, \ const struct edid *edid); -- 2.53.0
