From patchwork Wed Mar 30 13:19:57 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Amitkumar Karwar X-Patchwork-Id: 8696251 X-Patchwork-Delegate: kvalo@adurom.com Return-Path: X-Original-To: patchwork-linux-wireless@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 7C5B09FC5B for ; Wed, 30 Mar 2016 13:26:32 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 8C70020379 for ; Wed, 30 Mar 2016 13:26:31 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 9024B20382 for ; Wed, 30 Mar 2016 13:26:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753836AbcC3N0X (ORCPT ); Wed, 30 Mar 2016 09:26:23 -0400 Received: from mx0b-0016f401.pphosted.com ([67.231.156.173]:4175 "EHLO mx0b-0016f401.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753797AbcC3N0U (ORCPT ); Wed, 30 Mar 2016 09:26:20 -0400 Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.16.0.11/8.16.0.11) with SMTP id u2UDMi8d030290; Wed, 30 Mar 2016 06:26:17 -0700 Received: from sc-exch02.marvell.com ([199.233.58.182]) by mx0b-0016f401.pphosted.com with ESMTP id 2206d1k9a1-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 30 Mar 2016 06:26:17 -0700 Received: from SC-EXCH03.marvell.com (10.93.176.83) by SC-EXCH02.marvell.com (10.93.176.82) with Microsoft SMTP Server (TLS) id 15.0.1104.5; Wed, 30 Mar 2016 06:26:15 -0700 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server id 15.0.1104.5 via Frontend Transport; Wed, 30 Mar 2016 06:26:15 -0700 Received: from pe-lt101 (unknown [10.31.130.27]) by maili.marvell.com (Postfix) with ESMTP id 69DFF3F703F; Wed, 30 Mar 2016 06:26:15 -0700 (PDT) Received: from pe-lt101 (pe-lt077 [127.0.0.1]) by pe-lt101 (8.14.4/8.14.4) with ESMTP id u2UDKFMq005217; Wed, 30 Mar 2016 06:20:16 -0700 Received: (from root@localhost) by pe-lt101 (8.14.4/8.14.4/Submit) id u2UDK7lc005215; Wed, 30 Mar 2016 06:20:07 -0700 From: Amitkumar Karwar To: CC: Cathy Luo , Nishant Sarmukadam , , Wei-Ning Huang , Xinming Hu , Amitkumar Karwar Subject: [PATCH v6 1/2] dt: bindings: add MARVELL's sd8xxx wireless device Date: Wed, 30 Mar 2016 06:19:57 -0700 Message-ID: <1459343998-5187-1-git-send-email-akarwar@marvell.com> X-Mailer: git-send-email 1.7.3.4 MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2016-03-30_07:, , signatures=0 X-Proofpoint-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1601100000 definitions=main-1603300193 Sender: linux-wireless-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-wireless@vger.kernel.org X-Spam-Status: No, score=-7.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Xinming Hu Add device tree binding documentation for MARVELL's sd8xxx (sd8897 and sd8997) wlan chip. Signed-off-by: Xinming Hu Signed-off-by: Amitkumar Karwar --- Listing changelist for both 1/2 and 2/2 patches v3: Don't update adapter->dt_node if mwifiex_plt_dev is NULL v4: a)Corrected the 'name' and 'compatible' property names.(Arnd Bergmann and Rob Herring) b)Patch description wraped in 72 columns(Rob Herring) c)Moved DT binding file to bindings/net/wireless/(Rob Herring) d)Renamed "mwifiex,chip-gpio" to "marvell,wakeup-gpios"(Rob Herring/ Arnd Bergmann) e)Replaced #ifdef with __maybe_unused(Arnd Bergmann) v5: a)Removed wildcards from compatible string(Arnd Bergmann) b)Prepared single patch for all binding changes(Rob Herring) c)Specified our node as a subnode of SDIO controller. With this approach, we don't need to register new platform driver. (Rob herring) v6: a)List out the specific property names for marvell,caldata* and size of the data(Rob Herring) b)Use sdio function number for both the unit address and reg(Rob Herring) --- .../bindings/net/wireless/marvell-sd8xxx.txt | 63 ++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/wireless/marvell-sd8xxx.txt diff --git a/Documentation/devicetree/bindings/net/wireless/marvell-sd8xxx.txt b/Documentation/devicetree/bindings/net/wireless/marvell-sd8xxx.txt new file mode 100644 index 0000000..337fed4 --- /dev/null +++ b/Documentation/devicetree/bindings/net/wireless/marvell-sd8xxx.txt @@ -0,0 +1,63 @@ +Marvell 8897/8997 (sd8897/sd8997) SDIO devices +------ + +This node provides properties for controlling the marvell sdio wireless device. +The node is expected to be specified as a child node to the SDIO controller that +connects the device to the system. + +Required properties: + + - compatible : should be one of the following: + * "marvell,sd8897" + * "marvell,sd8997" + +Optional properties: + + - marvell,caldata* : A series of properties with marvell,caldata prefix, + represent calibration data downloaded to the device during + initialization. This is an array of unsigned values. + the properties should follow below property name and + corresponding array length: + "marvell,caldata_00_txpwrlimit_2g_cfg_set" (length = 566). + "marvell,caldata_00_txpwrlimit_5g_cfg_set_sub0" (length = 502). + "marvell,caldata_00_txpwrlimit_5g_cfg_set_sub1" (length = 688). + "marvell,caldata_00_txpwrlimit_5g_cfg_set_sub2" (length = 750). + "marvell,caldata_00_txpwrlimit_5g_cfg_set_sub3" (length = 502). + - marvell,wakeup-pin : 'wakeuppin' is a wakeup pin number of wifi chip which will + be configured to firmware. firmware will wakeup host side use + the pin during suspend/resume stage. + - interrupt-parent: phandle of the parent interrupt controller + - interrupts : interrupt pin number to the cpu. driver will request an irq based on + this interrupt number. during system suspend, the irq will be enabled + as system wakeup source, so that the wifi chip can wakeup host + platform under certain condition. during system resume, the irq will + be disabled to make sure unnecessary interrupt is not received. + +Example: + +Tx power limit calibration data is configured in below example. +The calibration data is an array of unsigned values, the length +can vary between hw versions. +IRQ pin 38 is used as system wakeup source interrupt. wakeup pin 3 is configured +so that firmware can wakeup host using this device side pin. + +&mmc3 { + status = "okay"; + vmmc-supply = <&wlan_en_reg>; + bus-width = <4>; + cap-power-off-card; + keep-power-in-suspend; + + #address-cells = <1>; + #size-cells = <0>; + mwifiex: mwifiex@1 { + compatible = "marvell,sd8897"; + reg = <1>; + interrupt-parent = <&pio>; + interrupts = <38 IRQ_TYPE_LEVEL_LOW>; + + marvell,caldata_00_txpwrlimit_2g_cfg_set = /bits/ 8 < + 0x01 0x00 0x06 0x00 0x08 0x02 0x89 0x01>; + marvell,wakeup-pin = <3>; + }; +};