From patchwork Fri Jun 24 12:34:28 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9197397 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 151CF60754 for ; Fri, 24 Jun 2016 12:35:05 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 054C5284AB for ; Fri, 24 Jun 2016 12:35:05 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id EDC4C284AF; Fri, 24 Jun 2016 12:35:04 +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 8B354284AB for ; Fri, 24 Jun 2016 12:35:04 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751462AbcFXMfB (ORCPT ); Fri, 24 Jun 2016 08:35:01 -0400 Received: from mail-wm0-f65.google.com ([74.125.82.65]:32840 "EHLO mail-wm0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751355AbcFXMe7 (ORCPT ); Fri, 24 Jun 2016 08:34:59 -0400 Received: by mail-wm0-f65.google.com with SMTP id r201so4641488wme.0 for ; Fri, 24 Jun 2016 05:34:59 -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=K0f5nPZOFroolZ9KHP+36G0URrz61V07OaFDbSj1VU4=; b=awmIPaFDVjnAQD490SL+RhTNHO3YWO1PbmtYDn4ii9G/DLG414rd073dBM5zRkwmTp wqCIYezQVrwS/MPo+gE3tq638Y420l/6NtWygLyP30nUu+r0ZmDlRmJ30z/+C0SfEqj5 jyYUBFDvWzqkj8BbQzHOu0/QWVn4FJjajUcX+wJQ8ps27KGlqvZPTCVObe9BBA4ORiIe cjszXo0kXkTgvw+gP/VbvXV1MNv//Wr10Uo8KAhC4ha1pWmSBqWkG9XDoAoJgsRDOTmV lAsdV2uh25tnzZTvTiwc6v38h+Hwcs6uZ1LgU7OBwfngNWgRnBYK1CyUo5xZL5kKoq0T +X3g== 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=K0f5nPZOFroolZ9KHP+36G0URrz61V07OaFDbSj1VU4=; b=U99ITx+aEngkpAyObsWAQKG6LXI0pUVcRIuWuipExbW8hTWqhkj+TLAFLv+QYpwzEl eg5C7ZhMuHkeRdIl2G11madukMhRH+6Me8moLiqV4//3phEvq63tMZ7l0ncc87DGCaTy y8+I7uFdLKaNaRMPixnQ2JxS/SsR+FO8r/yI4srxy6gO/e8kOSCTP2Eha1ZtKQoamxP9 cEW28nwO9++egSwgRIiDGhX4H2BQFHx49abuSQUrWvCkMAf8AJ2UrjxF8CiZLFks6Jfj znWSuXOOlC4ZcudTWAJwi3/O+k5YHz1zDr3207udvK/yBSUZjBt+EV6loqgUP2AtkGJP 9sug== X-Gm-Message-State: ALyK8tJUbvI4cC+XBZQ6t+H4h6LX5aJpxLAvjhRGvID6IYAkM+V0/+fC93n71U5f3FI5Ow== X-Received: by 10.194.22.72 with SMTP id b8mr3588832wjf.74.1466771698432; Fri, 24 Jun 2016 05:34:58 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3CD1B04711E7E5304799B46.dip0.t-ipconnect.de. [2003:dc:d3cd:1b04:711e:7e53:479:9b46]) by smtp.googlemail.com with ESMTPSA id x83sm2942499wmx.9.2016.06.24.05.34.57 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 24 Jun 2016 05:34:57 -0700 (PDT) From: Martin Blumenstingl To: ath9k-devel@qca.qualcomm.com, linux-wireless@vger.kernel.org, ath9k-devel@lists.ath9k.org Cc: nbd@nbd.name, chunkeey@googlemail.com, mark.rutland@arm.com, robh+dt@kernel.org, arend.vanspriel@broadcom.com, Martin Blumenstingl Subject: [PATCH RFC v3 1/3] Documentation: dt: net: add ath9k wireless device binding Date: Fri, 24 Jun 2016 14:34:28 +0200 Message-Id: <20160624123430.4097-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.9.0 In-Reply-To: <20160624123430.4097-1-martin.blumenstingl@googlemail.com> References: <20160624123430.4097-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 --- changes in v2 -> v3: - improved wording of the qca,disable-2ghz and qca,disable-5ghz properties - replaced qca,eeprom-name with qca,no-eeprom (the eeprom name is now built automatically within ath9k). The naming was chosen to stay consistent with other drivers (such as davicom-dm9000 and via-velocity) - added reference to the mac-address and local-mac-address properties - removed invalid device_type property from the example .../devicetree/bindings/net/wireless/qca,ath9k.txt | 46 ++++++++++++++++++++++ 1 file changed, 46 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..ff83fd4 --- /dev/null +++ b/Documentation/devicetree/bindings/net/wireless/qca,ath9k.txt @@ -0,0 +1,46 @@ +* 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,gpio-mask: The GPIO mask +- qca,gpio-val: The GPIO value +- qca,led-pin: The GPIO number to which the LED is connected +- qca,led-active-high: The LED is active when the GPIO is HIGH +- qca,clk-25mhz: Defines that at 25MHz clock is used +- qca,no-eeprom: Indicates that there is on physical EEPROM connected + to the ath9k wireless chip (in this case the + calibration / EEPROM data will be loaded from + userspace using the firmware mechanism) +- qca,check-eeprom-endianness: Allow checking the EEPROM endianness and + swapping of the EEPROM data if required +- qca,disable-2ghz: Overrides the settings from the EEPROM and disables + the 2.4GHz band, even if enabled in the EEPROM +- qca,disable-5ghz: Overrides the settings from the EEPROM and disables + the 5GHz band, even if enabled 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; + }; + }; +};