From patchwork Thu Feb 26 15:38:45 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matt Porter X-Patchwork-Id: 5894201 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 AA7E6BF440 for ; Thu, 26 Feb 2015 15:39:10 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id BF719203A5 for ; Thu, 26 Feb 2015 15:39:09 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id E141120304 for ; Thu, 26 Feb 2015 15:39:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753779AbbBZPiv (ORCPT ); Thu, 26 Feb 2015 10:38:51 -0500 Received: from mail-ie0-f182.google.com ([209.85.223.182]:34692 "EHLO mail-ie0-f182.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752483AbbBZPiu (ORCPT ); Thu, 26 Feb 2015 10:38:50 -0500 Received: by iecrp18 with SMTP id rp18so16760344iec.1 for ; Thu, 26 Feb 2015 07:38:50 -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=McQPUc+6LE0CkB1ntxzNWT9KyGu65zaASJVPGYVVRrymfLD4Kz6WVA0T/1U3AIyvO3 hjhS2Wj1O1g/6ajUjPd0XedlTh8eRDGqCiUg0y55/uA8BFU4FGTqYIqEp7OD2pWGwres YK/w4YpVCV9pxSmo4EkoqN5qn8383sPZLo14IspzVoJXxr1xoiT5xJibnY83/axe7VnT Dj4ypckZ3Da0idjXAFmt1PfhlVYgpf3nAOUQSILOCR8rWIHWMIIynfd6+U0PYm5vEh7c ijq5Y8SHisqGjbCZ746kblm6tIAnP70cHmuwuEUxCNzg1Lm036VpHw4ueuuG2Jmne8Mp 3oaQ== X-Gm-Message-State: ALoCoQmONdEN1IDkb3QCmtz+i0HVLLaGp+BiC6d3wU/oOAIc+o7PEE1P3tAqXeyxbjxBInKe4AoW X-Received: by 10.50.142.99 with SMTP id rv3mr35284628igb.11.1424965129802; Thu, 26 Feb 2015 07:38:49 -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 ie15sm1212922igb.12.2015.02.26.07.38.48 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 26 Feb 2015 07:38:49 -0800 (PST) From: Matt Porter To: Devicetree List Cc: =?UTF-8?q?Beno=C3=AEt=20Cousson?= , Linux OMAP List , Linux Kernel Mailing List Subject: [PATCH] Documentation: DT: omap_serial: document missing properties and add an example Date: Thu, 26 Feb 2015 10:38:45 -0500 Message-Id: <1424965125-31714-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>; + };