2,705
edits
Changes
Jump to navigation
Jump to search
Line 4:
Line 4: − + − + + + − + − + Line 43:
Line 45: − + − − It's a 9GB image file (a good amount of soundfonts) compiled for RBPi3 and pre-configured for working with Kits v2 out-the-box. Plug & Play! − − If you prefer a smaller image (Gorgonilla) or need support for RBPi2, then you can download the older Gorgona image: − '''[https://discourse.zynthian.org/t/merry-zynthians-and-happy-new-sd-image/314 Download Zynthian "Gorgona" SD-image]'''+ − + − + Line 67:
Line 65: − + Line 271:
Line 269: + + − − [[File:IMG_4777.JPG|600px]] Line 334:
Line 332: + + + + + + + + + + + + + + + + + Line 347:
Line 362: − + + + + + + + + + + Line 412:
Line 436: − These are the stages that you should see while booting:+ Line 422:
Line 446: − + + + + + + + + Line 431:
Line 462: + + Line 438:
Line 471: − + − '''CAPTURE NEEDED HERE'''+ Line 449:
Line 482: + + Line 493:
Line 528: − + − When everything is working OK, it's time to close the case. + − This can be a little bit tricky. Take your time to see how to bend and drive the cables to get a good fitting.+ − [[File:Zynthian_mounting_case_open.jpg|600px]]+ − + + + Line 514:
Line 551: − + Line 551:
Line 588: − +
Building a Zynthian Box using an official Kit v2 (view source)
Revision as of 23:28, 25 April 2018
, 23:28, 25 April 2018→Zynthian Box
This tutorial is mainly intended for those who are building a Zynthian Box using one of the ''official'' kits, that i offer here:
This tutorial is mainly intended for those who are building a Zynthian Box using one of the ''official'' kits, that i offer here:
[https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]
[http://shop.zynthian.org Zynthian Shop]
Specifically, the instructions are for the assembly of kits v2 (version 2), those using the All-In-One circuit and the PiScreen 3.5' display. If you have an older kit v1, based in the 2in1 circuit and the PiTFT 2.8' display, you better should read [[Building a Zynthian Box using an official Kit | this tutorial]].
Specifically, the instructions are for the assembly of kits v2 (version 2), those using the All-In-One circuit and the PiScreen 3.5' display. If you have an older kit v1, based in the 2in1 circuit and the PiTFT 2.8' display, you better should read [[Building a Zynthian Box using an official Kit | this tutorial]].
[[File:IMG_1459.JPG|600px]]
[[File:IMG_2287.JPG|600px]]
Anyway, the instructions are quite detailed and can be used as inspiration for building a custom Zynthian Box from scratch. Of course, you will have to be creative if you want to do it in that way ;-)
Anyway, the instructions are quite detailed and can be used as inspiration for building a custom Zynthian Box from scratch. Of course, you will have to be creative if you want to do it in that way ;-)
[[File:IMG_2280.JPG|600px]]
=Bill of Materials=
=Bill of Materials=
* Zynthian Basic Kit (custom PCBs, electronic parts, wiring and knobs) See: [https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]
* Zynthian Basic Kit (custom PCBs, electronic parts, wiring and knobs) Visit the [http://shop.zynthian.org Zynthian Shop]
* Case kit, including nuts, bolts and connectors. See: [https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]
* Case kit, including nuts, bolts and connectors. Visit the [http://shop.zynthian.org Zynthian Shop]
* Raspberry Pi 3 (or Raspberry Pi 2)
* Raspberry Pi 3 (or Raspberry Pi 2)
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+ souncard]
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+ souncard]
The easiest way of getting the software is downloading the last ''official'' SD image from here:
The easiest way of getting the software is downloading the last ''official'' SD image from here:
'''[http://blog.zynthian.org/download/zynthian_gorgona_edge_rbpi3_piscreen2-2017-10-23.img.torrent Download Zynthian "Gorgona Edge" SD-image]'''
'''[http://zynthian.org/download/zynthian_gorgona_omega_rbpi3_kitv2-2018-04-03.zip.torrent Download Zynthian "Gorgona Omega" SD-image, configured for Kits v2]'''
It's a 8GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3. (Please, keep feeding the torrent after downloading!)
These SD images are pre-configured for the older Kits v1, so you should adjust the configuration using the [[Configuration_Users_Guide|webconf tool]].
These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!
After downloading the SD-image, you have to write it to a SDcard. You need a minimum size of 16GB SDcard for the full ''Gorgona'' image or 8GB for the ''Gorgonilla'' lite image.
After downloading the SD-image, you have to write it to a SDcard. You need a SD card with a minimum size of 16GB, although you can use a bigger one if you want.
If you don't know how to do it, you can use [https://etcher.io/ Etcher] (free software works on Mac, Windows or Linux) to flash the image onto the SDcard. Or do it manually! There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
If you don't know how to do it, you can use [https://etcher.io/ Etcher] (free software works on Mac, Windows or Linux) to flash the image onto the SDcard. Or do it manually! There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].
This is a sketch with the main blocks of the ''official'' Zynthian Box:
This is a sketch with the main blocks of the ''official'' Zynthian Box:
[[File:Zynthian_hardware_scheme.png|600px]]
[[File:Zynthian_hardware_scheme.png|800px]]
In the project's repositories you will find all the electric schemes, PCB specifications, Herber files, etc. to build your own Zynthian Box from scratch:
In the project's repositories you will find all the electric schemes, PCB specifications, Herber files, etc. to build your own Zynthian Box from scratch:
Before mounting the MIDI-IN/OUT/THRU connectors into the case we will solder the needed wires. Doing it in that way is rather more comfortable than trying to solder inside the case with all the wiring mess.
Before mounting the MIDI-IN/OUT/THRU connectors into the case we will solder the needed wires. Doing it in that way is rather more comfortable than trying to solder inside the case with all the wiring mess.
[[File:IMG_4777.JPG|600px]]
If you want, you can protect the contacts using heat-shrink sleeve (the red sleeve pieces in the photo). In that case, remember to insert the sleeve pieces before soldering ;-)
If you want, you can protect the contacts using heat-shrink sleeve (the red sleeve pieces in the photo). In that case, remember to insert the sleeve pieces before soldering ;-)
[[File:IMG_1276.JPG|600px]]
[[File:IMG_1276.JPG|600px]]
[[File:IMG_1383.JPG|600px]]
[[File:IMG_1383.JPG|600px]]
===Mount the MIDI activity LEDS===
Insert the 3 LEDS in the case holes. You may want to push the LEDs with something more rigid than your finger. The screwdriver's handle could be fine.
[[File:IMG_2223.JPG|600px]]
[[File:IMG_2224.JPG|600px]]
When it's done, you have to solder the 2 LED wires (red/black) with the 2 spare wires on the MIDI JST harness (white/yellow). Polarity is important, so don't cross the wires:
* LED's red wire => JST's white wire
* LED's black wire => JST's yellow wire
After soldering all the 3 LEDs, you may want to protect the connection with heat shrink sleeve, adhesive tape or hot melt glue.
[[File:IMG_2226.JPG|600px]]
===Secure the Display===
===Secure the Display===
===Secure the Controllers===
===Secure the Controllers===
Fix the 4 controller modules to the case cover using the 4 bolts and washers attached to every rotary encoder.
Fix the 4 controller modules to the case cover using the 4 bolts and washers attached to every rotary encoder.
'''IMPORTANT:''' For avoiding problems while closing the case, i recommend to mount the controller modules with the connectors facing one another. See the photo below.
[[File:IMG_1393.JPG|600px]]
[[File:IMG_1393.JPG|600px]]
[[File:IMG_1401.JPG|600px]]
[[File:IMG_1401.JPG|600px]]
===Insert the knobs===
You should insert the knobs into the encoders before closing the case. This will avoid forcing the encoders too much as otherwise, you could break them. Follow these simple steps and you wouldn't have any problem:
* moisten with water or saliva the encoder stem and the knob hole
* press the encoder PCB with the finger from the rear side while pushing the knob from the front side until is completely inserted
===Stick the rubber feet===
===Stick the rubber feet===
2. Plug the mini-usb power conector. A good 5V micro-usb charger is recommended (> 2 Amp).
2. Plug the mini-usb power conector. A good 5V micro-usb charger is recommended (> 2 Amp).
If you are using a SD image pre-configured for the Zynthian Kits v2, these are the stages that you should see while booting:
1. Initially, the display must go white
1. Initially, the display must go white
If you get the Zynthian UI, congratulations!!! You are really close to get it!!
If you get the Zynthian UI, congratulations!!! You are really close to get it!!
[[file:IMG_1502.JPG|600px]]
[[file:IMG_1562.JPG|600px]]
If not, bad luck! Probably you made some mistake during the mounting process. You have to [[#Locating_and_Solving_problems|locate and solve the problem(s)]].
If not, bad luck! Probably you made some mistake during the mounting process. You have to [[#Locating_and_Solving_problems|locate and solve the problem(s)]].
If you are using an older SD image that is not pre-configure for the Kit v2, then you should configure your Zynthian Box's hardware using the [[Configuration_Users_Guide|webconf tool]]. These are the adjustments you have to do:
* '''Display:''' PiScreen 3.5 (v2)
* '''Audio:''' HifiBerry DAC+
* '''Wiring:''' MCP23017_ENCODERS
* '''Style:''' FontSize = 14
===Test the Controllers===
===Test the Controllers===
1. Push 'select' to create a new layer. You should get into the 'Engine Selection' screen.
1. Push 'select' to create a new layer. You should get into the 'Engine Selection' screen.
[[File:IMG_1563.JPG|600px]]
If it doesn't works, try pushing the 'snapshot' controller. Perhaps you have cross-wired the 3 & 4 controllers and in that case, you have to fix the wiring. If it doesn't work, try pushing the other two controllers and rotating the controllers. If something happens, most probably you have reversed the wiring order when connecting the controllers. Double-check the wiring again.
If it doesn't works, try pushing the 'snapshot' controller. Perhaps you have cross-wired the 3 & 4 controllers and in that case, you have to fix the wiring. If it doesn't work, try pushing the other two controllers and rotating the controllers. If something happens, most probably you have reversed the wiring order when connecting the controllers. Double-check the wiring again.
The selector must go down when rotating clockwise and go up when rotating counterclockwise. If the rotation sense is reversed, you should check the wiring.
The selector must go down when rotating clockwise and go up when rotating counterclockwise. If the rotation sense is reversed, you should check the wiring.
3. Select the ZynAddSubFX engine, select channel #1, bank and instrument. You should get into the 'Instrument Control' screen.
3. Select the ZynAddSubFX engine, select channel #1, bank and preset. You should get into the 'Instrument Control' screen.
[[File:IMG_1568.JPG|600px]]
4. Rotate every control to test that it works and that the rotation sense is correct.
4. Rotate every control to test that it works and that the rotation sense is correct.
6. Push 'Layer' again to return to the 'Layer Selection' screen. Try to create another layer following the same procedure.
6. Push 'Layer' again to return to the 'Layer Selection' screen. Try to create another layer following the same procedure.
[[File:IMG_1584.JPG|600px]]
7. From the "Instrument Control" screen, push 'Snapshot' to get into the 'Load Snapshot' screen. Push 'Snapshot' again to 'Save Snapshot'. Push 'BACK' to return to the 'Instrument Control' screen.
7. From the "Instrument Control" screen, push 'Snapshot' to get into the 'Load Snapshot' screen. Push 'Snapshot' again to 'Save Snapshot'. Push 'BACK' to return to the 'Instrument Control' screen.
If this doesn't work, you have to [[#Locating_and_Solving_problems|locate and solve the problem(s)]].
If this doesn't work, you have to [[#Locating_and_Solving_problems|locate and solve the problem(s)]].
=Close the Case=
=Final steps=
Once everything is in its place and you have tested that it works, it's time to close the case ...
===Close the case===
Take your time to see how to bend and drive the cables to get a good fitting when closing the case.
[[File:Zynthian_finished_01.jpg|600px]]
[[File:IMG_1626.JPG|600px]]
Finally, screw-drive the 8 sheet-threader bolts for securing the case, 4 each side.
Finally, screw-drive the 8 sheet-threader bolts for securing the case, 4 each side.
[[File:IMG_2287.JPG|600px]]
=Update your Zynthian Box=
=Update your Zynthian Box=
- '''restart GUI''' (or '''reboot''') from the admin menu
- '''restart GUI''' (or '''reboot''') from the admin menu
The update process can take some time. Be patient. If you get some ERROR message while updating, please, [[https://discourse.zynthian.org/t/problems-updating-the-software-from-the-admin-menu/386|ask in the forum]]. You can send a photo or description of the error message.
The update process can take some time. Be patient. If you get some ERROR message while updating, please, [https://discourse.zynthian.org/t/problems-updating-the-software-from-the-admin-menu/386 ask in the forum]. You can send a photo or description of the error message.
=Locating and Solving problems=
=Locating and Solving problems=
This is the electrical scheme of the All-In-One circuit:
This is the electrical scheme of the All-In-One circuit:
[[File:Zynthian_scheme_GPIO.png|800px]]
[[File:Zynthian_allinone.sch.svg|800px]]
===RBPi GPIO===
===RBPi GPIO===
[[File:Raspberry-Pi-j8header-2b.png|400px]]
[[File:Raspberry-Pi-j8header-2b.png|400px]]