GNU Linux-libre 6.8.9-gnu
[releases.git] / Documentation / devicetree / bindings / arm / omap / omap.txt
1 * Texas Instruments OMAP
2
3 OMAP is currently using a static file per SoC family to describe the
4 IPs present in the SoC.
5 On top of that an omap_device is created to extend the platform_device
6 capabilities and to allow binding with one or several hwmods.
7 The hwmods will contain all the information to build the device:
8 address range, irq lines, dma lines, interconnect, PRCM register,
9 clock domain, input clocks.
10 For the moment just point to the existing hwmod, the next step will be
11 to move data from hwmod to device-tree representation.
12
13
14 Required properties:
15 - compatible: Every devices present in OMAP SoC should be in the
16   form: "ti,XXX"
17 - ti,hwmods: list of hwmod names (ascii strings), that comes from the OMAP
18   HW documentation, attached to a device. Must contain at least
19   one hwmod.
20
21 Optional properties:
22 - ti,no_idle_on_suspend: When present, it prevents the PM to idle the module
23   during suspend.
24 - ti,no-reset-on-init: When present, the module should not be reset at init
25 - ti,no-idle-on-init: When present, the module should not be idled at init
26 - ti,no-idle: When present, the module is never allowed to idle.
27
28 Example:
29
30 spinlock@1 {
31     compatible = "ti,omap4-spinlock";
32     ti,hwmods = "spinlock";
33 };
34
35 SoC Type (optional):
36
37 - General Purpose devices
38   compatible = "ti,gp"
39 - High Security devices
40   compatible = "ti,hs"
41
42 SoC Families:
43
44 - DRA7 generic - defaults to DRA742
45   compatible = "ti,dra7"
46 - AM33x generic
47   compatible = "ti,am33xx"
48 - AM43x generic - defaults to AM4372
49   compatible = "ti,am43"
50
51 SoCs:
52
53 - DRA762
54   compatible = "ti,dra762", "ti,dra7"
55
56 - DRA742
57   compatible = "ti,dra742", "ti,dra74", "ti,dra7"
58
59 - DRA722
60   compatible = "ti,dra722", "ti,dra72", "ti,dra7"
61
62 - DRA718
63   compatible = "ti,dra718", "ti,dra722", "ti,dra72", "ti,dra7"
64
65 - AM5748
66   compatible = "ti,am5748", "ti,dra762", "ti,dra7"
67
68 - AM5728
69   compatible = "ti,am5728", "ti,dra742", "ti,dra74", "ti,dra7"
70
71 - AM5726
72   compatible = "ti,am5726", "ti,dra742", "ti,dra74", "ti,dra7"
73
74 - AM5718
75   compatible = "ti,am5718", "ti,dra722", "ti,dra72", "ti,dra7"
76
77 - AM5716
78   compatible = "ti,am5716", "ti,dra722", "ti,dra72", "ti,dra7"
79
80 - AM4372
81   compatible = "ti,am4372", "ti,am43"
82
83 Boards (incomplete list of examples):
84
85
86 - AM437x CM-T43
87   compatible = "compulab,am437x-cm-t43", "ti,am4372", "ti,am43"
88
89 - AM437x SBC-T43
90   compatible = "compulab,am437x-sbc-t43", "compulab,am437x-cm-t43", "ti,am4372", "ti,am43"
91
92 - AM43x EPOS EVM
93   compatible = "ti,am43x-epos-evm", "ti,am43", "ti,am438x"
94
95 - AM437x GP EVM
96   compatible = "ti,am437x-gp-evm", "ti,am4372", "ti,am43"
97
98 - AM437x SK EVM: AM437x StarterKit Evaluation Module
99   compatible = "ti,am437x-sk-evm", "ti,am4372", "ti,am43"
100
101 - AM57XX CL-SOM-AM57x
102   compatible = "compulab,cl-som-am57x", "ti,am5728", "ti,dra742", "ti,dra74", "ti,dra7"
103
104 - AM57XX SBC-AM57x
105   compatible = "compulab,sbc-am57x", "compulab,cl-som-am57x", "ti,am5728", "ti,dra742", "ti,dra74", "ti,dra7"
106
107 - AM5748 IDK
108   compatible = "ti,am5748-idk", "ti,am5748", "ti,dra762", "ti,dra7";
109
110 - AM5728 IDK
111   compatible = "ti,am5728-idk", "ti,am5728", "ti,dra742", "ti,dra74", "ti,dra7"
112
113 - AM5718 IDK
114   compatible = "ti,am5718-idk", "ti,am5718", "ti,dra7"
115
116 - DRA762 EVM:  Software Development Board for DRA762
117   compatible = "ti,dra76-evm", "ti,dra762", "ti,dra7"
118
119 - DRA742 EVM:  Software Development Board for DRA742
120   compatible = "ti,dra7-evm", "ti,dra742", "ti,dra74", "ti,dra7"
121
122 - DRA722 EVM: Software Development Board for DRA722
123   compatible = "ti,dra72-evm", "ti,dra722", "ti,dra72", "ti,dra7"
124
125 - DRA718 EVM: Software Development Board for DRA718
126   compatible = "ti,dra718-evm", "ti,dra718", "ti,dra722", "ti,dra72", "ti,dra7"