LN882H datasheet, pinout, WiFi modules (LN882HK, LN882HKx, LN882), Esphome/Tasmota style firmware

LN882H is a Single-Chip Wireless SOC with Cortex M4F CPU supporting 802.11b/g/n (2.4 GHz Wi-Fi) and Bluetooth 5.1 (LE). LN882H offers 296KB RAM / 128KB ROM, 512KB~4MB Flash for XIP application code and SWD debug interface.
LN882H peripherals include 20 GPIOs (QFN32) or 12 GPIOs (QFN24), SPI/I2S/I2C/SDIO/UART interfaces, Timer/Advance Timer (PWM), Multi-channel ADC with programmed amplifier for voice sense, XIP from external QSPI FLASH with high-speed cache, RTC, WDT, DMA controller and RGB LED protocol support (Compatible with the WS2811/WS2812).

LN882H block diagram and pinout
Here is LN882H diagram:

QFN32 pinout:

QFN24 pinout:

QFN40 pinout:

GPIO table:

LN882H has 12 or 20 GPIOs:
- Two group IOs GPIOA and GPIOB, which are separately configurable
- Configurable hardware and software control for each signal
- Configurable interrupt mode for Port A, debounce logic is used to generate single hi-active interrupts
SWD interface:

ADC:

Boot mode select:

Case codes:

Part Number	Package	Flash Size	Temperature
LN882HKI	QFN-32, 5mm pitch	2MB Flash	-40℃~105℃
LN882HKG	QFN-32, 5mm pitch	1MB Flash	-40℃~105℃
LN882HFG	QFN-24, 4mm pitch	1MB Flash	-40℃~105℃
LN882HC0	QFN-40, 5mm pitch	External Flash	-40℃~105℃

LN882H IoT modules
LN882H often comes in form of modules, for example, a WL2H-U module by Tuya:


Pinout:

Pin No.	Symbol	I/O Type	Description
1	GPIOA5	I/O	Common GPIO pin, which can be reused as SPI_SCK and corresponds to pin 13 of the IC.
2	GPIOA6	I/O	Common GPIO pin, which can be reused as SPI_MOSI and corresponds to pin 14 of the IC.
3	GPIOA4	I/O	Common GPIO pin, corresponding to pin 12 of the IC.
4	GPIOA1	I/O	Common GPIO pin, corresponding to pin 9 of the IC.
5	ADC	I/O	ADC pin, corresponding to the GPIOA0 pin (pin 8) of the IC.
6	RX1	I/O	UART_RX1 pin, corresponding to the GPIOB8 pin (pin 29) of the IC.
7	TX1	I/O	UART_TX1 pin for log printing, corresponding to the GPIOB9 pin (pin 30) of the IC.
8	GPIOA7	I/O	PWM pin, corresponding to pin 15 of the IC.
9	GPIOA10	I/O	PWM pin, corresponding to pin 21 of the IC.
10	GPIOA11	I/O	PWM pin, corresponding to pin 22 of the IC.
11	GPIOA12	I/O	PWM pin, corresponding to pin 23 of the IC.
12	GPIOB3	I/O	PWM pin, corresponding to pin 24 of the IC.
13	GND	P	The ground wire.
14	3V3	P	3.3V power supply.
15	TX0	I/O	UART_TX0 pin for sending user data, corresponding to the GPIOA2 pin (pin 10) of the IC.
16	RX0	I/O	UART_RX0 pin for receiving user data, corresponding to the GPIOA3 pin (pin 11) of the IC.
17	GPIOB4	I/O	Common GPIO pin, which can be reused as ADC2 and corresponds to pin 24 of the IC.
18	RST	I/O	Reset pin, which is active at a low level, internally pulled up, and compatible with other module designs.
19	GPIOB5	I/O	Common GPIO pin, corresponding to pin 26 of the IC.
20	GPIOB6	I/O	Common GPIO pin, which can be reused as SPI_MISO and corresponds to pin 27 of the IC.
21	GPIOB7	I/O	Common GPIO pin, which can be reused as SPI_CS and corresponds to pin 28 of the IC.
Top side test point (burning pin)	GPIOA9	I/O	Mode selection pin, which is pulled down before power-on to enter the burning mode and corresponds to pin 17 of the IC.

Sample IoT devices with LN882H
See following topics:
Flashing OpenBeken Firmware on WL2S Module with Lightning LN882HK Chip for ELIVCO LSPA9
Identify Mini smart switch WiFi Relay Module with ln882hki Chip
Heruled Tuya WiFi Smart LED Controller - Lightning Semiconductor LN8825B chip
More LN882 device teardowns should appear on our forum soon.

LN882H alternate firmware
There is one esphome/tasmota-style firmware that supports LN882H, the support at the time of the writing is WIP, but should be fully functional soon, see:
https://github.com/openshwprojects/OpenBK7231T_App

Also see our devices list:
https://openbekeniot.github.io/webapp/devicesList.html
And see OpenBeken tutorials on Elektroda Youtube:
https://www.youtube.com/@elektrodacom

LN882H firmware read/write procedure
The LN882H flashing tutorial will be posted as separate topic. Please watch for updates in the posts down below. For unofficial flasher info, please see this post:
https://www.elektroda.com/rtvforum/topic4008545-60.html#20897719

Futher reading
Here are some more detailed LN882H resources.
Datasheet:
LN882H_Dat..eet.pdf Download (2.89 MB)
Chinese detailed documentation:
ln882h-doc...104-p2.zip Download (57.5 MB)
ln882h-doc...104_p1.zip Download (55.72 MB)
SDK:
ln882h-202..104.zip Download (33.34 MB)
Miscellaneous:
ln882x-mcu...240104.zip Download (16.41 MB)
ln882h-nim...240104.zip Download (27.3 MB)
jdt-ln882h...otocol.zip Download (25.72 MB)
ln882x-off...240104.zip Download (42.61 MB)

Detailed flashing guide for open source firmware and pairing with HA guide will be posted separately! Please watch the posts below for updates!
This topic is information-only, it's locked for users, please open separate topic if you have a question.