Now that we have a chapter describing hardware control, let's add the terms used there to the glossary. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> --- .../userspace-api/media/glossary.rst | 42 ++++++++++++++++--- 1 file changed, 37 insertions(+), 5 deletions(-) diff --git a/Documentation/userspace-api/media/glossary.rst b/Documentation/userspace-api/media/glossary.rst index 18a1ace00159..8cdb7900e994 100644 --- a/Documentation/userspace-api/media/glossary.rst +++ b/Documentation/userspace-api/media/glossary.rst @@ -69,6 +69,20 @@ Glossary See https://en.wikipedia.org/wiki/Field-programmable_gate_array. + Hardware Component + A subset of the :term:`media hardware`. For example an :term:`I²C` or + :term:`SPI` device, or an :term:`IP block` inside a + :term:`SoC` or :term:`FPGA`. + + Hardware Peripheral + A group of :term:`hardware components <hardware component>` that + together make a larger user-facing functional peripheral. For + instance the :term:`SoC` :term:`ISP` :term:`IP block <ip block>` + and external camera sensors together make a camera hardware + peripheral. + + Also known as :term:`peripheral`. + I²C **Inter-Integrated Circuit** @@ -126,6 +140,14 @@ Glossary See :ref:`media_controller`. + MC-Centric + :term:`V4L2 hardware` that requires a :term:`MC API`. + + Such hardware have ``V4L2_CAP_IO_MC`` device_caps field unset + (see :ref:`VIDIOC_QUERYCAP`). + + See :ref:`v4l2_hardware_control` for more details. + Media Hardware Subset of the hardware that is supported by the Linux Media API. @@ -139,6 +161,9 @@ Glossary control and input/output (I/O) operations specified by the instructions on a single integrated circuit. + Peripheral + The same as :term:`hardware peripheral`. + RC API **Remote Controller API** @@ -168,15 +193,22 @@ Glossary The userspace API defined in :ref:`v4l2spec`, which is used to control a V4L2 hardware. + V4L2 Device Node + A :term:`device node` that is associated to a V4L driver. + + The V4L2 device node naming is specified at :ref:`v4l2_device_naming`. + V4L2 Hardware Part of a media hardware with is supported by the :term:`V4L2 API`. V4L2 Sub-device V4L2 hardware components that aren't controlled by a - :term:`bridge driver`. + :term:`bridge driver`. See :ref:`subdev`. - V4L2 Sub-device API - Part of the :term:`V4L2 API` which control - :term:`V4L2 sub-devices <V4L2 Sub-device>`. + Video-node-Centric + V4L2 hardware that doesn't require a media controller to be used. - See :ref:`subdev`. + Such hardware have ``V4L2_CAP_IO_MC`` device_caps field unset + (see :ref:`VIDIOC_QUERYCAP`). + + See :ref:`v4l2_hardware_control` for more details. -- 2.26.2
