Difference between revisions of "Building a Zynthian Box using an official Kit v3"

From ZynthianWiki
Jump to: navigation, search
(Zynthian Bundle All Kit v3)
 
(55 intermediate revisions by 2 users not shown)
Line 7: Line 7:
  
 
Specifically, the instructions are for the assembly of kits v3 (version 3), those using the Zynaptik circuit and the ZynScreen v1.4 display.
 
Specifically, the instructions are for the assembly of kits v3 (version 3), those using the Zynaptik circuit and the ZynScreen v1.4 display.
 +
  
 
[[File:ZynthianFront.jpg|600px]]
 
[[File:ZynthianFront.jpg|600px]]
Line 13: Line 14:
  
 
=Bill of Materials=
 
=Bill of Materials=
* Zynthian Basic Kit (custom PCBs, electronic parts, wiring and knobs)  
+
* Zynthian Basic Kit v3 (4 x controller v3 + zynaptic circuit + ribbon bus cable)
* Case kit, including nuts, bolts and connectors
+
* ZynScreen v1.4 (3.5" touch-display + controller driver)
 
* Raspberry Pi 3
 
* Raspberry Pi 3
 
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+ADC souncard]
 
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+ADC souncard]
* ZynScreen v1.4 (3.5" touch-display)
+
* Case kit v3, including nuts, bolts and connectors
 
* Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector)
 
* Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector)
 
* 16GB SD Card (a good one, please!)
 
* 16GB SD Card (a good one, please!)
Line 33: Line 34:
 
  + '''GNU Linux Operating System:''' Raspbian Jessie (Minibian is used in the most recent SD images)
 
  + '''GNU Linux Operating System:''' Raspbian Jessie (Minibian is used in the most recent SD images)
 
  + '''Jack Audio Daemon'''
 
  + '''Jack Audio Daemon'''
+ '''MOD-HOST + MOD-UI''' software, from [http://moddevices.com ModDevices] ([https://github.com/moddevices github repositories])
 
 
  + A collection of standalone '''Synth Engines & LV2 Plugins''' (see [[Zynthian_Supported_Synth_Engines|Supported Synth Engines & Plugins]])
 
  + A collection of standalone '''Synth Engines & LV2 Plugins''' (see [[Zynthian_Supported_Synth_Engines|Supported Synth Engines & Plugins]])
 +
+ '''MOD-HOST + MOD-UI''' software, from [http://moddevices.com ModDevices] ([https://github.com/moddevices github repositories])
 
  + '''Zynthian User Interface''' ([https://github.com/zynthian/zynthian-ui github repository])
 
  + '''Zynthian User Interface''' ([https://github.com/zynthian/zynthian-ui github repository])
 +
+ '''Zynthian Webconf Tool''' ([https://github.com/zynthian/zynthian-webconf github repository])
  
 
All the software used by Zynthian is Free Software (free as in ''freedom'', not as in ''free beer'') and it's covered by the GPL license or similar. If you don't know what i'm talking about, please, take a look to this:  
 
All the software used by Zynthian is Free Software (free as in ''freedom'', not as in ''free beer'') and it's covered by the GPL license or similar. If you don't know what i'm talking about, please, take a look to this:  
Line 45: Line 47:
 
  '''[https://os.zynthian.org/2019-06-26-zynthianos-stretch-lite-1.0.0-RC3.zip Download Zynthian "Aruk RC-3" SD-image]'''
 
  '''[https://os.zynthian.org/2019-06-26-zynthianos-stretch-lite-1.0.0-RC3.zip Download Zynthian "Aruk RC-3" SD-image]'''
  
It's a 8GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3. (Please, keep feeding the torrent after downloading!)
+
It's a 16GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3.
  
 
These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!  
 
These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!  
Line 74: Line 76:
 
===Zynthian Bundle All Kit v3===
 
===Zynthian Bundle All Kit v3===
  
A Zynthian Kit is a set of specific and generic electronic modules designed or picked for building a Zynthian Box. This tutorial refers to the ''official'' Zynthian Bundle All Kit v3, that is composed of these specific parts:
+
A Zynthian Kit is a set of specific and generic electronic parts. This tutorial refers to the ''official'' Zynthian Bundle All Kit v3, that is composed of these specific parts:
  
  + '''4 x Controller Modules''' (rotary encoder + switch)
+
  + '''4 x Controller Modules + Wiring'''  
  + '''1 x Zynaptik Module'''
+
  + '''1 x Zynaptik Module:''' MIDI Ports + extended I/O
 +
+ '''1 x ZynScreen 3.5':''' Touch-Display + Controllers circuit
 
  + '''1 x Main ribbon bus cable'''
 
  + '''1 x Main ribbon bus cable'''
+ '''Wiring Kit with JST connectors'''
 
  
[[File:Photo-not-available.jpg|600px]]
+
[[File:IMG_2461.JPG|600px]]
  
 
these generic parts:
 
these generic parts:
  
 
  + '''1 x Raspberry Pi 3'''
 
  + '''1 x Raspberry Pi 3'''
  + '''1 x Hifiberry DAC+ADC''' (also pro & lite)
+
  + '''1 x Hifiberry DAC+ADC'''
+ '''1 x ZynScreen 3.5' Touch-Display'''
+
  
[[File:Photo-not-available.jpg|600px]]
+
[[File:IMG_2377.JPG|600px]]
  
Of course, other arrangements and combinations are possible. You can easily configure your hardware using the [http://wiki.zynthian.org/index.php/Configuration_Users_Guide Webconf Tool], or if it doesn't work, tweaking from the [http://wiki.zynthian.org/index.php/Command_Line_User_Guide command line].
+
and the aluminium case:  
  
You can take a look to some of the alternate builds made by some community members:
 
 
- [https://discourse.zynthian.org/t/a-build-with-variations/324 A build with variations, by vagnscott]
 
- [https://discourse.zynthian.org/t/another-wiring/333 Another Wiring, by Imager]
 
- [https://discourse.zynthian.org/t/success-cases/41 Success Cases]
 
 
and customized case:
 
 
  + '''1 x Zynthian Aluminium Case'''
 
  + '''1 x Zynthian Aluminium Case'''
 
  + '''1 x Connectors'''
 
  + '''1 x Connectors'''
 
  + '''1 x Bolts & Nuts'''
 
  + '''1 x Bolts & Nuts'''
  
[[File:Photo-not-available.jpg|600px]]
+
[[File:IMG_2379.JPG|600px]]
 
+
[[File:IMG_2384.JPG|600px]]
This case is available as a [http://odoo.zynthian.org/shop/product/zynthian-aluminium-case-kit-v2-262?category=4  kit], including all the needed connectors, knobs, bolts & nuts.
+
If you intend to use a different soundcard or display, probably it won't fit the case and you will have to modify it. Of course, you can build your own customized case. Here you can find some examples from the community:
+
 
+
- [[Zynthian_Images_Enclosures|Zynthian Enclosures]]
+
- [https://discourse.zynthian.org/t/success-cases/41 Success Cases]
+
  
 
=Assembling your Zynthian Box=
 
=Assembling your Zynthian Box=
Line 116: Line 105:
 
===Prerequisites===
 
===Prerequisites===
  
Assembling your own Zynthian Box is not very difficult, but you will need your attention and screwdriver. Read the instructions and observe the detailed photos carefully. If you get in trouble you can ask the community:
+
Assembling your Zynthian Kit V3 is not difficult at all: you need your attention, a screwdriver and an adjustable wrench. The kit v3 is a pre-built kit and you don't need to solder anything, just screwdrive the bolts and plug the wires.
 +
 
 +
Read the instructions and observe the detailed photos carefully. If you get in trouble you can ask the community:
  
 
  https://discourse.zynthian.org
 
  https://discourse.zynthian.org
  
===Assemble the Main Computing Block===
+
===Secure the Jack connectors===
  
The main computing block is composed by the RBPi and the HifiBerry soundcard, and should be assembled using the next set of separator & bolts:
+
Insert every connector from the inner-side of the case and the ring washers and nuts from the outer-side. The ring-washers will avoid damaging the case surface when you tighten the nuts. A wrench or pair of pliers can be useful for tightening the nuts.
  
[[File:IMG_1293.JPG|400px]]
+
[[File:IMG_2397.JPG|600px]]
 +
[[File:IMG_2398.JPG|600px]]
  
For easier assembling, you should follow the next steps:
+
===Secure the MIDI connectors===
  
1. fix the 2x4 separators to the RBPi. The bigger one must be on top and the smaller one on bottom.
+
Just insert every connector with the JST-wire from the outer-side of the case and the nut from the inner-side. A wrench or pair of pliers can be useful for tightening the nuts.
2. insert the Hifiberry soundcard in the RBPi.  
+
3. screw the 4 bolts on top of the HifiBerry.
+
  
[[File:IMG_1353.JPG|600px]]
+
[[File:IMG_2401.JPG|600px]]
 +
[[File:IMG_2402.JPG|600px]]
  
[[File:Photo-not-available.jpg|600px]]
+
===Mount the MIDI activity LEDS===
  
[[File:photo-not-available.jpg|600px]]
+
Insert the 3 LEDS in the case holes, leaving the short lead at left. Don't push the LED's head! Instead push the black plastic holder around the LED. Sometimes is hard to push ...
  
===Secure the Main Computing Block===
+
[[File:IMG2403.JPG|600px]]
  
After assembling the main computing block, you should secure it to the case. Use 4 black M2.5 bolts (see photo above).
 
  
[[File:photo-not-available.jpg|600px]]
+
When it's done, you have to plug the LED wires into the 2 spare "DUPONT" connectors from the MIDI harness (green & yellow wires). Polarity is important, so don't cross the wires:
  
===Secure the Zynaptik module===
+
* JST Green wire (1) => LED's Anode (LED's long lead)
 +
* JST Yellow wire (2) => LED's Cathode (LED's short lead)
  
Secure the Zynaptik module to the case using 4 x separators and 8 x M2.5 bolts.
+
As the LED's leads are too long, you would like to cut them a little bit (7-8 mm is a good length), but remember where the "short" lead is located!!
  
[[File:IMG_1294.JPG|400px]]
+
[[File:IMG2406.JPG|600px]]
  
[[File:photo-not-available.jpg|600px]]
+
===Assemble the Main Computing Block===
  
===Secure the Jack connectors===
+
The main computing block is composed by the RBPi and the HifiBerry soundcard, and should be assembled using the next set of separator & bolts:
  
Put the rings on the outer side of the case to avoid damaging the case surface when you tighten the nuts.
+
[[File:IMG_1293.JPG|600px]]
  
[[File:photo-not-available.jpg|600px]]
+
For easier assembling, you should follow the next steps:
  
===Secure the MIDI-IN/OUT/THRU connectors===
+
1. Fix the 2x4 separators to the RBPi. The bigger one must be on top and the smaller one on bottom.
 +
2. Insert the Hifiberry soundcard in the RBPi.
 +
3. Screwdrive the 4 bolts on top of the HifiBerry.
  
Just insert the connector with the JST-wire from the out-side of the case and the nut from the innerside. A pair of pliers can be useful for tighten.
+
[[File:IMG_1353.JPG|600px]]
  
[[File:photo-not-available.jpg|600px]]
+
[[File:IMG_2393.JPG|600px]]
  
===Mount the MIDI activity LEDS===
+
[[File:IMG_2395.JPG|600px]]
  
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.
+
===Secure the Main Computing Block===
  
[[File:photo-not-available.jpg|600px]]
 
[[File:IMG_2365.JPG|600px]]
 
  
When it's done, you have to plug the 2 LED wires (red/black) with the 2 spare wires on the MIDI JST harness (green/yellow). Polarity is important, so don't cross the wires:
+
After assembling the main computing block, you should secure it to the case. Use 4 black M2.5 bolts (see photo above).
 +
 
 +
 
 +
[[File:IMG 2407.JPG|600px]]
 +
 
 +
===Secure the Zynaptik module===
 +
 
 +
Secure the Zynaptik module to the case using 4 x separators and 8 x M2.5 bolts. I recommend to start fixing the separators to the case.
 +
 
 +
[[File:IMG_1294.JPG|400px]]
 +
 
 +
[[File:IMG_2410.JPG|600px]]
  
* JST Green wire (1) => LED's Anode (LED's red wire/long lead)
 
* JST Yellow wire (2) => LED's Cathode (LED's black wire/short lead)
 
  
[[File:photo-not-available.jpg|600px]]
+
As you can see, the zynaptik circuit has some extra circuitry that is not soldered on it by default. Don't worry about it because it's not needed at all for building a fully functional standard Zynthian Box.
  
 
===Secure the Display===
 
===Secure the Display===
Line 186: Line 186:
 
It's composed of 4 bolts, 4 nuts and 4 nylon separators. Before fixing the screen, don't forget to remove the protective plastic sheet.
 
It's composed of 4 bolts, 4 nuts and 4 nylon separators. Before fixing the screen, don't forget to remove the protective plastic sheet.
  
[[File:photo-not-available.jpg|600px]]
+
[[File:IMG_2423.JPG|600px]]
  
 
===Secure the Controllers===
 
===Secure the Controllers===
  
Plug a wire in  every controller.
+
Plug a wire on every controller.
  
 
[[File:Rotary&wire.JPG|600px]]
 
[[File:Rotary&wire.JPG|600px]]
Line 209: Line 209:
 
===Stick the rubber feet===
 
===Stick the rubber feet===
  
[[File:Zynthian_mounting_case_bottom.jpg|600px]]
+
[[File:IMG 2536.JPG|600px]]
  
 
=Connecting everything=
 
=Connecting everything=
  
The Zynthian Kit 3 is designed to use JST connectors, so connecting everything is really straight-forward:
+
The Zynthian Kit 3 is designed to use JST connectors that can't be plugged reversed, so connecting everything is really straight-forward:
  
* Connect the Main Ribbon Bus cable to the RBPi's 40-pin header and also to the Zynaptik module
+
* Connect the Main Ribbon Bus cable to the RBPi's 40-pin header and also to the Zynaptik module. The red wire is pin 1, so if you are looking at the case from the front side, it should be at right.
  
 
[[File:Ribbon.jpeg|600px]]
 
[[File:Ribbon.jpeg|600px]]
 
 
[[File:Ribbon&Hifi&Zynaptik.JPG|600px]]
 
[[File:Ribbon&Hifi&Zynaptik.JPG|600px]]
  
* Connect the 4 double JST cables to the 4 controller connectors on the ZynScreen (CTRL1, CTRL2, CTRL3, CTRL4)
+
 
 +
* Connect the 4 controller cables to the 4 controller connectors on the ZynScreen (CTRL1, CTRL2, CTRL3, CTRL4)
  
 
[[File:ZynScreenConnect.JPG|600px]]
 
[[File:ZynScreenConnect.JPG|600px]]
  
* Connect the 3 JST cables from the MIDI connectors to the MIDI-IN, MIDI-OUT and MIDI-THRU connectors on the Zynaptik module.  
+
 
 +
* Connect the 3 cables from the MIDI connectors to the MIDI-IN, MIDI-OUT and MIDI-THRU connectors on the Zynaptik module.  
  
 
[[File:MIDIConnector.JPG|600px]]
 
[[File:MIDIConnector.JPG|600px]]
  
* Connect the Jack connector to the auxiliar audio-out connector on the HifiBerry soundcard. It's the 3-pin JST connector that you soldered before:
 
  
[[File:photo-not-available.jpg|600px]]
+
* Connect the audio output jack connectors to the audio-output header on the Hifiberry soundcard:
 +
 
 +
[[File:dacplus-adc-top audio-out.jpg|600px]]
 +
[[File:IMG_2414.JPG|600px]]
 +
 
 +
 
 +
The black wire on the "R" pin, white on the "L" one and red on "GND" (middle).
 +
 
 +
 
 +
* Connect the balanced audio input jack connector to the audio-input header on the Hifiberry soundcard:
 +
 
 +
[[File:dacplus-adc-top audio-in.jpg|600px]]
 +
[[File:IMG_2416.JPG|600px]]
 +
 
 +
 
 +
The black wire should be connected to pin 3, red wire to pin 2 and white wire to pin 1. Looking at the first photo, numbering is left to right.
  
 
===Connect the Display===
 
===Connect the Display===
  
And finally, connect the ribbon's 26-pin connector to the Display's male side connector. '''Put attention to the orientation'''. The red wire should be the pin 1 that as marked in the display's PCB surface.
+
And finally, connect the ribbon's 26-pin connector to the display's connector. '''Put attention to the orientation'''. The red wire should be the pin 1 that as marked in the display's PCB surface.
  
 
[[File:Screen&Ribbon.JPG|600px]]
 
[[File:Screen&Ribbon.JPG|600px]]
 +
  
 
At this point, your Zynthian Box should look something like this:
 
At this point, your Zynthian Box should look something like this:
 +
  
 
[[File:Precierre.JPG|600px]]
 
[[File:Precierre.JPG|600px]]
Line 250: Line 267:
  
 
It's easy to make a mistake while assembling the parts or connecting the wires. Some errors can be dangerous for the electronic components (short-circuits, some specific bad-wiring combinations) so it's better to be sure that everything is correctly assembled and connected.
 
It's easy to make a mistake while assembling the parts or connecting the wires. Some errors can be dangerous for the electronic components (short-circuits, some specific bad-wiring combinations) so it's better to be sure that everything is correctly assembled and connected.
 +
 +
Put special attention to ribbon bus connection and verify that red wire is on pin 1 for every connector. Also put attention to audio jack connectors and check that they are correctly connected to the Hifiberry soundcard.
  
 
===First Boot===
 
===First Boot===
  
When you are pretty sure that everything is in its place, it's time to boot by first time, so:
+
When you are sure that everything is in its place, it's time to boot the machine, so:
  
  1. Insert the SD-card with the zynthian image ready to run. If you don't have one yet, [[#Zynthian_Software|read this]].
+
  1. Insert the SD-card with the zynthian image ready to run. If you don't have one yet, [[#Zynthian_Software|read this]]. You can insert the SD-card through the "window" on the bottom-side of the case. Also, if the case is still open, you can do it from the top.
  2. Plug the mini-usb power conector. A good 5V micro-usb charger is recommended (> 2 Amp).
+
  2. Plug the mini-usb power connector. A good 5V micro-usb charger is recommended (> 2 Amp).
  
If you are using a SD image pre-configured for the Zynthian Kits v3, these are the stages that you should see while booting:
+
These are the stages that you should see while booting:
  
  1. Initially, the display must go white
+
  1. After 5-10 seconds, it will show the Zynthian splash screen
2. After 5-10 seconds, it will show the Zynthian splash screen
+
  2. After 3-4 seconds, it will go black
  3. After 1-2 seconds, it will go black
+
  3. If you are using a fresh zynthian image and it's the first boot, the stages 1 and 2 will be repeated
  4. If you are using a fresh zynthian image and it's the first boot, the stages 2 and 3 will be repeated
+
  4. After 5-10 seconds, the zynthian UI will be shown
  5. After 5-10 seconds, the zynthian UI will be shown
+
  
 
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_1562.JPG|600px]]
+
[[file:IMG_2490.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 you don't get an error screen or a blank screen, 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 v3, then you should configure your Zynthian Box's hardware using the [[Configuration_Users_Guide|webconf tool]]. These are the adjustments you have to do:
+
If you are using the Aruk RC-3 SD image (you should!), you will note that the controllers are not working at all. This SD image is pre-configured for working with the kit v2, so you need to configure the software for working with the kit v3. The simplest way of doing it is using the webconf tool:
  
* '''Display:''' PiScreen 3.5 (v2)
+
* Connect your zynthian to your local network using an ethernet cable (RJ-45).
* '''Audio:''' HifiBerry DAC+
+
* From your web browser, access the zynthian's webconf tool by typing "zynthian.local" in the address bar. If this doesn't work for you, you should try with the IP. You can get the IP of your zynthian by navigating to the Admin Menu and clicking "Network Info". You should do that by using the "touch" interface: Click the top bar with a stick (or your nail, if it's not too wide) until you are in the Admin Menu. Once you are there, go down and click "Network Info".
* '''Wiring:''' MCP23017_ENCODERS
+
* Type the password (''raspberry'') for login into the webconf tool.
* '''Style:''' FontSize = 14
+
* Once you are logged in, you have to access Hardware->Kit and select "Kit V3".
 +
* Save the changes and reboot your Zynthian.
  
===Test the Controllers===
+
===Test the Controllers & UI===
  
If you get into the Zynthian UI, then you should be in the 'Layer Selection' screen. Let's start testing that your controllers are working OK.  
+
If you get into the Zynthian UI, then you should be in the 'Layer list' screen. Let's start testing that your controllers are working OK.  
  
  1. Push 'select' to create a new layer. You should get into the 'Engine Selection' screen.  
+
  1. Rotate the SELECT controller up & down for selecting the different options in the Layers menu.  
  
[[File:IMG_1563.JPG|600px]]
+
2. Push SELECT to create a New 'Synth Layer'. You should get into the 'Engine Selection' screen.
  
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.
+
[[File:IMG_2496.JPG|600px]]
  
2. Rotate the 'SELECT' controller to select the engine you want to start for the new layer.  
+
If it doesn't works, try rotating/pushing the 'learn/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.
+
3. Rotate the SELECT controller to choose the engine you want to instance for the new layer.  
  
3. Select the ZynAddSubFX engine, select channel #1, bank and preset. You should get into the 'Instrument Control' screen.
+
The selector must go down when rotating clockwise and go up when rotating counter-clockwise. If the rotation sense is reversed, you should check the wiring. Perhaps some harness is faulty. The wires color sequence should be: red, black, yellow, green.
  
[[File:IMG_1568.JPG|600px]]
+
4. Select the ZynAddSubFX engine, select channel #1, bank 'Collection' and preset 'Metal Drips'.  
  
4. Rotate every control to test that it works and that the rotation sense is correct.  
+
[[File:IMG_2497.JPG|600px]]
  
If some controller doesn't work correctly, check the wiring again. You could try to figure what is happening by analizing the observed behaviour.
+
You should get into the 'Instrument Control' screen.
  
5. Push 'BACK'. You should go back to the 'Preset Selection' screen.  
+
[[File:IMG_2500.JPG|600px]]
  
  6. Push 'Layer' again to return to the 'Layer Selection' screen. Try to create another layer following the same procedure.
+
  5. Rotate every control to test that it works and that the rotation sense is correct.  
  
[[File:IMG_1584.JPG|600px]]
+
If some controller doesn't work correctly, check the wiring again. You could try to figure what is happening by analyzing the observed behaviour.
  
  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.
+
  6. Push SELECT to move to the next controller screen. Bold push to select a controller screen from the list.
  
If everything is working OK, then you should read the [[Zynthian_Users_Guide|User's Guide]] and start enjoying your Zynthian Box, but before that ...
+
7. Push BACK. You should go back to the 'Preset Selection' screen.
 +
 
 +
[[File:IMG_2499.JPG|600px]]
 +
 
 +
8. Push BACK again. You should go back to the 'Bank Selection' screen.
 +
 
 +
[[File:IMG_2498.JPG|600px]]
 +
 
 +
9. Push LAYER again to return to the 'Layer Selection' screen. Try to create another layer following the same procedure.
 +
 
 +
[[File:IMG_2509.JPG|600px]]
 +
 
 +
10. Push 'SNAPSHOT' to get into the 'Snapshot' screen. Select 'New Snapshot' and your first snapshot will be stored.
 +
 
 +
[[File:IMG_2506.JPG|600px]]
 +
 
 +
If everything is working OK, then you should read the [[Zynthian_Users_Guide|User's Guide]] and start enjoying your Zynthian Box, but before that ... why not enjoying a little bit? Connect your MIDI keyboard, your speakers and check this out:
 +
 
 +
Bank 'net-wisdom', Preset 'Vangelis Saw - C'
 +
 
 +
Keep pushing a single note (or a chord) and move the cutoff and resonance controllers. Enjoy! ;-)
  
 
===Test the Audio Output===
 
===Test the Audio Output===
Line 324: Line 363:
  
 
  1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
 
  1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
  2. Boot your Zynthian, select FluidSynth engine, channel #1 and 'FluidR3 GM' bank. Select some instrument.
+
  2. Boot your Zynthian, select FluidSynth engine, channel #1 and 'TimGM6mb' bank. Select some instrument, like "Piano 1".
 
  3. You could add more layers for completing the band ;-)
 
  3. You could add more layers for completing the band ;-)
 
  3. Push BACK, holding the switch pushed more than 2 seconds. You should get into the 'Admin' screen.
 
  3. Push BACK, holding the switch pushed more than 2 seconds. You should get into the 'Admin' screen.
Line 344: Line 383:
  
 
  1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
 
  1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
  2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and instrument
+
  2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and instrument.
  3. Connect your keyboard's MIDI-OUT to the Zynthian's MIDI-IN using a MIDI cable. The keyboard should be configured to use channel #1.
+
  3. Connect your keyboard's MIDI-OUT to the Zynthian's MIDI-IN using a MIDI cable.
 
  3. After 2-3 seconds, play something with your keyboard. OK! A single melody can do the task. You should hear your song ;-)
 
  3. After 2-3 seconds, play something with your keyboard. OK! A single melody can do the task. You should hear your song ;-)
  
Line 356: Line 395:
 
===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.
+
Take your time to see how to bend and drive the cables to get a good fitting when closing the case. The ribbon bus cable is pre-bended for easing this process.
 +
 
  
 
[[File:Precierre.JPG|600px]]
 
[[File:Precierre.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]]
+
 
 +
[[File:ZynthianFront.jpg|600px]]
  
 
=Update your Zynthian Box=
 
=Update your Zynthian Box=
Line 368: Line 410:
 
If you are using the official Zynthian SD Image, the first thing you should do after booting up your Zynthian Box and having the controllers working OK is update the software:
 
If you are using the official Zynthian SD Image, the first thing you should do after booting up your Zynthian Box and having the controllers working OK is update the software:
  
  - connect the Zynthian Box to your router using a RJ45 cable
+
  - connect your Zynthian Box to your router using an ethernet cable
  - '''update zynthian software''' from the admin menu
+
  - from the admin menu, click '''update software'''
  - '''update zynthian library''' from the admin menu
+
  - from the admin menu, click '''restart UI''' (or '''reboot''')
- '''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.
 +
 +
You can also update the software using the webconf tool, or from the command line.
  
 
=Locating and Solving problems=
 
=Locating and Solving problems=
Line 379: Line 422:
 
In this section i will try to give you some tips for locating and solving the problems you may have.
 
In this section i will try to give you some tips for locating and solving the problems you may have.
  
For finding and solving problems, i really recommend to connect a HDMI display to the RBPi. It will give you accurate information during the booting sequence. Also, if you connect a USB keyboard, you can login into the system and get extra information, inspect the logs, etc.
+
For finding and solving problems, i really recommend to connect a HDMI display to the RBPi. It will give you accurate information during the booting sequence. Also, if you connect an USB keyboard, you could login into the system and get extra information, inspect the logs, etc.
  
===The display don't go white in the boot stage 1===
+
===The display don't show the zynthian splash screen on boot===
  
I recommend you disconnect the controller and 2in1 modules and try to boot again.
+
In that case, probably the system is not booting correctly. You could try to connect a HDMI display and see if the system is booting. If you can't see the booting sequence, then you should re-burn your SD-card with the Zynthian image. Also, check that your image file is correct by using the SHA1 signature.
If the problem persist it's very probable you haven't solder correctly the side 26-pin connector. You should double check the connector and be sure that it's correctly soldered.
+
  
===The display don't show the zynthian splash screen in the boot stage 2===
+
===You get the zynthian error screen with the IP===
  
In that case, probably the system is not booting correctly. You could try to connect a HDMI display and see if the system is booting. If you can't see the booting sequence, then you should re-burn your SD-card with the Zynthian image. Also, check that your image file is correct by using the SHA1 signature.
+
Your hardware seems to be incorrectly configured. You should access the webconf tool and configure your hardware.
 +
 
 +
===Your controllers doesn't work===
  
'''More coming soon ...'''
+
You make a mistake while connecting the controllers or your hardware (wiring layout) is incorrectly configured. You should access the webconf tool and configure your hardware.
  
 
===You can't solve the problem===
 
===You can't solve the problem===
Line 405: Line 449:
  
 
You can find all this info and much more in the project's [https://github.com/zynthian/zynthian-hw Hardware Repository].
 
You can find all this info and much more in the project's [https://github.com/zynthian/zynthian-hw Hardware Repository].
 
===Electrical Schematic===
 
 
This is the electrical scheme of the All-In-One circuit:
 
 
[[File:Zynthian_allinone.sch.svg|800px]]
 
 
===RBPi GPIO===
 
 
[[File:Raspberry-Pi-j8header-2b.png|400px]]
 

Latest revision as of 22:37, 17 July 2019

Introduction

This tutorial is mainly intended for those who are building a Zynthian Box using one of the official kits, that i offer here:

Zynthian Shop

Specifically, the instructions are for the assembly of kits v3 (version 3), those using the Zynaptik circuit and the ZynScreen v1.4 display.


ZynthianFront.jpg

ZynthianBack.jpg

Bill of Materials

  • Zynthian Basic Kit v3 (4 x controller v3 + zynaptic circuit + ribbon bus cable)
  • ZynScreen v1.4 (3.5" touch-display + controller driver)
  • Raspberry Pi 3
  • HifiBerry DAC+ADC souncard
  • Case kit v3, including nuts, bolts and connectors
  • Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector)
  • 16GB SD Card (a good one, please!)

Some definitions

Zynthian

It's an open project with the goal of creating an Open Synth Platform based in Free Software and Open Hardware Specifications & Designs (when available). It's a community-driven project. If you are here, probably you already know all this ;-)

Zynthian Software

The Zynthian Software stack consist of:

+ GNU Linux Operating System: Raspbian Jessie (Minibian is used in the most recent SD images)
+ Jack Audio Daemon
+ A collection of standalone Synth Engines & LV2 Plugins (see Supported Synth Engines & Plugins)
+ MOD-HOST + MOD-UI software, from ModDevices (github repositories)
+ Zynthian User Interface (github repository)
+ Zynthian Webconf Tool (github repository)

All the software used by Zynthian is Free Software (free as in freedom, not as in free beer) and it's covered by the GPL license or similar. If you don't know what i'm talking about, please, take a look to this:

What is Free Software?

The easiest way of getting the software is downloading the last official SD image from here:

Download Zynthian "Aruk RC-3" SD-image

It's a 16GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3.

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 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 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 this link.

Finally, if you like, you can build your own SD image following these instructions:

Building the SD Image using the Setup Script

Zynthian Box

A Zynthian Box is a hardware device, a small digital computer designed to run the Zynthian Software. Currently it's based in the Raspberry Pi platform, but it could be easily adapted to other computer platforms.

This is a sketch with the main blocks of the official Zynthian Box:

Zynthian hardware scheme.png

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:

- Zynthian Hardware Repository
- Zynthian Case Repository

The official version is the canonical reference. Of course, you don't have to build the official version. You can build your customized Zynthian Box modifying and improving what you want. If you do so, some feedback would be very appreciated ;-)

Zynthian Bundle All Kit v3

A Zynthian Kit is a set of specific and generic electronic parts. This tutorial refers to the official Zynthian Bundle All Kit v3, that is composed of these specific parts:

+ 4 x Controller Modules + Wiring 
+ 1 x Zynaptik Module: MIDI Ports + extended I/O
+ 1 x ZynScreen 3.5': Touch-Display + Controllers circuit
+ 1 x Main ribbon bus cable

IMG 2461.JPG

these generic parts:

+ 1 x Raspberry Pi 3
+ 1 x Hifiberry DAC+ADC

IMG 2377.JPG

and the aluminium case:

+ 1 x Zynthian Aluminium Case
+ 1 x Connectors
+ 1 x Bolts & Nuts

IMG 2379.JPG IMG 2384.JPG

Assembling your Zynthian Box

Prerequisites

Assembling your Zynthian Kit V3 is not difficult at all: you need your attention, a screwdriver and an adjustable wrench. The kit v3 is a pre-built kit and you don't need to solder anything, just screwdrive the bolts and plug the wires.

Read the instructions and observe the detailed photos carefully. If you get in trouble you can ask the community:

https://discourse.zynthian.org

Secure the Jack connectors

Insert every connector from the inner-side of the case and the ring washers and nuts from the outer-side. The ring-washers will avoid damaging the case surface when you tighten the nuts. A wrench or pair of pliers can be useful for tightening the nuts.

IMG 2397.JPG IMG 2398.JPG

Secure the MIDI connectors

Just insert every connector with the JST-wire from the outer-side of the case and the nut from the inner-side. A wrench or pair of pliers can be useful for tightening the nuts.

IMG 2401.JPG IMG 2402.JPG

Mount the MIDI activity LEDS

Insert the 3 LEDS in the case holes, leaving the short lead at left. Don't push the LED's head! Instead push the black plastic holder around the LED. Sometimes is hard to push ...

IMG2403.JPG


When it's done, you have to plug the LED wires into the 2 spare "DUPONT" connectors from the MIDI harness (green & yellow wires). Polarity is important, so don't cross the wires:

* JST Green wire (1) => LED's Anode (LED's long lead)
* JST Yellow wire (2) => LED's Cathode (LED's short lead)

As the LED's leads are too long, you would like to cut them a little bit (7-8 mm is a good length), but remember where the "short" lead is located!!

IMG2406.JPG

Assemble the Main Computing Block

The main computing block is composed by the RBPi and the HifiBerry soundcard, and should be assembled using the next set of separator & bolts:

IMG 1293.JPG

For easier assembling, you should follow the next steps:

1. Fix the 2x4 separators to the RBPi. The bigger one must be on top and the smaller one on bottom.
2. Insert the Hifiberry soundcard in the RBPi. 
3. Screwdrive the 4 bolts on top of the HifiBerry.

IMG 1353.JPG

IMG 2393.JPG

IMG 2395.JPG

Secure the Main Computing Block

After assembling the main computing block, you should secure it to the case. Use 4 black M2.5 bolts (see photo above).


IMG 2407.JPG

Secure the Zynaptik module

Secure the Zynaptik module to the case using 4 x separators and 8 x M2.5 bolts. I recommend to start fixing the separators to the case.

IMG 1294.JPG

IMG 2410.JPG


As you can see, the zynaptik circuit has some extra circuitry that is not soldered on it by default. Don't worry about it because it's not needed at all for building a fully functional standard Zynthian Box.

Secure the Display

For fixing the display to the case cover, you have to use this set:

IMG 1295.JPG

It's composed of 4 bolts, 4 nuts and 4 nylon separators. Before fixing the screen, don't forget to remove the protective plastic sheet.

IMG 2423.JPG

Secure the Controllers

Plug a wire on every controller.

Rotary&wire.JPG

Fix the 4 controller modules to the case cover using the 4 bolts and washers attached to every rotary encoder.

ZynScreen&Controller.JPG

IMG 1401.JPG

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

IMG 2536.JPG

Connecting everything

The Zynthian Kit 3 is designed to use JST connectors that can't be plugged reversed, so connecting everything is really straight-forward:

  • Connect the Main Ribbon Bus cable to the RBPi's 40-pin header and also to the Zynaptik module. The red wire is pin 1, so if you are looking at the case from the front side, it should be at right.

Ribbon.jpeg Ribbon&Hifi&Zynaptik.JPG


  • Connect the 4 controller cables to the 4 controller connectors on the ZynScreen (CTRL1, CTRL2, CTRL3, CTRL4)

ZynScreenConnect.JPG


  • Connect the 3 cables from the MIDI connectors to the MIDI-IN, MIDI-OUT and MIDI-THRU connectors on the Zynaptik module.

MIDIConnector.JPG


  • Connect the audio output jack connectors to the audio-output header on the Hifiberry soundcard:

Dacplus-adc-top audio-out.jpg IMG 2414.JPG


The black wire on the "R" pin, white on the "L" one and red on "GND" (middle).


  • Connect the balanced audio input jack connector to the audio-input header on the Hifiberry soundcard:

Dacplus-adc-top audio-in.jpg IMG 2416.JPG


The black wire should be connected to pin 3, red wire to pin 2 and white wire to pin 1. Looking at the first photo, numbering is left to right.

Connect the Display

And finally, connect the ribbon's 26-pin connector to the display's connector. Put attention to the orientation. The red wire should be the pin 1 that as marked in the display's PCB surface.

Screen&Ribbon.JPG


At this point, your Zynthian Box should look something like this:


Precierre.JPG

Testing your Zynthian Box

And that's all. Your Zynthian Box is almost ready to boot. I recommend that you double-check everything before trying to boot.

Double-check part's assembling and wiring

It's easy to make a mistake while assembling the parts or connecting the wires. Some errors can be dangerous for the electronic components (short-circuits, some specific bad-wiring combinations) so it's better to be sure that everything is correctly assembled and connected.

Put special attention to ribbon bus connection and verify that red wire is on pin 1 for every connector. Also put attention to audio jack connectors and check that they are correctly connected to the Hifiberry soundcard.

First Boot

When you are sure that everything is in its place, it's time to boot the machine, so:

1. Insert the SD-card with the zynthian image ready to run. If you don't have one yet, read this. You can insert the SD-card through the "window" on the bottom-side of the case. Also, if the case is still open, you can do it from the top.
2. Plug the mini-usb power connector. A good 5V micro-usb charger is recommended (> 2 Amp).

These are the stages that you should see while booting:

1. After 5-10 seconds, it will show the Zynthian splash screen
2. After 3-4 seconds, it will go black
3. If you are using a fresh zynthian image and it's the first boot, the stages 1 and 2 will be repeated
4. After 5-10 seconds, the zynthian UI will be shown

If you get the Zynthian UI, congratulations!!! You are really close to get it!!

IMG 2490.JPG

If you don't get an error screen or a blank screen, bad luck! Probably you made some mistake during the mounting process. You have to locate and solve the problem(s).

If you are using the Aruk RC-3 SD image (you should!), you will note that the controllers are not working at all. This SD image is pre-configured for working with the kit v2, so you need to configure the software for working with the kit v3. The simplest way of doing it is using the webconf tool:

  • Connect your zynthian to your local network using an ethernet cable (RJ-45).
  • From your web browser, access the zynthian's webconf tool by typing "zynthian.local" in the address bar. If this doesn't work for you, you should try with the IP. You can get the IP of your zynthian by navigating to the Admin Menu and clicking "Network Info". You should do that by using the "touch" interface: Click the top bar with a stick (or your nail, if it's not too wide) until you are in the Admin Menu. Once you are there, go down and click "Network Info".
  • Type the password (raspberry) for login into the webconf tool.
  • Once you are logged in, you have to access Hardware->Kit and select "Kit V3".
  • Save the changes and reboot your Zynthian.

Test the Controllers & UI

If you get into the Zynthian UI, then you should be in the 'Layer list' screen. Let's start testing that your controllers are working OK.

1. Rotate the SELECT controller up & down for selecting the different options in the Layers menu. 
2. Push SELECT to create a New 'Synth Layer'. You should get into the 'Engine Selection' screen.

IMG 2496.JPG

If it doesn't works, try rotating/pushing the 'learn/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.

3. Rotate the SELECT controller to choose the engine you want to instance for the new layer. 

The selector must go down when rotating clockwise and go up when rotating counter-clockwise. If the rotation sense is reversed, you should check the wiring. Perhaps some harness is faulty. The wires color sequence should be: red, black, yellow, green.

4. Select the ZynAddSubFX engine, select channel #1, bank 'Collection' and preset 'Metal Drips'. 

IMG 2497.JPG

You should get into the 'Instrument Control' screen.

IMG 2500.JPG

5. Rotate every control to test that it works and that the rotation sense is correct. 

If some controller doesn't work correctly, check the wiring again. You could try to figure what is happening by analyzing the observed behaviour.

6. Push SELECT to move to the next controller screen. Bold push to select a controller screen from the list.
7. Push BACK. You should go back to the 'Preset Selection' screen. 

IMG 2499.JPG

8. Push BACK again. You should go back to the 'Bank Selection' screen. 

IMG 2498.JPG

9. Push LAYER again to return to the 'Layer Selection' screen. Try to create another layer following the same procedure.

IMG 2509.JPG

10. Push 'SNAPSHOT' to get into the 'Snapshot' screen. Select 'New Snapshot' and your first snapshot will be stored.

IMG 2506.JPG

If everything is working OK, then you should read the User's Guide and start enjoying your Zynthian Box, but before that ... why not enjoying a little bit? Connect your MIDI keyboard, your speakers and check this out:

Bank 'net-wisdom', Preset 'Vangelis Saw - C'

Keep pushing a single note (or a chord) and move the cutoff and resonance controllers. Enjoy! ;-)

Test the Audio Output

1. Connect the audio output (RCA or Jack connectors) to your amplifier or auto-amplified speakers.
2. Boot your Zynthian. You should be in the initial 'Layer Selection' screen.
3. Push BACK and you will get into the 'Admin' screen.
4. Select 'Audio Test' option and push 'SELECT'. You should hear the test audio-track: a nice afrocuban stuff ;-)
5. Push 'BACK' to stop the playing, and 'BACK' again to return to the "Layer Selection' screen.

If you hear nothing, please, check the amplifier, speakers, cabling, gain, volume, etc. If nothing works, you have to locate and solve the problem(s).

Test the MIDI subsystem

1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
2. Boot your Zynthian, select FluidSynth engine, channel #1 and 'TimGM6mb' bank. Select some instrument, like "Piano 1".
3. You could add more layers for completing the band ;-)
3. Push BACK, holding the switch pushed more than 2 seconds. You should get into the 'Admin' screen.
4. Select 'MIDI Test' option and push 'SELECT'. You should hear the test midi-track ('Take Five') interpreted by your Zynthian's band ;-)
5. Push 'BACK' to stop the playing

If you hear nothing, please, check the amplifier, speakers, cabling, gain, volume, etc. If nothing works, you have to locate and solve the problem(s).

Test the MIDI-USB inputs

1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and instrument
3. Connect a MIDI-USB keyboard to any USB port. The keyboard should be configured to use channel #1.
3. After 2-3 seconds , play something with your keyboard. A simple Chopin's Nocturni would be enough. You should hear your music. If you don't like it, probably you should take some piano lessons, same as me ;-)

If this doesn't work, you have to locate and solve the problem(s).

Test the MIDI-IN connector

1. Connect the audio output (RCA or Jack connector) to your amplifier or auto-amplified speakers.
2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and instrument.
3. Connect your keyboard's MIDI-OUT to the Zynthian's MIDI-IN using a MIDI cable.
3. After 2-3 seconds, play something with your keyboard. OK! A single melody can do the task. You should hear your song ;-)

If this doesn't work, you have to locate and solve the problem(s).

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. The ribbon bus cable is pre-bended for easing this process.


Precierre.JPG


Finally, screw-drive the 8 sheet-threader bolts for securing the case, 4 each side.


ZynthianFront.jpg

Update your Zynthian Box

If you are using the official Zynthian SD Image, the first thing you should do after booting up your Zynthian Box and having the controllers working OK is update the software:

- connect your Zynthian Box to your router using an ethernet cable
- from the admin menu, click update software
- from the admin menu, click restart UI (or reboot)

The update process can take some time. Be patient. If you get some ERROR message while updating, please, ask in the forum. You can send a photo or description of the error message.

You can also update the software using the webconf tool, or from the command line.

Locating and Solving problems

In this section i will try to give you some tips for locating and solving the problems you may have.

For finding and solving problems, i really recommend to connect a HDMI display to the RBPi. It will give you accurate information during the booting sequence. Also, if you connect an USB keyboard, you could login into the system and get extra information, inspect the logs, etc.

The display don't show the zynthian splash screen on boot

In that case, probably the system is not booting correctly. You could try to connect a HDMI display and see if the system is booting. If you can't see the booting sequence, then you should re-burn your SD-card with the Zynthian image. Also, check that your image file is correct by using the SHA1 signature.

You get the zynthian error screen with the IP

Your hardware seems to be incorrectly configured. You should access the webconf tool and configure your hardware.

Your controllers doesn't work

You make a mistake while connecting the controllers or your hardware (wiring layout) is incorrectly configured. You should access the webconf tool and configure your hardware.

You can't solve the problem

If you can't find a solution for your problem, ask the community:

https://discourse.zynthian.org

Also, if you found a solution for a problem not described here, please send feedback to the community, or better, edit this wiki! ;-)

Technical Reference

Finally, i have included here some detailed schemes. People hacking the standard Zynthian design would find it very useful. Also, if you have some problem and need to "debug", you would find it useful too.

You can find all this info and much more in the project's Hardware Repository.