adafruit · tannewt · Oct 2, 2026 · Sep 30, 2026 · Sep 30, 2026 · Sep 30, 2026
diff --git a/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/board.c b/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/board.c
@@ -0,0 +1,100 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2025 Benjamin Shockley
+// SPDX-FileCopyrightText: Copyright (c) 2026 David Glaude
+//
+// SPDX-License-Identifier: MIT
+//
+// Modified from waveshare_esp32_c6_lcd_1_47 to support waveshare_esp32_c5_lcd_1_47
+
+#include "supervisor/board.h"
+#include "mpconfigboard.h"
+#include "shared-bindings/microcontroller/Pin.h"
+#include "shared-bindings/busio/SPI.h"
+#include "shared-bindings/fourwire/FourWire.h"
+#include "shared-bindings/busdisplay/BusDisplay.h"
+#include "shared-module/displayio/__init__.h"
+#include "shared-module/displayio/mipi_constants.h"
+#include "shared-bindings/board/__init__.h"
+
+#define DELAY 0x80
+
+// Driver: ST7789V3, Panel: LBS147TC-IF15 (172x320 RGB)
+uint8_t display_init_sequence[] = {
+    0x01, 0 | DELAY, 120,
+    0x11, 0 | DELAY, 120,
+    0x13, 0,
+    0x36, 1, 0x00,
+    0x3A, 1 | DELAY, 0x05, 10,
+    0xB2, 5, 0x0C, 0x0C, 0x00, 0x33, 0x33,
+    0xB7, 1, 0x35,
+    0xBB, 1, 0x20,
+    0xC0, 1, 0x2C,
+    0xC2, 2, 0x01, 0xFF,
+    0xC3, 1, 0x13,
+    0xC4, 1, 0x20,
+    0xC6, 1, 0x0F,
+    0xD0, 2, 0xA4, 0xA1,
+    0xE0, 14, 0xF0, 0x00, 0x04, 0x04, 0x04, 0x05, 0x29, 0x33, 0x3E, 0x38, 0x12, 0x12, 0x28, 0x30,
+    0xE1, 14, 0xF0, 0x07, 0x0A, 0x0D, 0x0B, 0x07, 0x28, 0x33, 0x3E, 0x36, 0x14, 0x14, 0x29, 0x32,
+    0x21, 0,
+    0x29, 0 | DELAY, 255,
+};
+
+static void display_init(void) {
+    busio_spi_obj_t *spi = common_hal_board_create_spi(0);
+    fourwire_fourwire_obj_t *bus = &allocate_display_bus()->fourwire_bus;
+    bus->base.type = &fourwire_fourwire_type;
+
+    common_hal_fourwire_fourwire_construct(
+        bus,
+        spi,
+        MP_OBJ_FROM_PTR(&pin_GPIO24),    // LCD_DC
+        MP_OBJ_FROM_PTR(&pin_GPIO23),    // LCD_CS
+        MP_OBJ_FROM_PTR(&pin_GPIO26),    // LCD_RST
+        40000000,                       // Baudrate (40 MHz)
+        0,                              // Polarity
+        0                               // Phase
+        );
+
+    busdisplay_busdisplay_obj_t *display = &allocate_display()->display;
+    display->base.type = &busdisplay_busdisplay_type;
+
+    common_hal_busdisplay_busdisplay_construct(
+        display,
+        bus,
+        172,                            // Native width
+        320,                            // Native height
+        34,                             // Column start offset
+        0,                              // Row start offset
+        0,                              // Native rotation: 0 (portrait)
+        16,                             // Color depth
+        false,                          // Grayscale
+        false,                          // Pixels in byte share row
+        1,                              // Bytes per cell
+        false,                          // Reverse pixels in byte
+        true,                           // Reverse pixels in word
+        MIPI_COMMAND_SET_COLUMN_ADDRESS,
+        MIPI_COMMAND_SET_PAGE_ADDRESS,
+        MIPI_COMMAND_WRITE_MEMORY_START,
+        display_init_sequence,
+        sizeof(display_init_sequence),
+        &pin_GPIO10,                    // Backlight pin (LCD_BL)
+        NO_BRIGHTNESS_COMMAND,
+        1.0f,                           // Brightness
+        false,                          // Single byte bounds
+        false,                          // Data as commands
+        true,                           // Auto refresh
+        60,                             // Native FPS
+        true,                           // Backlight active high
+        false,                          // SH1107 addressing
+        50000                           // Backlight PWM frequency
+        );
+
+    // Switch to landscape: swaps width/height to 320x172 and recalculates RAM offsets
+    common_hal_busdisplay_busdisplay_set_rotation(display, 270);
+}
+
+void board_init(void) {
+    display_init();
+}
diff --git a/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/mpconfigboard.h b/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/mpconfigboard.h
@@ -0,0 +1,34 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2025 Benjamin Shockley
+// SPDX-FileCopyrightText: Copyright (c) 2026 David Glaude
+//
+// SPDX-License-Identifier: MIT
+//
+// Modified from waveshare_esp32_c6_lcd_1_47 to support waveshare_esp32_c5_lcd_1_47
+
+#pragma once
+
+// Micropython setup
+
+#define MICROPY_HW_BOARD_NAME "Waveshare ESP32-C5 LCD 1.47"
+#define MICROPY_HW_MCU_NAME "ESP32-C5"
+
+// For entering safe mode, use BOOT button
+#define CIRCUITPY_BOOT_BUTTON       (&pin_GPIO28)
+
+// Waveshare onboard NeoPixel on GPIO8
+#define CIRCUITPY_STATUS_LED_POWER (&pin_GPIO8)
+#define MICROPY_HW_NEOPIXEL (&pin_GPIO8)
+#define MICROPY_HW_NEOPIXEL_COUNT (1)
+
+// Default SPI bus definitions (shared between LCD and TF card)
+#define DEFAULT_SPI_BUS_SCK (&pin_GPIO7)
+#define DEFAULT_SPI_BUS_MOSI (&pin_GPIO6)
+#define DEFAULT_SPI_BUS_MISO (&pin_GPIO5)
+
+// Explanation of how a user got into safe mode
+#define BOARD_USER_SAFE_MODE_ACTION MP_ERROR_TEXT("You pressed the BOOT button at start up.")
+
+// Reduce wifi.radio.tx_power due to the antenna design of this board
+#define CIRCUITPY_WIFI_DEFAULT_TX_POWER   (15)
diff --git a/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/mpconfigboard.mk b/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/mpconfigboard.mk
@@ -0,0 +1,16 @@
+USB_PRODUCT = "Waveshare ESP32-C5 LCD 1.47"
+USB_MANUFACTURER = "Waveshare"
+
+CIRCUITPY_CREATOR_ID = 0x000C303A
+CIRCUITPY_CREATION_ID = 0x00C50002
+
+IDF_TARGET = esp32c5
+
+CIRCUITPY_ESP_FLASH_MODE = qio
+CIRCUITPY_ESP_FLASH_FREQ = 80m
+CIRCUITPY_ESP_FLASH_SIZE = 4MB
+
+CIRCUITPY_NEOPIXEL_WRITE = 1
+CIRCUITPY_BUSDISPLAY = 1
+CIRCUITPY_FOURWIRE = 1
+CIRCUITPY_4MB_FLASH_LARGE_USER_FS_LAYOUT = 1
diff --git a/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/pins.c b/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/pins.c
@@ -0,0 +1,62 @@
+#include "shared-bindings/board/__init__.h"
+#include "shared-module/displayio/__init__.h"
+
+static const mp_rom_map_elem_t board_module_globals_table[] = {
+    CIRCUITPYTHON_BOARD_DICT_STANDARD_ITEMS
+
+    // Boot / User button
+    { MP_ROM_QSTR(MP_QSTR_BUTTON), MP_ROM_PTR(&pin_GPIO28) },
+    { MP_ROM_QSTR(MP_QSTR_BOOT0), MP_ROM_PTR(&pin_GPIO28) },
+    { MP_ROM_QSTR(MP_QSTR_IO28), MP_ROM_PTR(&pin_GPIO28) },
+
+    // General purpose exposed GPIOs
+    { MP_ROM_QSTR(MP_QSTR_IO0), MP_ROM_PTR(&pin_GPIO0) },
+
+    // Status RGB LED
+    { MP_ROM_QSTR(MP_QSTR_NEOPIXEL), MP_ROM_PTR(&pin_GPIO8) },
+    { MP_ROM_QSTR(MP_QSTR_IO8), MP_ROM_PTR(&pin_GPIO8) },
+
+    // Primary SPI bus lines
+    { MP_ROM_QSTR(MP_QSTR_SCK), MP_ROM_PTR(&pin_GPIO7) },
+    { MP_ROM_QSTR(MP_QSTR_MOSI), MP_ROM_PTR(&pin_GPIO6) },
+    { MP_ROM_QSTR(MP_QSTR_MISO), MP_ROM_PTR(&pin_GPIO5) },
+
+    // LCD Dedicated Aliases
+    { MP_ROM_QSTR(MP_QSTR_LCD_CLK), MP_ROM_PTR(&pin_GPIO7) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_DIN), MP_ROM_PTR(&pin_GPIO6) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_MOSI), MP_ROM_PTR(&pin_GPIO6) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_CS), MP_ROM_PTR(&pin_GPIO23) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_DC), MP_ROM_PTR(&pin_GPIO24) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_RST), MP_ROM_PTR(&pin_GPIO26) },
+    { MP_ROM_QSTR(MP_QSTR_LCD_BL), MP_ROM_PTR(&pin_GPIO10) },
+    { MP_ROM_QSTR(MP_QSTR_BACKLIGHT), MP_ROM_PTR(&pin_GPIO10) },
+
+    // MicroSD (TF Card) Dedicated Aliases
+    { MP_ROM_QSTR(MP_QSTR_SD_CS), MP_ROM_PTR(&pin_GPIO4) },
+    { MP_ROM_QSTR(MP_QSTR_SD_CLK), MP_ROM_PTR(&pin_GPIO7) },
+    { MP_ROM_QSTR(MP_QSTR_SD_MOSI), MP_ROM_PTR(&pin_GPIO6) },
+    { MP_ROM_QSTR(MP_QSTR_SD_MISO), MP_ROM_PTR(&pin_GPIO5) },
+
+    // General purpose exposed GPIOs
+    { MP_ROM_QSTR(MP_QSTR_IO1), MP_ROM_PTR(&pin_GPIO1) },
+    { MP_ROM_QSTR(MP_QSTR_IO2), MP_ROM_PTR(&pin_GPIO2) },
+    { MP_ROM_QSTR(MP_QSTR_IO3), MP_ROM_PTR(&pin_GPIO3) },
+    { MP_ROM_QSTR(MP_QSTR_IO4), MP_ROM_PTR(&pin_GPIO4) },
+    { MP_ROM_QSTR(MP_QSTR_IO5), MP_ROM_PTR(&pin_GPIO5) },
+    { MP_ROM_QSTR(MP_QSTR_IO6), MP_ROM_PTR(&pin_GPIO6) },
+    { MP_ROM_QSTR(MP_QSTR_IO7), MP_ROM_PTR(&pin_GPIO7) },
+    { MP_ROM_QSTR(MP_QSTR_IO9), MP_ROM_PTR(&pin_GPIO9) },
+    { MP_ROM_QSTR(MP_QSTR_IO10), MP_ROM_PTR(&pin_GPIO10) },
+    { MP_ROM_QSTR(MP_QSTR_IO23), MP_ROM_PTR(&pin_GPIO23) },
+    { MP_ROM_QSTR(MP_QSTR_IO24), MP_ROM_PTR(&pin_GPIO24) },
+    { MP_ROM_QSTR(MP_QSTR_IO25), MP_ROM_PTR(&pin_GPIO25) },
+    { MP_ROM_QSTR(MP_QSTR_IO26), MP_ROM_PTR(&pin_GPIO26) },
+    { MP_ROM_QSTR(MP_QSTR_IO27), MP_ROM_PTR(&pin_GPIO27) },
+
+    // Shared SPI bus singleton
+    { MP_ROM_QSTR(MP_QSTR_SPI), MP_ROM_PTR(&board_spi_obj) },
+
+    // Built-in Display
+    { MP_ROM_QSTR(MP_QSTR_DISPLAY), MP_ROM_PTR(&displays[0].display) },
+};
+MP_DEFINE_CONST_DICT(board_module_globals, board_module_globals_table);
diff --git a/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/sdkconfig b/ports/espressif/boards/waveshare_esp32_c5_lcd_1_47/sdkconfig
@@ -0,0 +1 @@
+# Everything is default or implied by mpconfigboard.mk
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		# Everything is default or implied by mpconfigboard.mk