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. |
| | | |
− | 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 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 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 547: |
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 ...''' |