Changes

Jump to navigation Jump to search
Line 2: Line 2:  
=Introduction=
 
=Introduction=
   −
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:
 +
 
 +
[http://shop.zynthian.org Zynthian Shop]
 +
 
 +
Specifically, the instructions are for the assembly of kits v1 (version 1), those using the 2in1 circuit and the PiTFT 2.8' display. If you have a newer kit v2, based in the All-In-One circuit and the PiScreen 3.5' display, you better should read [[Building a Zynthian Box using an official Kit v2 | this updated tutorial]].
   −
[https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]
      
[[File:Zynthian_finished_02.jpg|600px]]
 
[[File:Zynthian_finished_02.jpg|600px]]
Line 11: Line 14:     
=Bill of Materials=
 
=Bill of Materials=
* Zynthian Basic Kit (custom PCBs, electronic parts, wiring and knobs) [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, with nuts, bolts and case connectors [https://discourse.zynthian.org/t/zynthian-kits/150/17 Getting a Zynthian Kit]
+
* Case kit, with nuts, bolts and case connectors. Visit the [http://shop.zynthian.org Zynthian Shop]
 
* Raspberry Pi 3 (or Raspberry Pi 2)
 
* Raspberry Pi 3 (or Raspberry Pi 2)
* HifiBerry DAC+ https://www.adafruit.com/product/2901
+
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+]
* TouchScreen LCD display PiTFT 2.8"
+
* PiTFT 2.8' TouchScreen
** https://www.adafruit.com/product/2298 Resistive touchscreen (less expensive)
+
** [https://www.adafruit.com/product/2298 Resistive touchscreen] (less expensive)
** https://www.adafruit.com/product/2423 Capacitive touchscreen (better touch response)
+
** [https://www.adafruit.com/product/2423 Capacitive touchscreen] (better touch response)
* Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector) https://www.adafruit.com/product/1995
+
* Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector)
    
=Some definitions=
 
=Some definitions=
Line 42: Line 45:  
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:
   −
  '''[https://discourse.zynthian.org/t/merry-zynthians-and-happy-new-sd-image/314 Download Zynthian "Gorgona" SD-image]'''
+
  '''[https://os.zynthian.org/zynthianos-last-stable.zip Download Last Stable ZynthianOS SD-image ]'''
 +
 
 +
It's a 8GB compressed image file (plenty of soundfonts) compiled for Raspberry Pi 3. (Please, keep feeding the torrent after downloading!)
 +
 
 +
These SD card images include all the Zynthian software, properly configured for working with the official kits. Completely ready to use. Plug and play!
   −
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 a SDcard. You need a SD card with a minimum size of 16GB, although you can use a bigger one if you want.
   −
After downloading the SD-image, you have to write it to a 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/ this link].
+
Use Etcher https://etcher.io/ (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 prefer, you can build your own SD image following these instructions:
 
If you prefer, you can build your own SD image following these instructions:
Line 58: Line 67:  
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:
Line 84: Line 93:  
  + '''1 x Adafruit PiTFT 2.8' ScreenTouch (or clonic)'''
 
  + '''1 x Adafruit PiTFT 2.8' ScreenTouch (or clonic)'''
   −
Of course, other arrangements and combinations are possible and some community members are working on them:
+
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].
 +
 
 +
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/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/another-wiring/333 Another Wiring, by Imager]
 +
- [https://discourse.zynthian.org/t/success-cases/41 Success Cases]
    
===Zynthian Case===
 
===Zynthian Case===
Line 188: Line 200:     
  + 1 x 2in1 PCB
 
  + 1 x 2in1 PCB
  + 1 x opto-coupler 6N138 => 8 pins IC
+
+ 1 x GPIO-expander MCP23008 => 18-pin IC
  + 1 x dioode 1N4148 (D1)
+
  + 1 x opto-coupler 6N138 => 8-pin IC
 +
  + 1 x diode 1N4148 (D1)
 
  + 1 x resistor 1K (R1) => brown-black-red (*)
 
  + 1 x resistor 1K (R1) => brown-black-red (*)
 
  + 1 x resistor 10K (R2) => brown-black-orange (*)
 
  + 1 x resistor 10K (R2) => brown-black-orange (*)
 
  + 1 x resistor 220 (R3) => red-red-brown (*)
 
  + 1 x resistor 220 (R3) => red-red-brown (*)
+ 1 x MCP23008 => 18 pins IC
   
  + 2 x ceramic capacitor 100nF (C1, C2)
 
  + 2 x ceramic capacitor 100nF (C1, C2)
  + 1 x 8-row-pin male connector (angle)
+
  + 1 x 8-row-pin male-angle connector
 
  + 1 x 6-row-pin male connector
 
  + 1 x 6-row-pin male connector
 
  + 1 x 2-row-pin male connector
 
  + 1 x 2-row-pin male connector
Line 341: Line 353:     
[[File:zynthian_mounting_controllers.jpg|600px]]
 
[[File:zynthian_mounting_controllers.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===
Line 557: Line 576:  
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 a USB keyboard, you can 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 doesn't go white in boot stage 1===
    
I recommend you disconnect the controller and 2in1 modules and try to boot again.
 
I recommend you disconnect the controller and 2in1 modules and try to boot again.
 
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.
 
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===
+
===The display doesn't show the Zynthian splash screen in boot stage 2===
    
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 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.
 +
 +
===The display is completely white===
 +
The latest SD Gorgona Edge image is pre-configured for the new v2 Kit. As you are using a Kit v1, you should access the Webconf tool (see [[Configuration_Users_Guide]]) using your browser and change these options:
 +
 +
Display: PiTFT 2.8’ Resistive
 +
Wiring Layout: PROTOTYPE-4
 +
Style -> Font Size: 10
    
'''More coming soon ...'''
 
'''More coming soon ...'''

Navigation menu