devicetree/bindings/dts-coding-style.rst

1 .. SPDX-License-Identifier: GPL-2.0
16 ---------------------------
24    * Lowercase characters: [a-z]
25    * Digits: [0-9]
26    * Dash: -
30    * Lowercase characters: [a-z]
31    * Digits: [0-9]
42 	gpi_dma2: dma-controller@a00000 {
43 		compatible = "qcom,sm8550-gpi-dma", "qcom,sm6350-gpi-dma";
48 --------------
56 2. Nodes without unit addresses shall be ordered alpha-numerically by the node
61    ordered either alpha-numerically or by keeping the order from DTSI, where
64 The above-described ordering rules are easy to enforce during review, reduce
82 			dma: dma-controller@10000 {
86 			clk: clock-controller@80000 {
92 	/* Board DTS - alphabetical order */
102 	/* Board DTS - alternative order, keep as DTSI */
113 ----------------------------------
121    vendor-prefixes)
122 5. Vendor-specific properties
128 The above-described ordering follows this approach:
143 	device_node: device-class@6789abc {
147 		#dma-cells = <1>;
149 		clock-names = "bus", "host";
150 		#address-cells = <1>;
151 		#size-cells = <1>;
152 		vendor,custom-property = <2>;
155 		child_node: child-class@100 {
164 		vdd-0v9-supply = <&board_vreg1>;
165 		vdd-1v8-supply = <&board_vreg4>;
166 		vdd-3v3-supply = <&board_vreg2>;
167 		vdd-12v-supply = <&board_vreg3>;
172 ------------------------
175    Documentation/process/coding-style.rst.
185 	thermal-sensor@c271000 {
186 		compatible = "qcom,sm8550-tsens", "qcom,tsens-v2";
195 -----------------------
203 2. If applicable: DTSI with common or re-usable parts of the hardware, e.g.
204    entire System-on-Module.
209 external reference SoC input clock, which could be coded as a fixed-clock in