Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Unit LCD Plus Internal Firmware

Arduino/PlatformIO firmware for M5Stack Unit LCD Plus (U242) with ESP32-C61.

This project is adapted from M5Unit-LCD-Internal-FW at commit 6b345872f033dc85fd56e7af722b31583a587a88. The Unit LCD I2C protocol and default address (0x3E) remain compatible. Unit LCD Plus adds a compatible encoder and button protocol in the previously unused 0xB0 through 0xB5 range.

Build

PlatformIO environments:

Environment Purpose
release, esp32_release Production internal firmware, version 1.2
iap_test, esp32_iap_test Temporary version 1.3 image for online-update validation
pio run -e release
pio run -e iap_test

Direct USB flashing uses 921600 baud. The encoder button is wired to GPIO9, the ESP32-C61 download-boot strapping pin (active low). Hold the encoder button while powering on to enter Joint Download Boot if USB auto-download is unavailable:

pio run -e release -t upload --upload-port /dev/ttyACM0
pio device monitor --port /dev/ttyACM0 --baud 115200

See docs/Unit_LCD_Plus_I2C_Protocol_zh.md for the complete display, input, address, reset, and IAP protocol. See docs/encoder_button_protocol_zh.md or docs/encoder_protocol.md for additional encoder event and ACK details.

Unit LCD Plus Pins

Function ESP32-C61 GPIO
Grove SDA / SCL 5 / 6
UART0 RX / TX 10 / 11
LCD RST / D-C 23 / 22
LCD MOSI / SCLK / CS 28 / 27 / 26
LCD backlight enable 25, active high
Encoder A / B / button 2 / 3 / 9

The internal canvas uses a three-byte RGB stream for compatibility with the original firmware. M5GFX programs the ST7789 with COLMOD=0x66, so the panel interface is RGB666 even though the internal API color depth is named 24-bit. External controllers can continue to use the RGB332, RGB565, and RGB888 protocol commands.

Firmware version 1.2

Current release uses major version 1 and minor version 2. READ_ID returns 77 89 01 02; byte 2 is the major version, not MODEL_ID. Byte 3 contains the plain minor version without build flags. Boot and Device Info read these same version values. IAP test builds use 1.3. Older serial-version 5/6 and model-based updater documentation describes the previous protocol.

Version 1.2 adds READ_MAC (0x0A): write the one-byte command, then read six factory-programmed eFuse MAC bytes in normal display order. Both STOP-separated and repeated-START reads are supported. The command does not start Wi-Fi, change the display owner, or enter the drawing queue. Hosts must use the known product/firmware version to determine support; older firmware treats 0x0A as undefined. See examples/ReadMac/ReadMac.ino for a host example.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages