Skip to content

Latest commit

 

History

History
154 lines (105 loc) · 11.8 KB

README.md

File metadata and controls

154 lines (105 loc) · 11.8 KB

Image

What is a MandoPuter Pi?

A basic electronics system that will display Mandalorian characters and animations on a small display using a Raspberry Pi Zero. Use this as a starting point for adding displays to your costume (like a gauntlet). Feel free to copy the design, modify it, or make feature requests. This is the way!

What is the difference between the original MandoPuter and a Mandoputer Pi?

  • The original MandoPuter has a longer battery life, but is best suited for text and one image
  • The MandoPuter Pi has lot more memory and can display multiple images including animated GIFs at the cost of lower battery life

This guide is still a work in progress

Parts list:

You will need the following parts:

  1. One supported display:
  2. Raspberry Pi Zero or Raspberry Pi Zero W (the Zero W has built-in Wi-Fi and Bluetooth)
  3. Suggested 5V power supplies (connected to the board, or powered through the micro USB connector)
  4. MicroSDHC Card 16GB preferred, speed class 10
  5. MicroSDHC card reader for your PC - you'll need to flash an image to the card
  6. Small Gauge (22-30) Wire to connect the display

Optional parts if you want to log in locally to customize the display sequence:

Unlike the Zero, the Zero W has Wi-Fi, so you can SSH into it remotely without the need for a keyboard, mouse, and monitor

  1. Micro USB to USB OTG adapter for connecting a wireless keyboard/mouse combo - or -
  2. Micro USB hub is another option if you need to connect more than one USB device to the Raspberry Pi
  3. Keyboard and Mouse These can be separate, or a combo unit like I have linked here
  4. Micro HDMI adapter to connect and external monitor (you'll need an HDMI monitor and cable)

Recommended Tools:

  1. Fine tip Soldering Iron (I use a Hakko FX-100, but any fine tip will work)
  2. Solder (what I'm using)
  3. Solder flux (what I'm using)
  4. Micro Cutters
  5. Wire Strippers
  6. Tweezers
  7. Isopropyl Alcohol for cleaning solder flux
  8. A computer with a USB port

I have the parts, now what do I do?

You'll follow 3 main steps to get things setup:

  1. Setup the Raspberry Pi Zero or Zero W (flash the image to the SD card)
  2. Solder the LCD
  3. Connect power

Optional - customize the character sequence and/or add graphics (details below)

That's it, no need to write any code or use any other fancy tools. The default setup will display text sequences, so no editing is required. The character sequences are as close as I can get analyzing many frames from the show and behind the scenes. From there you can make changes to the sequence, or add images or GIF animations.

1a. Raspberry Pi Zero W Setup

These steps only apply to the Raspberry Pi Zero W board (Wi-Fi version). If you have a Raspberry Pi Zero follow the steps in 1b below. Setup is simple, we will complete the following:

  1. Download the right image 💾 to your PC and flash it to the SD card
  2. Customize your Wi-Fi setting, so you can access it remotely. This is not required, but another way to connect and configure your MandoPuter if you do not have a keyboard and monitor connected to it
  3. Insert the SD card into the Pi

You will need to download one of the following images depending upon which display you are using:

Now we will need to flash the image to the SD card

  • Download balenaEtcher and install it on your PC or Mac
  • Connect an SD card reader with the SD card inside
  • Open balenaEtcher and select from your hard drive the Raspberry Pi .img or .zip file you wish to write to the SD card
  • Select the SD card you wish to write your image to
  • Review your selections, then click Flash! to begin writing data to the SD card

As an alternative you can use dd on GNU/Linux or macOS: Change the path to your image file, /dev/sdcard is the path to your SD card device

Configure your Wi-Fi by copying the wpa_supplicant.conf file to the root of your SD card. More details here

Insert the SD card into the Raspberry Pi You can power it up to see if it will boot if you connect it to an external monitor. If not go to step 2 below and solder the LCD.

1b. Raspberry Pi Zero Setup

These steps only apply to the Raspberry Pi Zero board (no Wi-Fi version). If you have a Raspberry Pi Zero W follow steps in 1a above. Setup is simple, we will complete these steps:

  1. Download the right image 💾 to your PC and flash it to the SD card
  2. Insert the SD card into the Pi

You will need to download one of the following images depending upon which display you are using:

Now we will need to flash the image to the SD card

  • Download balenaEtcher and install it on your PC or Mac
  • Connect an SD card reader with the SD card inside
  • Open balenaEtcher and select from your hard drive the Raspberry Pi .img or .zip file you wish to write to the SD card
  • Select the SD card you wish to write your image to
  • Review your selections, then click Flash! to begin writing data to the SD card

As an alternative you can use dd on GNU/Linux or macOS: Change the path to your image file, /dev/sdcard is the path to your SD card device

Insert the SD card into the Raspberry Pi You can power it up to see if it will boot if you connect it to an external monitor. If not go to step 2 below and solder the LCD.

2. Solder the LCD

Solder the display to the Raspberry Pi according to the diagram below (not all display pins are used). Depending upon how you intend to power your Pi, you may not need a 40 pin header. Both the displays are the same, so the wiring is identical. Adafruit has a great soldering guide if you are new to soldering. The only thing they did not mention is adding flux to the solder joint first. That makes it much easier to make a good solder joint, and you only need to touch the parts for a second or two.

Image

Raspberry Pin LCD Pin
1 - 3.3 VDC Vin (do not use 3V)
9 - GND GND
19 - SPI MOSI MOSI or SI
22 - GPIO6 DC or D/C
23 - SPI SCLK SCK
24 - SPI CE0 TFTCS or TCS
  • Raspberry Pi pinout details are documented here
  • The MandoPuter Pi supports displays connected via SPI port with the ST7789 chipset. Other SPI displays are possible with different chips, and I will evaluate other options if they are needed. We do not use a display connected through the HDMI port other than configuring the sequence.

3. Insert the SD card and power on the Raspberry Pi

Coming soon

4. Optional - customize your setup

More detail coming soon

These are 2 scripts that you can modify to customize what is shown on the display:

  • /home/pi/mandoputer/showtext.py - Displays text sequences followed by graphics sequences
  • /home/pi/mandoputer/showgif.py - Displays animated GIF files on the display

You can modify these scripts, and then copy one to /home/pi/mandoputer/autorun.py so it will run automatically on boot.

Want to know more?

SparkFun has a nice tutorial on the Raspberry Pi Zero W. This applies to the Zero model as well minus the Wi-Fi part.

Tom's Hardware has a nice article that goes into the specs and details of the Zero models. It has a getting started guide as well.

Adafruit has a nice PDF guide that goes through the features of the Raspberry Pi Zero W.

You should be ready to go. Give the system a minute or two to boot up, and you should see the display come to life.