From patchwork Tue Jun 12 20:20:42 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Brian Norris X-Patchwork-Id: 928479 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=chromium.org Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=chromium.org header.i=@chromium.org header.b="MnUM7f7E"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 4151Vl44C9z9s2t for ; Wed, 13 Jun 2018 06:21:19 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933155AbeFLUVF (ORCPT ); Tue, 12 Jun 2018 16:21:05 -0400 Received: from mail-pf0-f194.google.com ([209.85.192.194]:37807 "EHLO mail-pf0-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933792AbeFLUUv (ORCPT ); Tue, 12 Jun 2018 16:20:51 -0400 Received: by mail-pf0-f194.google.com with SMTP id y5-v6so116689pfn.4 for ; Tue, 12 Jun 2018 13:20:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=w7WUnYdQJVMcSzZoxupiQCcgfxRPRjU/e1SHOb0pfpk=; b=MnUM7f7EoQu7nls/SwzWNojr0hK90sfV5FqWFLeaBpOzjrrfMwkFuWr5bn+EBJjiJh GUb4ysqOyGR477L2rciE13JApi20Twef9T5YoHUKrCy8s6ftam5pjCInn8uY8gYFf+/9 7R+HCoprSWAyhMh59pN4eg0L5oT3uHv8cUAys= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=w7WUnYdQJVMcSzZoxupiQCcgfxRPRjU/e1SHOb0pfpk=; b=h3IxuNzgx3gvEE90i1ss55n9gBzZGHy2I/Ddtr5vy8muRwtSV0ktCumab67hNKd/kZ /kUJic2ONcGNrMGqt0UYu2dEFgUXtqgXz4Aqe9XMA/JGynZeVPA4nTl75D86YivBLPNw h/TLMC4WOByegGJO7WtgcN8c6gQ5pkAu9jCuDEBRy/bfqGM97eAlhKCknspMotAjVVHe K2PvRj7FX8ynuy7dx1eGxloLFJQ8kc542bJVkam5s44OBf/pSc8xpZrSoOPxW8c+PR2G 6egEhopczOZoTk/Qo3sheYUqEGLogqXUhUYpCPTWrQMxHY/VQ9/R7wyjUtl3cObZfGkG zTPw== X-Gm-Message-State: APt69E3dvUvkqAvkqhax6UaTcxwaoqCcri9OquwHzFTcDe4baI3wq8YK LGg/yt+fSgpFF/YI01TYGUsLhw== X-Google-Smtp-Source: ADUXVKK858UGeUyVsv8eccUUa2GK+EnGBO7b8kRsLBzjFCJ2jtlmehgtrQMjqX24DWE9i8UIOQSI6A== X-Received: by 2002:aa7:818b:: with SMTP id g11-v6mr1928413pfi.50.1528834851235; Tue, 12 Jun 2018 13:20:51 -0700 (PDT) Received: from ban.mtv.corp.google.com ([2620:0:1000:1501:bc2f:3082:9938:5d41]) by smtp.gmail.com with ESMTPSA id z28-v6sm1136732pfl.169.2018.06.12.13.20.49 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 12 Jun 2018 13:20:50 -0700 (PDT) From: Brian Norris To: Sebastian Reichel Cc: , Rob Herring , linux-pm@vger.kernel.org, devicetree@vger.kernel.org, Rhyland Klein , Alexandru Stan , Guenter Roeck , Doug Anderson , Phil Reid , Brian Norris Subject: [PATCH 2/2] dt-bindings: power: sbs-battery: re-document "ti, bq20z75" Date: Tue, 12 Jun 2018 13:20:42 -0700 Message-Id: <20180612202042.107603-2-briannorris@chromium.org> X-Mailer: git-send-email 2.18.0.rc1.242.g61856ae69a-goog In-Reply-To: <20180612202042.107603-1-briannorris@chromium.org> References: <20180612202042.107603-1-briannorris@chromium.org> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This compatible property was documented before the driver was renamed to "SBS" (see commit e57f1b68c406 ("devicetree-bindings: Propagate bq20z75->sbs rename to dt bindings")). The driver has continued to support this property as an alternative to "sbs,sbs-battery", and because we've noticed there are some lingering TI specifics (in the manufacturer-specific portion of the SBS spec), we'd like to start using this property again to differentiate. In typical DT fashion, the , specifics should be used ahead of the generic "sbs,sbs-battery" string, so we can handle vendor specifics -- so document this. Language borrowed mostly from Documentation/devicetree/bindings/power/supply/sbs_sbs-charger.txt Also fixup the example to use this property (it's already implying that it's "bq20z75@b"); fixup the node name to be generic ("battery", not ""); and fixup some whitespace. Signed-off-by: Brian Norris Acked-by: Rhyland Klein Reviewed-by: Rob Herring --- v2: add Rhyland's Acked-by v3: no change v4: add Rob's Reviewed-by v5: * note "sbs,sbs-battery" as a fallback for vendor,part-number * improve the Example * I still kept the {Acked,Reviewed}-by, since the substance of the change is essentially the same. Apologies if that is not proper. --- .../bindings/power/supply/sbs_sbs-battery.txt | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Documentation/devicetree/bindings/power/supply/sbs_sbs-battery.txt b/Documentation/devicetree/bindings/power/supply/sbs_sbs-battery.txt index c40e8926facf..4e78e51018eb 100644 --- a/Documentation/devicetree/bindings/power/supply/sbs_sbs-battery.txt +++ b/Documentation/devicetree/bindings/power/supply/sbs_sbs-battery.txt @@ -2,7 +2,11 @@ SBS sbs-battery ~~~~~~~~~~ Required properties : - - compatible : "sbs,sbs-battery" + - compatible: ",", "sbs,sbs-battery" as fallback. The + part number compatible string might be used in order to take care of + vendor specific registers. + Known ,: + ti,bq20z75 Optional properties : - sbs,i2c-retry-count : The number of times to retry i2c transactions on i2c @@ -14,9 +18,9 @@ Optional properties : Example: - bq20z75@b { - compatible = "sbs,sbs-battery"; - reg = < 0xb >; + battery@b { + compatible = "ti,bq20z75", "sbs,sbs-battery"; + reg = <0xb>; sbs,i2c-retry-count = <2>; sbs,poll-retry-count = <10>; sbs,battery-detect-gpios = <&gpio-controller 122 1>;