adafruit · tannewt · Feb 28, 2025 · Feb 14, 2025 · Feb 14, 2025 · Feb 14, 2025
diff --git a/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/board.c b/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/board.c
@@ -0,0 +1,113 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2020 Scott Shawcroft for Adafruit Industries
+//
+// SPDX-License-Identifier: MIT
+
+#include "supervisor/board.h"
+#include "mpconfigboard.h"
+#include "shared-bindings/busio/SPI.h"
+#include "shared-bindings/fourwire/FourWire.h"
+#include "shared-bindings/microcontroller/Pin.h"
+#include "shared-module/displayio/__init__.h"
+#include "shared-module/displayio/mipi_constants.h"
+#include "shared-bindings/board/__init__.h"
+#include "shared-bindings/digitalio/DigitalInOut.h"
+
+// SSD1683 EPD Driver chip
+const uint8_t display_start_sequence[] = {
+    // Init
+    0x12, 0x80, 0x0a,                   // Soft reset
+    0x01, 0x03, 0x2b, 0x01, 0x00,       // Set MUX as 300
+    0x21, 0x02, 0x40, 0x00,             // Display update control
+    0x3c, 0x01, 0x01,                   // Border waveform
+    0x11, 0x01, 0x03,                   // X- mode
+    0x44, 0x02, 0x00, 0x31,             // Set RAM X Address Start/End Pos
+    0x45, 0x04, 0x00, 0x00, 0x2b, 0x01, // Set RAM Y Address Start/End Pos
+    0x4e, 0x01, 0x00,                   // Set RAM X Address counter
+    0x4f, 0x02, 0x00, 0x00,             // Set RAM Y Address counter
+};
+
+const uint8_t display_stop_sequence[] = {
+    0x10, 0x01, 0x32,
+};
+
+const uint8_t refresh_sequence[] = {
+    0x22, 0x01, 0xf7,                   // Display update sequence option
+    0x20, 0x80, 0x0a,                   // Master activation
+};
+
+void board_init(void) {
+
+    // Enable EPD with driver pin
+    digitalio_digitalinout_obj_t epd_enable_pin_obj;
+    epd_enable_pin_obj.base.type = &digitalio_digitalinout_type;
+    common_hal_digitalio_digitalinout_construct(&epd_enable_pin_obj, &pin_GPIO7);
+    common_hal_digitalio_digitalinout_switch_to_output(&epd_enable_pin_obj, true, DRIVE_MODE_PUSH_PULL);
+    common_hal_digitalio_digitalinout_never_reset(&epd_enable_pin_obj);
+
+    // Set up the SPI object used to control the display
+    fourwire_fourwire_obj_t *bus = &allocate_display_bus()->fourwire_bus;
+    busio_spi_obj_t *spi = &bus->inline_bus;
+    common_hal_busio_spi_construct(spi, &pin_GPIO12, &pin_GPIO11, NULL, false);
+    common_hal_busio_spi_never_reset(spi);
+
+    // Set up the DisplayIO pin object
+    bus->base.type = &fourwire_fourwire_type;
+    common_hal_fourwire_fourwire_construct(bus,
+        spi,
+        &pin_GPIO46, // EPD_DC Command or data
+        &pin_GPIO45, // EPD_CS Chip select
+        &pin_GPIO47, // EPD_RST Reset
+        1000000, // Baudrate
+        0, // Polarity
+        0); // Phase
+
+// Set up the DisplayIO epaper object
+    epaperdisplay_epaperdisplay_obj_t *display = &allocate_display()->epaper_display;
+    display->base.type = &epaperdisplay_epaperdisplay_type;
+    common_hal_epaperdisplay_epaperdisplay_construct(
+        display,
+        bus,
+        display_start_sequence, sizeof(display_start_sequence),
+        1, // start up time
+        display_stop_sequence, sizeof(display_stop_sequence),
+        400, // width
+        300, // height
+        400, // ram_width
+        300, // ram_height
+        0, // colstart
+        0, // rowstart
+        0, // rotation
+        NO_COMMAND, // set_column_window_command
+        NO_COMMAND, // set_row_window_command
+        NO_COMMAND, // set_current_column_command
+        NO_COMMAND, // set_current_row_command
+        0x24, // write_black_ram_command
+        false, // black_bits_inverted
+        0x26, // write_color_ram_command
+        false, // color_bits_inverted
+        0x000000, // highlight_color
+        refresh_sequence, sizeof(refresh_sequence), // refresh_display_command
+        1.0, // refresh_time
+        &pin_GPIO48, // busy_pin
+        true, // busy_state
+        2.0, // seconds_per_frame
+        false, // always_toggle_chip_select
+        false, // grayscale
+        false, // acep
+        false, // two_byte_sequence_length
+        false); // address_little_endian
+}
+
+void board_deinit(void) {
+    epaperdisplay_epaperdisplay_obj_t *display = &displays[0].epaper_display;
+    if (display->base.type == &epaperdisplay_epaperdisplay_type) {
+        while (common_hal_epaperdisplay_epaperdisplay_get_busy(display)) {
+            RUN_BACKGROUND_TASKS;
+        }
+    }
+    common_hal_displayio_release_displays();
+}
+
+// Use the MP_WEAK supervisor/shared/board.c versions of routines not defined here.
diff --git a/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/mpconfigboard.h b/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/mpconfigboard.h
@@ -0,0 +1,27 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2019 Scott Shawcroft for Adafruit Industries
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+// Micropython setup
+
+#define MICROPY_HW_BOARD_NAME       "CrowPanel 4.2 EPaper"
+#define MICROPY_HW_MCU_NAME         "ESP32S3"
+#define MICROPY_HW_LED_STATUS       (&pin_GPIO41)
+#define CIRCUITPY_BOOT_BUTTON       (&pin_GPIO0)
+
+#define CIRCUITPY_BOARD_SPI         (2)
+#define CIRCUITPY_BOARD_SPI_PIN     { \
+        {.clock = &pin_GPIO39, .mosi = &pin_GPIO40, .miso = &pin_GPIO13}, /*SD*/ \
+        {.clock = &pin_GPIO12, .mosi = &pin_GPIO11}, /*EPD*/ \
+}
+
+// UART pins attached to the USB-serial converter chip
+#define DEFAULT_UART_BUS_RX         (&pin_GPIO44)
+#define DEFAULT_UART_BUS_TX         (&pin_GPIO43)
+
+#define CIRCUITPY_CONSOLE_UART_TX DEFAULT_UART_BUS_TX
+#define CIRCUITPY_CONSOLE_UART_RX DEFAULT_UART_BUS_RX
diff --git a/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/mpconfigboard.mk b/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/mpconfigboard.mk
@@ -0,0 +1,19 @@
+CIRCUITPY_CREATOR_ID = 0x1C350000
+CIRCUITPY_CREATION_ID = 0x00000001
+
+# This board doesn't have USB by default, it
+# instead uses a CH340C USB-to-Serial chip
+CIRCUITPY_USB_DEVICE = 0
+CIRCUITPY_ESP_USB_SERIAL_JTAG = 0
+
+IDF_TARGET = esp32s3
+
+CIRCUITPY_ESP_FLASH_SIZE = 8MB
+CIRCUITPY_ESP_FLASH_MODE = qio
+CIRCUITPY_ESP_FLASH_FREQ = 80m
+
+CIRCUITPY_ESP_PSRAM_SIZE = 8MB
+CIRCUITPY_ESP_PSRAM_MODE = opi
+CIRCUITPY_ESP_PSRAM_FREQ = 80m
+
+CIRCUITPY_ESPCAMERA = 0
diff --git a/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/pins.c b/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/pins.c
@@ -0,0 +1,73 @@
+// This file is part of the CircuitPython project: https://circuitpython.org
+//
+// SPDX-FileCopyrightText: Copyright (c) 2020 Scott Shawcroft for Adafruit Industries
+//
+// SPDX-License-Identifier: MIT
+
+#include "shared-bindings/board/__init__.h"
+#include "shared-module/displayio/__init__.h"
+
+CIRCUITPY_BOARD_BUS_SINGLETON(tf_spi, spi, 0)
+CIRCUITPY_BOARD_BUS_SINGLETON(epd_spi, spi, 1)
+
+
+static const mp_rom_map_elem_t board_module_globals_table[] = {
+    CIRCUITPYTHON_BOARD_DICT_STANDARD_ITEMS
+
+    // Buttons
+    { MP_ROM_QSTR(MP_QSTR_BUTTON_BOOT), MP_ROM_PTR(&pin_GPIO0) },
+    { MP_ROM_QSTR(MP_QSTR_BUTTON_EXIT), MP_ROM_PTR(&pin_GPIO1) },
+    { MP_ROM_QSTR(MP_QSTR_BUTTON_MENU), MP_ROM_PTR(&pin_GPIO2) },
+
+    // Rocker Switch
+    { MP_ROM_QSTR(MP_QSTR_ROCKER_DOWN), MP_ROM_PTR(&pin_GPIO4) },
+    { MP_ROM_QSTR(MP_QSTR_ROCKER_CLICK), MP_ROM_PTR(&pin_GPIO5) },
+    { MP_ROM_QSTR(MP_QSTR_ROCKER_UP), MP_ROM_PTR(&pin_GPIO6) },
+
+    // LED
+    { MP_ROM_QSTR(MP_QSTR_LED), MP_ROM_PTR(&pin_GPIO41) },
+
+    // Device Control (Pins that, when activated, enable devices)
+    { MP_ROM_QSTR(MP_QSTR_EPD_ENABLE), MP_ROM_PTR(&pin_GPIO7) },
+    { MP_ROM_QSTR(MP_QSTR_TF_ENABLE), MP_ROM_PTR(&pin_GPIO42) },
+
+    // EPD
+    { MP_ROM_QSTR(MP_QSTR_EPD_BUSY), MP_ROM_PTR(&pin_GPIO48) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_RES), MP_ROM_PTR(&pin_GPIO47) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_DC), MP_ROM_PTR(&pin_GPIO46) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_CS), MP_ROM_PTR(&pin_GPIO45) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_CLK), MP_ROM_PTR(&pin_GPIO12) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_MOSI), MP_ROM_PTR(&pin_GPIO11) },
+
+    // TF Slot
+    { MP_ROM_QSTR(MP_QSTR_TF_CS), MP_ROM_PTR(&pin_GPIO10) },
+    { MP_ROM_QSTR(MP_QSTR_TF_MOSI), MP_ROM_PTR(&pin_GPIO40) },
+    { MP_ROM_QSTR(MP_QSTR_TF_CLK), MP_ROM_PTR(&pin_GPIO39) },
+    { MP_ROM_QSTR(MP_QSTR_TF_MISO), MP_ROM_PTR(&pin_GPIO13) },
+
+    // User accessible GPIO
+    { MP_ROM_QSTR(MP_QSTR_IO3), MP_ROM_PTR(&pin_GPIO3) },
+    { MP_ROM_QSTR(MP_QSTR_IO8), MP_ROM_PTR(&pin_GPIO8) },
+    { MP_ROM_QSTR(MP_QSTR_IO9), MP_ROM_PTR(&pin_GPIO9) },
+    { MP_ROM_QSTR(MP_QSTR_IO14), MP_ROM_PTR(&pin_GPIO14) },
+    { MP_ROM_QSTR(MP_QSTR_IO15), MP_ROM_PTR(&pin_GPIO15) },
+    { MP_ROM_QSTR(MP_QSTR_IO16), MP_ROM_PTR(&pin_GPIO16) },
+    { MP_ROM_QSTR(MP_QSTR_IO17), MP_ROM_PTR(&pin_GPIO17) },
+    { MP_ROM_QSTR(MP_QSTR_IO18), MP_ROM_PTR(&pin_GPIO18) },
+    { MP_ROM_QSTR(MP_QSTR_IO19), MP_ROM_PTR(&pin_GPIO19) },
+    { MP_ROM_QSTR(MP_QSTR_IO20), MP_ROM_PTR(&pin_GPIO20) },
+    { MP_ROM_QSTR(MP_QSTR_IO21), MP_ROM_PTR(&pin_GPIO21) },
+    { MP_ROM_QSTR(MP_QSTR_IO38), MP_ROM_PTR(&pin_GPIO38) },
+
+    // UART
+    { MP_ROM_QSTR(MP_QSTR_TX), MP_ROM_PTR(&pin_GPIO43) },
+    { MP_ROM_QSTR(MP_QSTR_RX), MP_ROM_PTR(&pin_GPIO44) },
+
+    // Objects
+    { MP_ROM_QSTR(MP_QSTR_TF_SPI), MP_ROM_PTR(&board_tf_spi_obj) },
+    { MP_ROM_QSTR(MP_QSTR_EPD_SPI), MP_ROM_PTR(&board_epd_spi_obj) },
+    { MP_ROM_QSTR(MP_QSTR_UART), MP_ROM_PTR(&board_uart_obj) },
+    { 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/elecrow_crowpanel_4_2_epaper/sdkconfig b/ports/espressif/boards/elecrow_crowpanel_4_2_epaper/sdkconfig
@@ -0,0 +1,14 @@
+#
+# Espressif IoT Development Framework Configuration
+#
+#
+# Component config
+#
+#
+# LWIP
+#
+# end of LWIP
+
+# end of Component config
+
+# end of Espressif IoT Development Framework Configuration