Re: [PATCH 1/2] dt-bindings: power: supply: bq256xx: Add omit-battery-class property

From: Krzysztof Kozlowski
Date: Sat Sep 07 2024 - 07:12:13 EST


On 07/09/2024 13:07, Barnabás Czémán wrote:
> Add omit-battery-class property for avoid system create a battery device.

This does not help much, basically repeats commit subject. You need to
answer to "why?".
>
> Signed-off-by: Barnabás Czémán <barnabas.czeman@xxxxxxxxxxxxxx>
> ---
> Documentation/devicetree/bindings/power/supply/bq256xx.yaml | 6 ++++++
> 1 file changed, 6 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/power/supply/bq256xx.yaml b/Documentation/devicetree/bindings/power/supply/bq256xx.yaml
> index a76afe3ca299..744f5782e8e7 100644
> --- a/Documentation/devicetree/bindings/power/supply/bq256xx.yaml
> +++ b/Documentation/devicetree/bindings/power/supply/bq256xx.yaml
> @@ -62,6 +62,12 @@ properties:
> $ref: /schemas/types.yaml#/definitions/phandle
> description: phandle to the battery node being monitored
>
> + omit-battery-class:
> + type: boolean
> + description: |
> + If this property is set, the operating system does not try to create a
> + battery device.

You described the desired Linux feature or behavior, not the actual
hardware. The bindings are about the latter, so instead you need to
rephrase the property and its description to match actual hardware
capabilities/features/configuration etc.

Best regards,
Krzysztof