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

Commit 77edf603 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] cec rst: convert tables and drop the 'row' comments 



This uses Laurent's python script to convert all tables, dropping
the useless 'row' comments.

See commit c2b66caf ("[media] v4l: doc: Remove row numbers from tables")
for the script that was used.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent acd49735

Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst

+59 −97
Original line number Diff line number Diff line
@@ -48,39 +48,19 @@ returns the information to the application. The ioctl never fails. 
    :stub-columns: 0

    :widths:       1 1 16





    -  .. row 1



       -  char



    * - char

      - ``driver[32]``



      - The name of the cec adapter driver.



    -  .. row 2



       -  char



    * - char

      - ``name[32]``



      - The name of this CEC adapter. The combination ``driver`` and

	``name`` must be unique.



    -  .. row 3



       -  __u32



    * - __u32

      - ``capabilities``



      - The capabilities of the CEC adapter, see

	:ref:`cec-capabilities`.



    -  .. row 4



       -  __u32



    * - __u32

      - ``version``



      - CEC Framework API version, formatted with the ``KERNEL_VERSION()``

	macro.
@@ -94,66 +74,48 @@ returns the information to the application. The ioctl never fails. 
    :stub-columns: 0

    :widths:       3 1 8





    -  .. _`CEC-CAP-PHYS-ADDR`:

    * .. _`CEC-CAP-PHYS-ADDR`:



      - ``CEC_CAP_PHYS_ADDR``



      - 0x00000001



      - Userspace has to configure the physical address by calling

	:ref:`ioctl CEC_ADAP_S_PHYS_ADDR <CEC_ADAP_S_PHYS_ADDR>`. If

	this capability isn't set, then setting the physical address is

	handled by the kernel whenever the EDID is set (for an HDMI

	receiver) or read (for an HDMI transmitter).



    -  .. _`CEC-CAP-LOG-ADDRS`:

    * .. _`CEC-CAP-LOG-ADDRS`:



      - ``CEC_CAP_LOG_ADDRS``



      - 0x00000002



      - Userspace has to configure the logical addresses by calling

	:ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`. If

	this capability isn't set, then the kernel will have configured

	this.



    -  .. _`CEC-CAP-TRANSMIT`:

    * .. _`CEC-CAP-TRANSMIT`:



      - ``CEC_CAP_TRANSMIT``



      - 0x00000004



      - Userspace can transmit CEC messages by calling

	:ref:`ioctl CEC_TRANSMIT <CEC_TRANSMIT>`. This implies that

	userspace can be a follower as well, since being able to transmit

	messages is a prerequisite of becoming a follower. If this

	capability isn't set, then the kernel will handle all CEC

	transmits and process all CEC messages it receives.



    -  .. _`CEC-CAP-PASSTHROUGH`:

    * .. _`CEC-CAP-PASSTHROUGH`:



      - ``CEC_CAP_PASSTHROUGH``



      - 0x00000008



      - Userspace can use the passthrough mode by calling

	:ref:`ioctl CEC_S_MODE <CEC_S_MODE>`.



    -  .. _`CEC-CAP-RC`:

    * .. _`CEC-CAP-RC`:



      - ``CEC_CAP_RC``



      - 0x00000010



      - This adapter supports the remote control protocol.



    -  .. _`CEC-CAP-MONITOR-ALL`:

    * .. _`CEC-CAP-MONITOR-ALL`:



      - ``CEC_CAP_MONITOR_ALL``



      - 0x00000020



      - The CEC hardware can monitor all messages, not just directed and

	broadcast messages.

Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst

+174 −301
Original line number Diff line number Diff line
@@ -77,48 +77,28 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       1 1 16





    -  .. row 1



       -  __u8



    * - __u8

      - ``log_addr[CEC_MAX_LOG_ADDRS]``



      - The actual logical addresses that were claimed. This is set by the

	driver. If no logical address could be claimed, then it is set to

	``CEC_LOG_ADDR_INVALID``. If this adapter is Unregistered, then

	``log_addr[0]`` is set to 0xf and all others to

	``CEC_LOG_ADDR_INVALID``.



    -  .. row 2



       -  __u16



    * - __u16

      - ``log_addr_mask``



      - The bitmask of all logical addresses this adapter has claimed. If

	this adapter is Unregistered then ``log_addr_mask`` sets bit 15

	and clears all other bits. If this adapter is not configured at

	all, then ``log_addr_mask`` is set to 0. Set by the driver.



    -  .. row 3



       -  __u8



    * - __u8

      - ``cec_version``



      - The CEC version that this adapter shall use. See

	:ref:`cec-versions`. Used to implement the

	``CEC_MSG_CEC_VERSION`` and ``CEC_MSG_REPORT_FEATURES`` messages.

	Note that :ref:`CEC_OP_CEC_VERSION_1_3A <CEC-OP-CEC-VERSION-1-3A>` is not allowed by the CEC

	framework.



    -  .. row 4



       -  __u8



    * - __u8

      - ``num_log_addrs``



      - Number of logical addresses to set up. Must be ≤

	``available_log_addrs`` as returned by

	:ref:`CEC_ADAP_G_CAPS`. All arrays in
@@ -131,74 +111,39 @@ logical address types are already defined will return with error ``EBUSY``. 
	what was requested. If this field is set to 0, then the CEC

	adapter shall clear all claimed logical addresses and all other

	fields will be ignored.



    -  .. row 5



       -  __u32



    * - __u32

      - ``vendor_id``



      - The vendor ID is a 24-bit number that identifies the specific

	vendor or entity. Based on this ID vendor specific commands may be

	defined. If you do not want a vendor ID then set it to

	``CEC_VENDOR_ID_NONE``.



    -  .. row 6



       -  __u32



    * - __u32

      - ``flags``



      - Flags. See :ref:`cec-log-addrs-flags` for a list of available flags.



    -  .. row 7



       -  char



    * - char

      - ``osd_name[15]``



      - The On-Screen Display name as is returned by the

	``CEC_MSG_SET_OSD_NAME`` message.



    -  .. row 8



       -  __u8



    * - __u8

      - ``primary_device_type[CEC_MAX_LOG_ADDRS]``



      - Primary device type for each logical address. See

	:ref:`cec-prim-dev-types` for possible types.



    -  .. row 9



       -  __u8



    * - __u8

      - ``log_addr_type[CEC_MAX_LOG_ADDRS]``



      - Logical address types. See :ref:`cec-log-addr-types` for

	possible types. The driver will update this with the actual

	logical address type that it claimed (e.g. it may have to fallback

	to :ref:`CEC_LOG_ADDR_TYPE_UNREGISTERED <CEC-LOG-ADDR-TYPE-UNREGISTERED>`).



    -  .. row 10



       -  __u8



    * - __u8

      - ``all_device_types[CEC_MAX_LOG_ADDRS]``



      - CEC 2.0 specific: the bit mask of all device types. See

	:ref:`cec-all-dev-types-flags`. It is used in the CEC 2.0

	``CEC_MSG_REPORT_FEATURES`` message. For CEC 1.4 you can either leave

	this field to 0, or fill it in according to the CEC 2.0 guidelines to

	give the CEC framework more information about the device type, even

	though the framework won't use it directly in the CEC message.



    -  .. row 11



       -  __u8



    * - __u8

      - ``features[CEC_MAX_LOG_ADDRS][12]``



      - Features for each logical address. It is used in the CEC 2.0

	``CEC_MSG_REPORT_FEATURES`` message. The 12 bytes include both the

	RC Profile and the Device Features. For CEC 1.4 you can either leave
@@ -213,13 +158,10 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       3 1 4





    -  .. _`CEC-LOG-ADDRS-FL-ALLOW-UNREG-FALLBACK`:

    * .. _`CEC-LOG-ADDRS-FL-ALLOW-UNREG-FALLBACK`:



      - ``CEC_LOG_ADDRS_FL_ALLOW_UNREG_FALLBACK``



      - 1



      - By default if no logical address of the requested type can be claimed, then

	it will go back to the unconfigured state. If this flag is set, then it will

	fallback to the Unregistered logical address. Note that if the Unregistered
@@ -234,29 +176,20 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       3 1 4





    -  .. _`CEC-OP-CEC-VERSION-1-3A`:

    * .. _`CEC-OP-CEC-VERSION-1-3A`:



      - ``CEC_OP_CEC_VERSION_1_3A``



      - 4



      - CEC version according to the HDMI 1.3a standard.



    -  .. _`CEC-OP-CEC-VERSION-1-4B`:

    * .. _`CEC-OP-CEC-VERSION-1-4B`:



      - ``CEC_OP_CEC_VERSION_1_4B``



      - 5



      - CEC version according to the HDMI 1.4b standard.



    -  .. _`CEC-OP-CEC-VERSION-2-0`:

    * .. _`CEC-OP-CEC-VERSION-2-0`:



      - ``CEC_OP_CEC_VERSION_2_0``



      - 6



      - CEC version according to the HDMI 2.0 standard.
@@ -269,61 +202,40 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       3 1 4





    -  .. _`CEC-OP-PRIM-DEVTYPE-TV`:

    * .. _`CEC-OP-PRIM-DEVTYPE-TV`:



      - ``CEC_OP_PRIM_DEVTYPE_TV``



      - 0



      - Use for a TV.



    -  .. _`CEC-OP-PRIM-DEVTYPE-RECORD`:

    * .. _`CEC-OP-PRIM-DEVTYPE-RECORD`:



      - ``CEC_OP_PRIM_DEVTYPE_RECORD``



      - 1



      - Use for a recording device.



    -  .. _`CEC-OP-PRIM-DEVTYPE-TUNER`:

    * .. _`CEC-OP-PRIM-DEVTYPE-TUNER`:



      - ``CEC_OP_PRIM_DEVTYPE_TUNER``



      - 3



      - Use for a device with a tuner.



    -  .. _`CEC-OP-PRIM-DEVTYPE-PLAYBACK`:

    * .. _`CEC-OP-PRIM-DEVTYPE-PLAYBACK`:



      - ``CEC_OP_PRIM_DEVTYPE_PLAYBACK``



      - 4



      - Use for a playback device.



    -  .. _`CEC-OP-PRIM-DEVTYPE-AUDIOSYSTEM`:

    * .. _`CEC-OP-PRIM-DEVTYPE-AUDIOSYSTEM`:



      - ``CEC_OP_PRIM_DEVTYPE_AUDIOSYSTEM``



      - 5



      - Use for an audio system (e.g. an audio/video receiver).



    -  .. _`CEC-OP-PRIM-DEVTYPE-SWITCH`:

    * .. _`CEC-OP-PRIM-DEVTYPE-SWITCH`:



      - ``CEC_OP_PRIM_DEVTYPE_SWITCH``



      - 6



      - Use for a CEC switch.



    -  .. _`CEC-OP-PRIM-DEVTYPE-VIDEOPROC`:

    * .. _`CEC-OP-PRIM-DEVTYPE-VIDEOPROC`:



      - ``CEC_OP_PRIM_DEVTYPE_VIDEOPROC``



      - 7



      - Use for a video processor device.
@@ -336,61 +248,40 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       3 1 16





    -  .. _`CEC-LOG-ADDR-TYPE-TV`:

    * .. _`CEC-LOG-ADDR-TYPE-TV`:



      - ``CEC_LOG_ADDR_TYPE_TV``



      - 0



      - Use for a TV.



    -  .. _`CEC-LOG-ADDR-TYPE-RECORD`:

    * .. _`CEC-LOG-ADDR-TYPE-RECORD`:



      - ``CEC_LOG_ADDR_TYPE_RECORD``



      - 1



      - Use for a recording device.



    -  .. _`CEC-LOG-ADDR-TYPE-TUNER`:

    * .. _`CEC-LOG-ADDR-TYPE-TUNER`:



      - ``CEC_LOG_ADDR_TYPE_TUNER``



      - 2



      - Use for a tuner device.



    -  .. _`CEC-LOG-ADDR-TYPE-PLAYBACK`:

    * .. _`CEC-LOG-ADDR-TYPE-PLAYBACK`:



      - ``CEC_LOG_ADDR_TYPE_PLAYBACK``



      - 3



      - Use for a playback device.



    -  .. _`CEC-LOG-ADDR-TYPE-AUDIOSYSTEM`:

    * .. _`CEC-LOG-ADDR-TYPE-AUDIOSYSTEM`:



      - ``CEC_LOG_ADDR_TYPE_AUDIOSYSTEM``



      - 4



      - Use for an audio system device.



    -  .. _`CEC-LOG-ADDR-TYPE-SPECIFIC`:

    * .. _`CEC-LOG-ADDR-TYPE-SPECIFIC`:



      - ``CEC_LOG_ADDR_TYPE_SPECIFIC``



      - 5



      - Use for a second TV or for a video processor device.



    -  .. _`CEC-LOG-ADDR-TYPE-UNREGISTERED`:

    * .. _`CEC-LOG-ADDR-TYPE-UNREGISTERED`:



      - ``CEC_LOG_ADDR_TYPE_UNREGISTERED``



      - 6



      - Use this if you just want to remain unregistered. Used for pure

	CEC switches or CDC-only devices (CDC: Capability Discovery and

	Control).
@@ -406,53 +297,35 @@ logical address types are already defined will return with error ``EBUSY``. 
    :stub-columns: 0

    :widths:       3 1 4





    -  .. _`CEC-OP-ALL-DEVTYPE-TV`:

    * .. _`CEC-OP-ALL-DEVTYPE-TV`:



      - ``CEC_OP_ALL_DEVTYPE_TV``



      - 0x80



      - This supports the TV type.



    -  .. _`CEC-OP-ALL-DEVTYPE-RECORD`:

    * .. _`CEC-OP-ALL-DEVTYPE-RECORD`:



      - ``CEC_OP_ALL_DEVTYPE_RECORD``



      - 0x40



      - This supports the Recording type.



    -  .. _`CEC-OP-ALL-DEVTYPE-TUNER`:

    * .. _`CEC-OP-ALL-DEVTYPE-TUNER`:



      - ``CEC_OP_ALL_DEVTYPE_TUNER``



      - 0x20



      - This supports the Tuner type.



    -  .. _`CEC-OP-ALL-DEVTYPE-PLAYBACK`:

    * .. _`CEC-OP-ALL-DEVTYPE-PLAYBACK`:



      - ``CEC_OP_ALL_DEVTYPE_PLAYBACK``



      - 0x10



      - This supports the Playback type.



    -  .. _`CEC-OP-ALL-DEVTYPE-AUDIOSYSTEM`:

    * .. _`CEC-OP-ALL-DEVTYPE-AUDIOSYSTEM`:



      - ``CEC_OP_ALL_DEVTYPE_AUDIOSYSTEM``



      - 0x08



      - This supports the Audio System type.



    -  .. _`CEC-OP-ALL-DEVTYPE-SWITCH`:

    * .. _`CEC-OP-ALL-DEVTYPE-SWITCH`:



      - ``CEC_OP_ALL_DEVTYPE_SWITCH``



      - 0x04



      - This supports the CEC Switch or Video Processing type.

Documentation/media/uapi/cec/cec-ioc-dqevent.rst

+64 −118
Original line number Diff line number Diff line
@@ -58,22 +58,12 @@ it is guaranteed that the state did change in between the two events. 
    :stub-columns: 0

    :widths:       1 1 8





    -  .. row 1



       -  __u16



    * - __u16

      - ``phys_addr``



      - The current physical address. This is ``CEC_PHYS_ADDR_INVALID`` if no

          valid physical address is set.



    -  .. row 2



       -  __u16



    * - __u16

      - ``log_addr_mask``



      - The current set of claimed logical addresses. This is 0 if no logical

        addresses are claimed or if ``phys_addr`` is ``CEC_PHYS_ADDR_INVALID``.

	If bit 15 is set (``1 << CEC_LOG_ADDR_UNREGISTERED``) then this device
@@ -89,13 +79,8 @@ it is guaranteed that the state did change in between the two events. 
    :stub-columns: 0

    :widths:       1 1 16





    -  .. row 1



       -  __u32



    * - __u32

      - ``lost_msgs``



      - Set to the number of lost messages since the filehandle was opened

	or since the last time this event was dequeued for this

	filehandle. The messages lost are the oldest messages. So when a
@@ -116,60 +101,30 @@ it is guaranteed that the state did change in between the two events. 
    :stub-columns: 0

    :widths:       1 1 1 8





    -  .. row 1



       -  __u64



    * - __u64

      - ``ts``



      - :cspan:`1` Timestamp of the event in ns.



	The timestamp has been taken from the ``CLOCK_MONOTONIC`` clock. To access

	the same clock from userspace use :c:func:`clock_gettime`.



    -  .. row 2



       -  __u32



    * - __u32

      - ``event``



      - :cspan:`1` The CEC event type, see :ref:`cec-events`.



    -  .. row 3



       -  __u32



    * - __u32

      - ``flags``



      - :cspan:`1` Event flags, see :ref:`cec-event-flags`.



    -  .. row 4



       -  union



    * - union

      - (anonymous)



       -

      -



    -  .. row 5



      -

    * -

      - struct cec_event_state_change



      - ``state_change``



      - The new adapter state as sent by the :ref:`CEC_EVENT_STATE_CHANGE <CEC-EVENT-STATE-CHANGE>`

	event.



    -  .. row 6



       -

    * -

      - struct cec_event_lost_msgs



      - ``lost_msgs``



      - The number of lost messages as sent by the :ref:`CEC_EVENT_LOST_MSGS <CEC-EVENT-LOST-MSGS>`

	event.
@@ -183,23 +138,17 @@ it is guaranteed that the state did change in between the two events. 
    :stub-columns: 0

    :widths:       3 1 16





    -  .. _`CEC-EVENT-STATE-CHANGE`:

    * .. _`CEC-EVENT-STATE-CHANGE`:



      - ``CEC_EVENT_STATE_CHANGE``



      - 1



      - Generated when the CEC Adapter's state changes. When open() is

	called an initial event will be generated for that filehandle with

	the CEC Adapter's state at that time.



    -  .. _`CEC-EVENT-LOST-MSGS`:

    * .. _`CEC-EVENT-LOST-MSGS`:



      - ``CEC_EVENT_LOST_MSGS``



      - 2



      - Generated if one or more CEC messages were lost because the

	application didn't dequeue CEC messages fast enough.
@@ -213,13 +162,10 @@ it is guaranteed that the state did change in between the two events. 
    :stub-columns: 0

    :widths:       3 1 8





    -  .. _`CEC-EVENT-FL-INITIAL-VALUE`:

    * .. _`CEC-EVENT-FL-INITIAL-VALUE`:



      - ``CEC_EVENT_FL_INITIAL_VALUE``



      - 1



      - Set for the initial events that are generated when the device is

	opened. See the table above for which events do this. This allows

	applications to learn the initial state of the CEC adapter at

Documentation/media/uapi/cec/cec-ioc-g-mode.rst

+136 −181
Original line number Diff line number Diff line
@@ -83,32 +83,23 @@ Available initiator modes are: 
    :stub-columns: 0

    :widths:       3 1 16





    -  .. _`CEC-MODE-NO-INITIATOR`:

    * .. _`CEC-MODE-NO-INITIATOR`:



      - ``CEC_MODE_NO_INITIATOR``



      - 0x0



      - This is not an initiator, i.e. it cannot transmit CEC messages or

	make any other changes to the CEC adapter.



    -  .. _`CEC-MODE-INITIATOR`:

    * .. _`CEC-MODE-INITIATOR`:



      - ``CEC_MODE_INITIATOR``



      - 0x1



      - This is an initiator (the default when the device is opened) and

	it can transmit CEC messages and make changes to the CEC adapter,

	unless there is an exclusive initiator.



    -  .. _`CEC-MODE-EXCL-INITIATOR`:

    * .. _`CEC-MODE-EXCL-INITIATOR`:



      - ``CEC_MODE_EXCL_INITIATOR``



      - 0x2



      - This is an exclusive initiator and this file descriptor is the

	only one that can transmit CEC messages and make changes to the

	CEC adapter. If someone else is already the exclusive initiator
@@ -127,45 +118,33 @@ Available follower modes are: 
    :stub-columns: 0

    :widths:       3 1 16





    -  .. _`CEC-MODE-NO-FOLLOWER`:

    * .. _`CEC-MODE-NO-FOLLOWER`:



      - ``CEC_MODE_NO_FOLLOWER``



      - 0x00



      - This is not a follower (the default when the device is opened).



    -  .. _`CEC-MODE-FOLLOWER`:

    * .. _`CEC-MODE-FOLLOWER`:



      - ``CEC_MODE_FOLLOWER``



      - 0x10



      - This is a follower and it will receive CEC messages unless there

	is an exclusive follower. You cannot become a follower if

	:ref:`CEC_CAP_TRANSMIT <CEC-CAP-TRANSMIT>` is not set or if :ref:`CEC_MODE_NO_INITIATOR <CEC-MODE-NO-INITIATOR>`

	was specified, the ``EINVAL`` error code is returned in that case.



    -  .. _`CEC-MODE-EXCL-FOLLOWER`:

    * .. _`CEC-MODE-EXCL-FOLLOWER`:



      - ``CEC_MODE_EXCL_FOLLOWER``



      - 0x20



      - This is an exclusive follower and only this file descriptor will

	receive CEC messages for processing. If someone else is already

	the exclusive follower then an attempt to become one will return

	the ``EBUSY`` error code. You cannot become a follower if

	:ref:`CEC_CAP_TRANSMIT <CEC-CAP-TRANSMIT>` is not set or if :ref:`CEC_MODE_NO_INITIATOR <CEC-MODE-NO-INITIATOR>`

	was specified, the ``EINVAL`` error code is returned in that case.



    -  .. _`CEC-MODE-EXCL-FOLLOWER-PASSTHRU`:

    * .. _`CEC-MODE-EXCL-FOLLOWER-PASSTHRU`:



      - ``CEC_MODE_EXCL_FOLLOWER_PASSTHRU``



      - 0x30



      - This is an exclusive follower and only this file descriptor will

	receive CEC messages for processing. In addition it will put the

	CEC device into passthrough mode, allowing the exclusive follower
@@ -175,13 +154,10 @@ Available follower modes are: 
	code. You cannot become a follower if :ref:`CEC_CAP_TRANSMIT <CEC-CAP-TRANSMIT>`

	is not set or if :ref:`CEC_MODE_NO_INITIATOR <CEC-MODE-NO-INITIATOR>` was specified,

	the ``EINVAL`` error code is returned in that case.



    -  .. _`CEC-MODE-MONITOR`:

    * .. _`CEC-MODE-MONITOR`:



      - ``CEC_MODE_MONITOR``



      - 0xe0



      - Put the file descriptor into monitor mode. Can only be used in

	combination with :ref:`CEC_MODE_NO_INITIATOR <CEC-MODE-NO-INITIATOR>`, otherwise EINVAL error

	code will be returned. In monitor mode all messages this CEC
@@ -190,13 +166,10 @@ Available follower modes are: 
	be reported. This is very useful for debugging. This is only

	allowed if the process has the ``CAP_NET_ADMIN`` capability. If

	that is not set, then the ``EPERM`` error code is returned.



    -  .. _`CEC-MODE-MONITOR-ALL`:

    * .. _`CEC-MODE-MONITOR-ALL`:



      - ``CEC_MODE_MONITOR_ALL``



      - 0xf0



      - Put the file descriptor into 'monitor all' mode. Can only be used

	in combination with :ref:`CEC_MODE_NO_INITIATOR <CEC-MODE-NO-INITIATOR>`, otherwise

	the ``EINVAL`` error code will be returned. In 'monitor all' mode all messages
@@ -220,74 +193,56 @@ Core message processing details: 
    :stub-columns: 0

    :widths: 1 8





    -  .. _`CEC-MSG-GET-CEC-VERSION`:

    * .. _`CEC-MSG-GET-CEC-VERSION`:



      - ``CEC_MSG_GET_CEC_VERSION``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will return the CEC version that was

	set with :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`.



    -  .. _`CEC-MSG-GIVE-DEVICE-VENDOR-ID`:

    * .. _`CEC-MSG-GIVE-DEVICE-VENDOR-ID`:



      - ``CEC_MSG_GIVE_DEVICE_VENDOR_ID``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will return the vendor ID that was

	set with :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`.



    -  .. _`CEC-MSG-ABORT`:

    * .. _`CEC-MSG-ABORT`:



      - ``CEC_MSG_ABORT``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will return a feature refused

	message as per the specification.



    -  .. _`CEC-MSG-GIVE-PHYSICAL-ADDR`:

    * .. _`CEC-MSG-GIVE-PHYSICAL-ADDR`:



      - ``CEC_MSG_GIVE_PHYSICAL_ADDR``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will report the current physical

	address.



    -  .. _`CEC-MSG-GIVE-OSD-NAME`:

    * .. _`CEC-MSG-GIVE-OSD-NAME`:



      - ``CEC_MSG_GIVE_OSD_NAME``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will report the current OSD name as

	was set with :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`.



    -  .. _`CEC-MSG-GIVE-FEATURES`:

    * .. _`CEC-MSG-GIVE-FEATURES`:



      - ``CEC_MSG_GIVE_FEATURES``



      - When in passthrough mode this message has to be handled by

	userspace, otherwise the core will report the current features as

	was set with :ref:`ioctl CEC_ADAP_S_LOG_ADDRS <CEC_ADAP_S_LOG_ADDRS>`

	or the message is ignored if the CEC version was older than 2.0.



    -  .. _`CEC-MSG-USER-CONTROL-PRESSED`:

    * .. _`CEC-MSG-USER-CONTROL-PRESSED`:



      - ``CEC_MSG_USER_CONTROL_PRESSED``



      - If :ref:`CEC_CAP_RC <CEC-CAP-RC>` is set, then generate a remote control key

	press. This message is always passed on to userspace.



    -  .. _`CEC-MSG-USER-CONTROL-RELEASED`:

    * .. _`CEC-MSG-USER-CONTROL-RELEASED`:



      - ``CEC_MSG_USER_CONTROL_RELEASED``



      - If :ref:`CEC_CAP_RC <CEC-CAP-RC>` is set, then generate a remote control key

	release. This message is always passed on to userspace.



    -  .. _`CEC-MSG-REPORT-PHYSICAL-ADDR`:

    * .. _`CEC-MSG-REPORT-PHYSICAL-ADDR`:



      - ``CEC_MSG_REPORT_PHYSICAL_ADDR``



      - The CEC framework will make note of the reported physical address

	and then just pass the message on to userspace.

Documentation/media/uapi/cec/cec-ioc-receive.rst

+146 −248

File changed.

Preview size limit exceeded, changes collapsed.