/RepPanel_ESP32

Alternative to PanelDue. Embedded UI for Duet & RepRap based 3D printers. Running on the ESP32. Optimized for 3.5" displays. WiFi or UART connectivity.

Primary LanguageCApache License 2.0Apache-2.0

RepPanel

New Version HWv2 available

Check out the new version RepPanel HWv2 for RepRap-based 3D Printers! Improved performance with ready to flash hardware from your local supplier.

Older HWv1 version

A simple user interface for Duet/RepRap based 3D printers. Optimized for 3.5" touch panels controlled via SPI & I²C using an ESP32.

Supports wireless connection or wired via UART/PanelDue port.

An open source alternative to the PanelDue.

  • Cheap (~18€ display + 7€ ESP32)
  • Beautifully dark
  • Compact and easy to use
  • Support for most operations required to set up a 3D print
  • Wireless connection - portable with power bar
  • PanelDue-port/UART connection

The all-in-one module is currently not available but you can give me an idea on how much interest there is. The module will be ready to use and thinner than a DIY solution. It includes a custom board, display and more capable ESP32 (more storage for directory listings etc.). I would try to get the price somewhere ~50-60€ + shipping from Germany. Click the link above and enter your email to get notified when a module becomes available. Thanks!

RepPanel main menu

Features

Since RepPanel boots in ~1 second you can start setting up your printer in no time and with no additional hardware. No need to get the laptop and log in to DuetWebControl. No need to get mad over using WebControl in your smartphones browser.

  • Start, Stop, Pause & Resume print jobs based of Duets SD card
  • Simulate print jobs
  • Delete print jobs
  • Run macros (no dictionary support yet)
  • Home X, Y, Z or All axis
  • Set extruder fan speed
  • Load/Unload filament per tool
  • Set bed temperatures
  • Set tool temperatures
  • Monitor temperatures
  • Monitor print job:
    • Percent complete
    • Duration
    • Elapsed time (based of simulation, otherwise from file)
    • Job name
    • Current layer
  • Run manual and automated bed leveling
  • Automatic reconnection
  • Low latency
  • Screen Saver feature
  • Support for RRF 3.4+ Object Model

First release of RepPanel
First test of RepPanel

What this project is not

A full replacement for the DuetWebControl interface.

Supported Hardware/Software

The RepPanel project is based on the LVGL port for the ESP32. In theory this means all displays and touch controllers supported by the lv_port_esp32 project are also supported by RepPanel.

Tested Hardware

The listed hardware below is tested and pre-compiled images are available under GitHub releases.

Hardware v1 (HWv1) platform

Beware: There are numerous version of the ER-TFT035-6. You must choose the one with the SPI interface. Do not get the arduino shield version (no SPI config). The version with the screen breakout board is sufficient.**
Other display modules with a resolution of 480x320 should also work as long as they are supported by lv_port_esp32
As of now RepPanel is optimized for 3.5" displays with a resolution of 480x320 pixels. The display is connected via SPI.

Hardware v2 (HWv2) platform

  • coming soon

Differences between HWv1 & HWv2

coming soon

Tested Firmware

  • Duet2 WiFi running RepRap Firmware v3.0, v3.1, v3.2, v3.3 and corresponding Duet2WebControl
  • Duet3D + SBC is not supported via Wifi - only via the PanelDue serial port (wired connection)

Installation

Use ready made images or compile yourself.

Compile yourself

Set up ESP-IDF

Follow instructions on offical Espressif site.
ESP-IDF v4.0 is officially supported. ESP-IDF v4.3 is officially supported for the HWv2 electronics platform.

Clone Project

git clone --recurse-submodules https://github.com/seeul8er/RepPanel_ESP32

LVGL v7 is not supported. Last tested release of lv_port_esp32 is commit a76a3d5d9225d0cfb92c896b6b0f1867b62aa2b6. The project is linked against a fork to keep the legacy support and be able to fix bugs.

Configure Project

From its root run:

idf.py menuconfig

Under Component configuration you can change the supported TFT and Touchcontroller configuration and RepPanel specific settings.

See Custom LVGL port for the ESP32 for further and more detailed instructions.

Compile & Flash

idf.py build
idf.py -p (YOUR PORT) flash

See LVGL port for the ESP32 for further and more detailed instructions.

Use ready made images

Ready made images are only available for selected hardware combinations! Please compile the project by yourself in case you use different hardware or want a different pin connection layout

Check out releases for compiled binaries.

Wiring ER-TFTM035-6 to the ESP32 DevKit (HWv1)

Beware: The available development boards have different pin configurations. Some have GND & 3.3V at the bottom. Others at the top.

Pin configuration of ready made images:

**Pin Number ESP32 ** Pin Number ER-TFTM035-6 Function Description
VCC 3.3V 2 Power supply Match TFT voltage with ESP32 pin
GND 1 GND Ground
GPIO 13 27 MOSI Data line to TFT
GPIO 14 24 SCL SPI CLK for TFT
GPIO 15 23 Slave Select SPI
GPIO 22 30 SCL I²C - touch
GPIO 21 31 SDA I²C - touch
GPIO 4 21 Reset TFT related
GPIO 2 25 Data TFT related
GPIO 27 29 Backlight Turn on/off TFT backlight
GPIO 17 - UART TX Connect to RX PanelDue port
GPIO 16 - UART RX Connect to TX PanelDue port

Screenshots

RepPanel with case RepPanel print job status RepPanel process menu RepPanel console RepPanel start print dialog

For Developers

Check out the simulator project. Simulates the RepPanel GUI on Desktop computers for more efficient testing and implementation.

Use the provided for of lvgl for ESP32. This one contains the supported version of LVGL with some additional config options regarding the screen saver timeout. It is the only one maintained for RepPanel.

Custom changes to lv_conf.h
Copy file content of main/lv_conf_back.h over to externals/lv_port_esp32/components/lvgl/lv_conf.h.
Or simply add:

  • Set LV_USE_USER_DATA 1
  • Set LV_MEM_SIZE (17U * 1024U) to free up unused RAM
  • Add #define LV_USE_THEME_REP_PANEL_DARK 1
  • CONFIG_LVGL_FONT_ROBOTO16 & CONFIG_LVGL_FONT_ROBOTO22 must be activated
  • Add
#define LV_FONT_CUSTOM_DECLARE  LV_FONT_DECLARE(reppanel_font_roboto_bold_16) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_bold_18) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_bold_24) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_regular_26) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_light_26) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_thin_numeric_160) \
                                       LV_FONT_DECLARE(reppanel_font_roboto_regular_percent_40)

Compilation options for different hardware platforms

  • esp-idf 4.0.x for ER-TFTM035-6 and other ILI9488 based displays (later esp-idf versions cause rendering artifacts)
  • esp-idf 4.0.x or 4.3.x for ST7796s based displays

Known Limitations

  • Multiple tools supported but not tested
  • Auto swap from UART to WiFi connection might take up to 10s
  • Entries per directory listing limited to 24 for jobs and macros for ESP32 modules without external RAM
  • Directory path limited to 160 characters for ESP32 modules without external RAM
  • Filament listing (all filament names separated by one character) limited to 1014
  • No support for Duet3 + SBC via Wifi because of a different API
    • Workaround: Use wired UART/PanelDue connection
  • Can not list all files within a directory in case DuetWebControl API requires multiple requests per listing
    • Workaround: Delete files to reduce file count to make all files fit within one response