From patchwork Mon Nov 14 08:20:51 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: ChiYuan Huang X-Patchwork-Id: 19591 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp2030312wru; Mon, 14 Nov 2022 00:22:44 -0800 (PST) X-Google-Smtp-Source: AA0mqf6DoUSY0n8xDeM+KPiveQrHFAJyQbJY2PSx6SnJJkycLFa513Jy9L25dKC7f1kLdNKqNfqk X-Received: by 2002:a17:906:d82:b0:7ad:8a7a:2343 with SMTP id m2-20020a1709060d8200b007ad8a7a2343mr9285734eji.225.1668414164140; Mon, 14 Nov 2022 00:22:44 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668414164; cv=none; d=google.com; s=arc-20160816; b=Kgc6SQbYkypLT6Pu0vs48KsehHLO7Jl2HVwU5fYNioPiQPSKpni96Zoyg54IwASzp1 JJcSy6JWXuovHY6gIueCkOyeN9ci7V0HfNd2M/R7p10audpv+2QTu0kW/qHPBMqOnimS 7S7+AkYBoj3fBAvGANnsE8lt3vAyr7HwyKNWE0QOvCWZYwQ0xDUwkBAhyMI5CYpglGIj FPt6nP6YTBkVw5PSwXOPgVKirO6Ti19aYLFxV0yakSdYYVKTdLFONaYtJI6TI4FelDai /KkWoOQuiUXw5kz7lyWZOFtFt/dHpGJtk3th818+9IQ5bNM1+nURnXc1La0CevritwZe uCuQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from:dkim-signature; bh=6i4HyMglMaC/4c5RfmowST4xc1PHu7ajiLvUodJVrVY=; b=JweTE17fHQxEfApeeNa1fQ426CAXaBDE6ZdQSq7yNOVuCWrRe/hO6TKAOQYBeIvgLq l2oLWwPUQUGaUtn0e7OjD/ck2c7TsSb4bU73xeGcA7vMZAmPAFoAUIv5PHT+LmShiTTQ g+kndhBdiM+MhoOeEj8QmdurEbJVTRJNtA6vn9u0fLphZMDWMOMBoy7g94aF8NP6jkYa BLmDepRoPbG5mlcP8P3uCeKWgvbB7D7sotxnBbE3CMA4Dq14LmZM14J93rSfvD+Ivsdh RJ5jqCrDUXrEpwCVkiiNEkdt+69X9K9C8QvKYP6qYzeFi37xH3DdHtHqV7kbeAofsmYK hN8g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=jOdMhJuY; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ht13-20020a170907608d00b0078d93325645si8338600ejc.405.2022.11.14.00.22.20; Mon, 14 Nov 2022 00:22:44 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=jOdMhJuY; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236340AbiKNIVM (ORCPT + 99 others); Mon, 14 Nov 2022 03:21:12 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39882 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236320AbiKNIVE (ORCPT ); Mon, 14 Nov 2022 03:21:04 -0500 Received: from mail-pj1-x102d.google.com (mail-pj1-x102d.google.com [IPv6:2607:f8b0:4864:20::102d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E8FC51A822; Mon, 14 Nov 2022 00:21:03 -0800 (PST) Received: by mail-pj1-x102d.google.com with SMTP id d59-20020a17090a6f4100b00213202d77e1so13074143pjk.2; Mon, 14 Nov 2022 00:21:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from:from:to :cc:subject:date:message-id:reply-to; bh=6i4HyMglMaC/4c5RfmowST4xc1PHu7ajiLvUodJVrVY=; b=jOdMhJuYaPrfNRDkA04X8vm6WQ51WFHC4rY2fzCMDJiMqFzMXeLcNhuU7D/BKv7J7K wfK6wBIHtz+d4SNSubMZ4LldPF8xxxtDC+N4CSXygPkdm9vvIV9NX5yi0PvfCI/KFMwQ ejDzxS9FRJ59lWeZ7+p17YGamRE1Q12AG02Ad1S33TBKI/E4E1P56c289gyeq2K8oLAD PprLPyWdQo1XiZJOeDy3p3x2FROksDrero1v3BKL/Z2CFevo4zkRKQftZLG3TL6UDFdT MT+7wf8rndh/WkBSUh4Ia5JsXuaTDE7WTK2aVFuBZNVWLAnn0fx36ARzCIB3RF9cUohi 9KYg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=6i4HyMglMaC/4c5RfmowST4xc1PHu7ajiLvUodJVrVY=; b=H3arnuXN0C1rMFs7KfeMgawaHFjQelwUq068R23asZgRfciZd8A2Z/goNMF1GI7wJd 2ZO6d2VSHUYN8NUv/Ii8DtBGBkbfj7Ot/7aR79sw5pHJL60ny0tUcXha2880a+vO+bNC LTfSlbartAvwfem0r0H0OKOiLFEa/Q3/zHhTb1USWtPX3g0egjSQ44256Xg1YjbOQU3R kmsj+RZIBg/5HlcHx1Mdi6RpWtx8RlgnBH8OjBnGTqmDeRgRDRQuCitTwllP4qSm8KUN MiTbpeAXX7I9i57W8V3uIFBZEXKkzoMWROiUyJv+O8HaYSVltaIeSpNlzBkNxSjLnPsw asbw== X-Gm-Message-State: ANoB5pkJ7LWvL0lul8sq1IWrPo4uZZ/FVXk/PSNM1+NqI4Wj6V1S+I6w VAiA6b7iBWFbPAzTK2LtISg= X-Received: by 2002:a17:902:70ca:b0:188:b35e:c787 with SMTP id l10-20020a17090270ca00b00188b35ec787mr9916613plt.76.1668414063271; Mon, 14 Nov 2022 00:21:03 -0800 (PST) Received: from localhost.localdomain ([2402:7500:487:fe99:8803:61a2:a857:2b40]) by smtp.gmail.com with ESMTPSA id o38-20020a634e66000000b004639c772878sm5419997pgl.48.2022.11.14.00.21.00 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 14 Nov 2022 00:21:02 -0800 (PST) From: cy_huang To: robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, sre@kernel.org Cc: cy_huang@richtek.com, allen_chiang@richtek.com, linux-pm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 1/3] dt-bindings: power: supply: Add Richtek RT9759 smart cap divider charger Date: Mon, 14 Nov 2022 16:20:51 +0800 Message-Id: <1668414053-32728-2-git-send-email-u0084500@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1668414053-32728-1-git-send-email-u0084500@gmail.com> References: <1668414053-32728-1-git-send-email-u0084500@gmail.com> X-Spam-Status: No, score=-1.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749459050468201696?= X-GMAIL-MSGID: =?utf-8?q?1749459050468201696?= From: ChiYuan Huang Add bindings for the Richtek RT9759 smart cap divider charger. Signed-off-by: ChiYuan Huang Reviewed-by: Rob Herring --- Since v2 - Add Reviewed-by tag for dt-binding patch --- .../bindings/power/supply/richtek,rt9759.yaml | 61 ++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/supply/richtek,rt9759.yaml diff --git a/Documentation/devicetree/bindings/power/supply/richtek,rt9759.yaml b/Documentation/devicetree/bindings/power/supply/richtek,rt9759.yaml new file mode 100644 index 00000000..04fc6b0 --- /dev/null +++ b/Documentation/devicetree/bindings/power/supply/richtek,rt9759.yaml @@ -0,0 +1,61 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/power/supply/richtek,rt9759.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Richtek RT9759 Smart Cap Divider Charger + +maintainers: + - ChiYuan Huang + +description: | + The RT9759 is a high efficiency and high charge current charger. + The efficiency is up to 97.8% when VBAT = 4.2V, IBAT = 2.5A and the maximum + charge current is up to 8A. The device integrates smart cap divider topology + with dual phase charge pump core. The ADCs provide input and output voltage, + current and temperature information to monitor the whole charging process. + + Datasheet is available at + https://www.richtek.com/assets/product_file/RT9759/DS9759-02.pdf + +properties: + compatible: + enum: + - richtek,rt9759 + + reg: + maxItems: 1 + + wakeup-source: true + + interrupts: + maxItems: 1 + + shunt-resistor-micro-ohms: + description: Battery current sense resistor mounted. + default: 2000 + +required: + - compatible + - reg + - wakeup-source + - interrupts + +additionalProperties: false + +examples: + - | + #include + i2c { + #address-cells = <1>; + #size-cells = <0>; + + charger@66 { + compatible = "richtek,rt9759"; + reg = <0x66>; + wakeup-source; + interrupts-extended = <&gpio_intc 32 IRQ_TYPE_EDGE_FALLING>; + shunt-resistor-micro-ohms = <5000>; + }; + }; From patchwork Mon Nov 14 08:20:52 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: ChiYuan Huang X-Patchwork-Id: 19592 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp2030430wru; Mon, 14 Nov 2022 00:23:01 -0800 (PST) X-Google-Smtp-Source: AA0mqf6sb5dPzMBsPhJ5WlWKnG+JCsM1UmuO5kOzch9Iw8IdMObqi6+FwGj5Ui3m9Wc8ehygRkV5 X-Received: by 2002:a17:906:3a9b:b0:7ad:dc7e:1b8d with SMTP id y27-20020a1709063a9b00b007addc7e1b8dmr9251840ejd.276.1668414181137; Mon, 14 Nov 2022 00:23:01 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668414181; cv=none; d=google.com; s=arc-20160816; b=dBi4m3EcHo72AgK66kGeQ9r/m4v4QaPKTyE3WJ4AfFtU+aSe0VdI3JlE7sSyhiTsHM PKNw/tcf+96E1aEvV7ReFUIj8o73hV8VBy4+R9H8+Ct4pm5nLQyfOa163F3Fmwamt4km NabcO4iNd2uob7sm+8l5pc3pqnqXh0dOWQzkrb4L1Uw159ruQ1vNCK39tnPPsPZBz9c/ eeGiqsPLPROh+HdIWxoXVoTeKbhbAskWIyVaiJqUnqwgteKUNhjezRqooZsvE8nMIwOJ peDrh5o7R9QKTpAxE2r1aocPMT7imT16dh4zMfnE/LG6EUahqvx84BwmXc1Cgvn5Tek3 1EGg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from:dkim-signature; bh=Si7pCuua36zuQLwZpLhn7M+5lj1NDgXqu2zXkco5e0I=; b=xzGkIRQVdeWp6P94gGRdIbqJNihkuxLIhAH6NwPvknrYOv2ygQKIbYEwBSAc5BH33H MhNv6T6H0OmBPre+Ui043bWd6nHgcW9qzVh2sLyNf/Xc4v7tX34MJmPGadtFZ8+2JCSN 6Hm6yq7wqOvNNHLvkVHDvCQMg3YF21ujxjvtSQ5nCW0aBlCRw8IxDSJrOwvYIjfxaX6e wJCuNrcaEHg21U0JTPUahh7MLGOGIMzQXUC0e7fPr0Y2PN+kek0fjdefIrtiqmltTOXS 3rgDVgFYTskdySDrnZ7252whFUVwBD/QMSPei0JEY4hm/oN3xWTRvasSrCyI4t7Qvtbs Y+hg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=GH5oquvD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id qt13-20020a170906eced00b00770d9e664f8si7125904ejb.152.2022.11.14.00.22.38; Mon, 14 Nov 2022 00:23:01 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=GH5oquvD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236345AbiKNIVQ (ORCPT + 99 others); Mon, 14 Nov 2022 03:21:16 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40110 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236317AbiKNIVI (ORCPT ); Mon, 14 Nov 2022 03:21:08 -0500 Received: from mail-pj1-x1035.google.com (mail-pj1-x1035.google.com [IPv6:2607:f8b0:4864:20::1035]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5B32E1A827; Mon, 14 Nov 2022 00:21:07 -0800 (PST) Received: by mail-pj1-x1035.google.com with SMTP id b11so9683750pjp.2; Mon, 14 Nov 2022 00:21:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from:from:to :cc:subject:date:message-id:reply-to; bh=Si7pCuua36zuQLwZpLhn7M+5lj1NDgXqu2zXkco5e0I=; b=GH5oquvD3XcdZEWo+7I849Pu8WHNIVT3bO1zq8ZL/hzf7RrniZBOlth/dliVOn96uo whgFtS+EJSnYAQL0hzNIeqdf/lSyFMwc7B9nv+bHPZKSPtLkjmNEZb00b4tRNrBSlQPk 6MZTfHPTGk3MXko7eBhRXhcNBt5TvmK5Imr+lAyWeRlbEUYqGhKgUN1qkty96eTEXmEi c6whJDNlXWeGye4DgbOYq3Gvj5JG/F0oItrJCMioW9DzlVIUlu8YJy4NXxPLgP0hJ/bO q0HuNcWgr3TJD9Bk8vgBlm8FA6RlD2ylxgVZhmrfOIlQtysEUJ7piSFgTOSW+2Oyl9Rd Qkhg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Si7pCuua36zuQLwZpLhn7M+5lj1NDgXqu2zXkco5e0I=; b=l5tBK7x3wwPHA/z2DBR1LniizLvhC48AtiTERseUqtURC20KJs6GjQcbYHzTYho4ez a3Xq/r/AMfJlbqpxLMxUal8KDcOPd96D/oh08vU7ip6XbRBOEPrx9SJh6CZ9CPynJBC3 4l2vYFx1r144ekfwW3LMKyN7Hjf4mKuqN9i1PQQzJiyDj55PQIERCwsskqcZZo0yqzaz eIqwkqGqJu9f96oQWOZPJXFG/ZXKklzCqywxx9BrDK+Z2+0LNe0ZqmPHyc0WtDm0fIG8 MEV4iG3mSZE8m3T3UYE2rIOQF8tDZZZVZJfrNQKgD5nQWk9PQr0CdfJ97oCdhzKnNyeP iD3g== X-Gm-Message-State: ANoB5pnxf574+Oa4c3+QnMBivzcIl7+ofmcCdqWOl6fOs5qQzZU0sKo/ WAGsn8dRflE1edWKVDRl5H4= X-Received: by 2002:a17:902:7443:b0:186:e2c3:91c6 with SMTP id e3-20020a170902744300b00186e2c391c6mr12223565plt.27.1668414066654; Mon, 14 Nov 2022 00:21:06 -0800 (PST) Received: from localhost.localdomain ([2402:7500:487:fe99:8803:61a2:a857:2b40]) by smtp.gmail.com with ESMTPSA id o38-20020a634e66000000b004639c772878sm5419997pgl.48.2022.11.14.00.21.03 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 14 Nov 2022 00:21:06 -0800 (PST) From: cy_huang To: robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, sre@kernel.org Cc: cy_huang@richtek.com, allen_chiang@richtek.com, linux-pm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 2/3] power: supply: rt9759: Add Richtek RT9759 smart cap divider charger Date: Mon, 14 Nov 2022 16:20:52 +0800 Message-Id: <1668414053-32728-3-git-send-email-u0084500@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1668414053-32728-1-git-send-email-u0084500@gmail.com> References: <1668414053-32728-1-git-send-email-u0084500@gmail.com> X-Spam-Status: No, score=-1.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749459068151201415?= X-GMAIL-MSGID: =?utf-8?q?1749459068151201415?= From: ChiYuan Huang Add support for RT9759 smart cap divider charger. The RT9759 is a high efficiency and high charge current charger. The maximum charge current is up to 8A. It integrates a dual-phase charge pump core with ADC monitoring. Co-developed-by: Allen Chiang Signed-off-by: Allen Chiang Signed-off-by: ChiYuan Huang --- Since v3: - Fix patch title typo (from 'rt9471' to 'rt9759') - Remove unused R_VAC_OVP range. - Refer to ABI document, use 'status' to control battery charging, not 'online' - Refer to ABI document, use 'online' to indicate bus state Since v2: No change --- drivers/power/supply/Kconfig | 15 ++ drivers/power/supply/Makefile | 1 + drivers/power/supply/rt9759.c | 613 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 629 insertions(+) create mode 100644 drivers/power/supply/rt9759.c diff --git a/drivers/power/supply/Kconfig b/drivers/power/supply/Kconfig index 0bbfe6a..2f24f29 100644 --- a/drivers/power/supply/Kconfig +++ b/drivers/power/supply/Kconfig @@ -785,6 +785,21 @@ config BATTERY_RT5033 The fuelgauge calculates and determines the battery state of charge according to battery open circuit voltage. +config CHARGER_RT9759 + tristate "Richtek RT9759 smart cap divider charger driver" + depends on I2C + select REGMAP_I2C + select LINEAR_RANGES + help + This adds support for Richtek RT9759 smart cap divider charger driver. + It's a high efficiency and high charge current charger. the device + integrates smart cap divider topology with 9-channel high speed + ADCs that can provide input and output voltage, current and + temperature monitoring. + + This driver can also be built as a module. If so, the module will be + called rt9759. + config CHARGER_RT9455 tristate "Richtek RT9455 battery charger driver" depends on I2C diff --git a/drivers/power/supply/Makefile b/drivers/power/supply/Makefile index 0ee8653..b872c06 100644 --- a/drivers/power/supply/Makefile +++ b/drivers/power/supply/Makefile @@ -56,6 +56,7 @@ obj-$(CONFIG_BATTERY_MAX17042) += max17042_battery.o obj-$(CONFIG_BATTERY_MAX1721X) += max1721x_battery.o obj-$(CONFIG_BATTERY_Z2) += z2_battery.o obj-$(CONFIG_BATTERY_RT5033) += rt5033_battery.o +obj-$(CONFIG_CHARGER_RT9759) += rt9759.o obj-$(CONFIG_CHARGER_RT9455) += rt9455_charger.o obj-$(CONFIG_BATTERY_S3C_ADC) += s3c_adc_battery.o obj-$(CONFIG_BATTERY_TWL4030_MADC) += twl4030_madc_battery.o diff --git a/drivers/power/supply/rt9759.c b/drivers/power/supply/rt9759.c new file mode 100644 index 00000000..fd9bdae --- /dev/null +++ b/drivers/power/supply/rt9759.c @@ -0,0 +1,613 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * Copyright (C) 2022 Richtek Technology Corp. + * + * Authors: Allen Chiang + * ChiYuan Huang + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define RT9759_REG_VBATOVP 0x00 +#define RT9759_REG_IBATOCP 0x02 +#define RT9759_REG_VBUSOVP 0x06 +#define RT9759_REG_IBUSOCPUCP 0x08 +#define RT9759_REG_CONVST 0x0A +#define RT9759_REG_CHGCTL0 0x0B +#define RT9759_REG_CHGCTL1 0x0C +#define RT9759_REG_INTSTAT 0x0D +#define RT9759_REG_FLTFLAG 0x11 +#define RT9759_REG_DEVINFO 0x13 +#define RT9759_REG_ADCCTL 0x14 +#define RT9759_REG_IBUSADC 0x16 +#define RT9759_REG_REGCTL 0x2B +#define RT9759_REG_OTHER4 0x33 + +#define RT9759_VBUSUCP_MASK BIT(4) +#define RT9759_TDIEOTP_MASK BIT(7) +#define RT9759_WDT_MASK BIT(3) +#define RT9759_BUSBATOVP_MASK (BIT(7) | BIT(5)) +#define RT9759_BUSBATOCP_MASK (BIT(6) | BIT(4)) +#define RT9759_ADCEN_MASK BIT(7) +#define RT9759_ADCONCE_MASK BIT(6) + +#define RT9759_DEVID 0x08 +#define RT9759_ADC_CONVTIME 2000 +#define RT9759_ADC_MAXWAIT 16000 + +enum rt9759_adc_chan { + ADC_IBUS = 0, + ADC_VBUS, + ADC_VAC, + ADC_VOUT, + ADC_VBAT, + ADC_IBAT, + ADC_TSBUS, + ADC_TSBAT, + ADC_TDIE, + ADC_MAX_CHANNEL +}; + +enum rt9759_fields { + F_VBATOVP = 0, + F_IBATOCP, + F_VBUSOVP, + F_IBUSOCP, + F_SWITCHING, + F_REG_RST, + F_WDT_DIS, + F_WDT_TMR, + F_CHG_EN, + F_VAC_INSERT, + F_DEV_ID, + F_ADC_EN, + F_IBAT_RSEN, + F_MAX_FIELD +}; + +enum rt9759_ranges { + R_VBATOVP = 0, + R_IBATOCP, + R_VBUSOVP, + R_IBUSOCP, + R_MAX_RANGE +}; + +static const struct reg_field rt9759_chg_fields[F_MAX_FIELD] = { + [F_VBATOVP] = REG_FIELD(RT9759_REG_VBATOVP, 0, 5), + [F_IBATOCP] = REG_FIELD(RT9759_REG_IBATOCP, 0, 6), + [F_VBUSOVP] = REG_FIELD(RT9759_REG_VBUSOVP, 0, 6), + [F_IBUSOCP] = REG_FIELD(RT9759_REG_IBUSOCPUCP, 0, 3), + [F_SWITCHING] = REG_FIELD(RT9759_REG_CONVST, 2, 2), + [F_REG_RST] = REG_FIELD(RT9759_REG_CHGCTL0, 7, 7), + [F_WDT_DIS] = REG_FIELD(RT9759_REG_CHGCTL0, 2, 2), + [F_WDT_TMR] = REG_FIELD(RT9759_REG_CHGCTL0, 0, 1), + [F_CHG_EN] = REG_FIELD(RT9759_REG_CHGCTL1, 7, 7), + [F_VAC_INSERT] = REG_FIELD(RT9759_REG_INTSTAT, 2, 2), + [F_DEV_ID] = REG_FIELD(RT9759_REG_DEVINFO, 0, 3), + [F_ADC_EN] = REG_FIELD(RT9759_REG_ADCCTL, 7, 7), + [F_IBAT_RSEN] = REG_FIELD(RT9759_REG_REGCTL, 1, 1), +}; + +/* All converted to microvolt or microamp */ +static const struct linear_range rt9759_chg_ranges[R_MAX_RANGE] = { + LINEAR_RANGE_IDX(R_VBATOVP, 3500000, 0, 63, 25000), + LINEAR_RANGE_IDX(R_IBATOCP, 2000000, 0, 80, 100000), + LINEAR_RANGE_IDX(R_VBUSOVP, 6000000, 0, 127, 50000), + LINEAR_RANGE_IDX(R_IBUSOCP, 1000000, 0, 15, 250000), +}; + +struct charger_event { + unsigned int ucp_flag; + unsigned int conv_flag; + unsigned int wdt_flag; + unsigned int flt_flag; +}; + +struct rt9759_data { + struct device *dev; + struct regmap *regmap; + struct regmap_field *rm_fields[F_MAX_FIELD]; + struct power_supply *psy; + struct mutex adc_lock; + struct power_supply_desc psy_desc; + struct charger_event chg_evt; + unsigned int rg_resistor; + unsigned int real_resistor; +}; + +static int rt9759_get_value_by_field_range(struct rt9759_data *data, + enum rt9759_fields field, + enum rt9759_ranges rsel, int *val) +{ + const struct linear_range *range = rt9759_chg_ranges + rsel; + unsigned int sel; + int ret; + + ret = regmap_field_read(data->rm_fields[field], &sel); + if (ret) + return ret; + + return linear_range_get_value(range, sel, val); +} + +static int rt9759_set_value_by_field_range(struct rt9759_data *data, + enum rt9759_fields field, + enum rt9759_ranges rsel, int val) +{ + const struct linear_range *range = rt9759_chg_ranges + rsel; + unsigned int sel; + + linear_range_get_selector_within(range, val, &sel); + return regmap_field_write(data->rm_fields[field], sel); +} + +static int rt9759_get_adc(struct rt9759_data *data, enum rt9759_adc_chan chan, + int *val) +{ + struct regmap *regmap = data->regmap; + unsigned int reg_addr = RT9759_REG_IBUSADC + chan * 2; + unsigned int mask = RT9759_ADCEN_MASK | RT9759_ADCONCE_MASK; + unsigned int adc_cntl; + __be16 raws; + int scale, ret; + + mutex_lock(&data->adc_lock); + + ret = regmap_update_bits(regmap, RT9759_REG_ADCCTL, mask, mask); + if (ret) + goto adc_unlock; + + ret = regmap_read_poll_timeout(regmap, RT9759_REG_ADCCTL, adc_cntl, + !(adc_cntl & RT9759_ADCEN_MASK), + RT9759_ADC_CONVTIME, RT9759_ADC_MAXWAIT); + if (ret && ret != -ETIMEDOUT) + goto adc_unlock; + + ret = regmap_raw_read(regmap, reg_addr, &raws, sizeof(raws)); + if (ret) + goto adc_unlock; + + /* + * TDIE LSB 0.5'c, others LSB 1000uV or 1000uA. + * Rsense ratio is needed for IBAT channel + */ + if (chan == ADC_TDIE) + scale = 5; + else if (chan == ADC_IBAT) + scale = 1000 * data->rg_resistor / data->real_resistor; + else + scale = 1000; + + + *val = be16_to_cpu(raws) * scale; + +adc_unlock: + regmap_update_bits(regmap, RT9759_REG_ADCCTL, mask, 0); + + mutex_unlock(&data->adc_lock); + + return ret; +} + +static int rt9759_get_switching_state(struct rt9759_data *data, int *status) +{ + unsigned int switching_state; + int ret; + + ret = regmap_field_read(data->rm_fields[F_SWITCHING], &switching_state); + if (ret) + return ret; + + if (switching_state) + *status = POWER_SUPPLY_STATUS_CHARGING; + else + *status = POWER_SUPPLY_STATUS_NOT_CHARGING; + + return 0; +} + +static int rt9759_get_charger_health(struct rt9759_data *data) +{ + struct charger_event *evt = &data->chg_evt; + + if (evt->ucp_flag & RT9759_VBUSUCP_MASK) + return POWER_SUPPLY_HEALTH_UNSPEC_FAILURE; + + if (evt->conv_flag & RT9759_TDIEOTP_MASK) + return POWER_SUPPLY_HEALTH_OVERHEAT; + + if (evt->wdt_flag & RT9759_WDT_MASK) + return POWER_SUPPLY_HEALTH_WATCHDOG_TIMER_EXPIRE; + + if (evt->flt_flag & RT9759_BUSBATOVP_MASK) + return POWER_SUPPLY_HEALTH_OVERVOLTAGE; + + if (evt->flt_flag & RT9759_BUSBATOCP_MASK) + return POWER_SUPPLY_HEALTH_OVERCURRENT; + + return POWER_SUPPLY_HEALTH_GOOD; +} + +static const char * const rt9759_manufacturer = "Richtek Technology Corp."; +static const char * const rt9759_model = "RT9759"; + +static int rt9759_psy_get_property(struct power_supply *psy, + enum power_supply_property psp, + union power_supply_propval *val) +{ + struct rt9759_data *data = power_supply_get_drvdata(psy); + int *pval = &val->intval; + + switch (psp) { + case POWER_SUPPLY_PROP_STATUS: + return rt9759_get_switching_state(data, pval); + case POWER_SUPPLY_PROP_HEALTH: + *pval = rt9759_get_charger_health(data); + return 0; + case POWER_SUPPLY_PROP_ONLINE: + return regmap_field_read(data->rm_fields[F_VAC_INSERT], pval); + case POWER_SUPPLY_PROP_VOLTAGE_MAX: + return rt9759_get_value_by_field_range(data, F_VBUSOVP, R_VBUSOVP, pval); + case POWER_SUPPLY_PROP_VOLTAGE_NOW: + return rt9759_get_adc(data, ADC_VBUS, pval); + case POWER_SUPPLY_PROP_CURRENT_MAX: + return rt9759_get_value_by_field_range(data, F_IBUSOCP, R_IBUSOCP, pval); + case POWER_SUPPLY_PROP_CURRENT_NOW: + return rt9759_get_adc(data, ADC_IBUS, pval); + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX: + return rt9759_get_value_by_field_range(data, F_VBATOVP, R_VBATOVP, pval); + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX: + return rt9759_get_value_by_field_range(data, F_IBATOCP, R_IBATOCP, pval); + case POWER_SUPPLY_PROP_TEMP: + return rt9759_get_adc(data, ADC_TDIE, pval); + case POWER_SUPPLY_PROP_MODEL_NAME: + val->strval = rt9759_model; + return 0; + case POWER_SUPPLY_PROP_MANUFACTURER: + val->strval = rt9759_manufacturer; + return 0; + default: + return -ENODATA; + } +} + +static int rt9759_psy_set_property(struct power_supply *psy, + enum power_supply_property psp, + const union power_supply_propval *val) +{ + struct rt9759_data *data = power_supply_get_drvdata(psy); + int intval = val->intval; + + switch (psp) { + case POWER_SUPPLY_PROP_STATUS: + /* Before enabled, clear stored event */ + if (intval) + memset(&data->chg_evt, 0, sizeof(data->chg_evt)); + + return regmap_field_write(data->rm_fields[F_CHG_EN], !!intval); + case POWER_SUPPLY_PROP_VOLTAGE_MAX: + return rt9759_set_value_by_field_range(data, F_VBUSOVP, R_VBUSOVP, intval); + case POWER_SUPPLY_PROP_CURRENT_MAX: + return rt9759_set_value_by_field_range(data, F_IBUSOCP, R_IBUSOCP, intval); + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX: + return rt9759_set_value_by_field_range(data, F_VBATOVP, R_VBATOVP, intval); + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX: + return rt9759_set_value_by_field_range(data, F_IBATOCP, R_IBATOCP, intval); + default: + return -EINVAL; + } +} + +static const enum power_supply_property rt9759_psy_properties[] = { + POWER_SUPPLY_PROP_STATUS, + POWER_SUPPLY_PROP_HEALTH, + POWER_SUPPLY_PROP_ONLINE, + POWER_SUPPLY_PROP_VOLTAGE_MAX, + POWER_SUPPLY_PROP_VOLTAGE_NOW, + POWER_SUPPLY_PROP_CURRENT_MAX, + POWER_SUPPLY_PROP_CURRENT_NOW, + POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX, + POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX, + POWER_SUPPLY_PROP_TEMP, + POWER_SUPPLY_PROP_MODEL_NAME, + POWER_SUPPLY_PROP_MANUFACTURER, +}; + +static int rt9759_psy_property_is_writeable(struct power_supply *psy, + enum power_supply_property psp) +{ + switch (psp) { + case POWER_SUPPLY_PROP_STATUS: + case POWER_SUPPLY_PROP_VOLTAGE_MAX: + case POWER_SUPPLY_PROP_CURRENT_MAX: + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX: + case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX: + return 1; + default: + return 0; + } +} + +static const unsigned int rt9759_wdt_millisecond[] = { 500, 1000, 5000, 30000 }; + +static ssize_t watchdog_timer_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct power_supply *psy = to_power_supply(dev); + struct rt9759_data *data = power_supply_get_drvdata(psy); + unsigned int wdt_tmr_now = 0, wdt_sel, wdt_dis; + int ret; + + ret = regmap_field_read(data->rm_fields[F_WDT_DIS], &wdt_dis); + if (ret) + return ret; + + if (!wdt_dis) { + ret = regmap_field_read(data->rm_fields[F_WDT_TMR], &wdt_sel); + if (ret) + return ret; + + wdt_tmr_now = rt9759_wdt_millisecond[wdt_sel]; + } + + return sysfs_emit(buf, "%d\n", wdt_tmr_now); +} + +static ssize_t watchdog_timer_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t count) +{ + struct power_supply *psy = to_power_supply(dev); + struct rt9759_data *data = power_supply_get_drvdata(psy); + unsigned int wdt_set, wdt_sel; + int ret; + + ret = kstrtouint(buf, 10, &wdt_set); + if (ret) + return ret; + + ret = regmap_field_write(data->rm_fields[F_WDT_DIS], 1); + if (ret) + return ret; + + wdt_sel = find_closest(wdt_set, rt9759_wdt_millisecond, + ARRAY_SIZE(rt9759_wdt_millisecond)); + + ret = regmap_field_write(data->rm_fields[F_WDT_TMR], wdt_sel); + if (ret) + return ret; + + if (wdt_set) { + ret = regmap_field_write(data->rm_fields[F_WDT_DIS], 0); + if (ret) + return ret; + } + + return count; +} + +static ssize_t battery_voltage_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct power_supply *psy = to_power_supply(dev); + struct rt9759_data *data = power_supply_get_drvdata(psy); + int vbat_now, ret; + + ret = rt9759_get_adc(data, ADC_VBAT, &vbat_now); + if (ret) + return ret; + + return sysfs_emit(buf, "%d\n", vbat_now); +} + +static ssize_t battery_current_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct power_supply *psy = to_power_supply(dev); + struct rt9759_data *data = power_supply_get_drvdata(psy); + int ibat_now, ret; + + ret = rt9759_get_adc(data, ADC_IBAT, &ibat_now); + if (ret) + return ret; + + return sysfs_emit(buf, "%d\n", ibat_now); +} + +static DEVICE_ATTR_RW(watchdog_timer); +static DEVICE_ATTR_RO(battery_voltage); +static DEVICE_ATTR_RO(battery_current); + +static struct attribute *rt9759_sysfs_attrs[] = { + &dev_attr_watchdog_timer.attr, + &dev_attr_battery_voltage.attr, + &dev_attr_battery_current.attr, + NULL +}; + +ATTRIBUTE_GROUPS(rt9759_sysfs); + +static int rt9759_register_psy(struct rt9759_data *data) +{ + struct device *dev = data->dev; + struct power_supply_desc *desc = &data->psy_desc; + struct power_supply_config cfg = {}; + char *psy_name; + + cfg.drv_data = data; + cfg.of_node = dev->of_node; + cfg.attr_grp = rt9759_sysfs_groups; + + psy_name = devm_kasprintf(dev, GFP_KERNEL, "rt9759-%s", dev_name(dev)); + if (!psy_name) + return -ENOMEM; + + desc->name = psy_name; + desc->type = POWER_SUPPLY_TYPE_USB; + desc->properties = rt9759_psy_properties; + desc->num_properties = ARRAY_SIZE(rt9759_psy_properties); + desc->property_is_writeable = rt9759_psy_property_is_writeable; + desc->get_property = rt9759_psy_get_property; + desc->set_property = rt9759_psy_set_property; + + data->psy = devm_power_supply_register(dev, desc, &cfg); + + return PTR_ERR_OR_ZERO(data->psy); +} + +static irqreturn_t rt9759_irq_handler(int irq, void *devid) +{ + struct rt9759_data *data = devid; + struct regmap *regmap = data->regmap; + struct charger_event *evt = &data->chg_evt; + int ret; + + ret = regmap_read(regmap, RT9759_REG_IBUSOCPUCP, &evt->ucp_flag); + if (ret) + return IRQ_NONE; + + ret = regmap_read(regmap, RT9759_REG_CONVST, &evt->conv_flag); + if (ret) + return IRQ_NONE; + + ret = regmap_read(regmap, RT9759_REG_CHGCTL0, &evt->wdt_flag); + if (ret) + return IRQ_NONE; + + ret = regmap_read(regmap, RT9759_REG_FLTFLAG, &evt->flt_flag); + if (ret) + return IRQ_NONE; + + power_supply_changed(data->psy); + + return IRQ_HANDLED; +} + +static int rt9759_config_batsense_resistor(struct rt9759_data *data) +{ + unsigned int shunt_resistor_uohms = 2000, rsense_sel; + + device_property_read_u32(data->dev, "shunt-resistor-micro-ohms", + &shunt_resistor_uohms); + + if (!shunt_resistor_uohms || shunt_resistor_uohms > 5000) + return -EINVAL; + + data->real_resistor = shunt_resistor_uohms; + + if (shunt_resistor_uohms <= 2000) { + rsense_sel = 0; + data->rg_resistor = 2000; + } else { + rsense_sel = 1; + data->rg_resistor = 5000; + } + + return regmap_field_write(data->rm_fields[F_IBAT_RSEN], rsense_sel); +} + +static const struct reg_sequence rt9759_init_regs[] = { + REG_SEQ(0x0B, 0x80, 1000), /* REG_RESET */ + REG_SEQ0(0x05, 0x00), /* VAC_OVP = 11V */ + REG_SEQ0(0x0B, 0x44), /* WDT_DIS = 1 */ + REG_SEQ0(0x0C, 0x06), /* TSBUS/TSBAT OTP_DIS = 1 */ + REG_SEQ0(0x0F, 0xF9), /* DIS ALARM & ADC_DONE */ + REG_SEQ0(0x14, 0x00), /* IBUS_ADC_DIS = 0 */ +}; + +static const struct regmap_config rt9759_regmap_config = { + .reg_bits = 8, + .val_bits = 8, + .max_register = RT9759_REG_OTHER4, +}; + +static int rt9759_probe(struct i2c_client *i2c) +{ + struct device *dev = &i2c->dev; + struct rt9759_data *data; + struct regmap *regmap; + unsigned int devid; + int ret; + + data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL); + if (!data) + return -ENOMEM; + + data->dev = dev; + mutex_init(&data->adc_lock); + i2c_set_clientdata(i2c, data); + + regmap = devm_regmap_init_i2c(i2c, &rt9759_regmap_config); + if (IS_ERR(regmap)) + return dev_err_probe(dev, PTR_ERR(regmap), "Failed to init regmap\n"); + + data->regmap = regmap; + + ret = devm_regmap_field_bulk_alloc(dev, regmap, data->rm_fields, + rt9759_chg_fields, + ARRAY_SIZE(rt9759_chg_fields)); + if (ret) + return dev_err_probe(dev, ret, "Failed to alloc regmap fields\n"); + + ret = regmap_field_read(data->rm_fields[F_DEV_ID], &devid); + if (ret) + return dev_err_probe(dev, ret, "Filaed to read devid\n"); + + if (devid != RT9759_DEVID) + return dev_err_probe(dev, -ENODEV, "Incorrect VID 0x%02x\n", devid); + + ret = regmap_register_patch(regmap, rt9759_init_regs, + ARRAY_SIZE(rt9759_init_regs)); + if (ret) + return dev_err_probe(dev, ret, "Failed to init registers\n"); + + ret = rt9759_config_batsense_resistor(data); + if (ret) + return dev_err_probe(dev, ret, "Failed to config batsense resistor\n"); + + ret = rt9759_register_psy(data); + if (ret) + return dev_err_probe(dev, ret, "Failed to init power supply\n"); + + return devm_request_threaded_irq(dev, i2c->irq, NULL, rt9759_irq_handler, + IRQF_ONESHOT, dev_name(dev), data); +} + +static void rt9759_shutdown(struct i2c_client *i2c) +{ + struct rt9759_data *data = i2c_get_clientdata(i2c); + + regmap_field_write(data->rm_fields[F_REG_RST], 1); +} + +static const struct of_device_id rt9759_device_match_table[] = { + { .compatible = "richtek,rt9759" }, + {} +}; +MODULE_DEVICE_TABLE(of, rt9759_device_match_table); + +static struct i2c_driver rt9759_charger_driver = { + .driver = { + .name = "rt9759", + .of_match_table = rt9759_device_match_table, + }, + .probe_new = rt9759_probe, + .shutdown = rt9759_shutdown, +}; +module_i2c_driver(rt9759_charger_driver); + +MODULE_DESCRIPTION("Richtek RT9759 charger driver"); +MODULE_AUTHOR("Allen Chiang "); +MODULE_AUTHOR("ChiYuan Huang "); +MODULE_LICENSE("GPL"); From patchwork Mon Nov 14 08:20:53 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: ChiYuan Huang X-Patchwork-Id: 19593 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp2030481wru; Mon, 14 Nov 2022 00:23:07 -0800 (PST) X-Google-Smtp-Source: AA0mqf6VFPQcmwa0T8bEzwFn7BCxF67Ob2+HDyGGNsyXIzvEprqu3r+f/fhwIjW1+rI4n5yN5QGu X-Received: by 2002:a17:906:a1d3:b0:78d:9022:f146 with SMTP id bx19-20020a170906a1d300b0078d9022f146mr9109499ejb.656.1668414187732; Mon, 14 Nov 2022 00:23:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668414187; cv=none; d=google.com; s=arc-20160816; b=zPm0RA7z/a2WFA/4xtiDDPvxAtt7NhkI/9/pzL36H33QgBNo+OBAB06vfe5DP5n2XX ShsoMgPLLCNhrg+f7zq3LNe2mseGML2ak9vdG3+pglD1d2Oic6syMVRn2aCf9+82a/z/ edYiT9A/Cuslkz9ErAb1HYnO7AwEh7GQe7n8rlDZnRyPzP63Oe2PGIETAvuniu2xuiq+ cQzuxomB5jU2fewlSDkueANSHbLUiN0IMmq1JuAAr89rv4Osxt92rhMs5VqfhYTWKq1f He2/pYSbPzSkDM9u2AUiQ9JXqyzMIkADdIXV/0d4ZBXJ5YMX9iq5nsDCTGZtS/IFq4Mu 4u9g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from:dkim-signature; bh=WDpwxLGYQHucsjbGGxsVmJprs34jMYlaaLdB2Tw2WYk=; b=IaaL+K7E4S06Ep/EAu3h6QDL5TPRkjXpezz4qVEAxQNL7ioxhJgM/5Mu2hPxythiJX yvaCvFtvbYM1HyKXp0i2U96ndai4HYozKPaVmiyUyz5oeiGGkhy0pw0DKdtRNz34xM3E fR/ZcaYT142W7KV4yg8Cyk7iYOSg7fohI8txeO0zzMYh4xgbhrs8Ylp9K3Y2zJjSBzLD 9xx4HR03uffiXm7mmzDMYVzQlR7JNFKF61FfS+NaoCScfJiqMYMS2wMcUH+tNbt7IHD3 FmlQQbCq3QyN2naO5qUHvq1+53nF/ejR5iW4diSUOkhsGVNFEM+FL/kIl9DfyQfxDT7E tiXA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=e2vJRow3; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id dc26-20020a170906c7da00b0077b6ecac099si6045266ejb.287.2022.11.14.00.22.44; Mon, 14 Nov 2022 00:23:07 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=e2vJRow3; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236384AbiKNIVd (ORCPT + 99 others); Mon, 14 Nov 2022 03:21:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40252 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236352AbiKNIVO (ORCPT ); Mon, 14 Nov 2022 03:21:14 -0500 Received: from mail-pl1-x634.google.com (mail-pl1-x634.google.com [IPv6:2607:f8b0:4864:20::634]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 70D451AF03; Mon, 14 Nov 2022 00:21:10 -0800 (PST) Received: by mail-pl1-x634.google.com with SMTP id p21so9398220plr.7; Mon, 14 Nov 2022 00:21:10 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from:from:to :cc:subject:date:message-id:reply-to; bh=WDpwxLGYQHucsjbGGxsVmJprs34jMYlaaLdB2Tw2WYk=; b=e2vJRow3dF2A/9HFreVhoneMvppmyICDUnFXXVJwhbM7Ztoc7/m7YVnv4Qon7fFe96 FQk7Kl27px0mDAh3kOYwZzuHglRCUG0RrrLH6UWJWDA2EJmwY82+Qhn73WAuevRSl5Nf QCyTDZu6x4NYxo21NjMeWoYwP2Y7qkBwaOfM7rlD/Yj48ey7CPXKreBr4afOMRGNIXBP Ypj0hfAGn3ZUIcehmxIxu8Reqh5aBjiftXIoyiOC4eZ6kCOiHjoQKjRv+OvpiQ2VD3ym 226r3d5xJRT1Gi+0Hb0W/Ca1VGXhxUnjFDBvAFj1RSmO6V3peovIH5rvTLJd4HKi2Cri sPCw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=references:in-reply-to:message-id:date:subject:cc:to:from :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=WDpwxLGYQHucsjbGGxsVmJprs34jMYlaaLdB2Tw2WYk=; b=Z/o2olfzACmQIQJTpwRZpjYstJ25JHgFvjnNe4LnT3CJn30mugSpWgz5QA6LEJ05rw k+hApP0d0sv4/v/oa+K88sEJO7px9YSGpZiEeuPvMV1mfddTFPv8kK/wwvXxVtX4X/0S VEDbtyfqACjKW1D+uJULxldaMfgRXPshkNsJA+GsrXXTrNHqbZYUPiefmS7axMpBc5sM 97nWA6KI2Ae+vOfL3O9+W5nfGmP9P65syoU5iJTEa2OUPx8GmwjCnF01RpHsOxAk5KcF yRDjUYA3HhkKxQObP6M9FvasJp5BvZz0GpjHq09q0W/hfjg4cR/2b7ZEzCIPqaqUfu/x ik5g== X-Gm-Message-State: ANoB5pkxhUJ2U7Ju2N2DLinRvmN76QcwMqzHYfBaL56GQHIa15IPGYQb gu9ZFkISgikoJqUNSbqCAfc= X-Received: by 2002:a17:902:9a4a:b0:188:8e14:b4df with SMTP id x10-20020a1709029a4a00b001888e14b4dfmr12327323plv.136.1668414069875; Mon, 14 Nov 2022 00:21:09 -0800 (PST) Received: from localhost.localdomain ([2402:7500:487:fe99:8803:61a2:a857:2b40]) by smtp.gmail.com with ESMTPSA id o38-20020a634e66000000b004639c772878sm5419997pgl.48.2022.11.14.00.21.06 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 14 Nov 2022 00:21:09 -0800 (PST) From: cy_huang To: robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, sre@kernel.org Cc: cy_huang@richtek.com, allen_chiang@richtek.com, linux-pm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 3/3] Documentation: power: rt9759: Document exported sysfs entries Date: Mon, 14 Nov 2022 16:20:53 +0800 Message-Id: <1668414053-32728-4-git-send-email-u0084500@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1668414053-32728-1-git-send-email-u0084500@gmail.com> References: <1668414053-32728-1-git-send-email-u0084500@gmail.com> X-Spam-Status: No, score=-1.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749459075412679126?= X-GMAIL-MSGID: =?utf-8?q?1749459075412679126?= From: ChiYuan Huang Document the settings exported by rt9759 charger driver through sysfs entries: - watchdog_timer - battery_voltage - battery_current Signed-off-by: ChiYuan Huang --- Since v3: No change Since v2: - Change ABI document date from Oct 2022 to Nov 2022 and KernelVersion from 6.1 to 6.2 --- Documentation/ABI/testing/sysfs-class-power-rt9759 | 37 ++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-class-power-rt9759 diff --git a/Documentation/ABI/testing/sysfs-class-power-rt9759 b/Documentation/ABI/testing/sysfs-class-power-rt9759 new file mode 100644 index 00000000..8a7258f --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-power-rt9759 @@ -0,0 +1,37 @@ +What: /sys/class/power_supply/rt9759-*/watchdog_timer +Date: Nov 2022 +KernelVersion: 6.2 +Contact: ChiYuan Huang +Description: + This entry shows and sets the watchdog timer when rt9759 charger + operates in charging mode. When the timer expires, the device + will disable the charging. To prevent the timer expires, any + host communication can make the timer restarted. + + Access: Read, Write + + Valid values: + - 500, 1000, 5000 or 30000 (milliseconds), + - 0: disabled + +What: /sys/class/power_supply/rt9759-*/battery_voltage +Date: Nov 2022 +KernelVersion: 6.2 +Contact: ChiYuan Huang +Description: + Reports the current BAT voltage. + + Access: Read-Only + + Valid values: Represented in microvolts + +What: /sys/class/power_supply/rt9759-*/battery_current +Date: Nov 2022 +KernelVersion: 6.2 +Contact: ChiYuan Huang +Description: + Reports the current BAT current. + + Access: Read-Only + + Valid values: Represented in microamps