Re: [PATCH v2 4/8] Documentation: uAPI: media: add V4L2_CID_FLASH_DURATION
From: Hans Verkuil
Date: Fri Mar 14 2025 - 06:36:36 EST
On 14/03/2025 11:28, Richard Leitner wrote:
> Hi Hans,
>
> thanks for your quick feedback!
>
> On Fri, Mar 14, 2025 at 10:41:04AM +0100, Hans Verkuil wrote:
>> On 14/03/2025 09:49, Richard Leitner wrote:
>>> Add the new strobe_duration control to v4l uAPI documentation.
>>>
>>> Signed-off-by: Richard Leitner <richard.leitner@xxxxxxxxx>
>>> ---
>>> Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst | 5 +++++
>>> 1 file changed, 5 insertions(+)
>>>
>>> diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst
>>> index d22c5efb806a183a3ad67ec3e6550b002a51659a..03a58ef94be7c870f55d5a9bb09503995dbfb402 100644
>>> --- a/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst
>>> +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst
>>> @@ -186,3 +186,8 @@ Flash Control IDs
>>> 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.
>>> +
>>> +``V4L2_CID_FLASH_DURATION (integer)``
>>> + Duration the flash should be on when the flash LED is in flash mode
>>> + (V4L2_FLASH_LED_MODE_FLASH). The unit should be microseconds (µs)
>>> + if possible.
>>>
>>
>> If this control is present, does that mean that the flash duration always have
>> to be set manually? Or can there be an 'Auto' mode as well? And if so, how is
>> that set?
>
> To be honest I haven't thought about automatic flash duration. Is this
> something which is required?
No idea, it was just something I was wondering about. Sakari probably knows a lot
more about this.
Regards,
Hans
>
> At least for the ov9282 sensor (which I've implemented this control for
> in this series) there is no "auto" mode AFAIK.
>
> If it's required: What would be the best solution?
> Extending V4L2_CID_FLASH_LED_MODE with a new menu option? E.g.
> V4L2_FLASH_LED_MODE_FLASH_{MANUAL,AUTO}?
>
>>
>> Regards,
>>
>> Hans
>
> Thanks!
> Richard