Skip to contentSkip to conversation

arm64: dts: qcom: sc7280: Introduce herobrine-rev1

PATCH Superseded Douglas Anderson 4 participants 16 messages Jan 14, 2022 – Jan 21, 2022

Subsystems (4)

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore
#0 lore raw

cover arm64: dts: qcom: sc7280: Introduce herobrine-rev1

This series adds support for herobrine-rev1. Note that it's likely that with the introduction of -rev1 we can drop -rev0 support, but we'll keep it for now (though we won't try to "fit it in" and share code with it).

This series is confirmed to boot herobrine-rev1 atop mainline, commit fb3b0673b7d5 ("Merge tag 'mailbox-v5.17' of
git://git.linaro.org/landing-teams/working/fujitsu/integration"),
though it requires a hack to work around a misconfigured DMA for i2c14 (https://crrev.com/c/3378660)

Douglas Anderson (4):
arm64: dts: qcom: sc7280: Fix gmu unit address
arm64: dts: qcom: sc7280: Move herobrine-r0 to its own dts
arm64: dts: qcom: sc7280: Factor out Chrome common fragment
arm64: dts: qcom: sc7280: Add herobrine-r1

 arch/arm64/boot/dts/qcom/Makefile             |    3 +-
 .../boot/dts/qcom/sc7280-chrome-common.dtsi   |   97 ++
 .../qcom/sc7280-herobrine-herobrine-r0.dts    | 1352 +++++++++++++++++
 .../qcom/sc7280-herobrine-herobrine-r1.dts    |  314 ++++
 arch/arm64/boot/dts/qcom/sc7280-herobrine.dts |   14 -
 .../arm64/boot/dts/qcom/sc7280-herobrine.dtsi | 1045 +++----------
 arch/arm64/boot/dts/qcom/sc7280-idp.dtsi      |   75 +-
 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi    |  557 +++++++
 arch/arm64/boot/dts/qcom/sc7280.dtsi          |    2 +-
 9 files changed, 2532 insertions(+), 927 deletions(-)
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts
 delete mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine.dts
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi
Signature · 1 line
2.34.1.703.g22d0c6ccf7-goog
#1 lore raw

PATCH 1/4 arm64: dts: qcom: sc7280: Fix gmu unit address

When processing sc7280 device trees, I can see:

Warning (simple_bus_reg): /soc@0/gmu@3d69000:
simple-bus unit address format error, expected "3d6a000"

There's a clear typo in the node name. Fix it.

Fixes 96c471970b7b ("arm64: dts: qcom: sc7280: Add gpu support")

---

 arch/arm64/boot/dts/qcom/sc7280.dtsi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
arch/arm64/boot/dts/qcom/sc7280.dtsi +1 -1
index 937c2e0e93eb..eab7a8505053 100644
@@ -1790,7 +1790,7 @@ opp-550000000 {
 			};
 		};
 
-		gmu: gmu@3d69000 {
+		gmu: gmu@3d6a000 {
 			compatible="qcom,adreno-gmu-635.0", "qcom,adreno-gmu";
 			reg = <0 0x03d6a000 0 0x34000>,
 				<0 0x3de0000 0 0x10000>,
Signature · 1 line
2.34.1.703.g22d0c6ccf7-goog
Reviewed-by on v1 1/4
#2 lore raw

Re: [PATCH 1/4] arm64: dts: qcom: sc7280: Fix gmu unit address

Quoting Douglas Anderson (2022-01-13 16:43:00)

Quoted 10 lines

When processing sc7280 device trees, I can see:

Warning (simple_bus_reg): /soc@0/gmu@3d69000:
simple-bus unit address format error, expected "3d6a000"

There's a clear typo in the node name. Fix it.

Fixes 96c471970b7b ("arm64: dts: qcom: sc7280: Add gpu support")

---

BTW, gmu isn't a "standard" node name so might be worth replacing that with something else but I have no idea what. Maybe "firmware" or "power-controller"?

#3 lore raw

Re: [PATCH 1/4] arm64: dts: qcom: sc7280: Fix gmu unit address

Hi,

Quoted 7 lines · Stephen Boyd

Quoting Douglas Anderson (2022-01-13 16:43:00)

Quoted 5 lines

When processing sc7280 device trees, I can see:

Warning (simple_bus_reg): /soc@0/gmu@3d69000:
simple-bus unit address format error, expected "3d6a000"

Quoted 7 lines
Quoted 5 lines

There's a clear typo in the node name. Fix it.

Fixes 96c471970b7b ("arm64: dts: qcom: sc7280: Add gpu support")

---

Thanks for all the reviews!

Quoted 3 lines

BTW, gmu isn't a "standard" node name so might be worth replacing that with something else but I have no idea what. Maybe "firmware" or "power-controller"?

"gmu" matches what's in the "example" in Documentation/devicetree/bindings/display/msm/gmu.yaml. That was blessed by Rob Herring. If you think it should be something different, perhaps post a patch changing the example in the bindings?

-Doug

Reviewed-by on v1 1/4
#4 lore raw

Re: [PATCH 1/4] arm64: dts: qcom: sc7280: Fix gmu unit address

In reply to Douglas Anderson
Quoted 9 lines · Douglas Anderson

When processing sc7280 device trees, I can see:

Warning (simple_bus_reg): /soc@0/gmu@3d69000:
simple-bus unit address format error, expected "3d6a000"

There's a clear typo in the node name. Fix it.

Fixes 96c471970b7b ("arm64: dts: qcom: sc7280: Add gpu support")
#5 lore raw

PATCH 2/4 arm64: dts: qcom: sc7280: Move herobrine-r0 to its own dts

In reply to Douglas Anderson

The upcoming herobrine-r1 board is really not very similar to herobrine-r0. Let's get rid of the "herobrine.dtsi" file and stick all the content in the -r0 dts file directly. We'll also rename the dts so it's obvious that it's just for -r0.

While renaming, let's actually name the file so it's obvious that "herobrine" is both the name of the board and the name of the "baseboard". In other words "herobrine" is an actual board but also often used as the name of a whole class of similar boards that forked from a design. While "herobrine-herobrine" is a bit of mouthful it makes it more obvious which things are part of an actual board rather than the baseboard.

NOTE: herobrine-rev0's days are likely doomed and this device tree is likely to be deleted in the future.

---

 arch/arm64/boot/dts/qcom/Makefile                  |  2 +-
 ...rine.dtsi => sc7280-herobrine-herobrine-r0.dts} |  6 ++++++
 arch/arm64/boot/dts/qcom/sc7280-herobrine.dts      | 14 --------------
 3 files changed, 7 insertions(+), 15 deletions(-)
 rename arch/arm64/boot/dts/qcom/{sc7280-herobrine.dtsi => sc7280-herobrine-herobrine-r0.dts} (99%)
 delete mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine.dts
arch/arm64/boot/dts/qcom/Makefile +1 -1
index f7232052d286..9db743826391 100644
@@ -82,7 +82,7 @@ dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-pompom-r3.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-pompom-r3-lte.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1-lte.dtb
-dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine.dtb
+dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine-herobrine-r0.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp2.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-crd.dtb
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts renamed from arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi +6 -0
similarity index 99%
rename from arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi
rename to arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts
index 4619fa9fcacd..8676c93590b5 100644
@@ -22,6 +22,12 @@
 #include "pm8350c.dtsi"
 #include "pmk8350.dtsi"
 
+/ {
+	model = "Google Herobrine (rev0)";
+	compatible = "google,herobrine",
+		     "qcom,sc7280";
+};
+
 /*
  * Reserved memory changes
  *
arch/arm64/boot/dts/qcom/sc7280-herobrine.dts deleted +0 -14
deleted file mode 100644
index 7a92679a688b..000000000000
@@ -1,14 +0,0 @@
-// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
-/*
- * Google Herobrine board device tree source
- *
- * Copyright 2021 Google LLC.
- */
-
-#include "sc7280-herobrine.dtsi"
-
-/ {
-	model = "Google Herobrine";
-	compatible = "google,herobrine",
-		     "qcom,sc7280";
-};
Signature · 1 line
2.34.1.703.g22d0c6ccf7-goog
Reviewed-by on v1 2/4
#6 lore raw

Re: [PATCH 2/4] arm64: dts: qcom: sc7280: Move herobrine-r0 to its own dts

Quoting Douglas Anderson (2022-01-13 16:43:01)

Quoted 13 lines

The upcoming herobrine-r1 board is really not very similar to herobrine-r0. Let's get rid of the "herobrine.dtsi" file and stick all the content in the -r0 dts file directly. We'll also rename the dts so it's obvious that it's just for -r0.

While renaming, let's actually name the file so it's obvious that "herobrine" is both the name of the board and the name of the "baseboard". In other words "herobrine" is an actual board but also often used as the name of a whole class of similar boards that forked from a design. While "herobrine-herobrine" is a bit of mouthful it makes it more obvious which things are part of an actual board rather than the baseboard.

Quoted 5 lines

NOTE: herobrine-rev0's days are likely doomed and this device tree is likely to be deleted in the future.

---

Reviewed-by on v1 2/4
#7 lore raw

Re: [PATCH 2/4] arm64: dts: qcom: sc7280: Move herobrine-r0 to its own dts

In reply to Douglas Anderson
Quoted 13 lines · Douglas Anderson

The upcoming herobrine-r1 board is really not very similar to herobrine-r0. Let's get rid of the "herobrine.dtsi" file and stick all the content in the -r0 dts file directly. We'll also rename the dts so it's obvious that it's just for -r0.

While renaming, let's actually name the file so it's obvious that "herobrine" is both the name of the board and the name of the "baseboard". In other words "herobrine" is an actual board but also often used as the name of a whole class of similar boards that forked from a design. While "herobrine-herobrine" is a bit of mouthful it makes it more obvious which things are part of an actual board rather than the baseboard.

Quoted 4 lines

NOTE: herobrine-rev0's days are likely doomed and this device tree is likely to be deleted in the future.

#8 lore raw

PATCH 3/4 arm64: dts: qcom: sc7280: Factor out Chrome common fragment

In reply to Douglas Anderson

This factors out a device tree fragment from some sc7280 device trees. It represents the device tree bits that should be included for "Chrome" based sc7280 boards. On these boards the bootloader (Coreboot
+ Depthcharge) configures things slightly different than the bootloader that Qualcomm provides. The modem firmware on these boards also works differently than on other Qulacomm products and thus the reserved memory map needs to be adjusted.

NOTES:
- This is _not_ quite a no-op change. The "herobrine" and "idp" fragments here were different and it looks like someone simply forgot to update the herobrine version. This updates a few numbers to match IDP. This will also cause the pmk8350_pon to be disabled on idp/crd, which I belive is a correct change.
- At the moment this assumes LTE skus. Once it's clearer how WiFi SKUs will work (how much of the memory map they can reclaim) we may add an extra fragment that will rejigger one way or the other.

---

 .../boot/dts/qcom/sc7280-chrome-common.dtsi   | 97 +++++++++++++++++++
 .../qcom/sc7280-herobrine-herobrine-r0.dts    | 70 +------------
 arch/arm64/boot/dts/qcom/sc7280-idp.dtsi      | 75 +-------------
 3 files changed, 101 insertions(+), 141 deletions(-)
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi
arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi new file +97 -0
new file mode 100644
index 000000000000..9d4f25f77152
@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * sc7280 fragment for devices with Chrome bootloader
+ *
+ * This file mainly tries to abstract out the memory protections put into
+ * place by the Chrome bootloader which are different than what's put into
+ * place by Qualcomm's typical bootloader. It also has a smattering of other
+ * things that will hold true for any conceivable Chrome design
+ *
+ * Copyright 2022 Google LLC.
+ */
+
+/*
+ * Reserved memory changes
+ *
+ * Delete all unused memory nodes and define the peripheral memory regions
+ * required by the setup for Chrome boards.
+ */
+
+/delete-node/ &hyp_mem;
+/delete-node/ &xbl_mem;
+/delete-node/ &reserved_xbl_uefi_log;
+/delete-node/ &sec_apps_mem;
+
+/ {
+	reserved-memory {
+		adsp_mem: memory@86700000 {
+			reg = <0x0 0x86700000 0x0 0x2800000>;
+			no-map;
+		};
+
+		camera_mem: memory@8ad00000 {
+			reg = <0x0 0x8ad00000 0x0 0x500000>;
+			no-map;
+		};
+
+		venus_mem: memory@8b200000 {
+			reg = <0x0 0x8b200000 0x0 0x500000>;
+			no-map;
+		};
+
+		mpss_mem: memory@8b800000 {
+			reg = <0x0 0x8b800000 0x0 0xf600000>;
+			no-map;
+		};
+
+		wpss_mem: memory@9ae00000 {
+			reg = <0x0 0x9ae00000 0x0 0x1900000>;
+			no-map;
+		};
+
+		mba_mem: memory@9c700000 {
+			reg = <0x0 0x9c700000 0x0 0x200000>;
+			no-map;
+		};
+	};
+};
+
+/* The PMIC PON code isn't compatible w/ how Chrome EC/BIOS handle things. */
+&pmk8350_pon {
+	status = "disabled";
+};
+
+/*
+ * Chrome designs always boot from SPI flash hooked up to the qspi.
+ *
+ * It's expected that all boards will support "dual SPI" at 37.5 MHz.
+ * If some boards need a different speed or have a package that allows
+ * Quad SPI together with WP then those boards can easily override.
+ */
+&qspi {
+	status = "okay";
+	pinctrl-names = "default";
+	pinctrl-0 = <&qspi_clk>, <&qspi_cs0>, <&qspi_data01>;
+
+	spi_flash: flash@0 {
+		compatible = "jedec,spi-nor";
+		reg = <0>;
+
+		spi-max-frequency = <37500000>;
+		spi-tx-bus-width = <2>;
+		spi-rx-bus-width = <2>;
+	};
+};
+
+/* Modem setup is different on Chrome setups than typical Qualcomm setup */
+&remoteproc_mpss {
+	status = "okay";
+	compatible = "qcom,sc7280-mss-pil";
+	iommus = <&apps_smmu 0x124 0x0>, <&apps_smmu 0x488 0x7>;
+	memory-region = <&mba_mem &mpss_mem>;
+};
+
+/* Increase the size from 2.5MB to 8MB */
+&rmtfs_mem {
+	reg = <0x0 0x9c900000 0x0 0x800000>;
+};
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +2 -68

95 lines not on this page · raw message

arch/arm64/boot/dts/qcom/sc7280-idp.dtsi +2 -73

99 lines not on this page · raw message

Signature · 1 line
2.34.1.703.g22d0c6ccf7-goog
Reviewed-by on v1 3/4
#9 lore raw

Re: [PATCH 3/4] arm64: dts: qcom: sc7280: Factor out Chrome common fragment

Quoting Douglas Anderson (2022-01-13 16:43:02)

Quoted 18 lines

This factors out a device tree fragment from some sc7280 device trees. It represents the device tree bits that should be included for "Chrome" based sc7280 boards. On these boards the bootloader (Coreboot
+ Depthcharge) configures things slightly different than the bootloader that Qualcomm provides. The modem firmware on these boards also works differently than on other Qulacomm products and thus the reserved memory map needs to be adjusted.

NOTES:
- This is _not_ quite a no-op change. The "herobrine" and "idp" fragments here were different and it looks like someone simply forgot to update the herobrine version. This updates a few numbers to match IDP. This will also cause the pmk8350_pon to be disabled on idp/crd, which I belive is a correct change.
- At the moment this assumes LTE skus. Once it's clearer how WiFi SKUs will work (how much of the memory map they can reclaim) we may add an extra fragment that will rejigger one way or the other.

Quoted 2 lines

---

One comment below.

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi new file +0 -0
new file mode 100644
index 000000000000..9d4f25f77152
@@ -0,0 +1,97 @@

[...]

arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi line 91

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi new file +7 -0
+
+/* Modem setup is different on Chrome setups than typical Qualcomm setup */
+&remoteproc_mpss {
+       status = "okay";
+       compatible = "qcom,sc7280-mss-pil";
+       iommus = <&apps_smmu 0x124 0x0>, <&apps_smmu 0x488 0x7>;
+       memory-region = <&mba_mem &mpss_mem>;

I'd prefer this be

	memory-region = <&mba_mem>, <&mpss_mem>;

so that we know mpss_mem isn't an "argument" or cell for mba_mem. I see that this is just moving around in this patch though so probably can be done in a followup.

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-chrome-common.dtsi new file +6 -0
+};
+
+/* Increase the size from 2.5MB to 8MB */
+&rmtfs_mem {
+       reg = <0x0 0x9c900000 0x0 0x800000>;
+};
Reviewed-by on v1 3/4
#10 lore raw

Re: [PATCH 3/4] arm64: dts: qcom: sc7280: Factor out Chrome common fragment

In reply to Douglas Anderson
Quoted 18 lines · Douglas Anderson

This factors out a device tree fragment from some sc7280 device trees. It represents the device tree bits that should be included for "Chrome" based sc7280 boards. On these boards the bootloader (Coreboot
+ Depthcharge) configures things slightly different than the bootloader that Qualcomm provides. The modem firmware on these boards also works differently than on other Qulacomm products and thus the reserved memory map needs to be adjusted.

NOTES:
- This is _not_ quite a no-op change. The "herobrine" and "idp" fragments here were different and it looks like someone simply forgot to update the herobrine version. This updates a few numbers to match IDP. This will also cause the pmk8350_pon to be disabled on idp/crd, which I belive is a correct change.
- At the moment this assumes LTE skus. Once it's clearer how WiFi SKUs will work (how much of the memory map they can reclaim) we may add an extra fragment that will rejigger one way or the other.

Quoted 1 line
#11 lore raw

PATCH 4/4 arm64: dts: qcom: sc7280: Add herobrine-r1

In reply to Douglas Anderson

Add the new herobrine-r1. Note that this is pretty much a re-design compared to herobrine-r0 so we don't attempt any dtsi to share stuff between them.

This patch attempts to define things at 3 levels:

1. The Qcard level. Herobrine includes a Qcard PCB and the Qcard PCB is supposed to be the same (modulo stuffing options) across multiple boards, so trying to define what's there hopefully makes sense. NOTE that newer "CRD" boards from Qualcomm also use Qcard. When support for CRD3 is added hopefully it can use the Qcard include (and perhaps we should even evaluate it using herobrine.dtsi?)
2. The herobrine "baseboard" level. Right now most stuff is here with the exception of things that we _know_ will be different per board. We know that not all boards will have the same set of eMMC, nvme, and SD. We also know that the exact pin names are likely to be different.
3. The actual "board" level, AKA herobrine-rev1.

NOTES:
- This boots to command prompt, but no eDP yet since eDP hasn't been added to sc7280.dtsi yet.
- This assumes LTE for now. Once it's clear how WiFi-only SKUs will work we expect some small changes.

---

 arch/arm64/boot/dts/qcom/Makefile             |   1 +
 .../qcom/sc7280-herobrine-herobrine-r0.dts    |   2 +-
 .../qcom/sc7280-herobrine-herobrine-r1.dts    | 314 +++++++
 .../arm64/boot/dts/qcom/sc7280-herobrine.dtsi | 781 ++++++++++++++++++
 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi    | 557 +++++++++++++
 5 files changed, 1654 insertions(+), 1 deletion(-)
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi
arch/arm64/boot/dts/qcom/Makefile +1 -0
index 9db743826391..54998e108092 100644
@@ -83,6 +83,7 @@ dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-pompom-r3-lte.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1-lte.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine-herobrine-r0.dtb
+dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine-herobrine-r1.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp2.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-crd.dtb
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +1 -1
index 67680a13c234..dcd10d0ead1e 100644
@@ -26,7 +26,7 @@
 
 / {
 	model = "Google Herobrine (rev0)";
-	compatible = "google,herobrine",
+	compatible = "google,herobrine-rev0",
 		     "qcom,sc7280";
 };
 
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +314 -0

314 lines not on this page · raw message

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +781 -0

781 lines not on this page · raw message

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +557 -0

557 lines not on this page · raw message

Signature · 1 line
2.34.1.703.g22d0c6ccf7-goog
Reviewed-by on v1 4/4
#12 lore raw

Re: [PATCH 4/4] arm64: dts: qcom: sc7280: Add herobrine-r1

Quoting Douglas Anderson (2022-01-13 16:43:03)

Quoted 20 lines

Add the new herobrine-r1. Note that this is pretty much a re-design compared to herobrine-r0 so we don't attempt any dtsi to share stuff between them.

This patch attempts to define things at 3 levels:

1. The Qcard level. Herobrine includes a Qcard PCB and the Qcard PCB is supposed to be the same (modulo stuffing options) across multiple boards, so trying to define what's there hopefully makes sense. NOTE that newer "CRD" boards from Qualcomm also use Qcard. When support for CRD3 is added hopefully it can use the Qcard include (and perhaps we should even evaluate it using herobrine.dtsi?)
2. The herobrine "baseboard" level. Right now most stuff is here with the exception of things that we _know_ will be different per board. We know that not all boards will have the same set of eMMC, nvme, and SD. We also know that the exact pin names are likely to be different.
3. The actual "board" level, AKA herobrine-rev1.

Quoted 8 lines

NOTES:
- This boots to command prompt, but no eDP yet since eDP hasn't been added to sc7280.dtsi yet.
- This assumes LTE for now. Once it's clear how WiFi-only SKUs will work we expect some small changes.

---

Reviewed-by on v1 4/4
#13 lore raw

Re: [PATCH 4/4] arm64: dts: qcom: sc7280: Add herobrine-r1

In reply to Douglas Anderson
Quoted 20 lines · Douglas Anderson

Add the new herobrine-r1. Note that this is pretty much a re-design compared to herobrine-r0 so we don't attempt any dtsi to share stuff between them.

This patch attempts to define things at 3 levels:

1. The Qcard level. Herobrine includes a Qcard PCB and the Qcard PCB is supposed to be the same (modulo stuffing options) across multiple boards, so trying to define what's there hopefully makes sense. NOTE that newer "CRD" boards from Qualcomm also use Qcard. When support for CRD3 is added hopefully it can use the Qcard include (and perhaps we should even evaluate it using herobrine.dtsi?)
2. The herobrine "baseboard" level. Right now most stuff is here with the exception of things that we _know_ will be different per board. We know that not all boards will have the same set of eMMC, nvme, and SD. We also know that the exact pin names are likely to be different.
3. The actual "board" level, AKA herobrine-rev1.

Quoted 7 lines

NOTES:
- This boots to command prompt, but no eDP yet since eDP hasn't been added to sc7280.dtsi yet.
- This assumes LTE for now. Once it's clear how WiFi-only SKUs will work we expect some small changes.

#14 lore raw

Re: [PATCH 4/4] arm64: dts: qcom: sc7280: Add herobrine-r1

In reply to Douglas Anderson

Hi!

Your DTs look good, but incorporate some weird style decisions..

Quoted 58 lines · Douglas Anderson

Add the new herobrine-r1. Note that this is pretty much a re-design compared to herobrine-r0 so we don't attempt any dtsi to share stuff between them.

This patch attempts to define things at 3 levels:

1. The Qcard level. Herobrine includes a Qcard PCB and the Qcard PCB is supposed to be the same (modulo stuffing options) across multiple boards, so trying to define what's there hopefully makes sense. NOTE that newer "CRD" boards from Qualcomm also use Qcard. When support for CRD3 is added hopefully it can use the Qcard include (and perhaps we should even evaluate it using herobrine.dtsi?)
2. The herobrine "baseboard" level. Right now most stuff is here with the exception of things that we _know_ will be different per board. We know that not all boards will have the same set of eMMC, nvme, and SD. We also know that the exact pin names are likely to be different.
3. The actual "board" level, AKA herobrine-rev1.

NOTES:
- This boots to command prompt, but no eDP yet since eDP hasn't been added to sc7280.dtsi yet.
- This assumes LTE for now. Once it's clear how WiFi-only SKUs will work we expect some small changes.

---

 arch/arm64/boot/dts/qcom/Makefile             |   1 +
 .../qcom/sc7280-herobrine-herobrine-r0.dts    |   2 +-
 .../qcom/sc7280-herobrine-herobrine-r1.dts    | 314 +++++++
 .../arm64/boot/dts/qcom/sc7280-herobrine.dtsi | 781 ++++++++++++++++++
 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi    | 557 +++++++++++++
 5 files changed, 1654 insertions(+), 1 deletion(-)
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi
 create mode 100644 arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi
arch/arm64/boot/dts/qcom/Makefile +1 -0
index 9db743826391..54998e108092 100644
@@ -83,6 +83,7 @@ dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-pompom-r3-lte.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7180-trogdor-r1-lte.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine-herobrine-r0.dtb
+dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-herobrine-herobrine-r1.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-idp2.dtb
 dtb-$(CONFIG_ARCH_QCOM)	+= sc7280-crd.dtb
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +0 -0
index 67680a13c234..dcd10d0ead1e 100644

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts line 30

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +1 -1
@@ -26,7 +26,7 @@
 
 / {
 	model = "Google Herobrine (rev0)";
-	compatible = "google,herobrine",
+	compatible = "google,herobrine-rev0",
 		     "qcom,sc7280";

Why break the line here?

Quoted 11 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +0 -0
 };
 
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +3 -0
new file mode 100644
index 000000000000..c57bd689df23
@@ -0,0 +1,314 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * Google Herobrine board device tree source

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 13

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+ *
+ * Copyright 2022 Google LLC.
+ */
+
+/dts-v1/;
+
+#include "sc7280-herobrine.dtsi"
+
+/ {
+	model = "Google Herobrine (rev1+)";

Are you sure there won't be any changes significant enough in the future that will make rev2 or rev7 or rev8192 incompatible with the rev1+ DT?

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 15

Quoted 2 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +2 -0
+	compatible = "google,herobrine",
+		     "qcom,sc7280";

Why break the line here?

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 18

Quoted 3 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +3 -0
+};
+
+/* ADDITIONS TO NODES DEFINED IN PARENT DEVICE TREE FILES */

This is superfluous at best.

Quoted 26 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +26 -0
+
+&ap_spi_fp {
+	status = "okay";
+};
+
+/*
+ * Although the trackpad is really part of the herobrine baseboard, we'll
+ * put the actual definition in the board device tree since different boards
+ * might hook up different trackpads (or no i2c trackpad at all in the case
+ * of tablets / detachables).
+ */
+ap_tp_i2c: &i2c0 {
+	status = "okay";
+	clock-frequency = <400000>;
+
+	trackpad: trackpad@15 {
+		compatible = "elan,ekth3000";
+		reg = <0x15>;
+		pinctrl-names = "default";
+		pinctrl-0 = <&tp_int_odl>;
+
+		interrupt-parent = <&tlmm>;
+		interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
+
+		vcc-supply = <&pp3300_z1>;
+

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 54

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+		wakeup-source;
+	};
+};
+
+/*
+ * The touchscreen connector might come off the Qcard, at least in the case of
+ * eDP. Like the trackpad, we'll put it in the board device tree file since
+ * different boards have different touchscreens.
+ */
+ts_i2c: &i2c13 {

Either sort these by their i2c aliases, or by their new ones.. currently it is not alphabetically sorted at all..

Looks like some nodes below are just thrown at random places too..

Quoted 15 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +15 -0
+	status = "okay";
+	clock-frequency = <400000>;
+
+	ap_ts: touchscreen@5c {
+		compatible = "hid-over-i2c";
+		reg = <0x5c>;
+		pinctrl-names = "default";
+		pinctrl-0 = <&ts_int_conn>, <&ts_rst_conn>;
+
+		interrupt-parent = <&tlmm>;
+		interrupts = <55 IRQ_TYPE_LEVEL_LOW>;
+
+		post-power-on-delay-ms = <500>;
+		hid-descr-addr = <0x0000>;
+

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 79

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+		vdd-supply = <&ts_avdd>;
+	};
+};
+
+/* For nvme */
+&pcie1 {
+	status = "okay";
+};
+
+/* For nvme */

I think this is kind of obvious and there is no need for this to be said twice within 10 lines..

Quoted 5 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +5 -0
+&pcie1_phy {
+	status = "okay";
+};
+
+/* For eMMC */

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 94

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+&sdhc_1 {
+	status = "okay";
+};
+
+/* For SD Card */
+&sdhc_2 {
+	status = "okay";
+};
+
+/* PINCTRL - BOARD-SPECIFIC */

This is also kind of obvious, if it wasn't board-specific, it wouldn't be in the board DT..

Quoted 33 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +33 -0
+
+/*
+ * Methodology for gpio-line-names:
+ * - If a pin goes to herobrine board and is named it gets that name.
+ * - If a pin goes to herobrine board and is not named, it gets no name.
+ * - If a pin is totally internal to Qcard then it gets Qcard name.
+ * - If a pin is not hooked up on Qcard, it gets no name.
+ */
+
+&pm8350c_gpios {
+	gpio-line-names = "FLASH_STROBE_1",		/* 1 */
+			  "AP_SUSPEND",
+			  "PM8008_1_RST_N",
+			  "",
+			  "",
+			  "",
+			  "PMIC_EDP_BL_EN",
+			  "PMIC_EDP_BL_PWM",
+			  "";
+};
+
+&tlmm {
+	gpio-line-names = "AP_TP_I2C_SDA",		/* 0 */
+			  "AP_TP_I2C_SCL",
+			  "SSD_RST_L",
+			  "PE_WAKE_ODL",
+			  "AP_SAR_SDA",
+			  "AP_SAR_SCL",
+			  "PRB_SC_GPIO_6",
+			  "TP_INT_ODL",
+			  "HP_I2C_SDA",
+			  "HP_I2C_SCL",
+

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 137

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+			  "GNSS_L1_EN",			/* 10 */
+			  "GNSS_L5_EN",
+			  "SPI_AP_MOSI",
+			  "SPI_AP_MISO",
+			  "SPI_AP_CLK",
+			  "SPI_AP_CS0_L",
+			  /*
+			   * AP_FLASH_WP is crossystem ABI. Schematics
+			   * call it BIOS_FLASH_WP_OD.
+			   */

Is there a need to put this comment on 4 lines instead of a single one?

Quoted 189 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +177 -0
+			  "AP_FLASH_WP",
+			  "",
+			  "AP_EC_INT_L",
+			  "",
+
+			  "UF_CAM_RST_L",		/* 20 */
+			  "WF_CAM_RST_L",
+			  "UART_AP_TX_DBG_RX",
+			  "UART_DBG_TX_AP_RX",
+			  "",
+			  "PM8008_IRQ_1",
+			  "HOST2WLAN_SOL",
+			  "WLAN2HOST_SOL",
+			  "MOS_BT_UART_CTS",
+			  "MOS_BT_UART_RFR",
+
+			  "MOS_BT_UART_TX",		/* 30 */
+			  "MOS_BT_UART_RX",
+			  "PRB_SC_GPIO_32",
+			  "HUB_RST_L",
+			  "",
+			  "",
+			  "AP_SPI_FP_MISO",
+			  "AP_SPI_FP_MOSI",
+			  "AP_SPI_FP_CLK",
+			  "AP_SPI_FP_CS_L",
+
+			  "AP_EC_SPI_MISO",		/* 40 */
+			  "AP_EC_SPI_MOSI",
+			  "AP_EC_SPI_CLK",
+			  "AP_EC_SPI_CS_L",
+			  "LCM_RST_L",
+			  "EARLY_EUD_N",
+			  "",
+			  "DP_HOT_PLUG_DET",
+			  "IO_BRD_MLB_ID0",
+			  "IO_BRD_MLB_ID1",
+
+			  "IO_BRD_MLB_ID2",		/* 50 */
+			  "SSD_EN",
+			  "TS_I2C_SDA_CONN",
+			  "TS_I2C_CLK_CONN",
+			  "TS_RST_CONN",
+			  "TS_INT_CONN",
+			  "AP_I2C_TPM_SDA",
+			  "AP_I2C_TPM_SCL",
+			  "PRB_SC_GPIO_58",
+			  "PRB_SC_GPIO_59",
+
+			  "EDP_HOT_PLUG_DET_N",		/* 60 */
+			  "FP_TO_AP_IRQ_L",
+			  "",
+			  "AMP_EN",
+			  "CAM0_MCLK_GPIO_64",
+			  "CAM1_MCLK_GPIO_65",
+			  "WF_CAM_MCLK",
+			  "PRB_SC_GPIO_67",
+			  "FPMCU_BOOT0",
+			  "UF_CAM_SDA",
+
+			  "UF_CAM_SCL",			/* 70 */
+			  "",
+			  "",
+			  "WF_CAM_SDA",
+			  "WF_CAM_SCL",
+			  "",
+			  "",
+			  "EN_FP_RAILS",
+			  "FP_RST_L",
+			  "PCIE1_CLKREQ_ODL",
+
+			  "EN_PP3300_DX_EDP",		/* 80 */
+			  "SC_GPIO_81",
+			  "FORCED_USB_BOOT",
+			  "WCD_RESET_N",
+			  "MOS_WLAN_EN",
+			  "MOS_BT_EN",
+			  "MOS_SW_CTRL",
+			  "MOS_PCIE0_RST",
+			  "MOS_PCIE0_CLKREQ_N",
+			  "MOS_PCIE0_WAKE_N",
+
+			  "MOS_LAA_AS_EN",		/* 90 */
+			  "SD_CD_ODL",
+			  "",
+			  "",
+			  "MOS_BT_WLAN_SLIMBUS_CLK",
+			  "MOS_BT_WLAN_SLIMBUS_DAT0",
+			  "HP_MCLK",
+			  "HP_BCLK",
+			  "HP_DOUT",
+			  "HP_DIN",
+
+			  "HP_LRCLK",			/* 100 */
+			  "HP_IRQ",
+			  "",
+			  "",
+			  "GSC_AP_INT_ODL",
+			  "EN_PP3300_CODEC",
+			  "AMP_BCLK",
+			  "AMP_DIN",
+			  "AMP_LRCLK",
+			  "UIM1_DATA_GPIO_109",
+
+			  "UIM1_CLK_GPIO_110",		/* 110 */
+			  "UIM1_RESET_GPIO_111",
+			  "PRB_SC_GPIO_112",
+			  "UIM0_DATA",
+			  "UIM0_CLK",
+			  "UIM0_RST",
+			  "UIM0_PRESENT_ODL",
+			  "SDM_RFFE0_CLK",
+			  "SDM_RFFE0_DATA",
+			  "WF_CAM_EN",
+
+			  "FASTBOOT_SEL_0",		/* 120 */
+			  "SC_GPIO_121",
+			  "FASTBOOT_SEL_1",
+			  "SC_GPIO_123",
+			  "FASTBOOT_SEL_2",
+			  "SM_RFFE4_CLK_GRFC_8",
+			  "SM_RFFE4_DATA_GRFC_9",
+			  "WLAN_COEX_UART1_RX",
+			  "WLAN_COEX_UART1_TX",
+			  "PRB_SC_GPIO_129",
+
+			  "LCM_ID0",			/* 130 */
+			  "LCM_ID1",
+			  "",
+			  "SDR_QLINK_REQ",
+			  "SDR_QLINK_EN",
+			  "QLINK0_WMSS_RESET_N",
+			  "SMR526_QLINK1_REQ",
+			  "SMR526_QLINK1_EN",
+			  "SMR526_QLINK1_WMSS_RESET_N",
+			  "PRB_SC_GPIO_139",
+
+			  "SAR1_IRQ_ODL",		/* 140 */
+			  "SAR0_IRQ_ODL",
+			  "PRB_SC_GPIO_142",
+			  "",
+			  "WCD_SWR_TX_CLK",
+			  "WCD_SWR_TX_DATA0",
+			  "WCD_SWR_TX_DATA1",
+			  "WCD_SWR_RX_CLK",
+			  "WCD_SWR_RX_DATA0",
+			  "WCD_SWR_RX_DATA1",
+
+			  "DMIC01_CLK",			/* 150 */
+			  "DMIC01_DATA",
+			  "DMIC23_CLK",
+			  "DMIC23_DATA",
+			  "",
+			  "",
+			  "EC_IN_RW_ODL",
+			  "HUB_EN",
+			  "WCD_SWR_TX_DATA2",
+			  "",
+
+			  "",				/* 160 */
+			  "",
+			  "",
+			  "",
+			  "",
+			  "",
+			  "",
+			  "",
+			  "",
+			  "",
+
+			  "",				/* 170 */
+			  "MOS_BLE_UART_TX",
+			  "MOS_BLE_UART_RX",
+			  "",
+			  "",
+			  "";
+};
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +6 -0
new file mode 100644
index 000000000000..157da25cc5a8
@@ -0,0 +1,781 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * Google Herobrine baseboard device tree source
+ *
+ * The set of things in this file is a bit loosely defined. It's roughly
+ * defined as the set of things that the child boards happen to have in

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 16

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+ * common. Since all of the child boards started from the same original
+ * design this is hopefully a large set of things but as more derivatives
+ * appear things may "bubble down" out of this file. For things that are
+ * part of the reference design but might not exist on child nodes we will
+ * follow the lead of the SoC dtsi files and leave their status as "disabled".
+ *
+ * Copyright 2022 Google LLC.
+ */
+
+#include <dt-bindings/gpio/gpio.h>

Factoring gpio.h out into the SoC DT is a good idea.

Quoted 8 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +8 -0
+#include <dt-bindings/input/gpio-keys.h>
+#include <dt-bindings/input/input.h>
+
+#include "sc7280-qcard.dtsi"
+#include "sc7280-chrome-common.dtsi"
+
+/ {
+	chosen {

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 34

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+		stdout-path = "serial0:115200n8";
+	};
+
+	/*
+	 * FIXED REGULATORS
+	 *
+	 * Sort order:
+	 * 1. parents above children.
+	 * 2. higher voltage above lower voltage.
+	 * 3. alphabetically by node name.

Why not just alphabetically? These regulator-fixed nodes shouldn't have issues with probe order and their parent-child relations are specified in their properties.

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 37

Quoted 3 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +3 -0
+	 */
+
+	/* This is the top level supply and variable voltage */

Is there a way to read out the voltage somehow, perhaps as a TODO for the future if a driver is needed? I think the regulator framework used not to be very happy about not specifying a (fixed) voltage range on a fixed regulator, but I may be wrong..

Quoted 237 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +237 -0
+	ppvar_sys: ppvar-sys-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "ppvar_sys";
+		regulator-always-on;
+		regulator-boot-on;
+	};
+
+	/* This divides ppvar_sys by 2, so voltage is variable */
+	src_vph_pwr: src-vph-pwr-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "src_vph_pwr";
+
+		/* EC turns on with switchcap_on; always on for AP */
+		regulator-always-on;
+		regulator-boot-on;
+
+		vin-supply = <&ppvar_sys>;
+	};
+
+	pp5000_s5: pp5000-s5-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp5000_s5";
+
+		/* EC turns on with en_pp5000_s5; always on for AP */
+		regulator-always-on;
+		regulator-boot-on;
+		regulator-min-microvolt = <5000000>;
+		regulator-max-microvolt = <5000000>;
+
+		vin-supply = <&ppvar_sys>;
+	};
+
+	pp3300_z1: pp3300-z1-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_z1";
+
+		/* EC turns on with en_pp3300_z1; always on for AP */
+		regulator-always-on;
+		regulator-boot-on;
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		vin-supply = <&ppvar_sys>;
+	};
+
+	pp3300_codec: pp3300-codec-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_codec";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		gpio = <&tlmm 105 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		pinctrl-names = "default";
+		pinctrl-0 = <&en_pp3300_codec>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp3300_left_in_mlb: pp3300-left-in-mlb {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_left_in_mlb";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		gpio = <&tlmm 80 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		pinctrl-names = "default";
+		pinctrl-0 = <&en_pp3300_dx_edp>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp3300_mcu_fp:
+	pp3300_fp_ls:
+	pp3300_fp_mcu: pp3300-fp-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_fp";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		regulator-boot-on;
+		regulator-always-on;
+
+		/*
+		 * WARNING: it is intentional that GPIO 77 isn't listed here.
+		 * The userspace script for updating the fingerprint firmware
+		 * needs to control the FP regulators during a FW update,
+		 * hence the signal can't be owned by the kernel regulator.
+		 */
+
+		pinctrl-names = "default";
+		pinctrl-0 = <&en_fp_rails>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp3300_hub: pp3300-hub-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_hub";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		regulator-boot-on;
+		regulator-always-on;
+
+		gpio = <&tlmm 157 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		pinctrl-names = "default";
+		pinctrl-0 = <&hub_en>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp3300_tp: pp3300-tp-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_tp";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		/* AP turns on with PP1800_L18B_S0; always on for AP */
+		regulator-always-on;
+		regulator-boot-on;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp3300_ssd: pp3300-ssd {
+		compatible = "regulator-fixed";
+		regulator-name = "pp3300_ssd";
+
+		regulator-min-microvolt = <3300000>;
+		regulator-max-microvolt = <3300000>;
+
+		gpio = <&tlmm 51 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		pinctrl-names = "default";
+		pinctrl-0 = <&ssd_en>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp2850_vcm_wf_cam: pp2850-vcm-wf-cam {
+		compatible = "regulator-fixed";
+		regulator-name = "pp2850_vcm_wf_cam";
+
+		regulator-min-microvolt = <2850000>;
+		regulator-max-microvolt = <2850000>;
+
+		gpio = <&tlmm 119 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		pinctrl-names = "default";
+		pinctrl-0 = <&wf_cam_en>;
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp2850_wf_cam: pp2850-wf-cam {
+		compatible = "regulator-fixed";
+		regulator-name = "pp2850_wf_cam";
+
+		regulator-min-microvolt = <2850000>;
+		regulator-max-microvolt = <2850000>;
+
+		gpio = <&tlmm 119 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		/*
+		 * The pinconf can only be referenced once so we put it on the
+		 * first regulator and comment it out here.
+		 *
+		 * pinctrl-names = "default";
+		 * pinctrl-0 = <&wf_cam_en>;
+		 */
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	pp1800_fp: pp1800-fp-regulator {
+		compatible = "regulator-fixed";
+		regulator-name = "pp1800_fp";
+
+		regulator-min-microvolt = <1800000>;
+		regulator-max-microvolt = <1800000>;
+
+		regulator-boot-on;
+		regulator-always-on;
+
+		/*
+		 * WARNING: it is intentional that GPIO 77 isn't listed here.
+		 * The userspace script for updating the fingerprint firmware
+		 * needs to control the FP regulators during a FW update,
+		 * hence the signal can't be owned by the kernel regulator.
+		 */
+
+		pinctrl-names = "default";
+		pinctrl-0 = <&en_fp_rails>;
+
+		vin-supply = <&pp1800_l18b_s0>;
+		status = "disabled";
+	};
+
+	pp1800_wf_cam: pp1800-wf-cam {
+		compatible = "regulator-fixed";
+		regulator-name = "pp1800_wf_cam";
+
+		regulator-min-microvolt = <1800000>;
+		regulator-max-microvolt = <1800000>;
+
+		gpio = <&tlmm 119 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		/*
+		 * The pinconf can only be referenced once so we put it on the
+		 * first regulator and comment it out here.
+		 *
+		 * pinctrl-names = "default";
+		 * pinctrl-0 = <&wf_cam_en>;
+		 */
+
+		vin-supply = <&vreg_l19b_s0>;
+	};
+
+	pp1200_wf_cam: pp1200-wf-cam {
+		compatible = "regulator-fixed";
+		regulator-name = "pp1200_wf_cam";
+
+		regulator-min-microvolt = <1200000>;
+		regulator-max-microvolt = <1200000>;
+
+		gpio = <&tlmm 119 GPIO_ACTIVE_HIGH>;
+		enable-active-high;
+		/*
+		 * The pinconf can only be referenced once so we put it on the

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 284

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+		 * first regulator and comment it out here.
+		 *
+		 * pinctrl-names = "default";
+		 * pinctrl-0 = <&wf_cam_en>;
+		 */
+
+		vin-supply = <&pp3300_z1>;
+	};
+
+	/* BOARD-SPECIFIC TOP LEVEL NODES */

Again, seems superfluous.

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 288

Quoted 4 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +4 -0
+
+	pwmleds {
+		compatible = "pwm-leds";
+		status = "disabled";

If it's disabled and it's not enabled anywhere else, why is it here? Is it going to have users in a very near future?

Quoted 45 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +45 -0
+		keyboard_backlight: keyboard-backlight {
+			status = "disabled";
+			label = "cros_ec::kbd_backlight";
+			pwms = <&cros_ec_pwm 0>;
+			max-brightness = <1023>;
+		};
+	};
+};
+
+/*
+ * BOARD-LOCAL NAMES FOR REGULATORS THAT CONNECT TO QCARD
+ *
+ * Names are only listed here if regulators go somewhere other than a
+ * testpoint.
+ */
+
+/* From Qcard to our board; ordered by PMIC-ID / rail number */
+
+pp1256_s8b: &vreg_s8b_1p256 {};
+
+pp1800_l18b_s0: &vreg_l18b_1p8 {};
+pp1800_l18b:    &vreg_l18b_1p8 {};
+
+vreg_l19b_s0: &vreg_l19b_1p8 {};
+
+pp1800_alc5682: &vreg_l2c_1p8 {};
+pp1800_l2c:     &vreg_l2c_1p8 {};
+
+vreg_l4c: &vreg_l4c_1p8_3p0 {};
+
+ppvar_l6c: &vreg_l6c_2p96 {};
+
+pp3000_l7c: &vreg_l7c_3p0 {};
+
+pp1800_prox: &vreg_l8c_1p8 {};
+pp1800_l8c:  &vreg_l8c_1p8 {};
+
+pp2950_l9c: &vreg_l9c_2p96 {};
+
+pp1800_lcm:  &vreg_l12c_1p8 {};
+pp1800_mipi: &vreg_l12c_1p8 {};
+pp1800_l12c: &vreg_l12c_1p8 {};
+
+pp3300_lcm:  &vreg_l13c_3p0 {};
+pp3300_mipi: &vreg_l13c_3p0 {};

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 343

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+pp3300_l13c: &vreg_l13c_3p0 {};
+
+/* From our board to Qcard; ordered same as node definition above */
+
+vreg_edp_bl: &ppvar_sys {};
+
+ts_avdd:      &pp3300_left_in_mlb {};
+vreg_edp_3p3: &pp3300_left_in_mlb {};
+
+/* ADDITIONS TO NODES DEFINED IN PARENT DEVICE TREE FILES */

Again.

Quoted 8 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +8 -0
+
+ap_i2c_tpm: &i2c14 {
+	status = "okay";
+	clock-frequency = <400000>;
+
+	tpm@50 {
+		compatible = "google,cr50";
+		reg = <0x50>;

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 361

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+
+		pinctrl-names = "default";
+		pinctrl-0 = <&gsc_ap_int_odl>;
+
+		interrupt-parent = <&tlmm>;
+		interrupts = <104 IRQ_TYPE_EDGE_RISING>;
+	};
+};
+
+/* For nvme; not all herobrine boards have; boards set status = "okay" */

"NVMe drive, enabled on a per-board basis"?

Quoted 11 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +11 -0
+&pcie1 {
+	pinctrl-names = "default";
+	pinctrl-0 = <&pcie1_clkreq_n>, <&ssd_rst_l>, <&pe_wake_odl>;
+
+	perst-gpio = <&tlmm 2 GPIO_ACTIVE_LOW>;
+	vddpe-3v3-supply = <&pp3300_ssd>;
+};
+
+&pmk8350_rtc {
+	status = "disabled";
+};

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 382

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+
+&qupv3_id_0 {
+	status = "okay";
+};
+
+&qupv3_id_1 {
+	status = "okay";
+};
+
+/* For SD Card; not all herobrine boards have; boards set status = "okay" */

Ditto

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 394

Quoted 12 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +12 -0
+&sdhc_2 {
+	pinctrl-names = "default", "sleep";
+	pinctrl-0 = <&sdc2_on>;
+	pinctrl-1 = <&sdc2_off>;
+
+	vmmc-supply = <&pp2950_l9c>;
+	vqmmc-supply = <&ppvar_l6c>;
+
+	cd-gpios = <&tlmm 91 GPIO_ACTIVE_LOW>;
+};
+
+/* Not all herobrine boards have fingerprint; boards set status = "okay" */

Ditto

Quoted 120 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +120 -0
+ap_spi_fp: &spi9 {
+	pinctrl-0 = <&qup_spi9_data_clk>, <&qup_spi9_cs_gpio_init_high>, <&qup_spi9_cs_gpio>;
+
+	cs-gpios = <&tlmm 39 GPIO_ACTIVE_LOW>;
+
+	cros_ec_fp: ec@0 {
+		compatible = "google,cros-ec-spi";
+		reg = <0>;
+		interrupt-parent = <&tlmm>;
+		interrupts = <61 IRQ_TYPE_LEVEL_LOW>;
+		pinctrl-names = "default";
+		pinctrl-0 = <&fp_to_ap_irq_l>, <&fp_rst_l>, <&fpmcu_boot0>;
+		spi-max-frequency = <3000000>;
+	};
+};
+
+ap_ec_spi: &spi10 {
+	status = "okay";
+	pinctrl-0 = <&qup_spi10_data_clk>, <&qup_spi10_cs_gpio_init_high>, <&qup_spi10_cs_gpio>;
+
+	cs-gpios = <&tlmm 43 GPIO_ACTIVE_LOW>;
+
+	cros_ec: ec@0 {
+		compatible = "google,cros-ec-spi";
+		reg = <0>;
+		interrupt-parent = <&tlmm>;
+		interrupts = <18 IRQ_TYPE_LEVEL_LOW>;
+		pinctrl-names = "default";
+		pinctrl-0 = <&ap_ec_int_l>;
+		spi-max-frequency = <3000000>;
+
+		cros_ec_pwm: ec-pwm {
+			compatible = "google,cros-ec-pwm";
+			#pwm-cells = <1>;
+		};
+
+		i2c_tunnel: i2c-tunnel {
+			compatible = "google,cros-ec-i2c-tunnel";
+			google,remote-bus = <0>;
+			#address-cells = <1>;
+			#size-cells = <0>;
+		};
+
+		typec {
+			compatible = "google,cros-ec-typec";
+			#address-cells = <1>;
+			#size-cells = <0>;
+
+			usb_c0: connector@0 {
+				compatible = "usb-c-connector";
+				reg = <0>;
+				label = "left";
+				power-role = "dual";
+				data-role = "host";
+				try-power-role = "source";
+			};
+
+			usb_c1: connector@1 {
+				compatible = "usb-c-connector";
+				reg = <1>;
+				label = "right";
+				power-role = "dual";
+				data-role = "host";
+				try-power-role = "source";
+			};
+		};
+	};
+};
+
+#include <arm/cros-ec-keyboard.dtsi>
+#include <arm/cros-ec-sbs.dtsi>
+
+&keyboard_controller {
+	function-row-physmap = <
+		MATRIX_KEY(0x00, 0x02, 0)	/* T1 */
+		MATRIX_KEY(0x03, 0x02, 0)	/* T2 */
+		MATRIX_KEY(0x02, 0x02, 0)	/* T3 */
+		MATRIX_KEY(0x01, 0x02, 0)	/* T4 */
+		MATRIX_KEY(0x03, 0x04, 0)	/* T5 */
+		MATRIX_KEY(0x02, 0x04, 0)	/* T6 */
+		MATRIX_KEY(0x01, 0x04, 0)	/* T7 */
+		MATRIX_KEY(0x02, 0x09, 0)	/* T8 */
+		MATRIX_KEY(0x01, 0x09, 0)	/* T9 */
+		MATRIX_KEY(0x00, 0x04, 0)	/* T10 */
+	>;
+	linux,keymap = <
+		MATRIX_KEY(0x00, 0x02, KEY_BACK)
+		MATRIX_KEY(0x03, 0x02, KEY_REFRESH)
+		MATRIX_KEY(0x02, 0x02, KEY_ZOOM)
+		MATRIX_KEY(0x01, 0x02, KEY_SCALE)
+		MATRIX_KEY(0x03, 0x04, KEY_SYSRQ)
+		MATRIX_KEY(0x02, 0x04, KEY_BRIGHTNESSDOWN)
+		MATRIX_KEY(0x01, 0x04, KEY_BRIGHTNESSUP)
+		MATRIX_KEY(0x02, 0x09, KEY_MUTE)
+		MATRIX_KEY(0x01, 0x09, KEY_VOLUMEDOWN)
+		MATRIX_KEY(0x00, 0x04, KEY_VOLUMEUP)
+
+		CROS_STD_MAIN_KEYMAP
+	>;
+};
+
+&usb_1 {
+	status = "okay";
+};
+
+&usb_1_dwc3 {
+	dr_mode = "host";
+};
+
+&usb_1_hsphy {
+	status = "okay";
+};
+
+&usb_1_qmpphy {
+	status = "okay";
+};
+
+&usb_2 {
+	status = "okay";
+};

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 524

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+
+&usb_2_dwc3 {
+	dr_mode = "host";
+};
+
+&usb_2_hsphy {
+	status = "okay";
+};
+
+/* PINCTRL - ADDITIONS TO NODES IN PARENT DEVICE TREE FILES */

Again, seemingly not very useful.

Quoted 79 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +79 -0
+
+&qspi_cs0 {
+	drive-strength = <8>;
+	bias-disable;
+};
+
+&qspi_clk {
+	drive-strength = <8>;
+	bias-disable;
+};
+
+&qspi_data01 {
+	drive-strength = <8>;
+	/* High-Z when no transfers; nice to park the lines */
+	bias-pull-up;
+};
+
+/* For ap_tp_i2c */
+&qup_i2c0_data_clk {
+	drive-strength = <2>;
+	/* Has external pull */
+	bias-disable;
+};
+
+/* For ap_i2c_tpm */
+&qup_i2c14_data_clk {
+	drive-strength = <2>;
+	/* Has external pull */
+	bias-disable;
+};
+
+/* For ap_spi_fp */
+&qup_spi9_data_clk {
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For ap_spi_fp */
+&qup_spi9_cs_gpio {
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For ap_ec_spi */
+&qup_spi10_data_clk {
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For ap_ec_spi */
+&qup_spi10_cs_gpio {
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For uart_dbg */
+&qup_uart5_rx {
+	bias-pull-up;
+};
+
+/* For uart_dbg */
+&qup_uart5_tx {
+	drive-strength = <2>;
+	bias-disable;
+};
+
+&sdc2_on {
+	clk {
+		bias-disable;
+		drive-strength = <16>;
+	};
+
+	cmd {
+		bias-pull-up;
+		drive-strength = <10>;
+	};
+
+	data {
+		bias-pull-up;

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 613

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+		drive-strength = <10>;
+	};
+
+	sd-cd {
+		pins = "gpio91";
+		bias-pull-up;
+	};
+};
+
+/* PINCTRL - board-specific pinctrl */

And again

Quoted 8 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +8 -0
+
+&pm7325_gpios {
+	/*
+	 * On a quick glance it might look like KYPD_VOL_UP_N is used, but
+	 * that only passes through to a debug connector and not to the actual
+	 * volume up key.
+	 */
+	status = "disabled"; /* No GPIOs are connected */

arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi line 631

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +10 -0
+};
+
+&pmk8350_gpios {
+	status = "disabled"; /* No GPIOs are connected */
+};
+
+&tlmm {
+	/*
+	 * pinctrl settings for pins that have no real owners.
+	 */

You can make it /* one line */

Also, the following pins seem to be in random order, not sorted by either their name nor by their gpio number..

Quoted 435 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi new file +150 -0
+	pinctrl-names = "default";
+	pinctrl-0 = <&bios_flash_wp_od>;
+
+	amp_en: amp-en {
+		pins = "gpio63";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+	};
+
+	ap_ec_int_l: ap-ec-int-l {
+		pins = "gpio18";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	bios_flash_wp_od: bios-flash-wp-od {
+		pins = "gpio16";
+		function = "gpio";
+		/* Has external pull */
+		bias-disable;
+	};
+
+	en_fp_rails: en-fp-rails {
+		pins = "gpio77";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+		output-high;
+	};
+
+	en_pp3300_codec: en-pp3300-codec {
+		pins = "gpio105";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+	};
+
+	en_pp3300_dx_edp: en-pp3300-dx-edp {
+		pins = "gpio80";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+	};
+
+	hub_en: hub-en {
+		pins = "gpio157";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+	};
+
+	fp_rst_l: fp-rst-l {
+		pins = "gpio78";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+		output-high;
+	};
+
+	fp_to_ap_irq_l: fp-to-ap-irq-l {
+		pins = "gpio61";
+		function = "gpio";
+		/* Has external pullup */
+		bias-disable;
+	};
+
+	fpmcu_boot0: fpmcu-boot0 {
+		pins = "gpio68";
+		function = "gpio";
+		bias-disable;
+		output-low;
+	};
+
+	gsc_ap_int_odl: gsc-ap-int-odl {
+		pins = "gpio104";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	hp_irq: hp-irq {
+		pins = "gpio101";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	pe_wake_odl: pe-wake-odl {
+		pins = "gpio3";
+		function = "gpio";
+		drive-strength = <2>;
+		/* Has external pull */
+		bias-disable;
+	};
+
+	/* For ap_spi_fp */
+	qup_spi9_cs_gpio_init_high: qup-spi9-cs-gpio-init-high {
+		pins = "gpio39";
+		function = "gpio";
+		output-high;
+	};
+
+	/* For ap_ec_spi */
+	qup_spi10_cs_gpio_init_high: qup-spi10-cs-gpio-init-high {
+		pins = "gpio43";
+		function = "gpio";
+		output-high;
+	};
+
+	sar0_irq_odl: sar0-irq-odl {
+		pins = "gpio141";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	sar1_irq_odl: sar0-irq-odl {
+		pins = "gpio140";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	ssd_en: ssd-en {
+		pins = "gpio51";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+	};
+
+	ssd_rst_l: ssd-rst-l {
+		pins = "gpio2";
+		function = "gpio";
+		drive-strength = <2>;
+		bias-disable;
+		output-low;
+	};
+
+	tp_int_odl: tp-int-odl {
+		pins = "gpio7";
+		function = "gpio";
+		/* Has external pullup */
+		bias-disable;
+	};
+
+	wf_cam_en: wf-cam-en {
+		pins = "gpio119";
+		function = "gpio";
+		drive-strength = <2>;
+		/* Has external pulldown */
+		bias-disable;
+	};
+};
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +279 -0
new file mode 100644
index 000000000000..caff21d1e588
@@ -0,0 +1,557 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * sc7280 Qcard device tree source
+ *
+ * Qcard PCB has the processor, RAM, eMMC (if stuffed), and eDP connector (if
+ * stuffed) on it. This device tree tries to encapsulate all the things that
+ * all boards using Qcard will have in common. Given that there are stuffing
+ * options, some things may be left with status "disabled" and enabled in
+ * the actual board device tree files.
+ *
+ * Copyright 2022 Google LLC.
+ */
+
+#include <dt-bindings/iio/qcom,spmi-adc7-pmk8350.h>
+#include <dt-bindings/iio/qcom,spmi-adc7-pmr735a.h>
+#include <dt-bindings/pinctrl/qcom,pmic-gpio.h>
+#include <dt-bindings/regulator/qcom,rpmh-regulator.h>
+
+#include "sc7280.dtsi"
+
+/* PMICs depend on spmi_bus label and so must come after SoC */
+#include "pm7325.dtsi"
+#include "pm8350c.dtsi"
+#include "pmk8350.dtsi"
+
+/ {
+	aliases {
+		bluetooth0 = &bluetooth;
+		serial0 = &uart5;
+		serial1 = &uart7;
+	};
+};
+
+&apps_rsc {
+	/*
+	 * Regulators are given labels corresponding to the various names
+	 * they are referred to on schematics. They are also given labels
+	 * corresponding to named voltage inputs on the SoC or components
+	 * bundled with the SoC (like radio companion chips). We totally
+	 * ignore it when one regulator is the input to another regulator.
+	 * That's handled automatically by the initial config given to
+	 * RPMH by the firmware.
+	 *
+	 * Regulators that the HLOS (High Level OS) doesn't touch at all
+	 * are left out of here since they are managed elsewhere.
+	 */
+
+	pm7325-regulators {
+		compatible = "qcom,pm7325-rpmh-regulators";
+		qcom,pmic-id = "b";
+
+		vdd19_pmu_pcie_i:
+		vdd19_pmu_rfa_i:
+		vreg_s1b_1p856: smps1 {
+			regulator-min-microvolt = <1856000>;
+			regulator-max-microvolt = <2040000>;
+		};
+
+		vdd_pmu_aon_i:
+		vdd09_pmu_rfa_i:
+		vdd095_mx_pmu:
+		vdd095_pmu:
+		vreg_s7b_0p952: smps7 {
+			regulator-min-microvolt = <535000>;
+			regulator-max-microvolt = <1120000>;
+		};
+
+		vdd13_pmu_rfa_i:
+		vdd13_pmu_pcie_i:
+		vreg_s8b_1p256: smps8 {
+			regulator-min-microvolt = <1256000>;
+			regulator-max-microvolt = <1500000>;
+		};
+
+		vdd_a_usbssdp_0_core:
+		vreg_l1b_0p912: ldo1 {
+			regulator-min-microvolt = <825000>;
+			regulator-max-microvolt = <925000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_a_usbhs_3p1:
+		vreg_l2b_3p072: ldo2 {
+			regulator-min-microvolt = <2700000>;
+			regulator-max-microvolt = <3544000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_a_csi_0_1_1p2:
+		vdd_a_csi_2_3_1p2:
+		vdd_a_csi_4_1p2:
+		vdd_a_dsi_0_1p2:
+		vdd_a_edp_0_1p2:
+		vdd_a_qlink_0_1p2:
+		vdd_a_qlink_1_1p2:
+		vdd_a_pcie_0_1p2:
+		vdd_a_pcie_1_1p2:
+		vdd_a_ufs_0_1p2:
+		vdd_a_usbssdp_0_1p2:
+		vreg_l6b_1p2: ldo6 {
+			regulator-min-microvolt = <1140000>;
+			regulator-max-microvolt = <1260000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		/*
+		 * Despite the fact that this is named to be 2.5V on the
+		 * schematic, it powers eMMC which doesn't accept 2.5V
+		 */
+		vreg_l7b_2p5: ldo7 {
+			regulator-min-microvolt = <2960000>;
+			regulator-max-microvolt = <2960000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_px_wcd9385:
+		vdd_txrx:
+		vddpx_0:
+		vddpx_3:
+		vddpx_7:
+		vreg_l18b_1p8: ldo18 {
+			regulator-min-microvolt = <1800000>;
+			regulator-max-microvolt = <2000000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_1p8:
+		vdd_px_sdr735:
+		vdd_pxm:
+		vdd18_io:
+		vddio_px_1:
+		vddio_px_2:
+		vddio_px_3:
+		vddpx_ts:
+		vddpx_wl4otp:
+		vreg_l19b_1p8: ldo19 {
+			regulator-min-microvolt = <1800000>;
+			regulator-max-microvolt = <1800000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+	};
+
+	pm8350c-regulators {
+		compatible = "qcom,pm8350c-rpmh-regulators";
+		qcom,pmic-id = "c";
+
+		vdd22_wlbtpa_ch0:
+		vdd22_wlbtpa_ch1:
+		vdd22_wlbtppa_ch0:
+		vdd22_wlbtppa_ch1:
+		vdd22_wlpa5g_ch0:
+		vdd22_wlpa5g_ch1:
+		vdd22_wlppa5g_ch0:
+		vdd22_wlppa5g_ch1:
+		vreg_s1c_2p2: smps1 {
+			regulator-min-microvolt = <2190000>;
+			regulator-max-microvolt = <2210000>;
+		};
+
+		lp4_vdd2_1p052:
+		vreg_s9c_0p676: smps9 {
+			regulator-min-microvolt = <1010000>;
+			regulator-max-microvolt = <1170000>;
+		};
+
+		vdda_apc_cs_1p8:
+		vdda_gfx_cs_1p8:
+		vdda_turing_q6_cs_1p8:
+		vdd_a_cxo_1p8:
+		vdd_a_qrefs_1p8:
+		vdd_a_usbhs_1p8:
+		vdd_qfprom:
+		vreg_l1c_1p8: ldo1 {
+			regulator-min-microvolt = <1800000>;
+			regulator-max-microvolt = <1980000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l2c_1p8: ldo2 {
+			regulator-min-microvolt = <1620000>;
+			regulator-max-microvolt = <1980000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l3c_3p0: ldo3 {
+			regulator-min-microvolt = <2800000>;
+			regulator-max-microvolt = <3540000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vddpx_5:
+		vreg_l4c_1p8_3p0: ldo4 {
+			regulator-min-microvolt = <1620000>;
+			regulator-max-microvolt = <3300000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vddpx_6:
+		vreg_l5c_1p8_3p0: ldo5 {
+			regulator-min-microvolt = <1620000>;
+			regulator-max-microvolt = <3300000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vddpx_2:
+		vreg_l6c_2p96: ldo6 {
+			regulator-min-microvolt = <1800000>;
+			regulator-max-microvolt = <2950000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l7c_3p0: ldo7 {
+			regulator-min-microvolt = <3000000>;
+			regulator-max-microvolt = <3544000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l8c_1p8: ldo8 {
+			regulator-min-microvolt = <1620000>;
+			regulator-max-microvolt = <2000000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l9c_2p96: ldo9 {
+			regulator-min-microvolt = <2960000>;
+			regulator-max-microvolt = <2960000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_a_csi_0_1_0p9:
+		vdd_a_csi_2_3_0p9:
+		vdd_a_csi_4_0p9:
+		vdd_a_dsi_0_0p9:
+		vdd_a_dsi_0_pll_0p9:
+		vdd_a_edp_0_0p9:
+		vdd_a_gnss_0p9:
+		vdd_a_pcie_0_core:
+		vdd_a_pcie_1_core:
+		vdd_a_qlink_0_0p9:
+		vdd_a_qlink_0_0p9_ck:
+		vdd_a_qlink_1_0p9:
+		vdd_a_qlink_1_0p9_ck:
+		vdd_a_qrefs_0p875_0:
+		vdd_a_qrefs_0p875_1:
+		vdd_a_qrefs_0p875_2:
+		vdd_a_qrefs_0p875_3:
+		vdd_a_qrefs_0p875_4_5:
+		vdd_a_qrefs_0p875_6:
+		vdd_a_qrefs_0p875_7:
+		vdd_a_qrefs_0p875_8:
+		vdd_a_qrefs_0p875_9:
+		vdd_a_ufs_0_core:
+		vdd_a_usbhs_core:
+		vreg_l10c_0p88: ldo10 {
+			regulator-min-microvolt = <720000>;
+			regulator-max-microvolt = <1050000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l11c_2p8: ldo11 {
+			regulator-min-microvolt = <2800000>;
+			regulator-max-microvolt = <3544000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l12c_1p8: ldo12 {
+			regulator-min-microvolt = <1650000>;
+			regulator-max-microvolt = <2000000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vreg_l13c_3p0: ldo13 {
+			regulator-min-microvolt = <2700000>;
+			regulator-max-microvolt = <3544000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_HPM>;
+		};
+
+		vdd_flash:
+		vdd_iris_rgb:

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 289

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+		vdd_mic_bias:
+		vreg_bob: bob {
+			regulator-min-microvolt = <3008000>;
+			regulator-max-microvolt = <3960000>;
+			regulator-initial-mode = <RPMH_REGULATOR_MODE_AUTO>;
+		};
+	};
+};
+
+/* ADDITIONS TO NODES DEFINED IN PARENT DEVICE TREE FILES */

Ditto.

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 296

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +7 -0
+
+&ipa {
+	status = "okay";
+	modem-init;
+};
+
+/* For nvme; boards set status = "okay" */

This is kind of obvious, no?

Quoted 14 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +14 -0
+&pcie1_phy {
+	vdda-phy-supply = <&vreg_l10c_0p88>;
+	vdda-pll-supply = <&vreg_l6b_1p2>;
+};
+
+&pmk8350_vadc {
+	pmk8350-die-temp@3 {
+		reg = <PMK8350_ADC7_DIE_TEMP>;
+		label = "pmk8350_die_temp";
+		qcom,pre-scaling = <1 1>;
+	};
+
+	pmr735a-die-temp@403 {
+		reg = <PMR735A_ADC7_DIE_TEMP>;

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 320

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+		label = "pmr735a_die_temp";
+		qcom,pre-scaling = <1 1>;
+	};
+};
+
+&qfprom {
+	vcc-supply = <&vdd_qfprom>;
+};
+
+/* For eMMC; not all Qcards have eMMC stuffed; boards set status = "okay" */

Same here.

Quoted 12 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +12 -0
+&sdhc_1 {
+	pinctrl-names = "default", "sleep";
+	pinctrl-0 = <&sdc1_on>;
+	pinctrl-1 = <&sdc1_off>;
+
+	vmmc-supply = <&vreg_l7b_2p5>;
+	vqmmc-supply = <&vreg_l19b_1p8>;
+
+	non-removable;
+	no-sd;
+	no-sdio;
+};

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 342

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+
+uart_dbg: &uart5 {
+	compatible = "qcom,geni-debug-uart";
+	status = "okay";
+};
+
+mos_bt_uart: &uart7 {
+	status = "okay";
+
+	/delete-property/interrupts;

I think generally one should put a space after '/'.

Quoted 33 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +33 -0
+	interrupts-extended = <&intc GIC_SPI 608 IRQ_TYPE_LEVEL_HIGH>,
+				<&tlmm 31 IRQ_TYPE_EDGE_FALLING>;
+	pinctrl-names = "default", "sleep";
+	pinctrl-1 = <&qup_uart7_sleep_cts>, <&qup_uart7_sleep_rts>, <&qup_uart7_sleep_tx>, <&qup_uart7_sleep_rx>;
+
+	bluetooth: bluetooth {
+		compatible = "qcom,wcn6750-bt";
+		pinctrl-names = "default";
+		pinctrl-0 = <&mos_bt_en>;
+		enable-gpios = <&tlmm 85 GPIO_ACTIVE_HIGH>;
+		swctrl-gpios = <&tlmm 86 GPIO_ACTIVE_HIGH>;
+		vddaon-supply = <&vreg_s7b_0p952>;
+		vddbtcxmx-supply = <&vreg_s7b_0p952>;
+		vddrfacmn-supply = <&vreg_s7b_0p952>;
+		vddrfa0p8-supply = <&vreg_s7b_0p952>;
+		vddrfa1p7-supply = <&vdd19_pmu_rfa_i>;
+		vddrfa1p2-supply = <&vdd13_pmu_rfa_i>;
+		vddrfa2p2-supply = <&vreg_s1c_2p2>;
+		vddasd-supply = <&vreg_l11c_2p8>;
+		vddio-supply = <&vreg_l18b_1p8>;
+		max-speed = <3200000>;
+	};
+};
+
+&usb_1_hsphy {
+	vdda-pll-supply = <&vdd_a_usbhs_core>;
+	vdda33-supply = <&vdd_a_usbhs_3p1>;
+	vdda18-supply = <&vdd_a_usbhs_1p8>;
+};
+
+&usb_1_qmpphy {
+	vdda-phy-supply = <&vdd_a_usbssdp_0_1p2>;
+	vdda-pll-supply = <&vdd_a_usbssdp_0_core>;

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 385

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+};
+
+&usb_2_hsphy {
+	vdda-pll-supply = <&vdd_a_usbhs_core>;
+	vdda33-supply = <&vdd_a_usbhs_3p1>;
+	vdda18-supply = <&vdd_a_usbhs_1p8>;
+};
+
+/*
+ * PINCTRL - ADDITIONS TO NODES IN PARENT DEVICE TREE FILES

Again.

Quoted 13 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +13 -0
+ *
+ * NOTE: In general if pins leave the Qcard then the pinctrl goes in the
+ * baseboard or board device tree, not here.
+ */
+
+/*
+ * For ts_i2c
+ *
+ * Technically this i2c bus actually leaves the Qcard, but it leaves directly
+ * via the eDP connector (it doesn't hit the baseboard). The external pulls
+ * are on Qcard.
+ */
+&qup_i2c13_data_clk {

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 408

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+	drive-strength = <2>;
+	/* Has external pull */
+	bias-disable;
+};
+
+/* For mos_bt_uart */
+&qup_uart7_cts {
+	/*
+	 * Configure a pull-down on CTS to match the pull of
+	 * the Bluetooth module.

My email client doesn't show me the column count, but I think this would fit in a single 100 char line..

Quoted 137 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +137 -0
+	 */
+	bias-pull-down;
+};
+
+/* For mos_bt_uart */
+&qup_uart7_rts {
+	/* We'll drive RTS, so no pull */
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For mos_bt_uart */
+&qup_uart7_tx {
+	/* We'll drive TX, so no pull */
+	drive-strength = <2>;
+	bias-disable;
+};
+
+/* For mos_bt_uart */
+&qup_uart7_rx {
+	/*
+	 * Configure a pull-up on RX. This is needed to avoid
+	 * garbage data when the TX pin of the Bluetooth module is
+	 * in tri-state (module powered off or not driving the
+	 * signal yet).
+	 */
+	bias-pull-up;
+};
+
+/* eMMC, if stuffed, is straight on the Qcard */
+&sdc1_on {
+	clk {
+		bias-disable;
+		drive-strength = <16>;
+	};
+
+	cmd {
+		bias-pull-up;
+		drive-strength = <10>;
+	};
+
+	data {
+		bias-pull-up;
+		drive-strength = <10>;
+	};
+
+	rclk {
+		bias-pull-down;
+	};
+};
+
+/*
+ * PINCTRL - QCARD
+ *
+ * This has entries that are defined by Qcard even if they go to the main
+ * board. In cases where the pulls may be board dependent we defer those
+ * settings to the board device tree. Drive strengths tend to be assinged here
+ * but could conceivably be overwridden by board device trees.
+ */
+
+&pm8350c_gpios {
+	pmic_edp_bl_en: pmic-edp-bl-en {
+		pins = "gpio7";
+		function = "normal";
+		qcom,drive-strength = <PMIC_GPIO_STRENGTH_LOW>;
+		bias-disable;
+
+		/* Force backlight to be disabled to match state at boot. */
+		output-low;
+	};
+
+	pmic_edp_bl_pwm: pmic-edp-bl-pwm {
+		pins = "gpio8";
+		function = "func1";
+		qcom,drive-strength = <PMIC_GPIO_STRENGTH_LOW>;
+		bias-disable;
+		output-low;
+		power-source = <0>;
+	};
+};
+
+&tlmm {
+	mos_bt_en: mos-bt-en {
+		pins = "gpio85";
+		function = "gpio";
+		drive-strength = <2>;
+		output-low;
+	};
+
+	/* For mos_bt_uart */
+	qup_uart7_sleep_cts: qup-uart7-sleep-cts {
+		pins = "gpio28";
+		function = "gpio";
+		/*
+		 * Configure a pull-down on CTS to match the pull of
+		 * the Bluetooth module.
+		 */
+		bias-pull-down;
+	};
+
+	/* For mos_bt_uart */
+	qup_uart7_sleep_rts: qup-uart7-sleep-rts {
+		pins = "gpio29";
+		function = "gpio";
+		/*
+		 * Configure pull-down on RTS. As RTS is active low
+		 * signal, pull it low to indicate the BT SoC that it
+		 * can wakeup the system anytime from suspend state by
+		 * pulling RX low (by sending wakeup bytes).
+		 */
+		bias-pull-down;
+	};
+
+	/* For mos_bt_uart */
+	qup_uart7_sleep_rx: qup-uart7-sleep-rx {
+		pins = "gpio31";
+		function = "gpio";
+		/*
+		 * Configure a pull-up on RX. This is needed to avoid
+		 * garbage data when the TX pin of the Bluetooth module
+		 * is floating which may cause spurious wakeups.
+		 */
+		bias-pull-up;
+	};
+
+	/* For mos_bt_uart */
+	qup_uart7_sleep_tx: qup-uart7-sleep-tx {
+		pins = "gpio30";
+		function = "gpio";
+		/*
+		 * Configure pull-up on TX when it isn't actively driven
+		 * to prevent BT SoC from receiving garbage during sleep.
+		 */
+		bias-pull-up;
+	};
+
+	ts_int_conn: ts-int-conn {

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 555

Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +10 -0
+		pins = "gpio55";
+		function = "gpio";
+		bias-pull-up;
+	};
+
+	ts_rst_conn: ts-rst-conn {
+		pins = "gpio54";
+		function = "gpio";
+		bias-pull-up;
+		drive-strength = <2>;

Please be consistent in the order in which you add the same properties throughout GPIO nodes.

arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi line 557

Quoted 3 lines
arch/arm64/boot/dts/qcom/sc7280-qcard.dtsi new file +2 -0
+	};
+};

Konrad

#15 lore raw

Re: [PATCH 4/4] arm64: dts: qcom: sc7280: Add herobrine-r1

Hi,

Quoted 6 lines · Konrad Dybcio

Hi!

Your DTs look good, but incorporate some weird style decisions..

Funny. I've been working on a DT style guidelines doc. I guess I need to prioritize it...

Quoted 10 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts line 30

Quoted 9 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r0.dts +1 -1
@@ -26,7 +26,7 @@
 
 / {
      model = "Google Herobrine (rev0)";
-     compatible = "google,herobrine",
+     compatible = "google,herobrine-rev0",
                   "qcom,sc7280";

Why break the line here?

True, this can go on one line. One argument about having the SoC on a separate line is to make it consistent for boards that have more revs listed. That's not new for this patch, though. I could go either way, honestly.

I'll spin for this unless someone wants to defend it being on more than one line.

Quoted 13 lines
Quoted 13 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +7 -0
new file mode 100644
index 000000000000..c57bd689df23
@@ -0,0 +1,314 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * Google Herobrine board device tree source
+ *
+ * Copyright 2022 Google LLC.
+ */
+
Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 13

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +6 -0
+/dts-v1/;
+
+#include "sc7280-herobrine.dtsi"
+
+/ {
+     model = "Google Herobrine (rev1+)";

Are you sure there won't be any changes significant enough in the future that will make rev2 or rev7 or rev8192 incompatible with the rev1+ DT?

Definitely not. If there are significant changes, though, then we'll need a new dts. ...but right now, as coded, this will _match_ against anything rev1 or newer. This all has to do with now the bootloader does matching and also about the standard practices we use. Let me try to explain.

So you can see down below that we list the compatible as "google,herobrine" and _not_ "google,herobrine-rev1"? This is on purpose. The bootloader will read the board rev/sku strappings and then will search for device trees with this priority order (for rev1, sku0):

1. google,herobrine-rev1-sku0
2. google,herobrine-rev1
3. google,herobrine-sku0
4. google,herobrine

The general rule of thumb is that the newest board for any given device should _not_ list a revision or a SKU in its compatible but instead should just advertise itself as the default device tree for a given board. Basically that means that the current device tree, as coded, will match everything that's -rev1 or newer (because there is a more specific dts for -rev0).

Why do we do this? If the board manufacturer makes a new spin of the board and changes components around or changes routing or whatever, we want them to populate a new board ID even if the differences are _supposed_ to be invisible to software. This means that if the issues turn out _not_ to be invisible to software that we can later work around them. Usually when the board manufacturer spins the board like this the want the old software to "just work", so we want the default to automatically pick things up.

Even when changes _are_ visible to software, it's likely that a new rev of a board will most closely match the previous version. Thus, if we don't have a better board to match against, it's better to pick the newest revision and have some chance to boot than to crash or pick some other completely random dts file.

Quoted 3 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 15

Quoted 2 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +2 -0
+     compatible = "google,herobrine",
+                  "qcom,sc7280";

Why break the line here?

See above.

Quoted 4 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 18

Quoted 3 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +3 -0
+};
+
+/* ADDITIONS TO NODES DEFINED IN PARENT DEVICE TREE FILES */

This is superfluous at best.

So in general I try to use titles like this to indicate a change in the sort ordering. In different sections different sort ordering is used.

I'll plan to keep these line headings as they are in my next spin unless someone else wants to tie-break and tells me to get rid of them.

Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 54

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +6 -0
+/*
+ * The touchscreen connector might come off the Qcard, at least in the case of
+ * eDP. Like the trackpad, we'll put it in the board device tree file since
+ * different boards have different touchscreens.
+ */
+ts_i2c: &i2c13 {

Either sort these by their i2c aliases, or by their new ones.. currently it is not alphabetically sorted at all..

They are sorted by the name of what they are overriding. ...it can certainly get a little awkward at times, but so can any rule. In this case, the sort ordering is:

ap_spi_fp, i2c0, i2c13, pcie1, ...

I think the key here is that "ts_i2c" is a local label being added, but the sort order is based on the node name being overridden ("i2c13"). The fact that extra local labels are being added can confuse the issue for sure, but if you sort by local labels then that can be confusing in different ways. Specifically the local labels are optional, but if you later decide to add one you wouldn't want to change the sort order.

I'll plan to keep my sort ordering for the next spin.

Quoted 1 line

Looks like some nodes below are just thrown at random places too..

I believe everything has a consistent ordering, you just need to know what it is. At least I don't see anything mis-sorted.

Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 79

Quoted 6 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +6 -0
+/* For nvme */
+&pcie1 {
+     status = "okay";
+};
+
+/* For nvme */

I think this is kind of obvious and there is no need for this to be said twice within 10 lines..

I guess? It feels like this is about the scoping of the comment. I feel like these are comments that apply only to the next block and are not "section" comments that apply to anything below. Thus while it might be obvious it's inconsistent to exclude this comment.

Not planning to change this.

Quoted 3 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 94

Quoted 1 line
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +1 -0
+/* PINCTRL - BOARD-SPECIFIC */

This is also kind of obvious, if it wasn't board-specific, it wouldn't be in the board DT..

Sure, but it gets into:

1. Section headers indicate a change in sort ordering and explain why the stuff below isn't sorted inline with the stuff above.

2. In some files there are actually two separate pinctrl sections, one where we override / fill in details for parent nodes and one where we have pins that are totally board specific. You can see herobrine.dtsi where both pinctrl sections are marked.

Quoted 5 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 137

Quoted 4 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +4 -0
+                       /*
+                        * AP_FLASH_WP is crossystem ABI. Schematics
+                        * call it BIOS_FLASH_WP_OD.
+                        */

Is there a need to put this comment on 4 lines instead of a single one?

Probably doesn't need 4 more than one line now that people are more OK w/ longer lines. This makes it to exactly 100 characters wide if on one line. I guess it's a matter of opinion, but it actually looks quite a bit uglier to me on one line. All the other lines are short and this one really long line sticks out like a sore thumb.

I'll also note that the goal isn't to set 100 characters as the magic limit. As commit bdc48fa11e46 ("checkpatch/coding-style: deprecate 80-column warning") says, "80 columns is certainly still _preferred_" but that we should allow longer lines if they make things more readable / prettier. I disagree that it's prettier or more readable to put this on one line in this case.

Quoted 11 lines
Quoted 11 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+++ b/arch/arm64/boot/dts/qcom/sc7280-herobrine.dtsi
@@ -0,0 +1,781 @@
+// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
+/*
+ * Google Herobrine baseboard device tree source
+ *
+ * The set of things in this file is a bit loosely defined. It's roughly
+ * defined as the set of things that the child boards happen to have in
+ * common. Since all of the child boards started from the same original
+ * design this is hopefully a large set of things but as more derivatives
+ * appear things may "bubble down" out of this file. For things that are
Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 16

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +7 -0
+ * part of the reference design but might not exist on child nodes we will
+ * follow the lead of the SoC dtsi files and leave their status as "disabled".
+ *
+ * Copyright 2022 Google LLC.
+ */
+
+#include <dt-bindings/gpio/gpio.h>

Factoring gpio.h out into the SoC DT is a good idea.

I'm on the fence and I'd love a 2nd opinion. I don't see any usage of the GPIO_ definitions there. However, I agree that pretty much all boards should use them, so it probably makes sense...

Unless someone disagrees, I'll spin for this.

Quoted 10 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 23

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +7 -0
+     /*
+      * FIXED REGULATORS
+      *
+      * Sort order:
+      * 1. parents above children.
+      * 2. higher voltage above lower voltage.
+      * 3. alphabetically by node name.

Why not just alphabetically? These regulator-fixed nodes shouldn't have issues with probe order and their parent-child relations are specified in their properties.

Back in the day this used to reduce the amount of -EPROBE_DEFER that the system would suffer at bootup. ...but aside from that, I grew to feel that it made sense. For regulators you're often thinking them as a power tree. Things closer to "mains" or the battery are at the top and they feed into things that bring the voltage lower (since dropping a voltage is usually easier than raising it). Thus this ordering made a reasonable amount of sense for someone trying to understand the power tree for a board. Sorting things alphabetically, on the other hand, doesn't add anything to understanding. ...so why not sort by the order that helps people understand the board better?

Quoted 5 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 26

Quoted 3 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +3 -0
+      */
+
+     /* This is the top level supply and variable voltage */

Is there a way to read out the voltage somehow, perhaps as a TODO for the future if a driver is needed?

I don't believe so. IIRC this is a voltage that can either be provided by the battery or by "mains". I believe it feeds a bunch of stuff that can take whatever voltage is thrown at it and then regulate it down to something sane.

Quoted 3 lines

I think the regulator framework used not to be very happy
about not specifying a (fixed) voltage range on a fixed regulator, but I may be wrong..

It's never been a problem.

Quoted 6 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 30

Quoted 4 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +4 -0
+
+     pwmleds {
+             compatible = "pwm-leds";
+             status = "disabled";

If it's disabled and it's not enabled anywhere else, why is it here? Is it going to have users in a very near future?

Right, that's the idea. It's actually on the schematics but just not stuffed for -rev1 boards.

Quoted 10 lines
Quoted 10 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +10 -0
+ap_i2c_tpm: &i2c14 {
+     status = "okay";
+     clock-frequency = <400000>;
+
+     tpm@50 {
+             compatible = "google,cr50";
+             reg = <0x50>;
+
+             pinctrl-names = "default";
+             pinctrl-0 = <&gsc_ap_int_odl>;
Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 47

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +7 -0
+
+             interrupt-parent = <&tlmm>;
+             interrupts = <104 IRQ_TYPE_EDGE_RISING>;
+     };
+};
+
+/* For nvme; not all herobrine boards have; boards set status = "okay" */

"NVMe drive, enabled on a per-board basis"?

I guess. I'm not really convinced your wording is better but I'm fine with it. I'll change to your wording.

Quoted 5 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 51

Quoted 4 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +4 -0
+&tlmm {
+     /*
+      * pinctrl settings for pins that have no real owners.
+      */

You can make it /* one line */

Sure, I can spin for this.

Quoted 2 lines

Also, the following pins seem to be in random order, not sorted by either their name nor by their gpio number..

I think only "hub_en" is mis-sorted, right? Then they're sorted by node name. I'll spin for that.

Quoted 8 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 58

Quoted 7 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +7 -0
+
+&ipa {
+     status = "okay";
+     modem-init;
+};
+
+/* For nvme; boards set status = "okay" */

This is kind of obvious, no?

Sure, I can remove this comment.

Quoted 2 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 59

Quoted 1 line
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +1 -0
+/* For eMMC; not all Qcards have eMMC stuffed; boards set status = "okay" */

Same here.

Actually, this provides some pretty useful info IMO. I don't think it'd be terribly obvious that eMMC is on the Qcard PCB (if stuffed) but not always stuffed.

Quoted 5 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 63

Quoted 4 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +4 -0
+mos_bt_uart: &uart7 {
+     status = "okay";
+
+     /delete-property/interrupts;

I think generally one should put a space after '/'.

OK, I'll spin with this.

Quoted 7 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 68

Quoted 5 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +5 -0
+/* For mos_bt_uart */
+&qup_uart7_cts {
+     /*
+      * Configure a pull-down on CTS to match the pull of
+      * the Bluetooth module.

My email client doesn't show me the column count, but I think this would fit in a single 100 char line..

IMO it doesn't exactly look ugly the way it is, but sure I can make it one line. Seems to look fine that way too. I'll change it to one line.

Quoted 7 lines

arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts line 73

Quoted 5 lines
arch/arm64/boot/dts/qcom/sc7280-herobrine-herobrine-r1.dts new file +5 -0
+     ts_rst_conn: ts-rst-conn {
+             pins = "gpio54";
+             function = "gpio";
+             bias-pull-up;
+             drive-strength = <2>;

Please be consistent in the order in which you add the same properties throughout GPIO nodes.

Sure, I'll spin for this.

-Doug