media/cec/cec-ioc-receive.rst

2 .. c:namespace:: CEC
14 CEC_RECEIVE, CEC_TRANSMIT - Receive or transmit a CEC message
39 To receive a CEC message the application has to fill in the
50 1. a message received from another CEC device (the ``sequence`` field will
55 To send a CEC message the application has to fill in the struct
61 of 2-byte messages). Note that the CEC kernel framework will also reply
77 However, the CEC specification allows sending messages from 'Unregistered' to
83 physical address, but the cable is still connected and CEC still works.
124       - A non-zero sequence number is automatically assigned by the CEC framework
125 	for all transmitted messages. It is used by the CEC framework when it queues
152 	to :ref:`CEC_RX_STATUS_TIMEOUT <CEC-RX-STATUS-TIMEOUT>` or
153 	:ref:`CEC_RX_STATUS_FEATURE_ABORT <CEC-RX-STATUS-FEATURE-ABORT>`.
158 	The reason is that the ``CEC_MSG_INITIATE_ARC`` message is the only CEC
179 	:ref:`CEC_TX_STATUS_ARB_LOST <CEC-TX-STATUS-ARB-LOST>` status bit is set.
185 	:ref:`CEC_TX_STATUS_NACK <CEC-TX-STATUS-NACK>` status bit is set.
191 	:ref:`CEC_TX_STATUS_LOW_DRIVE <CEC-TX-STATUS-LOW-DRIVE>` status bit is set.
197 	valid if the :ref:`CEC_TX_STATUS_ERROR <CEC-TX-STATUS-ERROR>` status bit is set.
208     * .. _`CEC-MSG-FL-REPLY-TO-FOLLOWERS`:
212       - If a CEC transmit expects a reply, then by default that reply is only sent to
220     * .. _`CEC-MSG-FL-RAW`:
224       - Normally CEC messages are validated before transmitting them. If this
227 	This is useful when debugging CEC issues.
236 .. flat-table:: CEC Transmit Status
241     * .. _`CEC-TX-STATUS-OK`:
246 	exclusive with :ref:`CEC_TX_STATUS_MAX_RETRIES <CEC-TX-STATUS-MAX-RETRIES>`.
249     * .. _`CEC-TX-STATUS-ARB-LOST`:
253       - CEC line arbitration was lost, i.e. another transmit started at the
256     * .. _`CEC-TX-STATUS-NACK`:
264     * .. _`CEC-TX-STATUS-LOW-DRIVE`:
268       - Low drive was detected on the CEC bus. This indicates that a
272     * .. _`CEC-TX-STATUS-ERROR`:
280     * .. _`CEC-TX-STATUS-MAX-RETRIES`:
285 	mutually exclusive with :ref:`CEC_TX_STATUS_OK <CEC-TX-STATUS-OK>`.
287     * .. _`CEC-TX-STATUS-ABORTED`:
294     * .. _`CEC-TX-STATUS-TIMEOUT`:
305 .. flat-table:: CEC Receive Status
310     * .. _`CEC-RX-STATUS-OK`:
315     * .. _`CEC-RX-STATUS-TIMEOUT`:
320     * .. _`CEC-RX-STATUS-FEATURE-ABORT`:
327     * .. _`CEC-RX-STATUS-ABORTED`:
363     The CEC adapter is not configured, i.e. :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`
368     The CEC adapter is not configured, i.e. :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`