OctoPrint monitor for 320x240 TFT displays and a ESP8266 processor. Built with Visual Studio Code and PlatformIO.
Clone from the master branch for a working version. The dev branch should be considered a nightly / backup branch and will rarely work correctly unless noted above.
- OctoPrint Monitor - monitor up to ten 3D printers at once through Octoprint.
- Creates an access point for connecting to any WiFi network.
- 2.8" colour TFT for display. Should work with any size 320x240 display handled by the TFT library.
- Uses a cheap ESP8266 board as the controller.
- Different display modes. All display modes show WiFi strength, clock with date and time and use colourful icons.
- Display weather or a single printer.
- Cycle through weather (if enabled) and all enabled printers.
- All settings controlled through a web interface.
- Uses OpenWeather API for retrieving current weather.
- Can perform screengrabs and send them to a Processing sketch over serial connection.
- Password protected OTA updates enabled through PlatformIO (not through the web interface).
Uses the OpenWeather API for current conditions. You will need an API key and the ID of the location to display weather.
- ArduinoJson
- ESPAsyncWiFiManager
- ESPAsyncTCP
- ESPAsyncWebServer
- TaskScheduler
- TFT_eSPI
- NTPClient
Big thanks to all the library developers who make developing projects such as this simple.
Built using the following hardware from AliExpress.
Wemos D1 mini ESP8266 board
2.8" TFT non touch version
Development was done on NodeMCU and Wemos D1 Mini boards. Any TFT with a 320x240 display that works with the TFT_eSPI library should work but has not been tested.
Mini RST -> TFT RST
Mini D0 -> TFT LED (for display brightness control, hope this is OK, just connect TFT LED to VCC if worried)
Mini D5 -> TFT SCK
Mini D6 -> TFT MISO (only required if screen grab feature required)
Mini D7 -> TFT MOSI
Mini D8 -> TFT CS
Mini D3 -> TFT DC
Connect VCC and GND on the TFT to the respective pins on the Mini or NodeMCU.
There is a setting in the TFT_eSPI library that has to be set the same as you wire the TFT to the Mini. With the above wiring no changes should be required. Open User_Setup.h in the TFT_eSPI library folder and set the following to suit your build:
// ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP8266 SETUP ######
// For NodeMCU - use pin numbers in the form PIN_Dx where Dx is the NodeMCU pin designation
#define TFT_CS PIN_D8 // Chip select control pin D8
#define TFT_DC PIN_D3 // Data Command control pin
#define TFT_RST PIN_D4 // Reset pin (could connect to NodeMCU RST, see next line)
//#define TFT_RST -1 // Set TFT_RST to -1 if the display RESET is connected to NodeMCU RST or 3.3V
Contains defines for MD5 password hash if you want to use OTA for future updates. The SCREEN_ROTATION define should be set depending on if your screen is pins up or pins down in it's case.
Password protected OTA updates enabled. Set the MD5 hash of your prefered password in UserSettings.h. To upload via IP in PlatformIO create a file called uploadPassword.ini in the same folder as platformio.ini with the following contents:
[password]
upload_password = xxxxx
Replace xxxxx with the plain text version of your MD5 hash set above. MD5 Generator.
You can use any suitable 2.8" TFT D1 / NodeMCU case, many are available on ThingiVerse. My case can be found here.
Weather icons from umutavci.
Inspired by ThingPulse color weather station and printer-monitor.