From mboxrd@z Thu Jan  1 00:00:00 1970
From: Grant Likely <grant.likely@secretlab.ca>
Subject: Re: [PATCHv2 1/2] dt: document the of_serial bindings
Date: Thu, 23 Jun 2011 08:57:14 -0600
Message-ID: <BANLkTim8gaXHT_z-CSAc6=Etw5nOHxfbMA@mail.gmail.com>
References: <1308838115-23034-1-git-send-email-jamie@jamieiles.com>
 <BANLkTim_=xToTYjATh8Z_ji3muMy3dXj0Q@mail.gmail.com> <BANLkTinHFTEkLKo-__km5dRn6bXeJBZzzA@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE
Return-path: <linux-serial-owner@vger.kernel.org>
Received: from mail-gx0-f174.google.com ([209.85.161.174]:33771 "EHLO
	mail-gx0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
	with ESMTP id S1754653Ab1FWO5g convert rfc822-to-8bit (ORCPT
	<rfc822;linux-serial@vger.kernel.org>);
	Thu, 23 Jun 2011 10:57:36 -0400
Received: by gxk21 with SMTP id 21so800751gxk.19
        for <linux-serial@vger.kernel.org>; Thu, 23 Jun 2011 07:57:35 -0700 (PDT)
In-Reply-To: <BANLkTinHFTEkLKo-__km5dRn6bXeJBZzzA@mail.gmail.com>
Sender: linux-serial-owner@vger.kernel.org
List-Id: linux-serial@vger.kernel.org
To: Jamie Iles <jamie@jamieiles.com>
Cc: linux-serial@vger.kernel.org, Arnd Bergmann <arnd@arndb.de>, devicetree-discuss <devicetree-discuss@lists.ozlabs.org>

On Thu, Jun 23, 2011 at 8:56 AM, Grant Likely <grant.likely@secretlab.c=
a> wrote:
> On Thu, Jun 23, 2011 at 8:55 AM, Grant Likely <grant.likely@secretlab=
=2Eca> wrote:
>> On Thu, Jun 23, 2011 at 8:08 AM, Jamie Iles <jamie@jamieiles.com> wr=
ote:
>>> The of_serial bindings can be used to register a number of serial
>>> devices. =A0Document this binding with all of the others.
>>>
>>> Cc: Grant Likely <grant.likely@secretlab.ca>
>>> Cc: Arnd Bergmann <arnd@arndb.de>
>>> Signed-off-by: Jamie Iles <jamie@jamieiles.com>
>>> ---
>>> =A0.../devicetree/bindings/tty/serial/of-serial.txt =A0 | =A0 34 ++=
++++++++++++++++++
>>> =A01 files changed, 34 insertions(+), 0 deletions(-)
>>> =A0create mode 100644 Documentation/devicetree/bindings/tty/serial/=
of-serial.txt
>>>
>>> diff --git a/Documentation/devicetree/bindings/tty/serial/of-serial=
=2Etxt b/Documentation/devicetree/bindings/tty/serial/of-serial.txt
>>> new file mode 100644
>>> index 0000000..b0c52c2
>>> --- /dev/null
>>> +++ b/Documentation/devicetree/bindings/tty/serial/of-serial.txt
>>> @@ -0,0 +1,34 @@
>>> +* UART (Universal Asynchronous Receiver/Transmitter)
>>> +
>>> +Required properties:
>>> +- compatible : one of:
>>> + =A0 =A0 =A0 - "ns8250"
>>> + =A0 =A0 =A0 - "ns16450"
>>> + =A0 =A0 =A0 - "ns16550a"
>>> + =A0 =A0 =A0 - "ns16550"
>>> + =A0 =A0 =A0 - "ns16750"
>>> + =A0 =A0 =A0 - "ns16850"
>>> + =A0 =A0 =A0 - "nvidia,tegra250-uart"
>>> + =A0 =A0 =A0 - "ibm,qpace-nwp-serial"
>>> + =A0 =A0 =A0 - "serial" if the port type is unknown.
>>> +- reg : offset and length of the register set for the device.
>>> +- interrupts : should contain uart interrupt.
>>> +- clock-frequency : the input clock frequency for the UART.
>>> +
>>> +Optional properties:
>>> +- current-speed : the current active speed of the UART.
>>> +- reg-offset : offset to apply to the mapbase from the start of th=
e registers.
>>> +- reg-shift : quantity to shift the register offsets by.
>>> +- used-by-rtas : set to indicate that the port is in use by the fi=
rmware and
>>> + =A0should not be registered.
>>> +
>>> +Example:
>>> +
>>> + =A0 =A0 =A0 uart@80230000 {
>>> + =A0 =A0 =A0 =A0 =A0 =A0 =A0 compatible =3D "ns8250";
>>> + =A0 =A0 =A0 =A0 =A0 =A0 =A0 device-type =3D "serial";
>>
>> Drop device-type. =A0Otherwise looks good.
>
> Although the used-by-rtas description should probably mention
> specifically that it is used by OpenFirmware RTAS.

Oh, and device tree documentation changes should cc: the
devicetree-discuss@lists.ozlabs.org mailing list.

g.
--
To unsubscribe from this list: send the line "unsubscribe linux-serial"=
 in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html