-

Devicetree Specification v0.4-1-gbbb6c79

+

Devicetree Specification v0.4-2-g2697c66

Copyright

@@ -349,7 +349,7 @@

2.1. OverviewFig. 2.1 shows an example representation of a simple devicetree that is nearly complete enough to boot a simple operating system, with the platform -type, CPU, memory and a single UART described. Device nodes are shown +type, CPU, memory, and a single UART described. Device nodes are shown with properties and values inside each node.

@@ -1911,7 +1911,7 @@

3.3. "/simple-bus@fe000000/serial@llc500" defines the alias serial0.

-

Alias names shall be a lowercase text strings of 1 to 31 characters from +

Alias names shall be lowercase text strings of 1 to 31 characters from the following set of characters.

@@ -2507,7 +2507,7 @@

3.8.1. General Properties of If a CPU/thread cannot be the target of an external interrupt, then reg must be unique and out of bounds of the range addressed by -the interrupt controller

+the interrupt controller.

If a CPU/thread’s PIR (pending interrupt register) is modifiable, a client program should modify PIR to match the reg @@ -2878,20 +2878,20 @@

3.8.3. Internal (L1) Cache Properties

<u32>

+unified (combined instructions and data).

+cache (combined instructions and data).

@@ -3112,7 +3112,7 @@

3.9.1. Example -

Bindings may be defined as extensions of other each. For example a new +

Bindings may be defined as extensions of each other. For example, a new bus type could be defined as an extension of the simple-bus binding. In this case, the compatible property would contain several strings identifying each binding—from the most specific to the most general (see @@ -3169,9 +3169,9 @@

4.1.2.1. <prop-encoded-array> in one of two forms:

a 32-bit integer consisting of one <u32> specifying the -frequency

+frequency.

a 64-bit integer represented as a <u64> specifying the -frequency

+frequency.

@@ -3221,7 +3221,7 @@
4.1.2.3. <string>

- @@ -3234,10 +3234,10 @@
4.1.2.3. 4.2. Serial devices

4.2.1. Serial Class Binding

-

The class of serial devices consists of various types of point to point +

The class of serial devices consists of various types of point-to-point serial line devices. Examples of serial line devices include the 8250 -UART, 16550 UART, HDLC device, and BISYNC device. In most cases hardware -compatible with the RS-232 standard fit into the serial device class.

+UART, 16550 UART, HDLC device, and BISYNC device. In most cases, hardware +compatible with the RS-232 standard fits into the serial device class.

I2C and SPI (Serial Peripheral Interface) devices shall not be represented as serial port devices because they have their own specific representation.

@@ -3313,13 +3313,13 @@

4.2.2. National Semiconductor 16450/1655

+rate generator’s input clock.

+per second.

@@ -3327,7 +3327,7 @@

4.2.2. National Semiconductor 16450/1655 array>

+the parent bus.

@@ -3416,7 +3416,7 @@
4.3.1.2.
- + - + +is required in case where the Ethernet device is connected to +a physical layer device.

@@ -3654,7 +3654,7 @@

4.4. Power ISA Open PIC Interrupt Contro

- + @@ -3662,12 +3662,12 @@

4.4. Power ISA Open PIC Interrupt Contro array>

+the parent bus.

- + @@ -3735,7 +3735,7 @@

4.4. Power ISA Open PIC Interrupt Contro

5. Flattened Devicetree (DTB) Format

The Devicetree Blob (DTB) format is a flat binary encoding of devicetree data. -It used to exchange devicetree data between software programs. +It is used to exchange devicetree data between software programs. For example, when booting an operating system, firmware will pass a DTB to the OS kernel.

Note

@@ -3784,10 +3784,10 @@

4.4. Power ISA Open PIC Interrupt Contro the original definition of the format. Fields in the header give the version, so that the client program can determine if the devicetree is encoded in a compatible format.

-

This document describes only version 17 of the format. DTSpec compliant boot +

This document describes only version 17 of the format. DTSpec-compliant boot programs shall provide a devicetree of version 17 or later, and should provide a devicetree of a version that is backwards compatible with version 16. -DTSpec compliant client programs shall accept devicetrees of any version +DTSpec-compliant client programs shall accept devicetrees of any version backwards compatible with version 17 and may accept other versions as well.

Note

@@ -4085,7 +4085,7 @@

5.4.2. Tree structure

Table 3.2 Valid characters for alias names

Specifies the number of associativity sets in a unified cache. Required if the cache is -unified (combined instructions and data)

cache-block-size

SD

<u32>

Specifies the block size in bytes of a unified cache. Required if the processor has a unified -cache (combined instructions and data)

cache-line-size

SD

<u32>

Specifies the line size in bytes of a unified -cache, if different than the cache block size +cache, if different than the cache block size. Required if the processor has a unified cache (combined instructions and data).

Description

The label property defines a human readable string describing +

The label property defines a human-readable string describing a device. The binding for a given device specifies the exact meaning of the property for that device.

R

<u32>

Specifies the frequency (in Hz) of the baud -rate generator’s input clock

current-speed

OR

<u32>

Specifies current serial device speed in bits -per second

reg

R

Specifies the physical address of the registers device within the address space of -the parent bus

interrupts

OR

Value type

<prop-encoded-array> encoded as an array of hex numbers

<prop-encoded-array> encoded as an array of hex numbers.

Description

Specifies MAC address that was assigned to the network device @@ -3439,7 +3439,7 @@

4.3.1.3.

Value type

<prop-encoded-array> encoded as an array of hex numbers

<prop-encoded-array> encoded as an array of hex numbers.

Description

Specifies the MAC address that was last used by the boot @@ -3610,8 +3610,8 @@

4.3.2.3.

Description

Specifies a reference to a node representing a physical layer (PHY) device connected to this Ethernet device. This property -is required in case where the Ethernet device is connected a -physical layer device.

Example

phy-handle = <&PHY0>;

compatible

R

<string>

Value shall include "open-pic"

Value shall include "open-pic".

reg

R

Specifies the physical address of the registers device within the address space of -the parent bus

interrupt-controller

R

<empty>

Specifies that this node is an interrupt controller

Specifies that this node is an interrupt controller.

#interrupt-cells

R