projects / linux-2.6-block.git / blame
| Commit | Line | Data |
|---|---|---|
| f6ad395b JA |
1 | |
| 2 | Flash LED handling under Linux | |
| 3 | ============================== | |
| 4 | ||
| 5 | Some LED devices provide two modes - torch and flash. In the LED subsystem | |
| 6 | those modes are supported by LED class (see Documentation/leds/leds-class.txt) | |
| 7 | and LED Flash class respectively. The torch mode related features are enabled | |
| 8 | by default and the flash ones only if a driver declares it by setting | |
| 9 | LED_DEV_CAP_FLASH flag. | |
| 10 | ||
| 11 | In order to enable the support for flash LEDs CONFIG_LEDS_CLASS_FLASH symbol | |
| 12 | must be defined in the kernel config. A LED Flash class driver must be | |
| 13 | registered in the LED subsystem with led_classdev_flash_register function. | |
| 14 | ||
| 15 | Following sysfs attributes are exposed for controlling flash LED devices: | |
| 16 | (see Documentation/ABI/testing/sysfs-class-led-flash) | |
| 17 | - flash_brightness | |
| 18 | - max_flash_brightness | |
| 19 | - flash_timeout | |
| 20 | - max_flash_timeout | |
| 21 | - flash_strobe | |
| 22 | - flash_fault | |
| aaf2cbca JA |
23 | |
| 24 | ||
| 25 | V4L2 flash wrapper for flash LEDs | |
| 26 | ================================= | |
| 27 | ||
| 28 | A LED subsystem driver can be controlled also from the level of VideoForLinux2 | |
| 29 | subsystem. In order to enable this CONFIG_V4L2_FLASH_LED_CLASS symbol has to | |
| 30 | be defined in the kernel config. | |
| 31 | ||
| 32 | The driver must call the v4l2_flash_init function to get registered in the | |
| 33 | V4L2 subsystem. The function takes six arguments: | |
| 34 | - dev : flash device, e.g. an I2C device | |
| 35 | - of_node : of_node of the LED, may be NULL if the same as device's | |
| 36 | - fled_cdev : LED flash class device to wrap | |
| 37 | - iled_cdev : LED flash class device representing indicator LED associated with | |
| 38 | fled_cdev, may be NULL | |
| 39 | - ops : V4L2 specific ops | |
| 40 | * external_strobe_set - defines the source of the flash LED strobe - | |
| 41 | V4L2_CID_FLASH_STROBE control or external source, typically | |
| 42 | a sensor, which makes it possible to synchronise the flash | |
| 43 | strobe start with exposure start, | |
| 44 | * intensity_to_led_brightness and led_brightness_to_intensity - perform | |
| 45 | enum led_brightness <-> V4L2 intensity conversion in a device | |
| 46 | specific manner - they can be used for devices with non-linear | |
| 47 | LED current scale. | |
| 48 | - config : configuration for V4L2 Flash sub-device | |
| 49 | * dev_name - the name of the media entity, unique in the system, | |
| 50 | * flash_faults - bitmask of flash faults that the LED flash class | |
| 51 | device can report; corresponding LED_FAULT* bit definitions are | |
| 52 | available in <linux/led-class-flash.h>, | |
| 53 | * torch_intensity - constraints for the LED in TORCH mode | |
| 54 | in microamperes, | |
| 55 | * indicator_intensity - constraints for the indicator LED | |
| 56 | in microamperes, | |
| 57 | * has_external_strobe - determines whether the flash strobe source | |
| 58 | can be switched to external, | |
| 59 | ||
| 60 | On remove the v4l2_flash_release function has to be called, which takes one | |
| 61 | argument - struct v4l2_flash pointer returned previously by v4l2_flash_init. | |
| 62 | This function can be safely called with NULL or error pointer argument. | |
| 63 | ||
| 64 | Please refer to drivers/leds/leds-max77693.c for an exemplary usage of the | |
| 65 | v4l2 flash wrapper. | |
| 66 | ||
| 67 | Once the V4L2 sub-device is registered by the driver which created the Media | |
| 68 | controller device, the sub-device node acts just as a node of a native V4L2 | |
| 69 | flash API device would. The calls are simply routed to the LED flash API. | |
| 70 | ||
| 71 | Opening the V4L2 flash sub-device makes the LED subsystem sysfs interface | |
| 72 | unavailable. The interface is re-enabled after the V4L2 flash sub-device | |
| 73 | is closed. |