228
edits
Changes
Jump to navigation
Jump to search
m
no edit summary
Line 1:
Line 1:
===Displays===+===Audio interface===+===Before you go for it===+
−===Displays and interfaces===+====HDMI+USB Interface ====+====DSI - Display Serial Interface ====+
+
+
+
+
+
+
+===Foreword===+===The Raspberry Pi===+
−===The display===+====Zynscreen v1.5====+=I/O hardware=
−===Controls: Rotary encoders===
−* The MCP23017 port expander isn't really mandatory. You can choose to go with just the touch interface and there's nothing more to talk about or you can use an HDMI or DSI display. In that case, you will free up enough Rbpi GPIOs to wire the encoders directly to the Pi GPIOs (3 GPIOs per encoder). This setup could be configured through the webconf tool and is explained here.
−* When using a self made MCP23017 setup, you can use any free GPIO you want for INTA and INTB interrupts as they are configurable through the webconf tool.
−===The MIDI interface===
−===The audio side===
=Zynthian hardware=
=Zynthian hardware=
If you want to explore creating a DIY Zynthian install with various custom hardware, you will find more info here.
If you want to explore creating a DIY Zynthian install with various custom hardware, you will find more info here.
+
+* For the most hassle free experience a full kit is recommended as it is well documented and supported and comes with a full set of instructions for assembly
+* If you want to build a custom kit with minimal or no soldering, that's possible by finding port expanders, buttons and encoders on PCBs with built-in pins
+* If you are comfortable with a soldering iron, you can create a more robust and reliable control interface (with more choices for parts) arranged on a prototype board
+
= The official Zynthian kit =
= The official Zynthian kit =
As of late 2024 the kit version is v5.1 (which supports Raspberry Pi 5), it can be purchased by visiting the [http://shop.zynthian.org/ Zynthian shop]. You can also purchase some individual parts if you want to build a custom version that will better fit your needs.
As of late 2024 the kit version is v5.1 (which supports Raspberry Pi 5), it can be purchased by visiting the [http://shop.zynthian.org/ Zynthian shop]. You can also purchase some individual parts if you want to build a custom version that will better fit your needs.
Line 23:
Line 28:
= Compatible hardware =
= Compatible hardware =
−The Zynthian web configuration tool has several options to adapt the system to different kind of hardware. Be aware that only the kit parts are officially supported, others have been reported to work at a given time but could not work anymore.
+The Zynthian [[Web_Configuration_User_Guide | web configuration tool]] has several options to adapt the system to different kind of hardware. Be aware that only the kit parts are officially supported, others have been reported to work at a given time but could not work anymore.
−==Displays==
Below is the list of the hardware that can be configured with the [[Web_Configuration_User_Guide | Webconf tool]] and the kind of interface they use. This list is certainly out of date, for an up to date list, refer to the '''HARDWARE > Displays''' menu within the Webconf interface of your Zynthian install.
Below is the list of the hardware that can be configured with the [[Web_Configuration_User_Guide | Webconf tool]] and the kind of interface they use. This list is certainly out of date, for an up to date list, refer to the '''HARDWARE > Displays''' menu within the Webconf interface of your Zynthian install.
* PiScreen 3.5 (v2) GPIO-only
* PiScreen 3.5 (v2) GPIO-only
Line 55:
Line 60:
* Generic 4k HDMI Display
* Generic 4k HDMI Display
−==Audio interface==
* HifiBerry DAC+ ADC PRO
* HifiBerry DAC+ ADC PRO
* HifiBerry DAC+ ADC
* HifiBerry DAC+ ADC
Line 84:
Line 89:
'''Note:''' most of the USB sound cards should work out of the box with the "Generic USB device" settings.
'''Note:''' most of the USB sound cards should work out of the box with the "Generic USB device" settings.
−=Other hardware: Parts sourced in some Chinese shop.=
+=Other hardware=
−==Before you go for it - A note on random Chinese parts ordered online==
'''Note:''' You are on your own when trying to make them work with Zynthian. Some can be well supported by Zynthian software as they are clones from some well knowns products, some will work with more or less hassles and some will just not work at all.
'''Note:''' You are on your own when trying to make them work with Zynthian. Some can be well supported by Zynthian software as they are clones from some well knowns products, some will work with more or less hassles and some will just not work at all.
'''Advice:''' Be careful when trying to use any kind of "installer script" as they can override a Zynthian configuration file. It is always a good idea to test these kind of hardware on a stock Raspberry Pi OS and to study what's already done by the installer script.
'''Advice:''' Be careful when trying to use any kind of "installer script" as they can override a Zynthian configuration file. It is always a good idea to test these kind of hardware on a stock Raspberry Pi OS and to study what's already done by the installer script.
==Displays and interfaces==
Many of them are Waveshare clones, look at them carefully and especially to the GPIO pins they use and to the chips used to control the display and the touch interface.
Many of them are Waveshare clones, look at them carefully and especially to the GPIO pins they use and to the chips used to control the display and the touch interface.
'''Avoid displays that are using parallel, RGB or DPI interface'''.
'''Avoid displays that are using parallel, RGB or DPI interface'''.
Line 98:
Line 103:
Upon spending some time looking at various Raspberry Pi compatible screens it will become clear the most typical connections are either DSI or HDMI+USB.
Upon spending some time looking at various Raspberry Pi compatible screens it will become clear the most typical connections are either DSI or HDMI+USB.
−===HDMI+USB Interface ===
These appear to be the most commonly available and at the time of writing generally cheaper than DSI.
These appear to be the most commonly available and at the time of writing generally cheaper than DSI.
Line 104:
Line 109:
'''Upsides''' There are more options and types of screens available with this interface (narrow bezel)
'''Upsides''' There are more options and types of screens available with this interface (narrow bezel)
−===DSI - Display Serial Interface ===
The benefit of this interface for your DIY Zynthian is the compact flat cables for connecting the display that will leave
The benefit of this interface for your DIY Zynthian is the compact flat cables for connecting the display that will leave
+
'''Downsides''' At the time of writing there were no narrow bezel screens available from waveshare using DSI </br>
'''Downsides''' At the time of writing there were no narrow bezel screens available from waveshare using DSI </br>
'''Upsides''' Simplified cable setup. Doesn't require any USB ports
'''Upsides''' Simplified cable setup. Doesn't require any USB ports
−===Audio Boards ===
+Roundup of 10 Raspberry Pi compabtible displays here:
+<embedvideo alignment="inline" dimensions="451" service="youtube" description="10 Touchscreen monitors for Raspberry Pi.">hhttps://youtu.be/TVDdvaAKcnw</embedvideo>
+<br>
+==Audio Boards ==
Try to identify the DAC, ADC or CODEC chip
Try to identify the DAC, ADC or CODEC chip
* with pcm5102, pcm5102a or es9023 chips, boards should be supported as hifiberry-dac light.
* with pcm5102, pcm5102a or es9023 chips, boards should be supported as hifiberry-dac light.
Line 115:
Line 125:
* With SGTL5000 Fe-Pi audio board should be compatible.
* With SGTL5000 Fe-Pi audio board should be compatible.
−===Port expander & rotary encoders===
+=I/O hardware connections=
+Depending on the hardware used for your custom Zynthian, you may have a number of spare GPIO pins available that can be used to connect rotary encoders or buttons. These can then be assigned numbers in the Webconf wiring page to make them usable in Zynthian.
+===Direct to Raspberry Pi GPIO===
+===Via MCP23017 Port Expander===
+==Port expander & rotary encoders==
* The MCP23017 port expander can be found as SMD component mounted on a small breakout board. No bad experiences have been reported with them.
* The MCP23017 port expander can be found as SMD component mounted on a small breakout board. No bad experiences have been reported with them.
* You may find some rotary encoders already mounted on a small PCB: they do not fit to the schematic (have some pull up resistors and need to be powered) and bring usually many hassles.
* You may find some rotary encoders already mounted on a small PCB: they do not fit to the schematic (have some pull up resistors and need to be powered) and bring usually many hassles.
+
+
+==Controls: Rotary encoders==
+* The MCP23017 port expander isn't really mandatory. You can choose to go with just the touch interface and there's nothing more to talk about or you can use an HDMI or DSI display. In that case, you will free up enough Rbpi GPIOs to wire the encoders directly to the Pi GPIOs (3 GPIOs per encoder). This setup could be configured through the webconf tool and is explained here.
+* When using a self made MCP23017 setup, you can use any free GPIO you want for INTA and INTB interrupts as they are configurable through the webconf tool.
+
+==The MIDI interface==
+
+==The audio side==
+
+[[File:Switches encoders buttons.jpg|frameless|300px|Some different pieces that can be connected to Zynthian]]
+[[File:Mcp23017 breadboard.jpg|frameless|300px|MCP23017 breadboard setup]]
+[[File:Mcp23017 integrated.jpg|300px|frameless|Gravity I/O Expansion Module]]
+[[File:Prototype board pcb.jpg|x200px|frameless|Prototype board for making your circuit more permanent & robust]]
+
+=Custom Cases=
+There is a collection of information about custom cases including guides, descriptions and files available at [https://github.com/zynthian/zynthian-case the github project] for creating your own case with a 3d printer and other methods.
+
+To see a huge collection of cases built by Zynthian users, see the [https://discourse.zynthian.org/t/success-cases/41 Success Cases] thread in the forum.
=A deeper look at Zynthian Hardware architecture=
=A deeper look at Zynthian Hardware architecture=
−==Foreword==
The following is based on the kit v4.1 schematics but keep in mind that most of it is optional !
The following is based on the kit v4.1 schematics but keep in mind that most of it is optional !
One may choose to run an headless Zynthian, or with just a HDMI display and an USB and/or keyboard. Zynthian is modular enough to fits many needs a from pocket sized gear to a customized midi keyboard that will embed your build.
One may choose to run an headless Zynthian, or with just a HDMI display and an USB and/or keyboard. Zynthian is modular enough to fits many needs a from pocket sized gear to a customized midi keyboard that will embed your build.
All schematics below are from the [[Building_a_Zynthian_Box_using_an_official_Kit_v4.1#Technical_Reference|V4.1 Kit Building Tutorial]] and can also be found on Github.
All schematics below are from the [[Building_a_Zynthian_Box_using_an_official_Kit_v4.1#Technical_Reference|V4.1 Kit Building Tutorial]] and can also be found on Github.
−==The Raspberry Pi==
The Raspberry Pi is the heart of Zynthian, it runs the all the software and can be used "as is" in a headless setup. But it also communicates with all the hardware add-ons that makes a Zynthian Box.
The Raspberry Pi is the heart of Zynthian, it runs the all the software and can be used "as is" in a headless setup. But it also communicates with all the hardware add-ons that makes a Zynthian Box.
Line 189:
Line 228:
==The display==
−===Zynscreen v1.5===
[[File:ZynScreen_v15_sch.svg|800px]]
[[File:ZynScreen_v15_sch.svg|800px]]
Line 203:
Line 242:
* JP1: a 2x4 male pins header for selecting, using jumpers, the interrupts for the Zynscreen's MCP23017 port expander and the Zynaptik's MCP23017 port expander.
* JP1: a 2x4 male pins header for selecting, using jumpers, the interrupts for the Zynscreen's MCP23017 port expander and the Zynaptik's MCP23017 port expander.
* some 100nF power decoupling capacitors.
* some 100nF power decoupling capacitors.
−