linux/arch/arm64/boot/dts
Nishanth Menon 5d1bedf252 arm64: dts: ti: k3-j721e*: Cleanup disabled nodes at SoC dtsi level
The device tree standard states that when the status property is
not present under a node, the okay value is assumed. There are many
reasons for doing the same, the number of strings in the device
tree, default power management functionality, etc. are a few of the
reasons.

In general, after a few rounds of discussions [1] there are few
options one could take when dealing with SoC dtsi and board dts

a. SoC dtsi provide nodes as a super-set default (aka enabled) state and
   to prevent messy board files, when more boards are added per SoC, we
   optimize and disable commonly un-used nodes in board-common.dtsi
b. SoC dtsi disables all hardware dependent nodes by default and board
   dts files enable nodes based on a need basis.
c. Subjectively pick and choose which nodes we will disable by default
   in SoC dtsi and over the years we can optimize things and change
   default state depending on the need.

While there are pros and cons on each of these approaches, the right
thing to do will be to stick with device tree default standards and
work within those established rules. So, we choose to go with option
(a).

Lets cleanup defaults of j721e SoC dtsi before this gets more harder
to cleanup later on and new SoCs are added.

The only functional difference between the dtb generated is
status='okay' is no longer necessary for mcasp10 and depends on the
default state.

NOTE: There is a known risk of omission that new board dts developers
might miss reviewing both the board schematics in addition to all the
DT nodes of the SoC when setting appropriate nodes status to disable
or reserved in the board dts. This can expose issues in drivers that
may not anticipate an incomplete node (example: missing appropriate
board properties) being in an "okay" state. These cases are considered
bugs and need to be fixed in the drivers as and when identified.

[1] https://lore.kernel.org/linux-arm-kernel/20201027130701.GE5639@atomide.com/

Signed-off-by: Nishanth Menon <nm@ti.com>
Reviewed-by: Tomi Valkeinen <tomi.valkeinen@ti.com>
Reviewed-by: Tony Lindgren <tony@atomide.com>
Cc: Jyri Sarha <jsarha@ti.com>
Cc: Tomi Valkeinen <tomi.valkeinen@ti.com>
Cc: Peter Ujfalusi <peter.ujfalusi@ti.com>
Cc: Tony Lindgren <tony@atomide.com>
Link: https://lore.kernel.org/r/20201113211826.13087-3-nm@ti.com
2020-11-17 06:48:00 -06:00
..
actions arm64: dts: actions: Add DMA Controller for S700 2020-09-22 12:41:36 +05:30
allwinner ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
altera arm64: dts: stratix10/agilex: add the ptp_ref clock 2020-08-31 12:56:55 -05:00
amazon arm64: dts: alpine: Fix GIC unit address 2020-09-11 17:42:30 +02:00
amd
amlogic arm64: dts: meson: initial support for aml-s905x-cc v2 2020-09-18 13:35:27 -07:00
apm arm64: dts: apm: add required gpio-cells to DW APB GPIO controller port 2020-09-26 09:50:18 -07:00
arm arm64: dts: arm: Fix SP805 clock-names 2020-09-07 10:54:08 +01:00
bitmain
broadcom ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
cavium
exynos ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
freescale ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
hisilicon arm64: dts: hisilicon: Fix SP805 clocks 2020-09-14 15:27:04 +08:00
intel arm64: dts: stratix10/agilex: add the ptp_ref clock 2020-08-31 12:56:55 -05:00
lg arm64: dts: lg: Fix SP804 users 2020-10-03 12:56:46 -07:00
marvell pinctrl: armada-37xx: Add comment for pcie1_reset pin group 2020-08-27 10:25:17 +02:00
mediatek ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
microchip arm64: dts: sparx5: Add spi-nand devices 2020-09-16 11:39:51 +02:00
nvidia ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
qcom ARM: Devicetree updates 2020-10-24 10:44:18 -07:00
realtek
renesas arm64: dts: renesas: r8a774c0: Fix MSIOF1 DMA channels 2020-09-18 09:10:58 +02:00
rockchip arm64: dts: rockchip: add ir-receiver node to rk3399-khadas-edge 2020-09-23 15:39:58 +02:00
socionext arm64: dts: uniphier: Add missing clock-names and reset-names to pcie-phy 2020-07-10 10:33:28 +09:00
sprd arm64: dts: Add SC9863A emmc and sd card nodes 2020-05-21 11:50:44 +02:00
synaptics
ti arm64: dts: ti: k3-j721e*: Cleanup disabled nodes at SoC dtsi level 2020-11-17 06:48:00 -06:00
toshiba arm64: dts: visconti: Add device tree for TMPV7708 RM main board 2020-09-23 17:09:17 +09:00
xilinx arm64: dts: zynqmp: Fix leds subnode name for zcu100/ultra96 v1 2020-09-29 13:01:20 +02:00
zte
Makefile arm64: dts: visconti: Add device tree for TMPV7708 RM main board 2020-09-23 17:09:17 +09:00