Re: [PATCH 1/2] dt-bindings: media: i2c: dongwoon,dw9719: Document DW9714VA

[David Heidelberg <david@ixit.cz>]

On 16/10/2026 11:09, wyibo6109@gmail.com wrote:
> From: Yibo Wang <wyibo6109@gmail.com>
> 
> The dongwoon,dw9714va compatible names the DW9714V silicon revision
> found on the OnePlus Pad 4 (iceland) camera modules.  DW9714VA is not
> an official part number: it is coined to distinguish this revision,
> which shares its IC INFO id (0xFE) with the other DW9714V revisions.
> 
> In its register-mapped ("advanced") mode it exposes the DW9719
> register interface, with the SAC mode field in MODE shifted by 6 like
> on the DW9800K.  This differs from the advanced-mode layout of the
> currently available DW9714V datasheet (Rev. 0.03G), which puts
> SAC_MODE in [3:0] of SAC_CFG and splits the prescaler and SACT into
> separate registers.
> 
> The datasheet-conformant DW9714V and DW9714A, used in their normal
> (direct DAC) mode, are covered by the dongwoon,dw9714 binding
> instead; see the in-flight series by David Heidelberg documenting
> them:
> 
> https://lore.kernel.org/linux-media/20260729-dw9714v-v1-0-3c479b3cf8c0@ixit.cz/
> 
> The module-specific SAC tuning is carried by the already-documented
> dongwoon,sac-mode and dongwoon,vcm-prescale properties.
> 
> Cc: David Heidelberg <david@ixit.cz>
> Signed-off-by: Yibo Wang <wyibo6109@gmail.com>
> ---
>   .../devicetree/bindings/media/i2c/dongwoon,dw9719.yaml     | 7 +++++++
>   1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9719.yaml b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9719.yaml
> index 8e8d62436..f415f2369 100644
> --- a/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9719.yaml
> +++ b/Documentation/devicetree/bindings/media/i2c/dongwoon,dw9719.yaml
> @@ -14,10 +14,17 @@ description:
>     with 100 mA output current sink capability, designed for linear control of
>     voice coil motors (VCM) in camera lenses. This chip provides a Smart Actuator
>     Control (SAC) mode intended for driving voice coil lenses in camera modules.
> +  The DW9714V revision found on the OnePlus Pad 4 (iceland) camera
> +  modules exposes this register interface in its register-mapped
> +  ("advanced") mode, with a register layout following the DW9719
> +  rather than the DW9714V datasheet.  dongwoon,dw9714va is not an
> +  official part number: it is coined to name this revision, which
> +  shares its IC INFO id with the other DW9714V revisions.

Hello Yibo,

few things to improve.

1. you should disclose usage of LLM (e.g. Assisted-by: tag) - I assume you used it
2. No need to describe which device contains this piece of HW.
The binding doesn't care where it's used, only describes the actual HW.

You may mention the device using it in the series description, but doesn't make 
sense to do it in the binding/driver.

David

[...]