media/cec/cec-ioc-receive.rst

14 CEC_RECEIVE, CEC_TRANSMIT - Receive or transmit a CEC message
52 2. the transmit result of an earlier non-blocking transmit (the ``sequence``
55 3. the reply to an earlier non-blocking transmit (the ``sequence`` field will
61 ``CEC_CAP_TRANSMIT`` is set. If there is no more room in the transmit
63 The transmit queue has enough room for 18 messages (about 1 second worth
66 idea to fully fill up the transmit queue.
68 If the file descriptor is in non-blocking mode then the transmit will
69 return 0 and the result of the transmit will be available via
70 :ref:`ioctl CEC_RECEIVE <CEC_RECEIVE>` once the transmit has finished.
71 If a non-blocking transmit also specified waiting for a reply, then
73 be used to associate both transmit results and replies with the original
74 transmit.
128 	the transmit result for a non-blocking transmit. This allows the application
129 	to associate the received message with the original transmit.
131 	In addition, if a non-blocking transmit will wait for a reply (ii.e. ``timeout``
133 	value of the original transmit. This allows the application to associate the
134 	received message with the original transmit.
172 	this field will be 0 if the transmit started, or non-0 if the transmit
174 	to transmit a Poll message to yourself. That results in a
179       - A counter of the number of transmit attempts that resulted in the
185       - A counter of the number of transmit attempts that resulted in the
191       - A counter of the number of transmit attempts that resulted in the
197       - A counter of the number of transmit errors other than Arbitration
215       - If a CEC transmit expects a reply, then by default that reply is only sent to
251 	the transmit was eventually successful.
256       - CEC line arbitration was lost, i.e. another transmit started at the
265 	of a transmit is just OK or FAIL. In that case this status will be
266 	returned when the transmit failed.
287       - The transmit failed after one or more retries. This status bit is
294       - The transmit was aborted due to an HDMI disconnect, or the adapter
295         was unconfigured, or a transmit was interrupted, or the driver
296 	returned an error when attempting to start a transmit.
301       - The transmit timed out. This should not normally happen and this
374     to destination 0 ('TV'). In that case the transmit will proceed as usual.
378     is in mode ``CEC_MODE_NO_INITIATOR``. This is also returned if the transmit
385     The wait for a successful transmit was interrupted (e.g. by Ctrl-C).