WirelessPrinting

Print wirelessly from Cura, PrusaControl, or Slic3r PE to your 3D printer connected to an ESP8266 module.

UNDER DEVELOPMENT. See Issues. Pull requests welcome!

Comparison with other printer hosts

Hardware

WEMOS D1 mini modules can be used. Also, ESP32 modules can be used (status is experimental currently).

The WEMOS D1 mini module is connected with your 3D printer via the serial connection and to a SD card (acting as a cache during printing). You need to connect

• TX, RX from your 3D printer to the WEMOS D1 mini module (AUX-1 header on RAMPS boards). Note: For ESP32, use GPIO32 = RX, GPIO33 = TX
• Power and GND from your 3D printer to the WEMOS D1 mini module (attention, the AUX-1 header on RAMPS boards has 5V while the ESP8266 needs 3.3V but the WEMOS D1 mini has a voltage regulator)
• Optional: SD card shield to the WEMOS D1 mini module (a capacitor across the power pins of the SD card; SD shields have this). Using a SanDisk 2 GB card formatted with mkfs.vfat on Linux seems to work for me. If no SD card is connected, then the internal SPIFFS memory (3 MB) is used
• A matching case for a WEMOS D1 mini module and microSD shield can be found at http://www.thingiverse.com/thing:2287618

esp8266/Arduino sketch

The esp8266/Arduino sketch ESP8266WirelessPrintAsync.ino is uploaded to a ESP8266 module. See .travis.yml for how this is compiled on Travis CI.

Building

Pre-built binaries are available for download on GitHub Releases.

The following build procedure works on Linux:

sudo su
sudo apt-get install python-serial # Otherwise cannot build for ESP32

BD=esp8266:esp8266:d1_mini:xtal=80,eesz=4M3M
# or 
BD=esp32:esp32:esp32

wget http://downloads.arduino.cc/arduino-1.8.8-linux64.tar.xz
tar xf arduino-*-linux64.tar.xz
export PATH=$(readlink -f arduino-*/):$PATH

arduino --pref "boardsmanager.additional.urls=http://arduino.esp8266.com/stable/package_esp8266com_index.json,https://dl.espressif.com/dl/package_esp32_index.json" --save-prefs
if [[ "$BD" =~ "esp8266:esp8266:" ]]; then arduino --install-boards esp8266:esp8266:2.5.0 ; fi
if [[ "$BD" =~ "esp32:esp32:" ]]; then arduino --install-boards esp32:esp32 ; fi
arduino --pref "compiler.warning_level=all" --save-prefs
mkdir -p $HOME/Arduino/libraries/
cd $HOME/Arduino/libraries/
git clone https://github.com/greiman/SdFat
git clone -o 95dedf7 https://github.com/me-no-dev/ESPAsyncWebServer
git clone -o 7e9ed22 https://github.com/me-no-dev/ESPAsyncTCP # for esp8266
git clone https://github.com/me-no-dev/AsyncTCP # for esp32
git clone -o 1c02154 https://github.com/alanswx/ESPAsyncWiFiManager
( git clone -b 6.x https://github.com/bblanchon/ArduinoJson ; cd ArduinoJson ; git reset --hard 3df4efd )
cd -

git clone https://github.com/probonopd/WirelessPrinting/
cd WirelessPrinting/

VERSION=$(git rev-parse --short HEAD)
HERE=$(readlink -f .)
sed -i -e 's|#define SKETCH_VERSION ".*"|#define SKETCH_VERSION "'$VERSION'"|' $PWD/ESP8266WirelessPrintAsync/ESP8266WirelessPrintAsync.ino
arduino --pref build.path=. --verify --verbose-build --board $BD ESP8266WirelessPrintAsync/ESP8266WirelessPrintAsync.ino
BOARD=$(echo $BD | cut -d ":" -f 3)
mv ./ESP8266WirelessPrintAsync.ino.bin "ESP8266WirelessPrintAsync_${BOARD}_${VERSION}.bin"

Flashing from Linux

Can be flashed via USB or (subsequently) over the air. You can use the Arduino IDE if you compiled yourself, or one of the following commands if you just want to flash a precompiled firmware.

ESP8266

# USB
sudo chmod a+x /dev/ttyUSB0 ; /tmp/.mount_*/usr/bin/hardware/esp8266/esp8266/tools/esptool/esptool -vv -cd nodemcu -cb 921600 -cp /dev/ttyUSB0 -ca 0x00000 -cf ESP8266WirelessPrint*.bin

# Wireless
wget -c "https://raw.githubusercontent.com/esp8266/Arduino/master/tools/espota.py"
python espota.py -i 192.168.0.27 -p 8266 --auth= -f ESP8266WirelessPrint*.bin

ESP32

# USB
sudo apt install python-serial
sudo chmod a+x /dev/ttyUSB0 ; python $HOME/.arduino15/packages/esp32/tools/esptool_py/2.6.0/esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash 0x10000 ESP8266WirelessPrintAsync_esp32_*.bin

# Wireless
python $HOME/.arduino15/packages/esp32/hardware/esp32/1.0.1/tools/espota.py -i 192.168.0.16 -p 3232 --auth= -f ESP8266WirelessPrintAsync_esp32_*.bin

After the initial flashing, you can upload new versions of this firmware from the web interface without any further tools.

Initial WiFi Configuration

Following the instrucions in https://github.com/alanswx/ESPAsyncWiFiManager/ :

The first time the sketch is uploaded the ESP will enter in Access Point mode, so you have to open the wifi manager of your system and connect to wifi "AutoConnectAP", then open your browser and type http://192.168.4.1/, there you will see a menu, select "Configure WiFi", press scan and wait until the device scans available networks and select yours, enter the the password and click save. It will try to connect to your network, if it's successfull you will see a message on your 3D printer (or in a serial monitor if conected to your computer) with the new device IP, write down this IP if you wish to connect via browser.

Wireless printing with Cura

Cura 2.6 and later come with a bundled plugin which discovers OctoPrint instances using Zeroconf and enables printing directly to them. In newer versions of Cura, you need to install the Cura OctoPrint Plugin from the "Toolbox" menu. To use it,

• In Cura, add a Printer matching the 3D printer you have connected to WirelessPrint
• Select "Connect to OctoPrint" on the Manage Printers page
• Select your OctoPrint instance from the list
• Enter an API key (for now a random one is sufficient)
• Click "Connect", then click "Close" From this point on, the print monitor should be functional and you should see a "Print with OctoPrint" button on the bottom of the sidebar. Use this button to print wirelessly.

Wireless printing with PrusaControl

Currently a custom fork, PrusaControlWireless, is required. This may change in the future.

Wireless printing with Slic3r PE

Slic3r PE 1.36.0 and later discovers OctoPrint instances using Zeroconf and enables printing directly to them. No further software needs to be installed. To use it,

• In Slic3r PE, add the corresponding profile for your printer
• Select the "Printer Settings" tab
• Under "OctoPrint upload", enter the IP address of your WirelessPrinting device (in the future, it may be discoverable by Bonjour)
• Click "Test" From this point on, you should see a "Send to printer" button on the "Plater" tab. Use this button to print wirelessly.

Wireless printing using a browser or the command line

To print, just open http://the-ip-address/ and upload a G-Code file using the form:

Ycan also print from the command line using curl:

curl -F "file=@/path/to/some.gcode" -F "print=true" http://the-ip-address/print