Received: by 10.223.176.5 with SMTP id f5csp1969893wra; Thu, 8 Feb 2018 06:30:41 -0800 (PST) X-Google-Smtp-Source: AH8x2241xrbh+I28esDqdhJ+oxpJQYPsQXGeuPR4K764znXcqaQxD0T3fBJQoeR5xy14eZd88BVE X-Received: by 10.99.102.1 with SMTP id a1mr677693pgc.452.1518100241418; Thu, 08 Feb 2018 06:30:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518100241; cv=none; d=google.com; s=arc-20160816; b=WwRUu5z4+WT7xcFFqJq7ouvjvOvtTCw4ZiNSyKO81YAl1xDKU7TApjcO9jLINNemoG kxFg4SvCysUTOIGD0gyOOxQFtmlc6ONiT6+CwDgeacVTByrQBFZ9OvkqhOy7CJNA+qe+ 1vb0Ge0Q2zLoVSwKq0vjeEJEb6CSwSunZTxEkKO+zyELHZcFM6HP1pt1uqZfCqskqfJU P7VDAMJKuf4UaHrle3lmaNi0fVFbi7Li0yT/zgSsgULi29Olsh8dSqgSgOVw9dgd76F6 5/l0V3l3smXX6PMjBwblXmtDbYiHTQiwqIGBrD/qRZae0P7bSQTFelgXt4lrMdupkJDl USaw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:arc-authentication-results; bh=YIQMRKZ1kV1bVSMHa5hakT8aq7S3/u9JZtEgiiGeW1c=; b=pQ8nGlfXZc8cU6itKcfMyit/IdxIW6eoeXdCBV08hOt2vNtZXrCICNgbpP3MASKCka Bi7Uh/A3wo7/d/gH3hNLg4E7MZGONLYsOKXXUp0f+qIbqjFME7PN8g0meIb0L1YabZb7 ZXr/r7hAzKgAYfoC0llEL3+/DRsMwkFBPhu5hvNdmCfRg6TDLwVe2WTVRlW+Tcxi187r epSlp8HwOzZr4VyxvsBVhmMXKTZuO/oAe5Orn2SdRazW6MNAg0UxZnbJlmYyi71a+Ic6 3u699ZHMEYpRPYx+gQReRZApjJPaDWdHmztT6SpGte7QFS1GoLFQQ8al3Djv0RonCtHF XuSw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id f64-v6si37973plb.817.2018.02.08.06.30.27; Thu, 08 Feb 2018 06:30:41 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752412AbeBHO3Y (ORCPT + 99 others); Thu, 8 Feb 2018 09:29:24 -0500 Received: from mx07-00178001.pphosted.com ([62.209.51.94]:61434 "EHLO mx07-00178001.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751343AbeBHO2f (ORCPT ); Thu, 8 Feb 2018 09:28:35 -0500 Received: from pps.filterd (m0046037.ppops.net [127.0.0.1]) by mx07-.pphosted.com (8.16.0.21/8.16.0.21) with SMTP id w18EJAdf022896; Thu, 8 Feb 2018 15:27:55 +0100 Received: from beta.dmz-eu.st.com (beta.dmz-eu.st.com [164.129.1.35]) by mx07-00178001.pphosted.com with ESMTP id 2fw3qx2rqk-1 (version=TLSv1 cipher=ECDHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 08 Feb 2018 15:27:55 +0100 Received: from zeta.dmz-eu.st.com (zeta.dmz-eu.st.com [164.129.230.9]) by beta.dmz-eu.st.com (STMicroelectronics) with ESMTP id 738A634; Thu, 8 Feb 2018 14:27:54 +0000 (GMT) Received: from Webmail-eu.st.com (Safex1hubcas23.st.com [10.75.90.46]) by zeta.dmz-eu.st.com (STMicroelectronics) with ESMTP id 0038CA480; Thu, 8 Feb 2018 14:27:53 +0000 (GMT) Received: from SAFEX1HUBCAS22.st.com (10.75.90.92) by SAFEX1HUBCAS23.st.com (10.75.90.46) with Microsoft SMTP Server (TLS) id 14.3.361.1; Thu, 8 Feb 2018 15:27:54 +0100 Received: from localhost (10.201.20.5) by Webmail-ga.st.com (10.75.90.48) with Microsoft SMTP Server (TLS) id 14.3.352.0; Thu, 8 Feb 2018 15:27:53 +0100 From: Amelie Delaunay To: Lee Jones , Linus Walleij , Rob Herring , Mark Rutland , Russell King , "Alexandre Torgue" , Maxime Coquelin CC: , , , , "Amelie Delaunay" Subject: [PATCH 1/6] dt-bindings: mfd: Add ST Multi-Function eXpander driver Date: Thu, 8 Feb 2018 15:27:32 +0100 Message-ID: <1518100057-23234-2-git-send-email-amelie.delaunay@st.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1518100057-23234-1-git-send-email-amelie.delaunay@st.com> References: <1518100057-23234-1-git-send-email-amelie.delaunay@st.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [10.201.20.5] X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2018-02-08_08:,, signatures=0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This patch adds documentation of device tree bindings for the STMicroelectronics Multi-Function eXpander (MFX). Signed-off-by: Amelie Delaunay --- Documentation/devicetree/bindings/mfd/st-mfx.txt | 51 ++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/st-mfx.txt diff --git a/Documentation/devicetree/bindings/mfd/st-mfx.txt b/Documentation/devicetree/bindings/mfd/st-mfx.txt new file mode 100644 index 0000000..423d800 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/st-mfx.txt @@ -0,0 +1,51 @@ +STMicroelectronics Multi-Function eXpander + +ST Multi-Function eXpander (MFX) is a slave controller using I2C for +communication with the main MCU. Its main features are gpio expansion, main +MCU IDD measurement (IDD is the amount of current that flows through VDD) +and resistive touchscreen controller. + +Required properties: +- compatible: must be "st,mfx" +- reg: I2C address of the device +- interrupts: interrupt triggered by MFX_IRQ_OUT signal +- interrupt-parent: interrupt controller MFX is connected to +- interrupt-controller: marks the device as an interrupt controller +- #interrupt-cells: should be <1>, index of the interrupt within the + controller, in accordance with the "one cell" variant of + + +Optional nodes: + +* GPIO eXpander +MFX provides 16 programmable GPIOs, and it is also possible to recover 8 +alternate GPIOs if the main functions are not used (touchscreen controller and +IDD measurement not enabled). + +Required properties: +- compatible : must be "st,mfx-gpio" +- interrupt-parent : must be <&mfx> +- interrupts = must be <0> +- gpio-controller: marks the device node as a GPIO controller +- #gpio-cells: should be <2>, the first cell is the GPIO offset on this GPIO + controller, the second cell is the gpio flags in accordance with + . + +Example: + + mfx: mfx@42 { + compatible = "st,mfx"; + reg = <0x42>; + interrupts = <8 IRQ_TYPE_EDGE_RISING>; + interrupt-parent = <&gpioi>; + interrupt-controller; + #interrupt-cells = <1>; + + mfxgpio: mfx_gpio { + compatible = "st,mfx-gpio"; + interrupt-parent = <&mfx>; + interrupts = <0>; + gpio-controller; + #gpio-cells = <2>; + }; + }; -- 2.7.4