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!

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

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

ESP32 DevKit without external RAM
ER-TFTM035-6 display with capacitive touch screen, 4-Wire SPI, No font chip required

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

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