From patchwork Tue Sep 6 21:46:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9317949 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 461BF60760 for ; Tue, 6 Sep 2016 21:46:38 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 4BDFA28EF5 for ; Tue, 6 Sep 2016 21:46:38 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 401BD28F00; Tue, 6 Sep 2016 21:46:38 +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=-4.6 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM 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 DC4DC28EF5 for ; Tue, 6 Sep 2016 21:46:37 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933737AbcIFVqg (ORCPT ); Tue, 6 Sep 2016 17:46:36 -0400 Received: from mail-wm0-f65.google.com ([74.125.82.65]:32946 "EHLO mail-wm0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933490AbcIFVqd (ORCPT ); Tue, 6 Sep 2016 17:46:33 -0400 Received: by mail-wm0-f65.google.com with SMTP id w207so20702831wmw.0; Tue, 06 Sep 2016 14:46:33 -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=kkVcMA1hqXzJ2ghK+6RtyI1AHMMudxXo8VboMPJVnwg=; b=NCO8PCrcE77J+qLppAjkplEba8QoXqnMiTdRG9pthC9agvPm/0B+eAKmb9qe2ZHgQ6 4brwEroDDebJbQrhlJMz61DTJXgAor8KiFleF+zZDyDQWKX+fiGOK/VlKFD5IVI570os nEvtDd5V8vlYK3nM8QwXIVzLTesG8oNaGbRRVL01RVok/M9KO3tusgED/DbwxQ8dc+rE +2AN/bn97hl9Q36h8E8+MMDVW6S4viOB4aUnMKpZ+O1zLoyoIRO+Rp2GNLDQDxVqkX+0 NpArHU9KnycqhV96iWyPdJla+pHMwwAkaTh5c0JgBLYk31IKZaxBsKKHi97Yyf17WKLw 6Rgw== 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=kkVcMA1hqXzJ2ghK+6RtyI1AHMMudxXo8VboMPJVnwg=; b=EyivdQg0QPO2M1hbjvLOxVTsVVCdQ5KVEtsbDuOyI+I7Ywleu9rDqtzEGu58fdwUwC cBeBtJwKYiEwh0ccM0GVmPz+eeGDMgrxrI57mrPB/a9CbLIB/74vi84nLEARvHgbJuKg Es+EuzsGc+xlN5meNXRxDxFAAhvCARa7DBYoK4/t3a0AjjxI5L8A0zk1TFnFG5tyOrmk f/v6iVtOGYZicunRP+xXChShdDCpYayTETKk09Qdp59IJ3txRD8z7fHZyDYBdQDtbD4j wMSm9oyp/nF/5KamzuUP/8ZqADCC/BrwcWJkJO/MmPG4wY+Waj1xsj08yd2O48gqZCzP dPkg== X-Gm-Message-State: AE9vXwPyVhY0xUaIR6u8Ula2rq88FdFoKE/XS1bVJtMnw8w7bwh+hcMF8sg8Hm2NM2nAew== X-Received: by 10.28.210.82 with SMTP id j79mr660554wmg.10.1473198392263; Tue, 06 Sep 2016 14:46:32 -0700 (PDT) Received: from blackbox.darklights.net (p5DE38590.dip0.t-ipconnect.de. [93.227.133.144]) by smtp.googlemail.com with ESMTPSA id ex14sm35451113wjc.30.2016.09.06.14.46.30 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Sep 2016 14:46:31 -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, mark.rutland@arm.com, robh+dt@kernel.org, kvalo@codeaurora.org, chunkeey@googlemail.com, arend.vanspriel@broadcom.com, julian.calaby@gmail.com, bjorn@mork.no, linux@rempel-privat.de, nbd@nbd.name, Martin Blumenstingl Subject: [PATCH v6 1/3] Documentation: dt: net: add ath9k wireless device binding Date: Tue, 6 Sep 2016 23:46:21 +0200 Message-Id: <20160906214623.20424-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.9.3 In-Reply-To: <20160906214623.20424-1-martin.blumenstingl@googlemail.com> References: <20160821143105.27487-1-martin.blumenstingl@googlemail.com> <20160906214623.20424-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 | 39 ++++++++++++++++++++++ 1 file changed, 39 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..77b9202 --- /dev/null +++ b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt @@ -0,0 +1,39 @@ +* 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: For PCI and PCIe devices this should be an identifier following + the format as defined in "PCI Bus Binding to Open Firmware" + Revision 2.1. One of the possible formats is "pciVVVV,DDDD" + where VVVV is the PCI vendor ID and DDDD is PCI device ID. + +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,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: +&pci0 { + ath9k@168c,002d { + compatible = "pci168c,002d"; + reg = <0x7000 0 0 0 0x1000>; + qca,disable-5ghz; + }; +};