2,705
edits
Changes
Jump to navigation
Jump to search
Line 39:
Line 39: − + Line 76:
Line 76: − + Line 110:
Line 110: − + Line 127:
Line 127: − + Line 184:
Line 184: − + Line 318:
Line 318: − + Line 348:
Line 348: − + Line 360:
Line 360: − + Line 410:
Line 410: − + Line 425:
Line 425: − + − + Line 435:
Line 435: − + Line 442:
Line 442: − + Line 448:
Line 448: − + Line 456:
Line 456: − + − + − + − + Line 476:
Line 476: − + − +
Building a Zynthian Box using an official Kit v3 (view source)
Revision as of 13:17, 13 January 2020
, 13:17, 13 January 2020→Test the Controllers & UI
+ '''Zynthian Webconf Tool''' ([https://github.com/zynthian/zynthian-webconf github repository])
+ '''Zynthian Webconf Tool''' ([https://github.com/zynthian/zynthian-webconf github repository])
All the software used by Zynthian is Free Software, and it's covered by the GPL license or similar. If you don't know what Free Software is, take a look at this link:
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 Free Software is, take a look at this link:
[https://www.gnu.org/philosophy/free-sw.en.html What is Free Software?]
[https://www.gnu.org/philosophy/free-sw.en.html What is Free Software?]
===Zynthian Bundle All Kit v3===
===Zynthian Bundle All Kit v3===
A Zynthian Kit is a set of electronic parts. The ''official'' Zynthian Bundle All Kit v3 consists of specific parts:
A Zynthian Kit is a set of electronic and mechanic parts. The ''official'' Zynthian Bundle All Kit v3 consists of these specific parts:
+ '''4 x Controller Modules + Wiring'''
+ '''4 x Controller Modules + Wiring'''
===Prerequisites===
===Prerequisites===
Assembling your Zynthian Kit V3 is not difficult at all: you need is your attention, a screwdriver, and an adjustable wrench. You don't need to solder anything, just put it together and connect the wires.
Assembling your Zynthian Kit V3 is not difficult at all: you need your attention, a screwdriver, and an adjustable wrench. You don't need to solder anything, just put it together and connect the wires.
Read the instructions and observe the detailed photos carefully. If you get in trouble you can ask the community:
Read the instructions and observe the detailed photos carefully. If you get in trouble you can ask the community:
===Secure the MIDI connectors===
===Secure the MIDI connectors===
Insert each MIDI from the outside and secure them with the bolt from the inside.
Insert each MIDI connector, from the outside and secure them with the bolt from the inside.
[[File:IMG_2401.JPG|600px]]
[[File:IMG_2401.JPG|600px]]
[[File:IMG_2410.JPG|600px]]
[[File:IMG_2410.JPG|600px]]
The zynaptik board has some extra circuitry which doesn't have anything soldered on it. These are used for modifying the board, and it is fully functional as it is.
The zynaptik board has some extra circuitry which doesn't have anything soldered on it. These are used for adding extra functionality to the board.
===Mount the Display===
===Mount the Display===
4. After 5-10 seconds, the zynthian UI will be shown
4. After 5-10 seconds, the zynthian UI will be shown
If you get the Zynthian UI, then you have assembled the Zynthian box correctly.
If you get the Zynthian UI, then you have assembled the Zynthian box correctly. Congratulations!
[[file:IMG_2490.JPG|600px]]
[[file:IMG_2490.JPG|600px]]
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 one of the connections are faulty. The wires' color sequence should be red, black, yellow, green.
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 one of the connections are faulty. The wires' color sequence should be red, black, yellow, green.
4. Select the ZynAddSubFX engine, select channel #1, select 'Collection' and preset 'Metal Drips' present.
4. Select the ZynAddSubFX engine, select channel #1, select bank 'Collection' and preset 'Metal Drips'.
[[File:IMG_2497.JPG|600px]]
[[File:IMG_2497.JPG|600px]]
If one of the controllers doesn't work correctly, check the wiring again.
If one of the controllers doesn't work correctly, check the wiring again.
6. Push SELECT to move to the next controller screen. Bold push (a push lasting a few seconds) to select a controller screen from the list.
6. Push SELECT to move to the next controller screen. Bold push (a push lasting about 1 second) to select a controller screen from the list.
7. Push BACK. You should go back to the 'Preset Selection' screen.
7. Push BACK. You should go back to the 'Preset Selection' screen.
2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and an instrument
2. Boot your Zynthian, select ZynAddSubFX, channel #1, bank and an instrument
3. Connect a MIDI-USB keyboard to any USB port. The keyboard should be configured to use channel #1.
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'' shouldbe enough. You should hear your music. If you don't like it, probably you should take some piano lessons, like me.
3. After 2-3 seconds , play something with your keyboard. A simple ''Chopin's Nocturni'' should be enough. You should hear your music. If you don't like it, you should probably take some piano lessons, like me.
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)]].
=Final steps=
=Final steps=
Once everything is in its place and you have tested that it works, it's time to close the case ...
Once everything is in its place and you have tested that it works, it's time to close the case
===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.
Take your time to bend and push the cables to get a good fit when closing the case. The ribbon bus cable is pre-bent to make this process easier.
Finally, screw-drive the 8 sheet-threader bolts for securing the case, 4 each side.
Finally, fasten the 8 sheet-threaded bolts to secure the case, 4 on each side.
=Update your Zynthian Box=
=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:
If you are using the official Zynthian SD Image, the first thing you should do after booting up your Zynthian Box and making the controllers are working, is update the software:
- connect your Zynthian Box to your router using an ethernet cable
- connect your Zynthian Box to your router using an ethernet cable
- from the admin menu, click '''restart UI''' (or '''reboot''')
- 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, [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 an 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.
You can also update the software using the webconf tool, or from the command line.
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 an USB keyboard, you could login into the system and get extra information, inspect the logs, etc.
For finding and solving problems, I really recommend connecting a HDMI display to the Raspberry Pi. This will show you all information during the boot process. If you connect a USB keyboard to the Pi, you can login into the system and get extra information, inspect the logs, etc.
===The display don't show the zynthian splash screen on boot===
===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.
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 boot sequence, then you should re-flash 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===
===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 hardware seems to be configured incorrectly. You should access the webconf tool and configure your hardware.
===Your controllers doesn't work===
===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 made 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===
https://discourse.zynthian.org
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! ;-)
Also, if you found a solution for a problem not described here, please send feedback to the community so others can see how you solved the problem
=Technical Reference=
=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.
Finally, I have included some detailed schematics. People hacking the standard Zynthian design would find it very useful. If you have a problem and need to "debug", you could find it useful too.
[[File:Zynthian_controller_single2_smd.svg|600px]]
[[File:Zynthian_controller_single2_smd.svg|600px]]