From: Jacek Anaszewski <j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
To: linux-leds-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
	linux-media-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Cc: devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
	kyungmin.park-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org,
	pavel-+ZI9xUNit7I@public.gmane.org,
	cooloney-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	rpurdie-Fm38FmjxZ/leoWH0uzbU5w@public.gmane.org,
	sakari.ailus-X3B1VOXEql0@public.gmane.org,
	s.nawrocki-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org,
	Jacek Anaszewski
	<j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
Subject: [PATCH v2 09/11] Documentation: leds: Add description of v4l2-flash sub-device
Date: Fri, 27 Mar 2015 14:49:43 +0100	[thread overview]
Message-ID: <1427464185-27950-10-git-send-email-j.anaszewski@samsung.com> (raw)
In-Reply-To: <1427464185-27950-1-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
This patch extends LED Flash class documention by
the description of interactions with v4l2-flash sub-device.
Signed-off-by: Jacek Anaszewski <j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
Acked-by: Kyungmin Park <kyungmin.park-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
Acked-by: Sakari Ailus <sakari.ailus-VuQAYsv1563Yd54FQh9/CA@public.gmane.org>
Cc: Bryan Wu <cooloney-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Cc: Richard Purdie <rpurdie-Fm38FmjxZ/leoWH0uzbU5w@public.gmane.org>
---
 Documentation/leds/leds-class-flash.txt |   13 +++++++++++++
 1 file changed, 13 insertions(+)
diff --git a/Documentation/leds/leds-class-flash.txt b/Documentation/leds/leds-class-flash.txt
index 19bb673..8623413 100644
--- a/Documentation/leds/leds-class-flash.txt
+++ b/Documentation/leds/leds-class-flash.txt
@@ -20,3 +20,16 @@ Following sysfs attributes are exposed for controlling flash LED devices:
 	- max_flash_timeout
 	- flash_strobe
 	- flash_fault
+
+A LED subsystem driver can be controlled also from the level of VideoForLinux2
+subsystem. In order to enable this CONFIG_V4L2_FLASH_LED_CLASS symbol has to
+be defined in the kernel config. The driver must call the v4l2_flash_init
+function to get registered in the V4L2 subsystem. On remove the
+v4l2_flash_release function has to be called (see <media/v4l2-flash.h>).
+
+After proper initialization a V4L2 Flash sub-device is created. The sub-device
+exposes a number of V4L2 controls, which allow for controlling a LED Flash class
+device with use of its internal kernel API.
+Opening the V4L2 Flash sub-device makes the LED subsystem sysfs interface
+unavailable. The interface is re-enabled after the V4L2 Flash sub-device
+is closed.
-- 
1.7.9.5
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
next prev parent reply	other threads:[~2015-03-27 13:49 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-03-27 13:49 [PATCH v2 00/11] LED / flash API integration Jacek Anaszewski
2015-03-27 13:49 ` [PATCH v2 01/11] leds: unify the location of led-trigger API Jacek Anaszewski
2015-03-28 22:33   ` Sakari Ailus
2015-03-27 13:49 ` [PATCH v2 02/11] leds: add uapi header file Jacek Anaszewski
     [not found]   ` <1427464185-27950-3-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2015-03-28 22:35     ` Sakari Ailus
2015-03-30  7:22       ` Jacek Anaszewski
2015-03-27 13:49 ` [PATCH v2 03/11] leds: Add support for max77693 mfd flash cell Jacek Anaszewski
2015-03-28 22:45   ` Sakari Ailus
2015-03-27 13:49 ` [PATCH v2 04/11] DT: Add documentation for the mfd Maxim max77693 Jacek Anaszewski
2015-03-27 14:06   ` Jacek Anaszewski
2015-03-28 22:55   ` Sakari Ailus
2015-03-30  7:36     ` Jacek Anaszewski
     [not found]       ` <5518FD05.5060800-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2015-03-30  9:35         ` Sakari Ailus
2015-03-27 13:49 ` [PATCH v2 05/11] leds: Add driver for AAT1290 flash LED controller Jacek Anaszewski
2015-03-28 22:57   ` Sakari Ailus
2015-03-27 13:49 ` [PATCH v2 06/11] of: Add Skyworks Solutions, Inc. vendor prefix Jacek Anaszewski
     [not found] ` <1427464185-27950-1-git-send-email-j.anaszewski-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
2015-03-27 13:49   ` [PATCH v2 07/11] DT: Add documentation for the Skyworks AAT1290 Jacek Anaszewski
2015-03-27 13:49   ` [PATCH v2 08/11] media: Add registration helpers for V4L2 flash sub-devices Jacek Anaszewski
2015-03-27 13:49   ` Jacek Anaszewski [this message]
2015-03-28 23:35     ` [PATCH v2 09/11] Documentation: leds: Add description of v4l2-flash sub-device Sakari Ailus
2015-03-27 13:49 ` [PATCH v2 10/11] leds: max77693: add support for V4L2 Flash sub-device Jacek Anaszewski
2015-03-27 13:49 ` [PATCH v2 11/11] leds: aat1290: " Jacek Anaszewski
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox
  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):
  git send-email \
    --in-reply-to=1427464185-27950-10-git-send-email-j.anaszewski@samsung.com \
    --to=j.anaszewski-sze3o3uu22jbdgjk7y7tuq@public.gmane.org \
    --cc=cooloney-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    --cc=devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=kyungmin.park-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org \
    --cc=linux-leds-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=linux-media-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=pavel-+ZI9xUNit7I@public.gmane.org \
    --cc=rpurdie-Fm38FmjxZ/leoWH0uzbU5w@public.gmane.org \
    --cc=s.nawrocki-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org \
    --cc=sakari.ailus-X3B1VOXEql0@public.gmane.org \
    /path/to/YOUR_REPLY
  https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
  Be sure your reply has a Subject: header at the top and a blank line
  before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).