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.