Re: [PATCH 1/2] dt-bindings: power: supply: gpio-charger: Add status-gpios property

From: Artur Rojek
Date: Tue Feb 26 2019 - 09:40:46 EST


Hi Rob.

Thanks for the review.

On 2019-02-25 22:53, Rob Herring wrote:
On Tue, Feb 05, 2019 at 08:03:15PM +0100, Artur Rojek wrote:
Add documentation for the "status-gpios" property.

Signed-off-by: Artur Rojek <contact@xxxxxxxxxxxxxx>
---
.../devicetree/bindings/power/supply/gpio-charger.txt | 4 ++++
1 file changed, 4 insertions(+)

diff --git a/Documentation/devicetree/bindings/power/supply/gpio-charger.txt b/Documentation/devicetree/bindings/power/supply/gpio-charger.txt
index adbb5dc5b6e9..b98a05a4973c 100644
--- a/Documentation/devicetree/bindings/power/supply/gpio-charger.txt
+++ b/Documentation/devicetree/bindings/power/supply/gpio-charger.txt
@@ -14,12 +14,16 @@ Required properties :
usb-cdp (USB charging downstream port)
usb-aca (USB accessory charger adapter)

+Optional properties:
+ - status-gpios: GPIO indicating the charger status

So when it is asserted it has 'status'? What does status mean?
It is a GPIO indicating whether a battery is charging.
I shall make the description more clear.

+
Example:

usb_charger: charger {
compatible = "gpio-charger";
charger-type = "usb-sdp";
gpios = <&gpf0 2 0 0 0>;
+ status-gpios = <&gpf0 3 0 0 0>;

Humm, not sure what the thinking for 'gpios' was, but it's wrong and you
just copied it. If we follow the normal cell encoding with 2 cells, this
means the property takes 3 gpios (though the last 2 are marked not
present with 0).
I will replace both of those properties with a valid example.

Artur

Rob