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]]
    
Anyway, it's quite detailed and can be used as a guide to build a custom Zynthian Box from scratch. Of course, you will have to be creative if you want to do it in that way ;-)
 
Anyway, it's quite detailed and can be used as a guide to build a custom Zynthian Box from scratch. Of course, you will have to be creative if you want to do it in that way ;-)
 +
 +
=Bill of Materials=
 +
* 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. Visit the [http://shop.zynthian.org Zynthian Shop]
 +
* Raspberry Pi 3 (or Raspberry Pi 2)
 +
* [https://www.hifiberry.com/products/dacplus HifiBerry DAC+]
 +
* PiTFT 2.8' TouchScreen
 +
** [https://www.adafruit.com/product/2298 Resistive touchscreen] (less expensive)
 +
** [https://www.adafruit.com/product/2423 Capacitive touchscreen] (better touch response)
 +
* Power adapter for Raspberry Pi (5.1v 2.4A with microUSB connector)
    
=Some definitions=
 
=Some definitions=
Line 31: Line 44:     
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_next_rbpi3_pitft28-2017-11-14.img.torrent Download Zynthian "Gorgona Next" SD-image, configured for Kits v1]'''
 +
 +
It's a 11GB image file (plenty of soundfonts) compiled for RBPi3.
 +
 +
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]'''
 
  '''[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! ;-)
+
These SD images include all the Zynthian software, properly configured for the standard hardware -- 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.
 +
 
 +
Use Etcher https://etcher.io/ (free software works on Mac, Windows or Linux) to flash the image onto the SDcard.
   −
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].
+
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 74: Line 97:  
  + '''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 178: Line 204:     
  + 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 resistor 1K (R1) => brown-black-red
+
  + 1 x diode 1N4148 (D1)
  + 1 x resistor 10K (R2) => brown-black-orange
+
  + 1 x resistor 1K (R1) => brown-black-red (*)
  + 1 x resistor 220 (R3) => red-red-brown
+
  + 1 x resistor 10K (R2) => brown-black-orange (*)
+ 1 x MCP23008 => 18 pins IC
+
  + 1 x resistor 220 (R3) => red-red-brown (*)
 
  + 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 343: Line 369:     
====Controller Module 4-pin Dupont Wires (x 4)====
 
====Controller Module 4-pin Dupont Wires (x 4)====
 +
 +
The next scheme shows the numbering/naming used for encoders and switches:
 +
 +
[[File:zynthian_ui_legend.png]]
    
Take the 4 x "20cm 4-pin Dupont Connector Wires". These wires are used to connect the 4 controller modules to the RBPi GPIO:
 
Take the 4 x "20cm 4-pin Dupont Connector Wires". These wires are used to connect the 4 controller modules to the RBPi GPIO:
Line 543: Line 573:  
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 ...'''
Line 568: Line 605:  
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].
   −
===Electric Scheme===
+
===Electrical Schematic===
   −
This is the electric scheme of a Zynthian Box, excluding soundcard and display:
+
This is the electrical schematic of a Zynthian Box, excluding the soundcard and display:
    
[[File:Zynthian_scheme_GPIO.png|800px]]
 
[[File:Zynthian_scheme_GPIO.png|800px]]

Navigation menu