From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from lb3-smtp-cloud6.xs4all.net ([194.109.24.31]:50915 "EHLO lb3-smtp-cloud6.xs4all.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752683AbbHaLXo (ORCPT ); Mon, 31 Aug 2015 07:23:44 -0400 Message-ID: <55E43907.7040001@xs4all.nl> Date: Mon, 31 Aug 2015 13:22:47 +0200 From: Hans Verkuil MIME-Version: 1.0 To: Mauro Carvalho Chehab , Linux Media Mailing List CC: Mauro Carvalho Chehab , Jonathan Corbet , linux-doc@vger.kernel.org Subject: Re: [PATCH v8 41/55] [media] DocBook: update descriptions for the media controller entities References: <08890f5bbebb0ddaaacda3c95142fa545ab15306.1440902901.git.mchehab@osg.samsung.com> In-Reply-To: <08890f5bbebb0ddaaacda3c95142fa545ab15306.1440902901.git.mchehab@osg.samsung.com> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Sender: linux-media-owner@vger.kernel.org List-ID: On 08/30/2015 05:06 AM, Mauro Carvalho Chehab wrote: > Cleanup the media controller entities description: > - remove MEDIA_ENT_T_DEVNODE and MEDIA_ENT_T_V4L2_SUBDEV entity > types, as they don't mean anything; Shouldn't this add MEDIA_ENT_T_V4L2_VBI and _SWRADIO descriptions? Regards, Hans > - add MEDIA_ENT_T_UNKNOWN with a proper description; > - remove ALSA and FB entity types. Those should not be used, as > the types are deprecated. We'll soon be adidng ALSA, but with > a different entity namespace; > - improve the description of some entities. > > Signed-off-by: Mauro Carvalho Chehab > > diff --git a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml > index 32a783635649..bd90dde54416 100644 > --- a/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml > +++ b/Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml > @@ -179,70 +179,59 @@ > > > > - MEDIA_ENT_T_DEVNODE > - Unknown device node > + MEDIA_ENT_T_UNKNOWN and MEDIA_ENT_T_V4L2_SUBDEV_UNKNOWN > + Unknown entity. That generally indicates that > + a driver didn't initialize properly the entity, with is a Kernel bug > > > MEDIA_ENT_T_V4L2_VIDEO > - V4L video, radio or vbi device node > - > - > - MEDIA_ENT_T_DEVNODE_FB > - Frame buffer device node > - > - > - MEDIA_ENT_T_DEVNODE_ALSA > - ALSA card > + V4L video streaming input or output entity > > > MEDIA_ENT_T_DVB_DEMOD > - DVB frontend devnode > + DVB demodulator entity > > > MEDIA_ENT_T_DVB_DEMUX > - DVB demux devnode > + DVB demux entity. Could be implemented on hardware or in Kernelspace > > > MEDIA_ENT_T_DVB_TSOUT > - DVB DVR devnode > + DVB Transport Stream output entity > > > MEDIA_ENT_T_DVB_CA > - DVB CAM devnode > + DVB Conditional Access module (CAM) entity > > > MEDIA_ENT_T_DVB_DEMOD_NET_DECAP > - DVB network devnode > - > - > - MEDIA_ENT_T_V4L2_SUBDEV > - Unknown V4L sub-device > + DVB network ULE/MLE desencapsulation entity. Could be implemented on hardware or in Kernelspace > > > MEDIA_ENT_T_V4L2_SUBDEV_SENSOR > - Video sensor > + Camera video sensor entity > > > MEDIA_ENT_T_V4L2_SUBDEV_FLASH > - Flash controller > + Flash controller entity > > > MEDIA_ENT_T_V4L2_SUBDEV_LENS > - Lens controller > + Lens controller entity > > > MEDIA_ENT_T_V4L2_SUBDEV_DECODER > - Video decoder, the basic function of the video decoder is to > - accept analogue video from a wide variety of sources such as > + Analog video decoder, the basic function of the video decoder > + is to accept analogue video from a wide variety of sources such as > broadcast, DVD players, cameras and video cassette recorders, in > - either NTSC, PAL or HD format and still occasionally SECAM, separate > - it into its component parts, luminance and chrominance, and output > + either NTSC, PAL, SECAM or HD format, separating the stream > + into its component parts, luminance and chrominance, and output > it in some digital video standard, with appropriate embedded timing > signals. > > > MEDIA_ENT_T_V4L2_SUBDEV_TUNER > - TV and/or radio tuner > + Digital TV, analog TV, radio and/or software radio tuner > > > >