tactility/Devices/m5stack-cores3/m5stack,cores3.dts

/dts-v1/;

#include <tactility/bindings/root.h>
#include <tactility/bindings/esp32_ble.h>
#include <tactility/bindings/esp32_wifi_pinned.h>
#include <tactility/bindings/esp32_gpio.h>
#include <tactility/bindings/esp32_grove.h>
#include <tactility/bindings/esp32_i2c.h>
#include <tactility/bindings/esp32_i2s.h>
#include <tactility/bindings/esp32_spi.h>
#include <tactility/bindings/esp32_uart.h>
#include <tactility/bindings/gpio_hog.h>
#include <bindings/aw88298.h>
#include <bindings/aw9523b.h>
#include <bindings/axp2101.h>
#include <bindings/axp2101_backlight.h>
#include <bindings/bmi270.h>
#include <bindings/bm8563.h>
#include <bindings/es7210.h>
#include <bindings/ft5x06.h>
#include <bindings/ili9341.h>

// SD card is not supported because of a hardware problem:
// The display uses pin 35 as input (MISO), but the SPI bus (and SD card) uses the same pin as DC (output).

// Reference: https://docs.m5stack.com/en/core/CoreS3
/ {
	compatible = "root";
	model = "M5Stack CoreS3";

	wifi0 {
		compatible = "espressif,esp32-wifi-pinned";
		status = "disabled";
	};

	ble0 {
		compatible = "espressif,esp32-ble";
		status = "disabled";
	};

	gpio0 {
		compatible = "espressif,esp32-gpio";
		gpio-count = <49>;
	};

	i2s0 {
		// Note: M5Unified sets the following for speaker: magnification = 2, oversampling = 1
		// Note: M5Unified sets the following for microphone: magnification = 4
		compatible = "espressif,esp32-i2s";
		port = <I2S_NUM_0>;
		pin-bclk = <&gpio0 34 GPIO_FLAG_NONE>;
		pin-ws = <&gpio0 33 GPIO_FLAG_NONE>;
		pin-data-out = <&gpio0 13 GPIO_FLAG_NONE>;
		pin-data-in = <&gpio0 14 GPIO_FLAG_NONE>;
		pin-mclk = <&gpio0 0 GPIO_FLAG_NONE>;
	};

	i2c_internal {
		compatible = "espressif,esp32-i2c";
		port = <I2C_NUM_0>;
		clock-frequency = <400000>;
		pin-sda = <&gpio0 12 GPIO_FLAG_NONE>;
		pin-scl = <&gpio0 11 GPIO_FLAG_NONE>;

		bmi270 {
			compatible = "bosch,bmi270";
			reg = <0x69>;
		};

		bm8563 {
			compatible = "belling,bm8563";
			reg = <0x51>;
		};

		// P0_0 = touch reset, P0_1 = bus-out enable, P0_2 = AW88298 reset,
		// P0_4 = SD card switch, P1_1 = LCD reset, P1_7 = boost enable (SY7088)
		aw9523b {
			compatible = "awinic,aw9523b";
			reg = <0x58>;

			// Bus-out enable, AW88298 (audio amp) reset, SD card power switch and boost enable
			// (SY7088) are AW9523B pins with no owning peripheral driver yet.
			aw9523_bus_out_enable {
				compatible = "gpio-hog";
				pin = <&aw9523b 1 GPIO_FLAG_NONE>;
				mode = <GPIO_HOG_MODE_OUTPUT_HIGH>;
			};

			aw9523_sdcard_switch {
				compatible = "gpio-hog";
				pin = <&aw9523b 4 GPIO_FLAG_NONE>;
				mode = <GPIO_HOG_MODE_INPUT>;
			};

			aw9523_boost_enable {
				compatible = "gpio-hog";
				pin = <&aw9523b 15 GPIO_FLAG_NONE>;
				mode = <GPIO_HOG_MODE_OUTPUT_HIGH>;
			};
		};

		aw88298 {
			compatible = "awinic,aw88298";
			reg = <0x36>;
			i2s = <&i2s0>;
			pin-reset = <&aw9523b 2 GPIO_FLAG_NONE>;
		};

		axp2101: axp2101 {
			compatible = "x-powers,axp2101";
			reg = <0x34>;
			aldo1-millivolt = <1800>;
			aldo1-enabled;
			aldo2-millivolt = <3300>;
			aldo2-enabled;
			aldo3-millivolt = <3300>;
			aldo3-enabled;
			aldo4-millivolt = <3300>;
			aldo4-enabled;
			bldo1-enabled;
			bldo2-enabled;

			// LCD backlight (DLDO1). Raw register codes [20,28] map to [2500,3300]mV;
			// below 2500mV the backlight was considered "too dark" to be useful.
			display_backlight {
				compatible = "axp2101-backlight";
				ldo = <AXP2101_DLDO1>;
				min-millivolt = <2500>;
				max-millivolt = <3300>;
			};
		};

		touch {
			compatible = "focaltech,ft5x06";
			reg = <0x38>;
			x-max = <320>;
			y-max = <240>;
			pin-reset = <&aw9523b 0 GPIO_FLAG_NONE>;
		};

		es7210 {
			compatible = "everest,es7210";
			reg = <0x40>;
			i2s = <&i2s0>;
			// Only MIC1/MIC2 are wired to real capsules (see schematic); MIC3/MIC4
			// slots carry AEC_P/AEC_N reference signal, not microphone audio.
			mic-mask = <3>;
			// M5Unified applies a 4x post-gain "magnification" for this exact mic
			// wiring (see M5Unified.cpp _mic_data_cb_cores3): the ES7210's own
			// hardware ADC gain (already near-max via the default 90% input volume
			// setting, ~34dB of its 0-37.5dB range) still isn't enough for these
			// capsules on their own.
			input-gain-percent = <400>;
		};
	};

	port_a: grove0 {
		compatible = "espressif,esp32-grove";
		defaultMode = <GROVE_MODE_I2C>;
		pinSdaTx = <&gpio0 2 GPIO_FLAG_NONE>;
		pinSclRx = <&gpio0 1 GPIO_FLAG_NONE>;
		uartPort = <UART_NUM_1>;
		i2cPort = <I2C_NUM_1>;
		i2cClockFrequency = <400000>;
	};

	port_b: grove1 {
		compatible = "espressif,esp32-grove";
		defaultMode = <GROVE_MODE_UART>;
		pinSdaTx = <&gpio0 9 GPIO_FLAG_NONE>;
		pinSclRx = <&gpio0 8 GPIO_FLAG_NONE>;
		uartPort = <UART_NUM_1>;
		i2cPort = <I2C_NUM_1>;
		i2cClockFrequency = <400000>;
	};

	port_c: grove2 {
		compatible = "espressif,esp32-grove";
		defaultMode = <GROVE_MODE_UART>;
		pinSdaTx = <&gpio0 17 GPIO_FLAG_NONE>;
		pinSclRx = <&gpio0 18 GPIO_FLAG_NONE>;
		uartPort = <UART_NUM_2>;
		i2cPort = <I2C_NUM_1>;
		i2cClockFrequency = <400000>;
	};

	spi0 {
		compatible = "espressif,esp32-spi";
		host = <SPI2_HOST>;
		cs-gpios = <&gpio0 3 GPIO_FLAG_NONE>, // Display
		           <&gpio0 4 GPIO_FLAG_NONE>; // SD card
		pin-mosi = <&gpio0 37 GPIO_FLAG_NONE>;
		pin-miso = <&gpio0 35 GPIO_FLAG_NONE>;
		pin-sclk = <&gpio0 36 GPIO_FLAG_NONE>;

		display@0 {
			compatible = "ilitek,ili9341";
			horizontal-resolution = <320>;
			vertical-resolution = <240>;
			invert-color;
			bgr-order;
			pixel-clock-hz = <40000000>;
			pin-dc = <&gpio0 35 GPIO_FLAG_NONE>;
			pin-reset = <&aw9523b 9 GPIO_FLAG_NONE>;
			backlight = <&display_backlight>;
		};
	};

};