summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/hsi/omap_ssi.txt
blob: e3597ebd76c7c57a6fbd596e1b9e3b46f851ee35 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
OMAP SSI controller bindings

Required properties:
- compatible:		Should be set to the following value
                        ti,omap3-ssi (applicable to OMAP34xx devices)
- ti,hwmods:		Name of the hwmod associated to the controller, which
			is "ssi".
- reg:			Contains SSI register address range (base address and
			length).
- reg-names:		Contains the names of the address ranges. It's
                        expected, that "sys" and "gdd" address ranges are
			provided.
- interrupts: 		Contains the interrupt information for the controller.
- interrupt-names:      Contains the names of the interrupts. It's expected,
			that "gdd_mpu" is provided.
- ranges		Required as an empty node
- #address-cells	Should be set to <1>
- #size-cells		Should be set to <1>

Each port is represented as a sub-node of the ti,omap3-ssi device.

Required Port sub-node properties:
- compatible:		Should be set to the following value
                        ti,omap3-ssi-port (applicable to OMAP34xx devices)
- reg:			Contains port's register address range (base address
			and length).
- reg-names:		Contains the names of the address ranges. It's
                        expected, that "tx" and "rx" address ranges are
			provided.
- interrupt-parent	Should be a phandle for the interrupt controller
- interrupts:		Contains the interrupt information for the port.
- interrupt-names:	Contains the names of the interrupts. It's expected,
			that "mpu_irq0" and "mpu_irq1" are provided.
- ti,ssi-cawake-gpio:	Defines which GPIO pin is used to signify CAWAKE
			events for the port. This is an optional board-specific
			property. If it's missing the port will not be
			enabled.

Example for Nokia N900:

ssi-controller@48058000 {
	compatible = "ti,omap3-ssi";
	ti,hwmods = "ssi";

	reg = <0x48058000 0x1000>,
	      <0x48059000 0x1000>;
	reg-names = "sys",
		    "gdd";

	interrupts = <55>;
	interrupt-names = "gdd_mpu";

	#address-cells = <1>;
	#size-cells = <1>;
	ranges;

	ssi-port@0 {
		compatible = "ti,omap3-ssi-port";

		reg = <0x4805a000 0x800>,
		      <0x4805a800 0x800>;
		reg-names = "tx",
			    "rx";

		interrupt-parent = <&intc>;
		interrupts = <51>,
			     <52>;
		interrupt-names = "mpu_irq0",
				  "mpu_irq1";

		ti,ssi-cawake-gpio = <&gpio5 23 GPIO_ACTIVE_HIGH>; /* 151 */
	}
}