From patchwork Sat Jul 9 23:28:32 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9222189 X-Patchwork-Delegate: kvalo@adurom.com 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 579416089D for ; Sat, 9 Jul 2016 23:28:57 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 472C328466 for ; Sat, 9 Jul 2016 23:28:57 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 3BBD128471; Sat, 9 Jul 2016 23:28:57 +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_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, 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 CF3E328466 for ; Sat, 9 Jul 2016 23:28:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933215AbcGIX2y (ORCPT ); Sat, 9 Jul 2016 19:28:54 -0400 Received: from mail-wm0-f65.google.com ([74.125.82.65]:34823 "EHLO mail-wm0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933099AbcGIX2w (ORCPT ); Sat, 9 Jul 2016 19:28:52 -0400 Received: by mail-wm0-f65.google.com with SMTP id k123so12148858wme.2; Sat, 09 Jul 2016 16:28:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=UPSESy2x+09lyqRnEm0bCCkSIMO/TpyTID7VAwtYc8U=; b=bLQa97YUAaLdYdrM7zOYT8xqouE8k0gSWdhrYRpPAdFBA7PM6UJqEeupIw2lNzmXy3 pV2kPWKZWdzTh+lZXLVVyBfJ1qlMBiuPsmjyH88kMxrFZN4NAfnsjTVzRCeqCb8EJ4yz Q7zds2eJfNfVw4Xkvva7ACQz61UcNBkfuksaUTwK+EGXmJ5KYBI1ugACDTnGpEYuwg9j nEg7Ft97clJ3jttiDXpN0Lu0hsLnZ3WeBSwRBFvXd7UYNOYF/SK9Q5hQ0B22jKOmPRzf iY7qYpQl11idq5PaiUni2MIP7QzNOAd0k12KwzIpVhe7LMGErXmWV/R8pjVRYr44zJY3 QSvw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=UPSESy2x+09lyqRnEm0bCCkSIMO/TpyTID7VAwtYc8U=; b=frpFguyJn//T+7NDfUmS6dBQXpnr2Syk2cUcl/QCDTJf5G9E4cr2DnHdeZClAdAlpg 8DmHFlDT7v3WGm7yo0GvB6w2hrL1g4Dxa7VHizFqDuefj3qrIjNU59gj1jp6NF4gfdQa 0AeKR4rqk4M8Lky47vK3QR8CcxxU5S6yym1Nv92ZJLpr4Qhog8Vqn5guukxNsBv92nqW rn9uVdhYvGc0BT4wSkDtqRHGnAxFdOWCTb+TGf7ZfRPDkbIkeM4fprhwzbw0Dcrf5uro AAJXByv5eS+VXUwlRqnrNUtFpfw+F8wiidGHgXAY90TSy0ChDDZ4dDF+6kPMQXxmYuz1 hMRQ== X-Gm-Message-State: ALyK8tKQIo86/O7TBPSymaRkuFZvsiW5oYP0knUR9oFHIjdFyxHQ7PPqzlPjTHkRhVATnw== X-Received: by 10.28.215.139 with SMTP id o133mr9191177wmg.74.1468106930640; Sat, 09 Jul 2016 16:28:50 -0700 (PDT) Received: from blackbox.darklights.net (p5DE38945.dip0.t-ipconnect.de. [93.227.137.69]) by smtp.googlemail.com with ESMTPSA id r127sm10009891wmf.21.2016.07.09.16.28.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 09 Jul 2016 16:28:49 -0700 (PDT) From: Martin Blumenstingl To: ath9k-devel@lists.ath9k.org, devicetree@vger.kernel.org, linux-wireless@vger.kernel.org, ath9k-devel@qca.qualcomm.com Cc: mcgrof@do-not-panic.com, galak@codeaurora.org, ijc+devicetree@hellion.org.uk, mark.rutland@arm.com, pawel.moll@arm.com, robh+dt@kernel.org, kvalo@codeaurora.org, chunkeey@googlemail.com, arend.vanspriel@broadcom.com, julian.calaby@gmail.com, Martin Blumenstingl Subject: [PATCH v4 1/3] Documentation: dt: net: add ath9k wireless device binding Date: Sun, 10 Jul 2016 01:28:32 +0200 Message-Id: <20160709232834.31654-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.9.0 In-Reply-To: <20160709232834.31654-1-martin.blumenstingl@googlemail.com> References: <20160624123430.4097-1-martin.blumenstingl@googlemail.com> <20160709232834.31654-1-martin.blumenstingl@googlemail.com> Sender: linux-wireless-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-wireless@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add documentation how devicetree can be used to configure ath9k based devices. Signed-off-by: Martin Blumenstingl --- .../devicetree/bindings/net/wireless/qca,ath9k.txt | 59 ++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt diff --git a/Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt new file mode 100644 index 0000000..7c62c59 --- /dev/null +++ b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt @@ -0,0 +1,59 @@ +* Qualcomm Atheros ath9k wireless devices + +This node provides properties for configuring the ath9k wireless device. The +node is expected to be specified as a child node of the PCI controller to +which the wireless chip is connected. + +Required properties: +- compatible: Should be "qca,ath9k" + +Optional properties: +- reg: Address and length of the register set for the device. +- qca,clk-25mhz: Defines that a 25MHz clock is used +- qca,no-eeprom: Indicates that there is no physical EEPROM connected to the + ath9k wireless chip (in this case the calibration / + EEPROM data will be loaded from userspace using the + kernel firmware loader). +- qca,check-eeprom-endianness: When enabled, the driver checks if the + endianness of the EEPROM (based on the two + magic bytes at the start of the EEPROM) + matches the host system's native endianness. + The data will be swapped accordingly if there + is a mismatch. + Leaving this disabled means that the EEPROM + data will be interpreted in the system's + native endianness, regardless of the magic + bytes. + Enable this option only when the magic bytes + are known to indicate the correct endianness + of the EEPROM data, because otherwise the + EEPROM data may be swapped and thus may be + parsed incorrectly. +- qca,disable-2ghz: Overrides the settings from the EEPROM and disables the + 2.4GHz band. Setting this property is only needed + when the RF circuit does not support the 2.4GHz band + while it is enabled nevertheless in the EEPROM. +- qca,disable-5ghz: Overrides the settings from the EEPROM and disables the + 5GHz band. Setting this property is only needed when + the RF circuit does not support the 5GHz band while + it is enabled nevertheless in the EEPROM. +- mac-address: See ethernet.txt in the parent directory +- local-mac-address: See ethernet.txt in the parent directory + +In this example, the node is defined as child node of the PCI controller. + +pci { + pcie@0 { + reg = <0 0 0 0 0>; + #interrupt-cells = <1>; + #size-cells = <2>; + #address-cells = <3>; + device_type = "pci"; + + ath9k@0,0 { + compatible = "qca,ath9k"; + reg = <0 0 0 0 0>; + qca,disable-5ghz; + }; + }; +};