build tooling

This commit is contained in:
Owen 2024-09-03 17:06:38 +02:00
parent 9c1cc569e6
commit d339f6fe16
8 changed files with 482 additions and 2672 deletions

View File

@ -5,25 +5,23 @@ Copy the desired `.dts` file to the [build-trees](../build-trees) folder and fol
There are instructions at the end of that document on how you can use a custom `.dtb` and make it permanent across reboots and kernel upgrades.
The issue with using these trees is that **if** the upstream device tree or includes is modified you need to manually rebuild these trees.
The issue with using these trees is that **if** the upstream device tree or includes is modified you need to manually rebuild these trees.
EG any changes to the upstream `sun20i-d1-mangopi-mq-pro.dts` source needs to be detected and applied too. You need to examine file histories to do this.
- Fortunately this should not be an issue in practice; the kernel *should* remain very stable going forward. Ubuntu 24.04.1 is a LTS release..
The authors personal advice is to use this only if needed; or as a learning excercise.
## Common
[A common (generic) device tree I, suitable for many occasions](./common)
* Has 2x UART (plus the console uart), 2x I2C. 1xSPI
* 12 unassigned GPIO pins
## SPI and I2C
[SPI plus I2C interfaces](./spi_i2c)
* 1x SPI
* 4x I2C
* 3x UART (plus the console uart)
* 6 unassigned GPIO pins
## Serial
[Four UART interfaces *and* Four I2C interfaces](./serial)
* Has 4x UART (plus the console uart), 4x I2C
* UART3 has RTC/CTS pins available too
* 10 unassigned GPIO pins
## SPI
[SPI plus Serial interfaces](./spi)
* Has 3x UART (plus the console uart), 3x I2C. 1xSPI
* 8 unassigned GPIO pins
[Four UART interfaces](./serial)
* 4x UART (plus the console uart)
* UART3 has RTC/CTS pins available too
* 2x I2C
* 12 unassigned GPIO pins

View File

@ -1,33 +0,0 @@
```
MangoPI MQ Pro GPIO header (dtb name: MangoPi MQ Pro)
Gpio Header:
func des pin pin des func
3v3 1 --o o-- 2 5v
i2c0.sda (2502000.i2c:205) PG13 3 --o o-- 4 5v
i2c0.sck (2502000.i2c:204) PG12 5 --o o-- 6 gnd
free (39) PB7 7 --o o-- 8 PB8 uart0.tx (2500000.serial:40)
gnd 9 --o o-- 10 PB9 uart0.rx (2500000.serial:41)
free (117) PD21 11 --o o-- 12 PB5 free (37)
free (118) PD22 13 --o o-- 14 gnd
free (32) PB0 15 --o o-- 16 PB1 free (33)
3v3 17 --o o-- 18 PD14 spi1.hold (4026000.spi:110)
spi1.mosi (4026000.spi:108) PD12 19 --o o-- 20 gnd
spi1.miso (4026000.spi:109) PD13 21 --o o-- 22 PC1 uart2.rx (2500800.serial:65)
spi1.clk (4026000.spi:107) PD11 23 --o o-- 24 PD10 spi1.cs (4026000.spi:106)
gnd 25 --o o-- 26 PD15 spi1.wp (4026000.spi:111)
i2c3.sda (2502c00.i2c:145) PE17 27 --o o-- 28 PE16 i2c3.sck (2502c00.i2c:144)
free (42) PB10 29 --o o-- 30 gnd
free (43) PB11 31 --o o-- 32 PC0 uart2.tx (2500800.serial:64)
free (44) PB12 33 --o o-- 34 gnd
free (38) PB6 35 --o o-- 36 PB2 uart4.tx (2501000.serial:34)
free (113) PD17 37 --o o-- 38 PB3 uart4.rx (2501000.serial:35)
gnd 39 --o o-- 40 PB4 free (36)
Other gpio outputs of interest:
-- PD18: Blue Status Led - gpio (2000000.pinctrl:114)
Notes:
- I2C pins 3,5,27 and 28 (PG13, PG12, PE17 and PE16) have 10K pullup resistors to 3v3
- The Status LED (PD18) is common with the LED_PWM pin on the DSI/LVDS output
```

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,319 @@
// SPDX-License-Identifier: (GPL-2.0+ OR MIT)
// Copyright (C) 2022 Samuel Holland <samuel@sholland.org>
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/leds/common.h>
/dts-v1/;
#include "sun20i-d1.dtsi"
#include "sun20i-common-regulators.dtsi"
/ {
model = "MangoPi MQ Pro";
compatible = "widora,mangopi-mq-pro", "allwinner,sun20i-d1";
aliases {
ethernet0 = &rtl8723ds;
serial0 = &uart0;
};
chosen {
stdout-path = "serial0:115200n8";
};
hdmi_connector: connector {
compatible = "hdmi-connector";
type = "c";
port {
hdmi_connector_in: endpoint {
remote-endpoint = <&hdmi_out_connector>;
};
};
};
leds {
compatible = "gpio-leds";
led-0 {
color = <LED_COLOR_ID_BLUE>;
function = LED_FUNCTION_STATUS;
gpios = <&pio 3 18 GPIO_ACTIVE_HIGH>; /* PD18 */
};
};
reg_avdd2v8: avdd2v8 {
compatible = "regulator-fixed";
regulator-name = "avdd2v8";
regulator-min-microvolt = <2800000>;
regulator-max-microvolt = <2800000>;
vin-supply = <&reg_vcc_3v3>;
};
reg_dvdd: dvdd {
compatible = "regulator-fixed";
regulator-name = "dvdd";
regulator-min-microvolt = <1200000>;
regulator-max-microvolt = <1200000>;
vin-supply = <&reg_vcc_3v3>;
};
reg_vdd_cpu: vdd-cpu {
compatible = "regulator-fixed";
regulator-name = "vdd-cpu";
regulator-min-microvolt = <1100000>;
regulator-max-microvolt = <1100000>;
vin-supply = <&reg_vcc>;
};
wifi_pwrseq: wifi-pwrseq {
compatible = "mmc-pwrseq-simple";
reset-gpios = <&pio 6 17 GPIO_ACTIVE_LOW>; /* PG17 */
};
};
&cpu0 {
cpu-supply = <&reg_vdd_cpu>;
};
&dcxo {
clock-frequency = <24000000>;
};
&codec {
routing = "Internal Speaker", "HPOUTL",
"Internal Speaker", "HPOUTR";
widgets = "Speaker", "Internal Speaker";
status = "okay";
};
&de {
status = "okay";
};
&ehci1 {
status = "okay";
};
&hdmi {
status = "okay";
};
&hdmi_out {
hdmi_out_connector: endpoint {
remote-endpoint = <&hdmi_connector_in>;
};
};
&hdmi_phy {
status = "okay";
};
&mmc0 {
bus-width = <4>;
cd-gpios = <&pio 5 6 GPIO_ACTIVE_HIGH>; /* PF6 */
disable-wp;
vmmc-supply = <&reg_vcc_3v3>;
vqmmc-supply = <&reg_vcc_3v3>;
pinctrl-0 = <&mmc0_pins>;
pinctrl-names = "default";
status = "okay";
};
&mmc1 {
bus-width = <4>;
mmc-pwrseq = <&wifi_pwrseq>;
non-removable;
vmmc-supply = <&reg_vcc_3v3>;
vqmmc-supply = <&reg_vcc_3v3>;
pinctrl-0 = <&mmc1_pins>;
pinctrl-names = "default";
status = "okay";
rtl8723ds: wifi@1 {
reg = <1>;
interrupt-parent = <&pio>;
interrupts = <6 10 IRQ_TYPE_LEVEL_LOW>; /* PG10 */
interrupt-names = "host-wake";
};
};
&ohci1 {
status = "okay";
};
&pio {
vcc-pe-supply = <&reg_avdd2v8>;
/omit-if-no-ref/
i2c0_pg12_pins: i2c0-pg12-pins {
pins = "PG12", "PG13";
function = "i2c0";
};
/omit-if-no-ref/
i2c1_pb4_pins: i2c1-pb4-pins {
pins = "PB4", "PB5";
function = "i2c1";
};
/omit-if-no-ref/
i2c2_pb0_pins: i2c2-pb0-pins {
pins = "PB0", "PB1";
function = "i2c2";
};
/omit-if-no-ref/
i2c2_pc0_pins: i2c2-pc0-pins {
pins = "PC0", "PC1";
function = "i2c2";
};
/omit-if-no-ref/
i2c3_pe16_pins: i2c3-pe16-pins {
pins = "PE16", "PE17";
function = "i2c3";
};
/omit-if-no-ref/
uart2_pc0_pins: uart2-pc0-pins {
pins = "PC0", "PC1";
function = "uart2";
};
/omit-if-no-ref/
uart3_pd10_pins: uart3-pd10-pins {
pins = "PD10", "PD11";
function = "uart3";
};
/omit-if-no-ref/
uart3_pd13_rts_cts_pins: uart3-pd13-rts-cts-pins {
pins = "PD13", "PD14";
function = "uart3";
};
/omit-if-no-ref/
uart3_pb6_pins: uart3-pb6-pins {
pins = "PB6", "PB7";
function = "uart3";
};
/omit-if-no-ref/
uart4_pb2_pins: uart4-pb2-pins {
pins = "PB2", "PB3";
function = "uart4";
};
/omit-if-no-ref/
uart5_pb4_pins: uart5-pb4-pins {
pins = "PB4", "PB5";
function = "uart5";
};
};
/* Disabled
&spi1 {
pinctrl-0 = <&spi1_pd_pins>; // conflicts uart3
pinctrl-names = "default";
status = "okay";
};
*/
&i2c0 {
pinctrl-0 = <&i2c0_pg12_pins>;
pinctrl-names = "default";
status = "okay";
};
/* Disabled
&i2c1 {
pinctrl-0 = <&i2c1_pb4_pins>; // conflicts uart5
pinctrl-names = "default";
status = "okay";
};
*/
/* disabled
&i2c2 {
pinctrl-0 = <&i2c2_pb0_pins>;
pinctrl-names = "default";
status = "okay";
};
*/
&i2c2 {
pinctrl-0 = <&i2c2_pc0_pins>; // conflicts uart2
pinctrl-names = "default";
status = "okay";
};
&i2c3 {
pinctrl-0 = <&i2c3_pe16_pins>;
pinctrl-names = "default";
status = "okay";
};
&uart0 {
pinctrl-0 = <&uart0_pb8_pins>;
pinctrl-names = "default";
status = "okay";
};
&uart1 {
uart-has-rtscts;
pinctrl-0 = <&uart1_pg6_pins>, <&uart1_pg8_rts_cts_pins>;
pinctrl-names = "default";
status = "okay";
bluetooth {
compatible = "realtek,rtl8723ds-bt";
device-wake-gpios = <&pio 6 18 GPIO_ACTIVE_HIGH>; /* PG18 */
enable-gpios = <&pio 6 15 GPIO_ACTIVE_HIGH>; /* PG15 */
host-wake-gpios = <&pio 6 14 GPIO_ACTIVE_HIGH>; /* PG14 */
};
};
&uart2 {
pinctrl-0 = <&uart2_pc0_pins>;
pinctrl-names = "default";
status = "okay";
};
&uart3 {
uart-has-rtscts;
pinctrl-0 = <&uart3_pd10_pins>, <&uart3_pd13_rts_cts_pins>; // conflicts spi1
pinctrl-names = "default";
status = "okay";
};
/* Disabled
&uart3 {
pinctrl-0 = <&uart3_pb6_pins>;
pinctrl-names = "default";
status = "okay";
};
*/
&uart4 {
pinctrl-0 = <&uart4_pb2_pins>;
pinctrl-names = "default";
status = "okay";
};
&uart5 {
pinctrl-0 = <&uart5_pb4_pins>; // conflicts i2c1
pinctrl-names = "default";
status = "okay";
};
&usb_otg {
dr_mode = "peripheral";
status = "okay";
};
&usbphy {
usb1_vbus-supply = <&reg_vcc>;
status = "okay";
};

File diff suppressed because it is too large Load Diff

View File

@ -6,23 +6,23 @@ Gpio Header:
3v3 1 --o o-- 2 5v
i2c0.sda (2502000.i2c:205) PG13 3 --o o-- 4 5v
i2c0.sck (2502000.i2c:204) PG12 5 --o o-- 6 gnd
free (39) PB7 7 --o o-- 8 PB8 uart0.tx (2500000.serial:40)
uart3.rx (2500c00.serial:39 PB7 7 --o o-- 8 PB8 uart0.tx (2500000.serial:40)
gnd 9 --o o-- 10 PB9 uart0.rx (2500000.serial:41)
free (117) PD21 11 --o o-- 12 PB5 uart5.rx (2501400.serial:37)
free (117) PD21 11 --o o-- 12 PB5 i2c1.sda (2502400.i2c:37)
free (118) PD22 13 --o o-- 14 gnd
uart2.tx (2500800.serial:32) PB0 15 --o o-- 16 PB1 uart2.rx (2500800.serial:33)
i2c2.sck (2502800.i2c:32) PB0 15 --o o-- 16 PB1 i2c2.sda (2502800.i2c:33)
3v3 17 --o o-- 18 PD14 spi1.hold (4026000.spi:110)
spi1.mosi (4026000.spi:108) PD12 19 --o o-- 20 gnd
spi1.miso (4026000.spi:109) PD13 21 --o o-- 22 PC1 i2c2.sda (2502800.i2c:65)
spi1.miso (4026000.spi:109) PD13 21 --o o-- 22 PC1 uart2.rx (2500800.serial:65)
spi1.clk (4026000.spi:107) PD11 23 --o o-- 24 PD10 spi1.cs (4026000.spi:106)
gnd 25 --o o-- 26 PD15 spi1.wp (4026000.spi:111)
i2c3.sda (2502c00.i2c:145) PE17 27 --o o-- 28 PE16 i2c3.sck (2502c00.i2c:144)
free (42) PB10 29 --o o-- 30 gnd
free (43) PB11 31 --o o-- 32 PC0 i2c2.sck (2502800.i2c:64)
free (43) PB11 31 --o o-- 32 PC0 uart2.tx (2500800.serial:64)
free (44) PB12 33 --o o-- 34 gnd
free (38) PB6 35 --o o-- 36 PB2 uart4.tx (2501000.serial:34)
uart3.tx (2500c00.serial:38) PB6 35 --o o-- 36 PB2 uart4.tx (2501000.serial:34)
free (113) PD17 37 --o o-- 38 PB3 uart4.rx (2501000.serial:35)
gnd 39 --o o-- 40 PB4 uart5.tx (2501400.serial:36)
gnd 39 --o o-- 40 PB4 i2c1.sck (2502400.i2c:36
Other gpio outputs of interest:
-- PD18: Blue Status Led - gpio (2000000.pinctrl:114)

View File

@ -22,6 +22,17 @@
stdout-path = "serial0:115200n8";
};
hdmi_connector: connector {
compatible = "hdmi-connector";
type = "c";
port {
hdmi_connector_in: endpoint {
remote-endpoint = <&hdmi_out_connector>;
};
};
};
leds {
compatible = "gpio-leds";
@ -70,10 +81,35 @@
clock-frequency = <24000000>;
};
&codec {
routing = "Internal Speaker", "HPOUTL",
"Internal Speaker", "HPOUTR";
widgets = "Speaker", "Internal Speaker";
status = "okay";
};
&de {
status = "okay";
};
&ehci1 {
status = "okay";
};
&hdmi {
status = "okay";
};
&hdmi_out {
hdmi_out_connector: endpoint {
remote-endpoint = <&hdmi_connector_in>;
};
};
&hdmi_phy {
status = "okay";
};
&mmc0 {
bus-width = <4>;
cd-gpios = <&pio 5 6 GPIO_ACTIVE_HIGH>; /* PF6 */
@ -109,10 +145,76 @@
&pio {
vcc-pe-supply = <&reg_avdd2v8>;
/omit-if-no-ref/
i2c0_pg12_pins: i2c0-pg12-pins {
pins = "PG12", "PG13";
function = "i2c0";
};
/omit-if-no-ref/
i2c1_pb4_pins: i2c1-pb4-pins {
pins = "PB4", "PB5";
function = "i2c1";
};
/omit-if-no-ref/
i2c2_pb0_pins: i2c2-pb0-pins {
pins = "PB0", "PB1";
function = "i2c2";
};
/omit-if-no-ref/
i2c2_pc0_pins: i2c2-pc0-pins {
pins = "PC0", "PC1";
function = "i2c2";
};
/omit-if-no-ref/
i2c3_pe16_pins: i2c3-pe16-pins {
pins = "PE16", "PE17";
function = "i2c3";
};
/omit-if-no-ref/
uart2_pc0_pins: uart2-pc0-pins {
pins = "PC0", "PC1";
function = "uart2";
};
/omit-if-no-ref/
uart3_pd10_pins: uart3-pd10-pins {
pins = "PD10", "PD11";
function = "uart3";
};
/omit-if-no-ref/
uart3_pd13_rts_cts_pins: uart3-pd13-rts-cts-pins {
pins = "PD13", "PD14";
function = "uart3";
};
/omit-if-no-ref/
uart3_pb6_pins: uart3-pb6-pins {
pins = "PB6", "PB7";
function = "uart3";
};
/omit-if-no-ref/
uart4_pb2_pins: uart4-pb2-pins {
pins = "PB2", "PB3";
function = "uart4";
};
/omit-if-no-ref/
uart5_pb4_pins: uart5-pb4-pins {
pins = "PB4", "PB5";
function = "uart5";
};
};
&spi1 {
pinctrl-0 = <&spi1_pd_pins>;
pinctrl-0 = <&spi1_pd_pins>; // conflicts uart3
pinctrl-names = "default";
status = "okay";
};
@ -123,17 +225,25 @@
status = "okay";
};
/*&i2c1 {
pinctrl-0 = <&i2c1_pb4_pins>;
&i2c1 {
pinctrl-0 = <&i2c1_pb4_pins>; // conflicts uart5
pinctrl-names = "default";
status = "okay";
};*/
};
/*&i2c2 {
pinctrl-0 = <&i2c2_pc0_pins>;
&i2c2 {
pinctrl-0 = <&i2c2_pb0_pins>;
pinctrl-names = "default";
status = "okay";
};*/
};
/* disabled
&i2c2 {
pinctrl-0 = <&i2c2_pc0_pins>; // conflicts uart2
pinctrl-names = "default";
status = "okay";
};
*/
&i2c3 {
pinctrl-0 = <&i2c3_pe16_pins>;
@ -162,36 +272,39 @@
};
&uart2 {
pinctrl-0 = <&uart2_pc0_pins>;
pinctrl-names = "default";
status = "okay";
pinctrl-0 = <&uart2_pc0_pins>;
pinctrl-names = "default";
status = "okay";
};
/*&uart3 {
uart-has-rtscts;
pinctrl-0 = <&uart3_pd10_pins>, <&uart3_pd13_rts_cts_pins>;
pinctrl-names = "default";
status = "okay";
};*/
/* Disabled
&uart3 {
uart-has-rtscts;
pinctrl-0 = <&uart3_pd10_pins>, <&uart3_pd13_rts_cts_pins>; // conflicts spi1
pinctrl-names = "default";
status = "okay";
};
*/
&uart3 {
pinctrl-0 = <&uart3_pb6_pins>;
pinctrl-names = "default";
status = "okay";
};
&uart4 {
pinctrl-0 = <&uart4_pb2_pins>;
pinctrl-names = "default";
status = "okay";
pinctrl-0 = <&uart4_pb2_pins>;
pinctrl-names = "default";
status = "okay";
};
/*&uart5 {
pinctrl-0 = <&uart5_pb4_pins>;
pinctrl-names = "default";
status = "okay";
};*/
&pwm {
//pinctrl-0 = <&pwm0_pb12_pin>, <&pwm2_pd18_pin>;
pinctrl-0 = <&pwm0_pb12_pin>;
pinctrl-names = "default";
status = "okay";
/* Disabled
&uart5 {
pinctrl-0 = <&uart5_pb4_pins>; // conflicts i2c1
pinctrl-names = "default";
status = "okay";
};
*/
&usb_otg {
dr_mode = "peripheral";

View File

@ -10,7 +10,7 @@ echo "Compiling against headers for $revision"
if [ -d "$revision" ]; then
echo "Cleaning and Using existing build directory"
rm "$revision/*.dts $revision/*.dtsi $revision/*.dtb"
rm $revision/*.dts $revision/*.dtsi $revision/*.dtb
else
echo "Creating new build directory: $revision"
mkdir "$revision"