/ESPRINTER

Duet web panel for ESP8266

Primary LanguageJavaScript

3D Printer ESP8266 Web Interface

Join the chat at https://gitter.im/toxuin/ESPRINTER

This one nifty tool lets you use awesome web panel from Duet electronics on any other hardware that supports auxiliary serial connections.

Supported firmwares are RepRapFirmware and toxuin's fork of Repetier-Firmware (pull request submitted).

Anyways, it was tested with RAMPS 1.4 and RADDS and it mostly works. Use at own risk.

Here's some picture to give you an idea what it is:

Duet interface screenshot Image from David Crocker's Solutions blog

Setup

First, you need an ESP8266 module with at least 1MB (Megabyte) of flash. They aren't all the same, even within same model number. Then, you need to solder it up like this: ESP improved stability Yes, you have to heat up the soldering iron and smell some toxic fumes. If you don't want want that – you can buy a pre-soldered board mentioned on this page but don't forget that it has to have >= 1MB flash.

Then, you'll need fully functional Arduino IDE for ESP8266. Arduino for ESP8266 project has some nice manuals how to set it up. You'll need the staging version of their board package, not a stable one!

You have to be able to upload SPIFFS data to it. Do not ignore that part or you'll get constant 404's.

Once you got everything working and blinked some LEDs you need to clone this repo and copy this repo contents into your sketchbook folder. Then open the ESPRINTER.ino file and upload it to your device. Watch the upload settings! Remember about the >=1MB flash chip? Don't forget to select yours in IDE or it won't upload (and it won't tell you why)! Then select "Tools -> ESP8266 Sketch Data Upload" and wait for upload.

Once you uploaded all that, your module will seek wifi router. It won't find any known hotspots and will start his own named ESPrinter. Connect to it and go to http://192.168.1.1/ in your browser. There will be a list with all the WiFi hotspots and you'll have to select yours and enter the password. Module will then reboot (if it will not – help it!) and connect to your network.

Then wire up your ESP8266 to your 3d printer auxiliary output. Beware that ESP8266 is powered by 3.3V and supplying 5V (general 3D printer electronics voltage) will instantly release magic smoke (= will kill ESP8266). If your board does not supply 3.3V you will need a voltage regulator for 3.3v.

Here is a wiring diagram for RADDS board: RADDS ESP8266 wiring

If you have a LCD display it will most likely display an IP address on it.

If you have an Apple Mac machine you can just go to http://esprinter.local/ , you amazing half-god.

If you're using RepRapFirmware you'll have to add this to the end of your config.g file:

 M575 P1 B115200 S0  ; set aux port to 115200 baud and do not require checksum

If you're using Repetier Firmware – configure it like it is a Bluetooth adapter: select an auxiliary port (Serial 1 for RADDS in the picture), set baud rate to 115200.

Then reboot everything and it will (hopefully) work.

What does not work

  • Creating folders on SD card works only with Repetier
  • File transfers are slow and unstable

You can do a pull request and fix those. But unless we have a separate SD on ESP8266 all transfers will be super slow. Like, really, really slow. Even slower than 3G in Canada.

Thing is – files are uploaded through HTML5 File API at 10 lines per transaction. That's NOT how you should normally transfer files in a computer system, but it works in this case and does not require any extra hardware. Speeds are hilarious: ~3 Kb/s for Repetier and about 30 Kb/s for RepRapFirmware. But it's something! For ~$3 you get a wifi for your printer. Great deal, if you ask me!

Modify

You need to have node.js installed to minify your js and css. Do the

 cd build
 npm install
 node minify.js

This will create the minified js and css. Do this every time you change anything in CSS or JS.

Credits

  • Duet web panel was originally developed by Christian Hammacher.

  • Arduino for ESP8266 was developed by these guys

  • RepRapFirmware was developed by Adrian Bowyer, dc42 and dcnewman helped.