From patchwork Fri Mar 6 15:16:12 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matt Porter X-Patchwork-Id: 5955621 Return-Path: X-Original-To: patchwork-linux-omap@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 48F6ABF440 for ; Fri, 6 Mar 2015 15:16:45 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 82E7B20396 for ; Fri, 6 Mar 2015 15:16:43 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 9F6AB20392 for ; Fri, 6 Mar 2015 15:16:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755328AbbCFPQ3 (ORCPT ); Fri, 6 Mar 2015 10:16:29 -0500 Received: from mail-ie0-f181.google.com ([209.85.223.181]:44115 "EHLO mail-ie0-f181.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753376AbbCFPQV (ORCPT ); Fri, 6 Mar 2015 10:16:21 -0500 Received: by iecar1 with SMTP id ar1so86126707iec.11 for ; Fri, 06 Mar 2015 07:16:20 -0800 (PST) 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; bh=s5k7Q7SMP9mR7mRzaF9P4gqQs952u51Wvfc5oRltp+s=; b=VRrINKvH4i055avSR2Sbx6izBZkJE4YAQ7Sl2kkUP7kRA/C8mP1uNbRHW84BZcvGo5 Yszl7l8EqQBH5ICq/TnRxAwaT3MerM4WQ9EWLAbD1LZO3JQGceATNwXCdVOvyQhmpdHs mU7/qzo0JrmN3Ol2iC7DxnHcui1YAssP/pVH9fFh9TZ8Utj/T22noMtm1OtLkj1CLdmy 9JIfGFTR/oxBzbWTLvX6GvaH8vvrSv3SZ451LjYe+dmFD/9rEkJ7cOx+gNf25VjoOBrA vJvicDvoNpgwLvd71oX/8/yNJlrpXQXp6QdlX44ASOzkQs7ZbHTGPnjR5Gq2WtZW5F+k kEwQ== X-Gm-Message-State: ALoCoQlvFznSZCA3cVOiEdvaEPGxAXCbczU6Rl6nes6/HnOJAZgfHdZxRzi/+0hurQ97098t8rqi X-Received: by 10.42.12.206 with SMTP id z14mr3256735icz.47.1425654980448; Fri, 06 Mar 2015 07:16:20 -0800 (PST) Received: from beef.ohporter.com (cpe-107-10-23-53.neo.res.rr.com. [107.10.23.53]) by mx.google.com with ESMTPSA id mi3sm14966549igb.13.2015.03.06.07.16.19 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 06 Mar 2015 07:16:20 -0800 (PST) From: Matt Porter To: Devicetree List Cc: Rob Herring , Mark Rutland , =?UTF-8?q?Beno=C3=AEt=20Cousson?= , Tony Lindgren , Linux OMAP List , Linux Kernel Mailing List Subject: [PATCH RESEND] serial: omap_serial: document missing properties and add an example Date: Fri, 6 Mar 2015 10:16:12 -0500 Message-Id: <1425654972-8044-1-git-send-email-mporter@konsulko.com> X-Mailer: git-send-email 1.8.4 Sender: linux-omap-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-omap@vger.kernel.org X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, T_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 The omap_serial.txt binding documentation lacks a number of properties that are used in DTS files for platforms incorporating this peripheral. Fix this by documenting the missing required and optional fields and add an example. Signed-off-by: Matt Porter --- .../devicetree/bindings/serial/omap_serial.txt | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/Documentation/devicetree/bindings/serial/omap_serial.txt b/Documentation/devicetree/bindings/serial/omap_serial.txt index 342eedd..54c2a15 100644 --- a/Documentation/devicetree/bindings/serial/omap_serial.txt +++ b/Documentation/devicetree/bindings/serial/omap_serial.txt @@ -4,7 +4,27 @@ Required properties: - compatible : should be "ti,omap2-uart" for OMAP2 controllers - compatible : should be "ti,omap3-uart" for OMAP3 controllers - compatible : should be "ti,omap4-uart" for OMAP4 controllers +- reg : address and length of the register space +- interrupts or interrupts-extended : Should contain the uart interrupt + specifier or both the interrupt + controller phandle and interrupt + specifier. - ti,hwmods : Must be "uart", n being the instance number (1-based) Optional properties: - clock-frequency : frequency of the clock input to the UART +- dmas : DMA specifier, consisting of a phandle to the DMA controller + node and a DMA channel number. +- dma-names : "rx" for receive channel, "tx" for transmit channel. + +Example: + + uart4: serial@49042000 { + compatible = "ti,omap3-uart"; + reg = <0x49042000 0x400>; + interrupts = <80>; + dmas = <&sdma 81 &sdma 82>; + dma-names = "tx", "rx"; + ti,hwmods = "uart4"; + clock-frequency = <48000000>; + };