[lightning-ln882h] Add support for Lightning LN882H family

.github/workflows/push-dev.yml

@@ -3,6 +3,7 @@ on:
   push:
     branches: ["**"]
   pull_request:
+  workflow_dispatch:
 jobs:
   lint-clang:
     name: Run Clang lint

README.md

@@ -15,10 +15,11 @@
 
 ![RTL8710BN](https://img.shields.io/badge/-rtl8710bn-blue)
 ![BK7231](https://img.shields.io/badge/-bk7231-blue)
+![LN882H](https://img.shields.io/badge/-ln882h-blue)
 
 </div>
 
-PlatformIO development platform for BK7231 and RTL8710 IoT chips.
+PlatformIO development platform for BK7231 and RTL8710 and LN882H IoT chips.
 
 The main goal of this project is to provide a usable build environment for IoT developers. While also providing vendor SDKs as PlatformIO cores,
 the project focuses on developing working Arduino-compatible cores for supported families. The cores are inspired by Espressif's official core for ESP32,

SUMMARY.md

@@ -19,6 +19,7 @@
 	* [Realtek AmebaZ](docs/platform/realtek-ambz/README.md)
 		* [Debugging](docs/platform/realtek-ambz/debugging.md)
 		* [Exception decoder](docs/platform/realtek-ambz/exception-decoder.md)
+	* [Lightning LN882x](docs/platform/lightning-ln882x/README.md)
 * [🔧 LT Configuration](docs/dev/config.md)
 * 🧑 Programmer's manual
 	* [⚠️ Migration guide](docs/dev/migration_v1.0.0.md)

boards/_base/ic/ln882hk.json

@@ -0,0 +1,149 @@
+{
+	"pcb": {
+		"ic": {
+			"7": {
+				"IO": "I",
+				"CTRL": "CEN"
+			},
+			"8": {
+				"C_NAME": "PA_0",
+				"GPIO": "PA00",
+				"IRQ": null,
+				"ADC": 2,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"9": {
+				"C_NAME": "PA_1",
+				"GPIO": "PA01",
+				"IRQ": null,
+				"ADC": 3,
+				"SWD": "DIO",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"10": {
+				"C_NAME": "PA_2",
+				"GPIO": "PA02",
+				"IRQ": null,
+				"UART": "0_TX",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"11": {
+				"C_NAME": "PA_3",
+				"GPIO": "PA03",
+				"IRQ": null,
+				"UART": "0_RX",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"12": {
+				"C_NAME": "PA_4",
+				"GPIO": "PA04",
+				"ADC": 4,
+				"SWD": "CLK",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"13": {
+				"C_NAME": "PA_5",
+				"GPIO": "PA05",
+				"IRQ": null,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"14": {
+				"C_NAME": "PA_6",
+				"GPIO": "PA06",
+				"IRQ": null,
+				"SD": "D2",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"15": {
+				"C_NAME": "PA_7",
+				"GPIO": "PA07",
+				"IRQ": null,
+				"SD": "D3",
+				"I2S": "0_RX",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"16": {
+				"C_NAME": "PA_8",
+				"GPIO": "PA08",
+				"CTRL": "BOOT0",
+				"SD": "CMD",
+				"I2S": "0_WS",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"17": {
+				"C_NAME": "PA_9",
+				"GPIO": "PA09",
+				"CTRL": "BOOT1",
+				"SD": "CLK",
+				"I2S": "0_SCLK",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"21": {
+				"C_NAME": "PA_10",
+				"GPIO": "PA10",
+				"SD": "D0",
+				"I2S": "0_TX",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"22": {
+				"C_NAME": "PA_11",
+				"GPIO": "PA11",
+				"SD": "D1",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"23": {
+				"C_NAME": "PA_12",
+				"GPIO": "PA12",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"24": {
+				"C_NAME": "PB_3",
+				"GPIO": "PB03",
+				"GPIONUM": 19,
+				"ADC": 5,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"25": {
+				"C_NAME": "PB_4",
+				"GPIO": "PB04",
+				"GPIONUM": 20,
+				"ADC": 6,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"26": {
+				"C_NAME": "PB_5",
+				"GPIO": "PB05",
+				"GPIONUM": 21,
+				"ADC": 7,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"27": {
+				"C_NAME": "PB_6",
+				"GPIO": "PB06",
+				"GPIONUM": 22,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"28": {
+				"C_NAME": "PB_7",
+				"GPIO": "PB07",
+				"GPIONUM": 23,
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"29": {
+				"C_NAME": "PB_8",
+				"GPIO": "PB08",
+				"GPIONUM": 24,
+				"UART": "1_RX",
+				"I2C": ["0_SCL","0_SDA"]
+			},
+			"30": {
+				"C_NAME": "PB_9",
+				"GPIO": "PB09",
+				"GPIONUM": 25,
+				"IRQ": null,
+				"UART": "1_TX",
+				"I2C": ["0_SCL","0_SDA"]
+			}
+		}
+	}
+}

boards/_base/lightning-ln882hki.json

@@ -0,0 +1,31 @@
+{
+	"build": {
+		"family": "LN882H",
+		"ldscript": "ln882hki_bsp.ld",
+		"bootfile": "boot_ln882h.bin"
+	},
+	"flash": {
+		"boot": "0x000000+0x06000",
+		"part_tab": "0x006000+0x01000",
+		"app": "0x007000+0x12C000",
+		"ota": "0x133000+0xAA000",
+		"nvds": "0x1DD000+0x03000",
+		"kv": "0x1E0000+0x04000",
+		"kvs": "0x1E4000+0x08000",
+		"user": "0x1EC000+0x14000"
+	},
+	"upload": {
+		"flash_size": 2097152,
+		"maximum_size": 1228800
+	},
+	"connectivity": [
+		"ble"
+	],
+	"doc": {
+		"params": {
+			"extra": {
+				"Bluetooth": "BLE v5.1"
+			}
+		}
+	}
+}

boards/_base/lightning-ln882x.json

@@ -0,0 +1,44 @@
+{
+	"build": {
+		"f_cpu": "160000000L",
+		"prefix": "arm-none-eabi-"
+	},
+	"flash": {
+	},
+	"connectivity": [
+		"wifi"
+	],
+	"debug": {
+		"protocol": "openocd",
+		"protocols": [
+			"openocd"
+		],
+		"openocd_config": "ln882x.cfg",
+		"gdb_init": [
+			"mem 0x00000000 0x10000000 ro"
+		]
+	},
+	"upload": {
+		"maximum_ram_size": 302080,
+		"require_upload_port": true,
+		"speed": 115200,
+		"protocol": "uart",
+		"protocols": [
+			"uart"
+		]
+	},
+	"doc": {
+		"params": {
+			"manufacturer": "Lightning",
+			"series": "LN882X",
+			"voltage": "3.0V - 3.6V",
+			"extra": {
+				"Wi-Fi": "802.11 b/g/n"
+			}
+		},
+		"links": {
+			"Info & flashing guide": "../../docs/platform/lightning-ln882x/README.md",
+			"Debugging": "../../docs/platform/lightning-ln882x/debugging.md"
+		}
+	}
+}

boards/_base/pcb/ln-02-test.json

@@ -0,0 +1,23 @@
+{
+	"pcb": {
+		"test_pads": {
+			"TBOOT": "ln-02.back.boot.anchor"
+		},
+		"back": [
+			{
+				"id": "boot",
+				"name": "label_line_up",
+				"pos": "12,12.1",
+				"vars": {
+					"DIR": "right",
+					"W": 2.5,
+					"H": 0
+				}
+			},
+			{
+				"name": "test_pad_1mm",
+				"pos": "11,12"
+			}
+		]
+	}
+}

boards/_base/pcb/ln-02.json

@@ -0,0 +1,58 @@
+{
+	"pcb": {
+		"templates": [
+			"tuya2",
+			"pcb-black",
+			"rf-type1"
+		],
+		"scale": 10.5,
+		"pinout_hidden": "I2S,TRIG,WAKE,CTS,RTS,SD,SPI,I2C",
+		"pinout": {
+			"1": {
+				"PWR": 3.3
+			},
+			"2": {
+				"IC": 22,
+				"ARD": "D0"
+			},
+			"3": {
+				"GND": null
+			},
+			"4": {
+				"IC": 24,
+				"ARD": ["D1","A0"]
+			},
+			"5": {
+				"IC": 11,
+				"ARD": "D2"
+			},
+			"6": {
+				"IC": 29,
+				"ARD": "D3"
+			},
+			"7": {
+				"IC": 10,
+				"ARD": "D4"
+			},
+			"8": {
+				"IC": 30,
+				"ARD": "D5"
+			},
+			"9": {
+				"IC": 9,
+				"ARD": ["D6","A1"]
+			},
+			"10": {
+				"IC": 7
+			},
+			"11": {
+				"IC": 8,
+				"ARD": ["D7","A2"]
+			},
+			"TBOOT": {
+				"IC": 17,
+				"ARD": "D8"
+			}
+		}
+	}
+}