From patchwork Sat Aug 26 05:14:10 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Liam Breck X-Patchwork-Id: 9923113 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 94449603FF for ; Sat, 26 Aug 2017 05:15:20 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8CB72285AE for ; Sat, 26 Aug 2017 05:15:20 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 818A5285C2; Sat, 26 Aug 2017 05:15:20 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 77F1A285BD for ; Sat, 26 Aug 2017 05:15:19 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751464AbdHZFOv (ORCPT ); Sat, 26 Aug 2017 01:14:51 -0400 Received: from mail-pf0-f196.google.com ([209.85.192.196]:33080 "EHLO mail-pf0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750736AbdHZFOu (ORCPT ); Sat, 26 Aug 2017 01:14:50 -0400 Received: by mail-pf0-f196.google.com with SMTP id c28so350953pfe.0; Fri, 25 Aug 2017 22:14:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=dulQBGrDagm957e/9tttVfQ/W5rVS55UK4OjR+N9keY=; b=D9qhueRZE4u5zfeuC1/x5KRqy/YrZLwAw92LDhq5yZ0PmFRMgBdkoINLkwCSvLdZND sX0RRVXBcNOJbuaUlbaZT5Q7B4VRmGkDipe12lmK8hqgBjHdgfZvF62rKT78TOu+C3Er /9U39RxBoN7LQDkvR7lZUg3WqIVgjz1Z+7/2BxJhOVhLj5lnMQUr7TGhp5P76n15kiiZ V/SFjE44a6oc2T3E9IrJyglthF1ccMA69DkDe2eOoehJw4joFFARyKmhs64qQe0Vsl5j 3/ENkgs1fW6fLI5CuA+OKHLWZvEUQmP8sf7/zFw/EHKyXJnFd6pOSfFbAO1Ews7ANS/k R2Bw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=dulQBGrDagm957e/9tttVfQ/W5rVS55UK4OjR+N9keY=; b=fjF4ler4Z6bKWJ0MUscQ+GJSSrw2HpBPNZQkOiSx4p1eEIU/XLW6rCD+Cu3pe0wmYk kESGWDW3E/AMcwD3JRUYNWXAlZgK7gSp5lz4ENdI0/DpvLg9UFdLoJqD/cGC12oyo3gA OcAc5AoAgfyLnIPZuiXwrh8amW9QfNr4YxXmU7WpqEs6wIKgxEQG5Y21LrLfEVUh3GjT Zr7oUAJu4q5iTkHOhD+NMVTcYfBUAu2HNmOA+PVrma1xGPVJqEzc3X1jZbSjONYx4m4c s7nHzrWA33z5O+CToXqPlQBMdXqMQbfWbFrcuM45PzmwpkpNC2j2gAC8lEKwSVtDsqLJ UBBQ== X-Gm-Message-State: AHYfb5ikcFTCFxUyl5nJ82KpoxKPhvbX8WUHyNeTwkbLhDIr4wohIzx2 B/TbcsTiWN191w== X-Received: by 10.99.95.197 with SMTP id t188mr752738pgb.169.1503724489935; Fri, 25 Aug 2017 22:14:49 -0700 (PDT) Received: from localhost.localdomain (c-73-223-93-234.hsd1.ca.comcast.net. [73.223.93.234]) by smtp.gmail.com with ESMTPSA id m10sm13845770pgd.62.2017.08.25.22.14.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 25 Aug 2017 22:14:49 -0700 (PDT) From: Liam Breck To: Sebastian Reichel , linux-pm@vger.kernel.org Cc: Tony Lindgren , Hans de Goede , Rob Herring , devicetree@vger.kernel.org, Liam Breck Subject: [PATCH v3 2/5] devicetree: power: Add docs for TI BQ24190 battery charger Date: Fri, 25 Aug 2017 22:14:10 -0700 Message-Id: <20170826051413.24569-3-liam@networkimprov.net> X-Mailer: git-send-email 2.13.2 In-Reply-To: <20170826051413.24569-1-liam@networkimprov.net> References: <20170826051413.24569-1-liam@networkimprov.net> Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Liam Breck Document monitored-battery and ti,system-minimum-microvolt properties. Cc: Rob Herring Cc: devicetree@vger.kernel.org Signed-off-by: Liam Breck Acked-by: Tony Lindgren --- .../devicetree/bindings/power/supply/bq24190.txt | 51 ++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/supply/bq24190.txt diff --git a/Documentation/devicetree/bindings/power/supply/bq24190.txt b/Documentation/devicetree/bindings/power/supply/bq24190.txt new file mode 100644 index 00000000..9e517d30 --- /dev/null +++ b/Documentation/devicetree/bindings/power/supply/bq24190.txt @@ -0,0 +1,51 @@ +TI BQ24190 Li-Ion Battery Charger + +Required properties: +- compatible: contains one of the following: + * "ti,bq24190" + * "ti,bq24192i" +- reg: integer, I2C address of the charger. +- interrupts[-extended]: configuration for charger INT pin. + +Optional properties: +- monitored-battery: phandle of battery characteristics devicetree node + The charger uses the following battery properties: + + precharge-current-microamp: maximum charge current during precharge + phase (typically 20% of battery capacity). + + charge-term-current-microamp: a charge cycle terminates when the + battery voltage is above recharge threshold, and the current is below + this setting (typically 10% of battery capacity). + See also Documentation/devicetree/bindings/power/supply/battery.txt +- ti,system-minimum-microvolt: when power is connected and the battery is below + minimum system voltage, the system will be regulated above this setting. + +Notes: +- Some circuit boards wire the chip's "OTG" pin high (enabling 500mA default + charge current on USB SDP ports, among other features). To simulate this on + boards that wire the pin to a GPIO, set a gpio-hog. + +Example: + + bat: battery { + compatible = "simple-battery"; + precharge-current-microamp = <256000>; + charge-term-current-microamp = <128000>; + // etc. + }; + + bq24190: charger@6a { + compatible = "ti,bq24190"; + reg = <0x6a>; + interrupts-extended = <&gpiochip 10 IRQ_TYPE_EDGE_FALLING>; + monitored-battery = <&bat>; + ti,system-minimum-microvolt = <3200000>; + }; + + &twl_gpio { + otg { + gpio-hog; + gpios = <6 0>; + output-high; + line-name = "otg-gpio"; + }; + };