OctoPrint - Raspberry Pi Zero W
- How to install Raspberry Pi Zero W to your MK3S
- How to download or create your own RPi Zero W OctoPrint image
- I. Download the latest OctoPrint image
- II. Download flashing utility Etcher
- III. Using Etcher, flash the OctoPrint's image on the MicroSD card
- IV. Editing the wireless settings
- V. First boot of the OctoPrint
- VI. Finding the IP address of the RPi Zero W
- VII. First connection using the terminal
- VIII. Changing default password
- IX. Expanding size of the filesystem
- X. Editing serial connection
- XI. Swapping ports used by GPIO and Bluetooth
- XII. Disabling the serial console
- XIII. Rebooting RPi
- XIV. Adding serial port
- How to see the IP address on your printer's screen
- How to update firmware using RPi Zero W
- How to setup the OctoPrint with the MMU2S
How to install Raspberry Pi Zero W to your MK3S
Installing RPi Zero W requires purchasing the board together with several other components. You need to know how to solder pins or have somebody experienced around. All information is provided in the online step-by-step photo guide. In case of any issues during the reassembly, feel free to use the comments section below each step.
How to download or create your own RPi Zero W OctoPrint image
There are two ways to get OctoPrint up and running on the RPi Zero W. First, there is a custom version called PrusaPrint, which was created by Prusa Research. Our engineers optimized the settings directly for the MK3. There is no need for additional setup or config changes. The software is ready to print. Download the image, unzip it and flash it to the MicroSD card. The whole process is described in our online step-by-step photo guide.
Download link: Plugin for displaying the IP address on the printer's screen is currently being updated, once finished it will be shared in here.
The second option is to create your own image, which will contain the most basic setting to get OctoPrint to communicate with your MK3 printer. Some settings included in the PrusaPrint will be missing and are not part of this guide.
I. Download the latest OctoPrint image
II. Download flashing utility Etcher
III. Using Etcher, flash the OctoPrint's image on the MicroSD card
Select image - Select SD card - Flash
IV. Editing the wireless settings
On your computer, locate the SD card partition called "boot" and open it. Look for a file called "octopi-wpa-supplicant.txt"
"octopi-network.txt", open it for editing. Insert your Wi-Fi name and password, also uncomment (by deleting "#") three lines show below to activate this part of the custom configuration.
## WPA/WPA2 secured
# ssid="put SSID here"
# psk="put password here"
Example of adjusted config:
## WPA/WPA2 secured
V. First boot of the OctoPrint
Insert the MicroSD card in the RPi Zero W and connect it to the MK3 printer. See our online step-by-step photo guide for detailed instructions. You need to activate the RPi port in the MK3 printer, enter menu -> settings -> RPi Port and set it to "ON".
VI. Finding the IP address of the RPi Zero W
In order to be able to edit setting in the OctoPrint, you need to use terminal (SSH) and connect to your RPi Zero W using IP address. If you have access to your home Wi-Fi router look for the latest leased IP address leased by DHCP server, or use a network monitoring tool (ex. Angry IP scanner) to discover your RPi Zero W.
VII. First connection using the terminal
Open the terminal and connect to your Pi using SSH, which is enabled by default. Make sure the printer and your computer are connected to the same network. Type following:
VIII. Changing default password
Using default password "raspberry" is not recommended, please change it immediately. Type the command below and follow the instructions on the screen:
IX. Expanding size of the filesystem
By default, the available space is limited to lower OctoPrint's overall size. To increase it, open Raspberry settings:
In the menu select: Advanced Options -> Expand Filesystem -> Reboot
X. Editing serial connection
By default, OctoPrint doesn't include settings to connect to the MK3 via the serial port. Two config files must be updated and serial port added using the web interface. Some of the following codes are taken from a thread by Scott.w12. More information is provided in the following steps.
XI. Swapping ports used by GPIO and Bluetooth
The first thing to enable serial connection is to swap ports used by the GPIO (soldered pins) and the internal Bluetooth chip. We need to add a line in the config file on the boot partition.
sudo nano /boot/config.txt
Move the cursor to the very end and add:
XII. Disabling the serial console
Moving to another config file, where part of the code must be deleted to disable serial console.
sudo nano /boot/cmdline.txt
Look for following string (text) and delete it
XIII. Rebooting RPi
For all changes to take effect, please reboot your Raspberry Pi Zero W.
XIV. Adding serial port
Last part of the configuration is in the web interface. Open your browser and type either "octoprint.local" or the IP address of the RPi Zero W. You might be greeted with the welcome wizard, please go through it first.
As soon as you arrive at the home screen, open "Settings" (top right), head to "Serial Connection", then "Additional serial ports" and insert following:
Save the change and reboot OctoPrint. After reboot, select the new port and connect to your printer.
Congratulations, you just finished the custom OctoPrint setup for your MK3!
How to see the IP address on your printer's screen
Running Raspberry Pi Zero W on your MK3 is sometimes called having a headless system, as there is no screen directly connected to the Pi board. Whenever you move your MK3 to a different network or forget the printer's IP address it might be hard to retrieve it. Luckily there is a great plugin, which will show the address on the printer's screen during the startup.
Visit GitHub website and look for OctoPrint-ipOnConnect plugin by jneilliii and download it. Open your OctoPrint's web interface (in the web browser). Open settings and in the left column find "Plugin manager", then click on "Get More..." and using an option " ... from an uploaded archive" point to the file on your computer you've downloaded previously.
After the plugin is installed, go back to the main screen (homepage) and ensure you have ticked "Auto-connect on server startup". Reboot the printer, give it a minute or two and you should see the IP address on the MK3's screen. Note, that as long as you enter the printer's menu or insert an SD card, the IP address will disappear from the screen and you have to reboot the printer to see it again.
How to update firmware using RPi Zero W
Updating firmware on the Original Prusa i3 MK3 using RPi Zero W is currently not possible due to hardware limitations on the Raspberry board. Our engineers are looking into possible solutions.
For now, to update the firmware on your MK3, please use the official software provided by Prusa Research. The updater is included in the driver's package. Follow the instructions provided in the firmware flashing guide.
How to setup the OctoPrint with the MMU2S
If you have a multi-extruder setup like the MMU2S, make sure your printer profile has configured all available extruders. You should have five extruders and a shared nozzle configured in OctoPrint.