sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget;/translations/zh_CN/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/zh_TW/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/it_IT/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/ja_JP/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/ko_KR/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget;/translations/sp_SP/userspace-api/media/v4l/ext-ctrls-flashmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhU/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rsthKubhtarget)}(h.. _flash-controls:h]h}(h]h ]h"]h$]h&]refidflash-controlsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hFlash Control Referenceh]hFlash Control Reference}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hThe V4L2 flash controls are intended to provide generic access to flash controller devices. Flash controller devices are typically used in digital cameras.h]hThe V4L2 flash controls are intended to provide generic access to flash controller devices. Flash controller devices are typically used in digital cameras.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hThe interface can support both LED and xenon flash devices. As of writing this, there is no xenon flash driver using this interface.h]hThe interface can support both LED and xenon flash devices. As of writing this, there is no xenon flash driver using this interface.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(h.. _flash-controls-use-cases:h]h}(h]h ]h"]h$]h&]hflash-controls-use-casesuh1hhKhhhhhhubh)}(hhh](h)}(hSupported use casesh]hSupported use cases}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h*Unsynchronised LED flash (software strobe)h]h*Unsynchronised LED flash (software strobe)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hUnsynchronised LED flash is controlled directly by the host as the sensor. The flash must be enabled by the host before the exposure of the image starts and disabled once it ends. The host is fully responsible for the timing of the flash.h]hUnsynchronised LED flash is controlled directly by the host as the sensor. The flash must be enabled by the host before the exposure of the image starts and disabled once it ends. The host is fully responsible for the timing of the flash.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h#Example of such device: Nokia N900.h]h#Example of such device: Nokia N900.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h](unsynchronised-led-flash-software-strobeah ]h"]*unsynchronised led flash (software strobe)ah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h(Synchronised LED flash (hardware strobe)h]h(Synchronised LED flash (hardware strobe)}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFhhhhhK#ubh)}(hThe synchronised LED flash is pre-programmed by the host (power and timeout) but controlled by the sensor through a strobe signal from the sensor to the flash.h]hThe synchronised LED flash is pre-programmed by the host (power and timeout) but controlled by the sensor through a strobe signal from the sensor to the flash.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjFhhubh)}(hsThe sensor controls the flash duration and timing. This information typically must be made available to the sensor.h]hsThe sensor controls the flash duration and timing. This information typically must be made available to the sensor.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjFhhubeh}(h]&synchronised-led-flash-hardware-strobeah ]h"](synchronised led flash (hardware strobe)ah$]h&]uh1hhjhhhhhK#ubh)}(hhh](h)}(hLED flash as torchh]hLED flash as torch}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hhhhhK.ubh)}(heLED flash may be used as torch in conjunction with another use case involving camera or individually.h]heLED flash may be used as torch in conjunction with another use case involving camera or individually.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hj{hhubh)}(h.. _flash-control-id:h]h}(h]h ]h"]h$]h&]hflash-control-iduh1hhK4hj{hhhhubeh}(h]led-flash-as-torchah ]h"]led flash as torchah$]h&]uh1hhjhhhhhK.ubh)}(hhh](h)}(hFlash Control IDsh]hFlash Control IDs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK7ubhdefinition_list)}(hhh](hdefinition_list_item)}(h=``V4L2_CID_FLASH_CLASS (class)`` The FLASH class descriptor. h](hterm)}(h ``V4L2_CID_FLASH_CLASS (class)``h]hliteral)}(hjh]hV4L2_CID_FLASH_CLASS (class)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK:hjubh definition)}(hhh]h)}(hThe FLASH class descriptor.h]hThe FLASH class descriptor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhK:hjubj)}(h``V4L2_CID_FLASH_LED_MODE (menu)`` Defines the mode of the flash LED, the high-power white LED attached to the flash controller. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT. h](j)}(h"``V4L2_CID_FLASH_LED_MODE (menu)``h]j)}(hj h]hV4L2_CID_FLASH_LED_MODE (menu)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK@hjubj)}(hhh]h)}(hDefines the mode of the flash LED, the high-power white LED attached to the flash controller. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.h]hDefines the mode of the flash LED, the high-power white LED attached to the flash controller. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhK@hjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubhtabular_col_spec)}(hhh]h}(h]h ]h"]h$]h&]spec|p{5.7cm}|p{11.8cm}|uh1jAhhhKBhjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhjUubjY)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhjUubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h``V4L2_FLASH_LED_MODE_NONE``h]j)}(hjh]hV4L2_FLASH_LED_MODE_NONE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj}ubah}(h]h ]h"]h$]h&]uh1hhhhKHhjzubah}(h]h ]h"]h$]h&]uh1jxhjuubjy)}(hhh]h)}(hOff.h]hOff.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jxhjuubeh}(h]h ]h"]h$]h&]uh1jshjpubjt)}(hhh](jy)}(hhh]h)}(h``V4L2_FLASH_LED_MODE_FLASH``h]j)}(hjh]hV4L2_FLASH_LED_MODE_FLASH}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKJhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(h Flash mode.h]h Flash mode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshjpubjt)}(hhh](jy)}(hhh]h)}(h``V4L2_FLASH_LED_MODE_TORCH``h]j)}(hjh]hV4L2_FLASH_LED_MODE_TORCH}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKLhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh](h)}(h Torch mode.h]h Torch mode.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubh)}(h#See V4L2_CID_FLASH_TORCH_INTENSITY.h]h#See V4L2_CID_FLASH_TORCH_INTENSITY.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubeh}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshjpubeh}(h]h ]h"]h$]h&]uh1jnhjUubeh}(h]h ]h"]h$]h&]colsKuh1jShjPubah}(h]h ]h"]h$]h&]uh1jNhjhhhNhNubj)}(hhh]j)}(hT``V4L2_CID_FLASH_STROBE_SOURCE (menu)`` Defines the source of the flash LED strobe. h](j)}(h'``V4L2_CID_FLASH_STROBE_SOURCE (menu)``h]j)}(hjah]h#V4L2_CID_FLASH_STROBE_SOURCE (menu)}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhhhKThj[ubj)}(hhh]h)}(h+Defines the source of the flash LED strobe.h]h+Defines the source of the flash LED strobe.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjvubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhhhKThjXubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubjB)}(hhh]h}(h]h ]h"]h$]h&]jL|p{7.5cm}|p{7.5cm}|uh1jAhhhKVhjhhubjO)}(hhh]jT)}(hhh](jY)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhjubjY)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhjubjo)}(hhh](jt)}(hhh](jy)}(hhh]h)}(h%``V4L2_FLASH_STROBE_SOURCE_SOFTWARE``h]j)}(hjh]h!V4L2_FLASH_STROBE_SOURCE_SOFTWARE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK\hjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hIThe flash strobe is triggered by using the V4L2_CID_FLASH_STROBE control.h]hIThe flash strobe is triggered by using the V4L2_CID_FLASH_STROBE control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshjubjt)}(hhh](jy)}(hhh]h)}(h%``V4L2_FLASH_STROBE_SOURCE_EXTERNAL``h]j)}(hjh]h!V4L2_FLASH_STROBE_SOURCE_EXTERNAL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK_hjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hThe flash strobe is triggered by an external source. Typically this is a sensor, which makes it possible to synchronise the flash strobe start to exposure start.h]hThe flash strobe is triggered by an external source. Typically this is a sensor, which makes it possible to synchronise the flash strobe start to exposure start.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hj#ubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshjubeh}(h]h ]h"]h$]h&]uh1jnhjubeh}(h]h ]h"]h$]h&]colsKuh1jShjubah}(h]h ]h"]h$]h&]uh1jNhjhhhNhNubj)}(hhh](j)}(hX%``V4L2_CID_FLASH_STROBE (button)`` Strobe flash. Valid when V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_FLASH and V4L2_CID_FLASH_STROBE_SOURCE is set to V4L2_FLASH_STROBE_SOURCE_SOFTWARE. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT. h](j)}(h"``V4L2_CID_FLASH_STROBE (button)``h]j)}(hj\h]hV4L2_CID_FLASH_STROBE (button)}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&]uh1jhhhKkhjVubj)}(hhh]h)}(hXStrobe flash. Valid when V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_FLASH and V4L2_CID_FLASH_STROBE_SOURCE is set to V4L2_FLASH_STROBE_SOURCE_SOFTWARE. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.h]hXStrobe flash. Valid when V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_FLASH and V4L2_CID_FLASH_STROBE_SOURCE is set to V4L2_FLASH_STROBE_SOURCE_SOFTWARE. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjqubah}(h]h ]h"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]uh1jhhhKkhjSubj)}(hG``V4L2_CID_FLASH_STROBE_STOP (button)`` Stop flash strobe immediately. h](j)}(h'``V4L2_CID_FLASH_STROBE_STOP (button)``h]j)}(hjh]h#V4L2_CID_FLASH_STROBE_STOP (button)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKnhjubj)}(hhh]h)}(hStop flash strobe immediately.h]hStop flash strobe immediately.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKnhjShhubj)}(h``V4L2_CID_FLASH_STROBE_STATUS (boolean)`` Strobe status: whether the flash is strobing at the moment or not. This is a read-only control. h](j)}(h*``V4L2_CID_FLASH_STROBE_STATUS (boolean)``h]j)}(hjh]h&V4L2_CID_FLASH_STROBE_STATUS (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKrhjubj)}(hhh]h)}(h_Strobe status: whether the flash is strobing at the moment or not. This is a read-only control.h]h_Strobe status: whether the flash is strobing at the moment or not. This is a read-only control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKrhjShhubj)}(h``V4L2_CID_FLASH_TIMEOUT (integer)`` Hardware timeout for flash. The flash strobe is stopped after this period of time has passed from the start of the strobe. h](j)}(h$``V4L2_CID_FLASH_TIMEOUT (integer)``h]j)}(hjh]h V4L2_CID_FLASH_TIMEOUT (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKvhjubj)}(hhh]h)}(hzHardware timeout for flash. The flash strobe is stopped after this period of time has passed from the start of the strobe.h]hzHardware timeout for flash. The flash strobe is stopped after this period of time has passed from the start of the strobe.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKvhjShhubj)}(h``V4L2_CID_FLASH_INTENSITY (integer)`` Intensity of the flash strobe when the flash LED is in flash mode (V4L2_FLASH_LED_MODE_FLASH). The unit should be milliamps (mA) if possible. h](j)}(h&``V4L2_CID_FLASH_INTENSITY (integer)``h]j)}(hj<h]h"V4L2_CID_FLASH_INTENSITY (integer)}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj:ubah}(h]h ]h"]h$]h&]uh1jhhhK{hj6ubj)}(hhh]h)}(hIntensity of the flash strobe when the flash LED is in flash mode (V4L2_FLASH_LED_MODE_FLASH). The unit should be milliamps (mA) if possible.h]hIntensity of the flash strobe when the flash LED is in flash mode (V4L2_FLASH_LED_MODE_FLASH). The unit should be milliamps (mA) if possible.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjQubah}(h]h ]h"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]uh1jhhhK{hjShhubj)}(hX``V4L2_CID_FLASH_TORCH_INTENSITY (integer)`` Intensity of the flash LED in torch mode (V4L2_FLASH_LED_MODE_TORCH). The unit should be milliamps (mA) if possible. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT. h](j)}(h,``V4L2_CID_FLASH_TORCH_INTENSITY (integer)``h]j)}(hjth]h(V4L2_CID_FLASH_TORCH_INTENSITY (integer)}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&]uh1jhhhKhjnubj)}(hhh]h)}(hIntensity of the flash LED in torch mode (V4L2_FLASH_LED_MODE_TORCH). The unit should be milliamps (mA) if possible. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.h]hIntensity of the flash LED in torch mode (V4L2_FLASH_LED_MODE_TORCH). The unit should be milliamps (mA) if possible. Setting this control may not be possible in presence of some faults. See V4L2_CID_FLASH_FAULT.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhhhKhjShhubj)}(h``V4L2_CID_FLASH_INDICATOR_INTENSITY (integer)`` Intensity of the indicator LED. The indicator LED may be fully independent of the flash LED. The unit should be microamps (uA) if possible. h](j)}(h0``V4L2_CID_FLASH_INDICATOR_INTENSITY (integer)``h]j)}(hjh]h,V4L2_CID_FLASH_INDICATOR_INTENSITY (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]h)}(hIntensity of the indicator LED. The indicator LED may be fully independent of the flash LED. The unit should be microamps (uA) if possible.h]hIntensity of the indicator LED. The indicator LED may be fully independent of the flash LED. The unit should be microamps (uA) if possible.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjShhubj)}(hX``V4L2_CID_FLASH_FAULT (bitmask)`` Faults related to the flash. The faults tell about specific problems in the flash chip itself or the LEDs attached to it. Faults may prevent further use of some of the flash controls. In particular, V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_NONE if the fault affects the flash LED. Exactly which faults have such an effect is chip dependent. Reading the faults resets the control and returns the chip to a usable state if possible. h](j)}(h"``V4L2_CID_FLASH_FAULT (bitmask)``h]j)}(hjh]hV4L2_CID_FLASH_FAULT (bitmask)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]h)}(hXFaults related to the flash. The faults tell about specific problems in the flash chip itself or the LEDs attached to it. Faults may prevent further use of some of the flash controls. In particular, V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_NONE if the fault affects the flash LED. Exactly which faults have such an effect is chip dependent. Reading the faults resets the control and returns the chip to a usable state if possible.h]hXFaults related to the flash. The faults tell about specific problems in the flash chip itself or the LEDs attached to it. Faults may prevent further use of some of the flash controls. In particular, V4L2_CID_FLASH_LED_MODE is set to V4L2_FLASH_LED_MODE_NONE if the fault affects the flash LED. Exactly which faults have such an effect is chip dependent. Reading the faults resets the control and returns the chip to a usable state if possible.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjShhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubjB)}(hhh]h}(h]h ]h"]h$]h&]jL|p{8.4cm}|p{9.1cm}|uh1jAhhhKhjhhubjO)}(hhh]jT)}(hhh](jY)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhj)ubjY)}(hhh]h}(h]h ]h"]h$]h&]colwidthK2uh1jXhj)ubjo)}(hhh](jt)}(hhh](jy)}(hhh]h)}(h!``V4L2_FLASH_FAULT_OVER_VOLTAGE``h]j)}(hjKh]hV4L2_FLASH_FAULT_OVER_VOLTAGE}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhhhKhjFubah}(h]h ]h"]h$]h&]uh1jxhjCubjy)}(hhh]h)}(hbFlash controller voltage to the flash LED has exceeded the limit specific to the flash controller.h]hbFlash controller voltage to the flash LED has exceeded the limit specific to the flash controller.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjfubah}(h]h ]h"]h$]h&]uh1jxhjCubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h``V4L2_FLASH_FAULT_TIMEOUT``h]j)}(hjh]hV4L2_FLASH_FAULT_TIMEOUT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hThe flash strobe was still on when the timeout set by the user --- V4L2_CID_FLASH_TIMEOUT control --- has expired. Not all flash controllers may set this in all such conditions.h]hThe flash strobe was still on when the timeout set by the user --- V4L2_CID_FLASH_TIMEOUT control --- has expired. Not all flash controllers may set this in all such conditions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h%``V4L2_FLASH_FAULT_OVER_TEMPERATURE``h]j)}(hjh]h!V4L2_FLASH_FAULT_OVER_TEMPERATURE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(h$The flash controller has overheated.h]h$The flash controller has overheated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h"``V4L2_FLASH_FAULT_SHORT_CIRCUIT``h]j)}(hj h]hV4L2_FLASH_FAULT_SHORT_CIRCUIT}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hHThe short circuit protection of the flash controller has been triggered.h]hHThe short circuit protection of the flash controller has been triggered.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj&ubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h!``V4L2_FLASH_FAULT_OVER_CURRENT``h]j)}(hjKh]hV4L2_FLASH_FAULT_OVER_CURRENT}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhhhKhjFubah}(h]h ]h"]h$]h&]uh1jxhjCubjy)}(hhh]h)}(hXCurrent in the LED power supply has exceeded the limit specific to the flash controller.h]hXCurrent in the LED power supply has exceeded the limit specific to the flash controller.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjfubah}(h]h ]h"]h$]h&]uh1jxhjCubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h``V4L2_FLASH_FAULT_INDICATOR``h]j)}(hjh]hV4L2_FLASH_FAULT_INDICATOR}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hYThe flash controller has detected a short or open circuit condition on the indicator LED.h]hYThe flash controller has detected a short or open circuit condition on the indicator LED.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h"``V4L2_FLASH_FAULT_UNDER_VOLTAGE``h]j)}(hjh]hV4L2_FLASH_FAULT_UNDER_VOLTAGE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hlFlash controller voltage to the flash LED has been below the minimum limit specific to the flash controller.h]hlFlash controller voltage to the flash LED has been below the minimum limit specific to the flash controller.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h"``V4L2_FLASH_FAULT_INPUT_VOLTAGE``h]j)}(hj h]hV4L2_FLASH_FAULT_INPUT_VOLTAGE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jxhjubjy)}(hhh]h)}(hThe input voltage of the flash controller is below the limit under which strobing the flash at full current will not be possible.The condition persists until this flag is no longer set.h]hThe input voltage of the flash controller is below the limit under which strobing the flash at full current will not be possible.The condition persists until this flag is no longer set.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj&ubah}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ]h"]h$]h&]uh1jshj@ubjt)}(hhh](jy)}(hhh]h)}(h)``V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE``h]j)}(hjKh]h%V4L2_FLASH_FAULT_LED_OVER_TEMPERATURE}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjIubah}(h]h ]h"]h$]h&]uh1hhhhKhjFubah}(h]h ]h"]h$]h&]uh1jxhjCubjy)}(hhh]h)}(h@The temperature of the LED has exceeded its allowed upper limit.h]h@The temperature of the LED has exceeded its allowed upper limit.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjfubah}(h]h ]h"]h$]h&]uh1jxhjCubeh}(h]h ]h"]h$]h&]uh1jshj@ubeh}(h]h ]h"]h$]h&]uh1jnhj)ubeh}(h]h ]h"]h$]h&]colsKuh1jShj&ubah}(h]h ]h"]h$]h&]uh1jNhjhhhNhNubj)}(hhh](j)}(h]``V4L2_CID_FLASH_CHARGE (boolean)`` Enable or disable charging of the xenon flash capacitor. h](j)}(h#``V4L2_CID_FLASH_CHARGE (boolean)``h]j)}(hjh]hV4L2_CID_FLASH_CHARGE (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]h)}(h8Enable or disable charging of the xenon flash capacitor.h]h8Enable or disable charging of the xenon flash capacitor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hX``V4L2_CID_FLASH_READY (boolean)`` Is the flash ready to strobe? Xenon flashes require their capacitors charged before strobing. LED flashes often require a cooldown period after strobe during which another strobe will not be possible. This is a read-only control.h](j)}(h"``V4L2_CID_FLASH_READY (boolean)``h]j)}(hjh]hV4L2_CID_FLASH_READY (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]h)}(hIs the flash ready to strobe? Xenon flashes require their capacitors charged before strobing. LED flashes often require a cooldown period after strobe during which another strobe will not be possible. This is a read-only control.h]hIs the flash ready to strobe? Xenon flashes require their capacitors charged before strobing. LED flashes often require a cooldown period after strobe during which another strobe will not be possible. This is a read-only control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h](flash-control-idsjeh ]h"](flash control idsflash-control-ideh$]h&]uh1hhjhhhhhK7expect_referenced_by_name}j jsexpect_referenced_by_id}jjsubeh}(h](supported-use-casesheh ]h"](supported use casesflash-controls-use-caseseh$]h&]uh1hhhhhhhhKj }j" hsj }hhsubeh}(h](flash-control-referenceheh ]h"](flash control referenceflash-controlseh$]h&]uh1hhhhhhhhKj }j- hsj }hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjxfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjT error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(h]hah]haj]jaunameids}(j- hj, j) j" hj! j jCj@jxjujjj jj j u nametypes}(j- j, j" j! jCjxjj j uh}(hhj) hhjj jj@jjujFjj{jjj ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h4Hyperlink target "flash-controls" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1j ubj )}(hhh]h)}(hhh]h>Hyperlink target "flash-controls-use-cases" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypej sourcehlineKuh1j ubj )}(hhh]h)}(hhh]h6Hyperlink target "flash-control-id" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypej sourcehlineK4uh1j ube transformerN include_log] decorationNhhub.