View source for Building a Zynthian Box using an official Kit


=Introduction=

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

 [https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]

Anyway, it's quite detailed and can be used as a guide to build your Zynthian Box from scratch. Of course, you will have to be more creative if you want to do it in that way ;-)

=Some definitions=

===Zynthian===

It's a project with the goal of creating an Open Synth Platform. It's a community-driven project. If you are here, probably you already know this ;-)

===Zynthian Software===

The Zynthian Software stack consist of:

 * GNU Linux Operating System: Raspbian Jessie (Minibian is used in the last SD images)
 * Jack Audio Daemon
 * MOD-HOST + MOD-UI software, from [http://moddevices.com ModDevices]
 * A collection of standalone Synth Engines & LV2 Plugins
 * Zynthian User Interface

All the software used by Zynthian is Free Software (free as freedom) 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: [https://www.gnu.org/philosophy/free-sw.en.html What is Free Software?]

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

 [https://discourse.zynthian.org/t/merry-zynthians-and-happy-new-sd-image/314 Download Zynthian "Gorgona" SD-image]

This SD-image include all the zynthian software, properly configured and ready to use. Plug and play! ;-)

After downloading the SD-image, you have to write it to an SD-card. Depending on your OS you have to choose how to create the SD-card. You need a minimum size of 16GB for the full "Gorgona" image and 8GB for the "Gorgonilla" lite image. There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ https://www.raspberrypi.org/documentation/installation/installing-images/].

If you prefer, you can build your own SD image following these instructions:

 [https://discourse.zynthian.org/t/new-sd-image-setup-script/283 Building the SD Image using the Setup Script]

===Zynthian Box===

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

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

[[File:Zynthian_hardware_scheme.png|600px]]

And this is the electric scheme of a Zynthian Box, excluding soundcard and display:

[[File:Zynthian_scheme_GPIO.png|600px]]

In the project repositories you will find all the electric schemes, PCB specifications, Herber files, etc. to build your own zynthian box from scratch:

 * [https://github.com/zynthian/zynthian-hw Zynthian Hardware Repository]
 * [https://github.com/zynthian/zynthian-case Zynthian Case Repository]

===Zynthian Kit===

A Zynthian Kit is a set of SPECIFIC electronic modules designed for building a Zynthian Box. This tutorial refers to the "canonical" zynthian kit, that is composed of:

 * 4 x Controller Modules (rotary encoder + switch)
 * 1 x 2in1 Module (GPIO expander + MIDI IN)
 * Main ribbon bus cable
 * Dupont color-wire connectors

[[File:Zynthian_kit_ensambled.jpg|600px]]

Of course, other arrangements are possible and some people is working in different ones:

 * [https://discourse.zynthian.org/t/a-build-with-variations/324]
 * [https://discourse.zynthian.org/t/another-wiring/333]

===Zynthian Case===

It's the enclosure used to put on all the parts. Again, this tutorial refers to the "cannonical" zynthian aluminum case, that is designed to be used in conjunction with the next parts:

 + Raspberry Pi 2/3
 + Soundcard HifiBerry DAC+ (also pro & lite)
 + Display Adafruit PiTFT 2.8" touchscreen (or clonic version)

The case is available as a kit, with all the needed connectors, knobs, bolts & nuts:

[[File:Zynthian_aluminum_case_kit.jpg|600px]]

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 case like other people has done:

 * [[Zynthian_Images_Enclosures|Zynthian Enclosures]]
 * [https://discourse.zynthian.org/t/success-cases/41 Success Cases]


[[File:4xcontroller_single_kit.jpg|600px]]


[[File:2in1_kit.jpg|600px]]