About: Hey my name is Chris, welcome to my instructors page. I'm happily married with a wonderful son, he makes the best workshop assistant ever. Plus I find a 7 year old has much more creative ideas than me. I wo...

Welcome to the PiSwitch

Hello to the wonderful world of instructables. Sometimes this website feels like a second home to me I spend so much time drooling over the projects I wish I had the time and money to make. Alas, It's finally time for me to drop on you amazing people, my second instructable I call it The Pi-Switch. It's a conglomeration of the work of many people but this particular build is, certainly and uniquely my own. I do however want to give credit where credit is due. First off much thanks to Drew Wallace with the Switch Berry I couldn't make his software work but he helped get me started. Thanks to Adafruit they built the PiGrrl2 a while back and if the internals to my pi case seem familiar that's because the charging circuit and audio amplifier are the same circuits used in the PiGrrl 2. Third Thanks to the wonderful developers over at the pi foundation, RetroPie, and last but not least Kodi. My scripts are built around the incredible work you've done developing software to run on the raspberry pi. Finally, thanks to Nintendo for making me want to reverse engineer, poorly might I ad, their Switch Console.

Step 1: Procuring Provisions

You will need:


Soldering iron + solder + soldering flux

Hot Glue Gun

A 3D Printer or $20-$40 and 3dhubs.com

A decent micro screwdriver kit

A Dremel Tool with a fine bit or a drill with a 3/16th bit



Pi Foundation 7" Raspberry Pi screen

Kingwin 80 Piece Assorted Notebook Replacement Screw Kit or (various screws of fortunate sizes lying about)

26 awg wire

1/8 inch stereo jack with switch

Mini Metal Speaker

tiny power switch

6600 mah battery of plentiful life

Joy-Con Controllers (reccomend the addition of a charger)

Raspberry Pi 3 (Bluetooth and WiFi built in)

PAM8302 2.5W Audio Amp

PowerBoost 1000C

3d Printed Case (Files Are Attached to this step the instructable assumes you've printed the part.)


PiCamera V2

Step 2: Soldering Headphone Jack to the Pi

I have pictures from the various steps above.

Start with the Pi and solder some 26 awg wire to it:

I used red for the left audio to pp26 near the audio jack (thank you pi foundation for labeling the solder pads)

solder black for ground to pp24

right audio is a yellow wire and you solder it to the upper left pin on the audio jack.

UPDATE: 3-26:

Some more testing showed to me that PP24 directly to the metal pad is ground PP25 is right audio and PP26 is left audio. Picture of updated solder pad usage attached.

I recommend leaving the wires long 3-4" you can trim them down or tuck them in later. I leave them long because my projects often get pulled apart and rebuilt/re-purposed. I really like this particular 1/8 in jack. I chose it because the clear top means you can see and understand exactly how it works.

Soldering The Audio Jack (The pinout is in pics above):

Take the red wire from the pi and solder it to pin 2 on the 1/8 in jack.

Take the yellow wire from the pi and solder it to pin 5 on the 1/8 in jack.

take the black wire and twist another 3-4" length of black wire to it then solder to pin 1 on the 1/8 in jack.

solder a 3-4" red wire to pin 3 on the 1/8 in jack.

You should now have an audio jack connected to the pi, if you were to play sound with headphones plugged in you would have music playing clearly on this jack. I reccomend hot gluing the wires on the bottom of the pi and the bottom of the jack in order to secure the thin wires and also to protect them from damage and shorts.

Step 3: Soldering the Power Board & Switch

The PowerBoost 1000C for all your lithium charging needs.

Unfortunately this little deal though fantastic does not output enough power to run the Pi-Switch. It does however do a great job charging the battery which has plenty of amperage to power the pi, screen, and audio simultaneously for about 2-3 hours. I left the power on the pi open so that running out of battery just means you need to plug directly to the pi. I'm working on a better solution still. I may build a switching circuit. I will update this if I find a better way to power this device but 2-3 hours isn't bad.

Power Leads:

Lets start by looking at Picture 1 above you'll notice 3 black circles and 3 red circles.

You Guessed IT !! solder 3 10" black wires and 3 10" red wires to the corrosponding spots marked on the PowerBoost.

The Switch (The Power Switch (Not Nintendo)):

Cut a single right or left leg off your switch and solder on a 2" wire to the remaining center and alternate legs of your amputee power switch.

solder one of the wires from you switch to en on the powerboost and the remaining wire to gnd on your powerboost board.

Hot Glue is cheap, quick, and easy. I reccomend now putting some hot glue over each of the wires connected to the PowerBoost Board

Step 4: Speaker and Audio Board and HeadPhone Jack (A.K.A. Tying It All Together)

This is the step in which we combine our various assets

Solder the Speaker:

Look at the picture above and solder one wire to each of the pads on the speaker as shown above. I'm too cheap for heat shrink so if you're like me HOT GLUE!

Solder the audio board:

grab your PAM8302 look at the writing. On the side where the board says 4-8 ohms solder your speaker wires to the two center pads as pictured above.

Solder the power to the audio:

Take one of you red power leads and one of your grounds from you PowerBoost board and solder the red wire to vin on the PAM8302 and the black wire to gnd on your PAM8302.

Solder headphone to the PAM8302:

Take the red wire from your headphone jack and solder it to A+ on your PAM8302

Take the black wire from your headphone jack and solder it to A- on your PAM8302

Solder the Pi:

There's a picture of the pi above. Take one black wire from your power boost solder it to the black dot on the picture of the pi.

Take one red wire from your power boost solder it to the red dot on the picture of the pi.


carefully be sure the remaining black wire from the power boost and red wire from the powerboost aren't touching anything. then attach the battery and flip the switch. if everything is hooked up correctly an led should light on the pi, on the charge board and you may hear a light buzz from the speaker if it's noisy enough to bother you you likely have an issue with you solder joints.

Step 5: Assembly

We should now have everything attached with exception of the LCD and the optional pi camera. in the first few pictures you'll see how to screw in the pi itself. it's quite simple, so pull out your kit of 80 various laptop screws find some screws just a mm or two longer than the thickness of the pi and thread them into the soft printed plastic. PLA is recommended. there should be two lovely pegs to set the pi on, and on the opposite corners there's holes to thread. the same goes for the power board. there's pictures above that shows the assembly of the power boards.

now push the switch through the tiny hole above the power board. grab the switch from the outside with with some tweezers or finger nails. While pulling gently on the switch to keep it from falling back into the case put some hot glue on the backside of the switch as pictured above. once the glue has cooled double check that the switch is in a good position for use. If it's not good peal off the glue and try again.

Drill a 3/16th inch hole between the pi and the powerboost you can also dremel a hole. This should be on the side of the case where the pi's usb ports are located. Slide the headphone jack into the hole and hot glue it in place.

Finally, glue the speaker battery and audio boards in place as pictured above. I put the speaker facing the plastic under the battery which i tucked directly behind the powerboost board. Then I glued the battery up against the sides of the 3d printed case. Ffinally I glued the speaker amplifier the top of the battery.

So if you've done everything right this far you should have the pi, powerboost, the PAM8302, the speaker, the power switch, and the battery all installed and secured in the back of the pi case. There should also be one 10" black wire and one 10" red wire left.

Step 6: Adding the Screen and Finshing Assembly

Pat yourself on the back you're almost done with a rather complex assembly. now take some 6mm long screws and thread the side bars. They should thread into the screw holes on the screen as shown in the pics above. If the screen doesn't line up and fit you probably have it upside down. Look at the pictures and you may notice I have prototyping wires attached to my screen. I actually put pin headers on my powerboost instead of soldering direct. if you followed through step by step without looking ahead then you're soldering the wires on. if not it's your choice. I prefer pin headers for quick easy modification because my creations are always in a state of flux and improvement.

Use the remaining Wires:

Solder the remaining red wire from the powerboost to the vin pin on the screen

Solder the remaining black wire from the powerboost to the gnd pin on the screen

Attaching The Camera (Optional):

plug the camera cable into the camera board

plug the cable in the pi as shown above

flip the camera over the ethernet jack.

bend the cable flat and glue in place.

Attaching the screen ribbon:

Plug the Ribbon cable in to the pi as shown

if you look at picture 5 it shows how I flip the back panel down into place after attaching the ribbon

Finally screw the four screws from the back panel into the brackets on the back of the screen and you're fully assembled.

Step 7: Building the Pi Software Image

Step 1)

plug a keyboard into your pi, and make sure the pi is plugged into a charger.

Go to this website and follow the install: (only setup your keyboard as a temporary controller)


Step 2)

You may have an annoying buzz sound (It's ok ignore for now, we'll fix it soon)
go through the ReroPie Menu as follows to setup wifi:

retropie / settings > raspi-config > interfacing options > SSH > Yes > Ok > Finish > Retropie Setup > Configuration Tools > wifi > (configure your wifi) > exit >

step 3)

Install Pixel:

raspbiantools > Install Pixel Desktop Environment > yes > (wait a while) > ok (to flash player) > (wait a while longer) > ok > cancel > back >

step 4)

Install Kodi:

Manage Packages > Manage Optional Packages > Kodi > Install from binary > (wait a while) > back > back > back>

step 5)

register and connect your JoyCons:

Configuration /Tools > bluetooth > Register and Connect (while pressing the tiny button between L and R on the right joy-con) > choose Joy-Con (R) > NoInputNoOutput > (wait) > ok > ok

step 6)

repeat step 5 with Joy-Con (L)

step 8)

cancel > back > exit > (start button) > quit > quit emulation station> yes

step 9)

type the following:
sudo apt-get update && sudo apt-get upgrade && sudo rpi-update
sudo reboot

step 10)

type the following:
wget  https://raw.githubusercontent.com/cfoote7/PiSwitc...
sudo chmod 777 setup.sh && sudo chmod a+x setup.sh 


I've added a controller connection menu, where the screen will tell you if both joy-cons are connected. also added a one player two player mode selection menu. on first competed boot you will now connect your controllers with the + and - buttons, click next, click retropie, and choose 1 player mode.


when the device gets to the touchscreen boot menu tap + and - to activate the two controllers and tap retropie.

Choose retropie hit start > configure controllers > configure your joycons

Tada this is your first boot to the completed device. Now you just need to set it up with your own media and roms.

Check back for updates with automatic controller connecting and parsec for computer to pi game streaming.


pywx.py is my touchscreen boot selection menu, it's not actually a boot selection being that all these options exist under one raspbian jessie build. I plan on adding a simpler way of pairing the controllers at boot to this menu. check back for updates, and please let me know if you build this especially if you make any improvements I'd love any co-op on this that's offered. Please check back on my repository I'll be updating it https://github.com/cfoote7/PiSwitch

Thanks for looking if you have any questions about my custom built hardware or software feel free to ask I like to answer questions and find ways to make my instructables clearer :)

Epilog Challenge 9

Runner Up in the
Epilog Challenge 9



    • Warm and Fuzzy Contest

      Warm and Fuzzy Contest
    • Epilog X Contest

      Epilog X Contest
    • Cardboard Challenge

      Cardboard Challenge

    64 Discussions


    Question 8 days ago on Step 7

    how do you attache the switch controller to the side of the screen case?


    Question 21 days ago

    I haven't taken the time to read this instructable in detail. but I noticed that it jumped right into building the PiSwitch, and never did answer the basic questions of What is a PiSwitch and why would I want one?


    Question 8 months ago

    I'm still at this; how is the Raspberry Pi 3B being powered through the PowerBoost 1000C? The Pi 3 needs 2A at max usage (which admittedly isn't all the time), but I'm getting the Low Voltage symbol almost constantly whenever I'm playing - anybody solve this? I see some solutions would be to use an alternate power source, like an Anker 13000, but that doesn't seem like a very clean solution

    1 answer

    Answer 5 months ago

    Hey, did you ever come up with a better power solution?


    Question 6 months ago on Step 1

    Hi Chris, Tried checking the 3d stencils on 3dhubs.com and the case is showing me this error: Hard to Remove Support issues detected.

    This part has hard to remove support with FDM.

    Would appreciate getting some clarification on what the problem is. Thanks!


    Screen Shot 2018-07-12 at 11.24.25 AM.png

    Question 6 months ago

    Does anybody know how to implement the "joy-mouse" mapping? I have played around and got it working with SCUMMVM, but it only works if I ONLY call this mapping on boot. I lose the dual joy-con/keyboard mapping. I would like to call this using the runcommand-onstart.sh script only for SCUMMVM programs (and possibly DOSBOX), but I can't find a way to make it play nice


    Question 6 months ago


    Is the Analog Stick only mapped as digital signals (up, down, left, right) or as real analog axis?

    Greetings from Switzerland


    1 answer

    Answer 6 months ago

    It's only digital signals (up, down, left, right). The joystick mapper only maps as keyboard presses, not as real analog axis


    Tip 9 months ago

    Hi everyone,

    I've tried building this project directly, and there are a few points I would like to pass on to future builders.

    As is, this project is based around Retropie 4.3; unless cfoote7 ever updates it, as of April 2018, it MUST be based on Jessie and not Stretch to use as-is. This project will NOT work with a new Raspberry Pi 3B+. Even with a regular 3B, if you initially base your build on Stretch, all you will get is a black screen with a flashing cursor.

    Next, the build instruction seem like a "hodge-podge" from Adafruit's PiGrrl 2, mixed with a few random notes here and there. When built exactly as these instructions list, it didn't really work for me. I have documented my changes to the wiring diagram, and list them here:


    Finally, the case STL file has been redesigned, closing some of the unnecessary gaps, adding standoffs for the PAM8302, adding a speaker mount and a mount for the headphone jack.


    Even after this, I'm still having minor issues with this project; using all of the original parts list, the Raspberry Pi and the Touchscreen both issue "low voltage" and "under-voltage" warnings. Also, the joy cons never respond when choosing "two-player" mode from cfoote's selection menu.

    Hopefully my experiences following this project will help others :)

    1 reply

    Reply 6 months ago

    Thanks for posting the edits! Were you able to work through the power issues?


    Question 10 months ago

    Hi Chris. I really love what you've done here and I got the case printed and bought everything I needed. I get to step 10 and after running the setup.sh, I get a black screen with a blinking cursor. If I reboot it, it has the same thing.

    Any ideas as to how to help things along will be appreciated.

    3 answers

    Answer 9 months ago

    Hey buddy...
    I got the same thing.. Were you ever able to solve the issue? Or did you get an answer from this guy.


    Answer 10 months ago

    This is more than likely either the config .txt or a corrupted card. config.txt could cause it if you're using different hardware than me. If you dont mind going to my github


    and reposting this question under issues. Include any possible hardare differences you have. and I'll work with you to resolve the issues you're having. I've followed my instructions step for step several times with different pi setups and haven't ran into that particular issue but I'm certain we can work it out together. :)


    Question 7 months ago on Step 7

    I have two questions, both software related.

    -I've flowed the steps to a tee, and both of my recent tries I've ended up with my pi unable to boot after running setup.sh

    -In a previous build using your software, I was able to do everything with relative sucsess, however I could not get Retropad w/Analog (Left analog) to work with the Joy-cons. Do you have an alternate method, or fix, for using the left analog during d-pad only games?

    Thanks, and great stuff.

    Cagri Kanver

    8 months ago

    Impressive and very smart work. Do appreciate the share!


    Question 9 months ago

    Hey buddy,
    Great instructable.. I am making this now. Got my Screen in the mail and 3d printed the body!! fits a treat also.

    I was wondering i have a Raspberry 3 B+ will your image work on that?? or do i need to use the Model B...

    Also is there a link to a complete IMAGE of your system so that all is set up and i can just image my SD??

    Thanks again and i look forward to sharing my pics of my Piswitch.

    2 answers

    Answer 9 months ago


    thanks for the response on Github, Unfortunately the 4.3 version doesn't work on the B+

    i will have to wait for you to finish the 4.4 version.



    Answer 9 months ago

    Just to add to this.. I even plugged it in to my raspberry pi 3 model b.. With the same result... I thought it migjt be a model issur but clearly it isint..

    Any thoughts buddy.. I would love to get this off the ground before i order the other parts.


    Question 9 months ago on Step 5

    If I dont wanna do the full same build and just use the joycons on my own build could I just do steps 9,10 on a normal retropi build?