# 3.5" PiTFT OctoPrint Rig ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/032/757/medium800/3d_printing_hero-printer-01.jpg?1464467615) ## What Is OctoPrint? OctoPrint is a piece of software for the Raspberry Pi (or other platforms) that allows you to wirelessly control and monitor a 3D printer. It's host software that turns the Raspberry Pi into a server, adding a web interface. For a full list of features and functionalty, please check out the [OctoPrint website](http://octoprint.org/). ## Why Would I want OctoPrint? Ideally, if you're tired of walking up to your printer and inserting/removing an SD card. If your 3D printer is not near your workspace (or tetherd to your desktop/laptop) and you want to quickly preheat / home axises without having to fiddle with the on-board screen (if the 3D printer even has one).  ![](https://cdn-learn.adafruit.com/assets/assets/000/032/759/medium800/3d_printing_hero-printer-02.jpg?1464467760) ## OctoPrint & Raspberry Pi This project adds a touch screen display **directly** to the Raspberry Pi. An Adafruit PiTFT can be used to display the graphical interface of OctoPrint. There is no soldering or laborious assembly required - it's actually pretty easy! ## Touch UI Plugin for OctoPrint The Touch UI plugin adds a **mobile friendy,** _responsive_ layout to the OctoPrint web interface. It's an easy to install add-on that auto-detects a devices screen resolution and enables large controls ideal for small touch screen displays. Check out the [Touch UI plugin page](http://plugins.octoprint.org/plugins/touchui/)for more information. ![](https://cdn-learn.adafruit.com/assets/assets/000/032/758/medium800/3d_printing_parts.jpg?1464467666) ## Parts - Raspberry Pi 2/3 - Adafruit 3.5" PiTFT Plus 480x320 Resistive Touch Display - 4GB SD Card - USB WiFi Dongle - USB Keyboard # 3.5" PiTFT OctoPrint Rig ## 3D Printed Case ## Pi + PiTFT Case A simple 3D printed case will keep the Raspberry Pi and PiTFT display protected and enclosured. This 2-piece case is snap-fit together and requires no hardware screws to assemble. All of the ports from the Raspberry Pi 2/3 are accessible. Danger: ![](https://cdn-learn.adafruit.com/assets/assets/000/032/760/medium800/3d_printing_case-parts-2.jpg?1464467784) [Download STLs on Thingiverse](http://www.thingiverse.com/thing:1601055) [Download CAD Source](https://cdn-learn.adafruit.com/assets/assets/000/130/044/original/CAD.zip?1715704955) # 3.5" PiTFT OctoPrint Rig ## Software https://www.youtube.com/watch?v=thQ3PdLxqe8 https://www.youtube.com/watch?v=3ecVLfa3pas ## FAQ ### Can I add a PiTFT to my existing OctoPrint rig? That depedens! If your installation of OctoPrint is based on Raspbian Jesse Lite, then no - because this requires the X11 graphical operating system. If it does, then you should be able to install the [Adafruit PiTFT scripts](https://learn.adafruit.com/adafruit-pitft-3-dot-5-touch-screen-for-raspberry-pi/easy-install-2) required to use the touch screen display. ## First Steps I suggest starting with the Adafruit 3.5" PiTFT img and installing OctoPrint ontop. Click the link below and burn the .img file to a microSD Card using the official [Raspberry Pi Imager](https://www.raspberrypi.com/software/). [Download Jessie-based PiTFT 3.5" Resistive Image for Pi 1, Pi 2, and Pi 3 (March 25 2015)](https://adafruit-download.s3.amazonaws.com/2016-03-25_Jessie_PiTFT35r.zip) ## Second Steps Once the card is burnt with the 3.5" image, insert it into the Raspbery Pi and plug in a 5V USB power supply to power it on. The PiTFT will display the boot screen and automatically login and load the X11 graphical user interface. The touch screen is precalibrated so you can use it right away. Next, get the Pi onto a WiFi network by tapping on the WiFi icon on the top right and select your preferred network. Use a keyboard to enter your WiFi credentials. ## Install OctoPrint on Raspbian Now that you have WiFi setup on the Raspberry Pi, it's time to install OctoPrint. I recommend following the steps listed on the OctoPrint github page. I didn't cover them here because it's rather extensive. You have the option to run the commands through your desktop/laptop via SSH in the terminal, or directly on the Raspberry Pi and PiTFT. It's up to you, but I found doing it on my laptop faster. If you want to run the isntallation directly on the Pi, you'll obviously need a keyboard to type commands and/or copy and paste things. [Setup a Raspberry Pi running Raspbian](https://github.com/foosel/OctoPrint/wiki/Setup-on-a-Raspberry-Pi-running-Raspbian) ## Configure OctoPrint for 3D Printer Once you've installed the dependencies and OctoPrint software, you should be able to start the OctoPrint server. Next, you'll want to configure settings for your 3D printer, preferribly on your desktop/laptop. The default OctoPrint web interface is difficult to control on the 3.5" PiTFT, so access the web interface on your desktop/laptop by loading your Pi's IP address in your browser (ie. **http://10.1.10.555:5000** ). From there, you can configure a printer and material profiles (under the settings icon). ## Connect USB from 3D Printer to Raspberry Pi Use a USB cable to connect the 3D printer to the Raspberry Pi. In the OctoPrint web interface, under the "connection" section, select the USB thing and braudrate (use auto option if you're unsure). Click the "connect" button and the 3D printer should connect to OctoPrint. Try homing the axises to see if it's connected. ## Install Touch UI Plugin Once your printer and material profiles are setup, then it's time to install the Touch UI Plugin. Under the settings section, goto the plugin manager and search for "Touch UI", then click the install button - OctoPrint will need to be restarted after installation (which can be done with the **sudo service octoprint restart** command in terminal). When OctoPrint restarts, the plug will be automatically enabled for devices with a small display. ## Loading OctoPrint Web Interface on PiTFT Display OK, so now OctoPrint is installed on the Pi and configrued with your printer/material profiles and the Touch UI plugin. Now you should be able to use the OctoPrint web interface on the Pi with the PiTFT display. Launch the epiphany web browse on the Pi and load OctoPrint (it'll be the URL  **http://0.0.0.0:5000** ). The Touch UI plugin will display a _mobile friendly_ interface, yay!! # 3.5" PiTFT OctoPrint Rig ## Hardware ## Connect PiTFT to Raspberry Pi GPIO Align up the GPIO header pins from the Raspberry Pi with the headers of the PiTFT. Press the Pi and the PiTFT together until they're fully joined. ![3d_printing_pitft-pi-join.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/761/medium640/3d_printing_pitft-pi-join.jpg?1464468455) ![3d_printing_pitft-pi-join-1.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/762/medium640/3d_printing_pitft-pi-join-1.jpg?1464473237) ![3d_printing_pitft-pi-join-3.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/763/medium640/3d_printing_pitft-pi-join-3.jpg?1464473262) ## Install PiTFT Orient the top half of the csae with the "viewable" area of the display. Notice the side of TFT display with the black strip - this should be covered up by the top half of the case. Insert the PiTFT into the top half of the case and align up the mounting holes with the standoffs. Press it down until the screen is flush with the inside of the top half of the case. ![3d_printing_case-pitft-top.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/764/medium640/3d_printing_case-pitft-top.jpg?1464473309) ![3d_printing_case-pegs.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/765/medium640/3d_printing_case-pegs.jpg?1464473342) ![3d_printing_case-top-screen.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/766/medium640/3d_printing_case-top-screen.jpg?1464473377) ## Open SD Card Door Use the tip of a hobby knife to free the SD card door from the bottom half of the case. Insert the knife into the edge and cut along the opening to release the door. There's a thin layer near the door that allows it to be opened and closed. ![3d_printing_case-door-2.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/770/medium640/3d_printing_case-door-2.jpg?1464473527) ![3d_printing_case-door.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/771/medium640/3d_printing_case-door.jpg?1464473555) ![3d_printing_case-door-4.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/772/medium640/3d_printing_case-door-4.jpg?1464473596) ![3d_printing_case-door-3.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/774/medium640/3d_printing_case-door-3.jpg?1464474291) ## Install Raspberry Pi Place the bottom half of the case over the Raspberry PI at an angle with the ports (microUSB, HDMI and A/V jack) aligned up with the cutouts. Join the bottom half of the case with the top half and press them together until they snap shut. ![3d_printing_case-join-3.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/767/medium640/3d_printing_case-join-3.jpg?1464473447) ![3d_printing_case-join-1.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/768/medium640/3d_printing_case-join-1.jpg?1464473467) ![3d_printing_case-join-2.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/769/medium640/3d_printing_case-join-2.jpg?1464473486) ## Finished Case The back of the case has a large opening for keeping the Raspberry Pi well ventilated. ![3d_printing_case-back.jpg](https://cdn-learn.adafruit.com/assets/assets/000/032/773/medium640/3d_printing_case-back.jpg?1464473654) ![](https://cdn-learn.adafruit.com/assets/assets/000/032/775/medium800/3d_printing_hero-single-03.jpg?1464474364) ## PiTFT Stand You can rest the PiTFT case on the the stand to keep it upright ## Featured Products ### PiTFT Plus 480x320 3.5" TFT+Touchscreen for Raspberry Pi [PiTFT Plus 480x320 3.5" TFT+Touchscreen for Raspberry Pi](https://www.adafruit.com/product/2441) Is this not the cutest, little display for the Raspberry Pi? It features a **3.5" display with 480x320** 16-bit color pixels and a resistive touch overlay [just like our popular original](https://www.adafruit.com/products/2097), but this one is engineered... Out of Stock [Buy Now](https://www.adafruit.com/product/2441) [Related Guides to the Product](https://learn.adafruit.com/products/2441/guides) ### Raspberry Pi 3 - Model B - ARMv8 with 1G RAM [Raspberry Pi 3 - Model B - ARMv8 with 1G RAM](https://www.adafruit.com/product/3055) Did you really think the Raspberry Pi would stop getting better? At this point, we sound like a broken record, extolling on the new Pi’s myriad improvements like we’re surprised that the folks at the Raspberry Pi Foundation are continuously making their flagship board better. ... In Stock [Buy Now](https://www.adafruit.com/product/3055) [Related Guides to the Product](https://learn.adafruit.com/products/3055/guides) ### Raspberry Pi 2 - Model B v1.2 - ARM Cortex-A53 with 1G RAM [Raspberry Pi 2 - Model B v1.2 - ARM Cortex-A53 with 1G RAM](https://www.adafruit.com/product/2358) Didn't think the Raspberry Pi could get any better? You're in for a big surprise! The Raspberry Pi 2 Model B is out and it's amazing! With an upgraded ARM Cortex-A53 quad-core processor, Dual Core VideoCore IV Multimedia coprocessor, and a full Gigabyte of RAM, this... No Longer Stocked [Buy Now](https://www.adafruit.com/product/2358) [Related Guides to the Product](https://learn.adafruit.com/products/2358/guides) ### Miniature WiFi (802.11b/g/n) Module: For Raspberry Pi and more [Miniature WiFi (802.11b/g/n) Module: For Raspberry Pi and more](https://www.adafruit.com/product/814) Make your Internet of Things device cable-free by adding WiFi. Take advantage of the Raspberry Pi and Beagle Bone's USB port to add a low cost, but high-reliability wireless link. We tried half a dozen modules to find one that works well with the Pi and Bone without the need of recompiling... No Longer Stocked [Buy Now](https://www.adafruit.com/product/814) [Related Guides to the Product](https://learn.adafruit.com/products/814/guides) ### Full Size Wireless Keyboard with Trackpad [Full Size Wireless Keyboard with Trackpad](https://www.adafruit.com/product/2876) The quick brown fox jumps over the lazy dog.  The quick brown fox jumps over the lazy dog.  The quick brown fox - sorry! We were practicing our typing ON THIS AWESOME KEYBOARD. With slim chiclet keys, this 'normal size' keyboard is the perfect on-the-go accessory to... In Stock [Buy Now](https://www.adafruit.com/product/2876) [Related Guides to the Product](https://learn.adafruit.com/products/2876/guides) ### Raspberry Pi Camera Board [Raspberry Pi Camera Board](https://www.adafruit.com/product/1367) The Raspberry Pi Camera Module is a custom designed add-on for Raspberry Pi. It attaches to Raspberry Pi by way of one of the two small sockets on the board upper surface. This interface uses the dedicated CSI interface, which was designed especially for interfacing to cameras. The CSI bus is... No Longer Stocked [Buy Now](https://www.adafruit.com/product/1367) [Related Guides to the Product](https://learn.adafruit.com/products/1367/guides) ### Raspberry Pi Camera Board v2 - 8 Megapixels [Raspberry Pi Camera Board v2 - 8 Megapixels](https://www.adafruit.com/product/3099) Snap, snap! The Camera v2 is the new official camera board released by the Raspberry Pi Foundation! The **Raspberry Pi Camera Board v2** is a high quality 8 megapixel Sony IMX219 image sensor custom designed add-on board for Raspberry Pi, featuring a fixed focus lens.... In Stock [Buy Now](https://www.adafruit.com/product/3099) [Related Guides to the Product](https://learn.adafruit.com/products/3099/guides) ## Related Guides - [Kali Linux on the Raspberry Pi with the PiTFT](https://learn.adafruit.com/kali-linux-on-the-raspberry-pi-with-the-pitft.md) - [Adafruit PiTFT 3.5" Touch Screen for Raspberry Pi](https://learn.adafruit.com/adafruit-pitft-3-dot-5-touch-screen-for-raspberry-pi.md) - [Pi Hole Ad Detection Display with PiTFT](https://learn.adafruit.com/pi-hole-ad-pitft-tft-detection-display.md) - [Mini Raspberry Pi Handheld Notebook](https://learn.adafruit.com/mini-raspberry-pi-handheld-notebook-palmtop.md) - [Using OSC to Communicate with a Raspberry Pi](https://learn.adafruit.com/raspberry-pi-open-sound-control.md) - [Raspberry Pi Pipboy 3000](https://learn.adafruit.com/raspberry-pi-pipboy-3000.md) - [Processing on the Raspberry Pi & PiTFT](https://learn.adafruit.com/processing-on-the-raspberry-pi-and-pitft.md) - [Analog Knobs on Raspberry Pi 400 with CYBERDECK Hat](https://learn.adafruit.com/analog-knobs-on-raspberrypi-400-with-cyberdeck-hat.md) - [DIY Bluetooth Gamepad](https://learn.adafruit.com/diy-bluetooth-gamepad.md) - [GitHub Actions Status Tower Light](https://learn.adafruit.com/github-actions-status-tower-light.md) - [Pokemon Potion USB Battery Pack](https://learn.adafruit.com/pokemon-potion-usb-battery-pack.md) - [How to use 3D Parts GitHub Repo](https://learn.adafruit.com/how-to-use-3d-parts-github-repo.md) - [3D Printed Battery Tester](https://learn.adafruit.com/3d-printed-battery-tester.md) - [Four Channel Audio Passive Stereo Mixer](https://learn.adafruit.com/four-channel-audio-passive-stereo-mixer.md) - [16x16 NeoPixel Matrix Square Pixel Display](https://learn.adafruit.com/16x16-neopixel-matrix-square-pixel-display.md)