Zynthian Hardware - Revision history

Lfo: /* Direct to Raspberry Pi GPIO */

2024-12-31T05:09:00Z

Direct to Raspberry Pi GPIO

Lfo at 10:45, 30 December 2024

2024-12-30T10:45:25Z

Lfo: Adjustments & rewrites

2024-12-29T08:11:33Z

Adjustments & rewrites

Lfo: Spellcheck, format, new sub-headings, update and add info to sections

2024-12-29T07:27:06Z

Spellcheck, format, new sub-headings, update and add info to sections

Show changes

Ie51 at 19:29, 5 March 2021

2021-03-05T19:29:46Z

Ie51 at 23:49, 26 February 2021

2021-02-26T23:49:47Z

Ie51 at 23:48, 26 February 2021

2021-02-26T23:48:28Z

Ie51: Undo revision 11834 by Ie51 (talk)

2021-02-26T22:39:47Z

Undo revision 11834 by Ie51 (talk)

Ie51 at 22:35, 26 February 2021

2021-02-26T22:35:50Z

Show changes

Ie51: Create Zynthian Hardware

2021-02-26T00:44:07Z

Create Zynthian Hardware

New page

=Zynthian hardware=
You will find here more informations about Zynthian Hardware.
= The official Zynthian kit: =
Actual kit version is v4.1, 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 is, the kit consists in:
* a Raspberry Pi 4 (Raspberry Pi 3 and 3B+ are also supported but will be quickly overloaded when running too much sound engines simultaneously). The kit can be purchased with or without the Raspberry Pi if you already have one lying around.
* [https://shop.zynthian.org/shop/product/hifiberry-dac-adc-stage-378 an high end sound card], the Hifiberry DAC+ADC stage wich offers Burr Brown exas Instruments DAC (TRS 6.35mm jack stereo line out) + ADC (TRS 6.35mm jack stereo line in)
* a dedicated [https://shop.zynthian.org/shop/product/zynscreen-v1-5-361?category=16 3.5 inch touchscreen display] wich also has a port expander on board for connectig the
** [https://shop.zynthian.org/shop/product/controllers-set-v3-v4-328?category=16 4 rotary encoders] for controlling the user interface (UI)
** and the 4 assignable push buttons
* an [https://shop.zynthian.org/shop/product/zynaptik-module-330?category=16 expansion board] called Zynaptik that provides the MIDI interface (IN, OUT and THRU) and some footprints for components that are not populated: a second port expander for adding more switches and/or rotary encoders, an ADC and a DAC footprints for adding CV gates.
* a lovely but strong [http://shop.zynthian.org/shop/category/parts-v2-14 metal case]
* all the needed wires with their already mounted connectors

Building an official kit is quiet easy and procedure is [[Building_a_Zynthian_Box_using_an_official_Kit_v4.1|fullly described here]].

'''You will also need, and this is really important for having the best experience:'''
* A good quality SD Card of at least 16Gb
* a good Power Supply Unit (PSU) (5V 3A)
* a strong usb powering cable
Official Raspberry Pi PSU is highly recommended (can deliver 5.1V 3A and is shiped with an excellent USB cable) and is also [https://shop.zynthian.org/shop/product/raspberry-pi-15-3w-usb-c-power-supply-389?category=16 available in the shop].

= Other hardware =
The Zynthian web configuration tool has several options to adapt the system to different kind of hardware but be aware that only the kit parts are officialy supported, other 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 Webconf tool and the kind of interface they use.
* PiScreen 3.5 (v2) GPIO-only
* PiScreen 3.5 (v1) GPIO-only
* PiTFT 2.8 Resistive GPIO-only
* PiTFT 2.8 Capacitive GPIO-only
* PiTFT 3.5 Resistive GPIO-only
* RPi-Display 2.8 GPIO-only
* WaveShare 3.2B GPIO-only
* WaveShare 3.2C GPIO-only
* WaveShare 3.5A GPIO-only
* WaveShare 3.5B GPIO-only
* WaveShare 3.5B V2 GPIO-only
* WaveShare 4A GPIO-only
* WaveShare 4C GPIO-only
* WaveShare 4 HDMI+GPIO
* WaveShare 4.3 HDMI+GPIO
* WaveShare 5 HDMI+GPIO
* WaveShare 5 HDMI+USB
* WaveShare 7 HDMI+GPIO 1024x600
* WaveShare 7 HDMI+GPIO 800x480
* WaveShare 7 HDMI+USB
* Sainsmart 1.8 GPIO-only
* MHS35 480x320 GPIO-only
* MPI5008 800x480 GPIO-only
* Pi 7 Touchscreen Display 800x480 DSI+GPIO
* 5 inch DSI Display 800x480 DSI-only
* Generic HDMI Display
* Generic 4k HDMI Display

==Audio interface:==
* HifiBerry DAC+ ADC PRO
* HifiBerry DAC+ ADC
* HifiBerry DAC+ light
* HifiBerry DAC+ RTC
* HifiBerry Digi
* HifiBerry Amp
* AudioInjector
* AudioInjector Isolated
* AudioInjector Ultra
* IQAudio DAC
* IQAudio DAC+
* IQAudio Digi
* PiSound
* JustBoom DAC
* JustBoom Digi
* Fe-Pi Audio
* Generic USB device
* Behringer UCA222
* Behringer UMC404HD
* Behringer UMC1820
* Steinberg UR22 MKII
* Edirol UA1-EX
* Yeti Microphone
* RBPi Headphones
* RBPi HDMI

'''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.=
==Before you go for it==
'''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 hassels and some will just not work at all.

'''Advice:''' Be carefull when trying to use any kind of "installer script" as they can overide a Zynthian configuration file. It is always a good idea to test these kind of harware on a stock Raspberry Pi OS and to study what's already done by the installer script.

==Displays:==
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 ad the touch interface.
'''Avoid displays that are using parallel, RGB or DPI interface'''.

==Audio Boards: ==
Try to identify the DAC, ADC or CODEC chip
* with pcm5102, pcm5102a or es9023 chips, boards should be supported as hifiberry-dac light.
* With a pcm5122 chip boards should be supported as IQaudio DAC.
* With SGTL5000 Fe-Pi audio board should be compatible.

==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.
* 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 hassels.

=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 optionnal !
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.
==The audio side==

==The MIDI interface==

==Controls: Rotary encoders and the switches==

← Older revision		Revision as of 05:09, 31 December 2024
Line 132:		Line 132:
	===Direct to Raspberry Pi GPIO===		===Direct to Raspberry Pi GPIO===

		+	See this thread for discussion on making connections to the Pi: [https://discourse.zynthian.org/t/encoders-directly-to-the-gpio-of-the-pi-4/4728/1 Encoders directly to the GPIO of the Pi 4?]

	===Via MCP23017 Port Expander===		===Via MCP23017 Port Expander===

@@ Line 1: / Line 1: @@
 =Zynthian hardware=
 If you want to explore creating a DIY Zynthian install with various custom hardware, you will find more info here.
 = 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.
@@ Line 23: / Line 28: @@
 = 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===
+==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.
 * PiScreen 3.5 (v2) GPIO-only
@@ Line 55: / Line 60: @@
 * Generic 4k HDMI Display
-===Audio interface===
+==Audio interface==
 * HifiBerry DAC+ ADC PRO
 * 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.
-=Other hardware: Parts sourced in some Chinese shop.=
+=Other hardware=
-===Before you go for it===
+==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.
 '''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===
+==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.
 '''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.
-====HDMI+USB Interface ====
+===HDMI+USB Interface ===
 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)
-====DSI - Display Serial Interface ====
+===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
 '''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
-===Audio Boards ===
+Roundup of 10 Raspberry Pi compabtible displays here:
 Try to identify the DAC, ADC or CODEC chip
 * 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.
-===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.
 * 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.
 =A deeper look at Zynthian Hardware architecture=
-===Foreword===
+==Foreword==
 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.
 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==
 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===
+==The display==
-====Zynscreen v1.5====
+===Zynscreen v1.5===
 [[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.
 * some 100nF power decoupling capacitors.

@@ Line 25: / Line 25: @@
 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.
-===Displays:===
+===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.
 * PiScreen 3.5 (v2) GPIO-only
@@ Line 55: / Line 55: @@
 * Generic 4k HDMI Display
-===Audio interface:===
+===Audio interface===
 * HifiBerry DAC+ ADC PRO
 * HifiBerry DAC+ ADC
@@ Line 90: / Line 90: @@
 '''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:===
+===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 ad 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'''.
-===Audio Boards: ===
+====HDMI+USB Interface ====
 Try to identify the DAC, ADC or CODEC chip
 * with pcm5102, pcm5102a or es9023 chips, boards should be supported as hifiberry-dac light.
@@ Line 189: / Line 204: @@
 * some 100nF power decoupling capacitors.
-==Alternate hardware==
+=I/O hardware=
 ===Controls: Rotary encoders===

@@ Line 111: / Line 111: @@
 ==The Raspberry Pi==
-[[File:Raspberry-Pi-j8header-2b.png|thumb|right|Raspberry PI 2/3/4 40 pins header]]
 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 124: / Line 124: @@
 Pin numbers given above are the Raspberry pins numbers and as noticed on picture and because Zynthian software makes the use of the WiringPi library, they have also a specific WiringPi number wich does not correspond to the Broadcom chip pin number. So one may find usefull to have this table:
 {| class="wikitable"
@@ Line 174: / Line 176: @@
 ==The display==
-==Controls: Rotary encoders and the switches==
+===Zynscreen v1.5===
 ==The MIDI interface==
 ==The audio side==

@@ Line 49: / Line 49: @@
 * Sainsmart 1.8 GPIO-only
 * MHS35 480x320 GPIO-only
-* MPI5008 800x480 GPIO-only
+* MPI5008 800x480 HDMI+GPIO
 * Pi 7 Touchscreen Display 800x480 DSI+GPIO
 * 5 inch DSI Display 800x480 DSI-only

← Older revision		Revision as of 22:39, 26 February 2021
Line 1:		Line 1:
		+	=Zynthian hardware=
		+	You will find here more informations about Zynthian Hardware.
		+	= The official Zynthian kit: =
		+	Actual kit version is v4.1, 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 is, the kit consists in:
		+	* a Raspberry Pi 4 (Raspberry Pi 3 and 3B+ are also supported but will be quickly overloaded when running too much sound engines simultaneously). The kit can be purchased with or without the Raspberry Pi if you already have one lying around.
		+	* [https://shop.zynthian.org/shop/product/hifiberry-dac-adc-stage-378 an high end sound card], the Hifiberry DAC+ADC stage wich offers Burr Brown exas Instruments DAC (TRS 6.35mm jack stereo line out) + ADC (TRS 6.35mm jack stereo line in)
		+	* a dedicated [https://shop.zynthian.org/shop/product/zynscreen-v1-5-361?category=16 3.5 inch touchscreen display] wich also has a port expander on board for connectig the
		+	** [https://shop.zynthian.org/shop/product/controllers-set-v3-v4-328?category=16 4 rotary encoders] for controlling the user interface (UI)
		+	** and the 4 assignable push buttons
		+	* an [https://shop.zynthian.org/shop/product/zynaptik-module-330?category=16 expansion board] called Zynaptik that provides the MIDI interface (IN, OUT and THRU) and some footprints for components that are not populated: a second port expander for adding more switches and/or rotary encoders, an ADC and a DAC footprints for adding CV gates.
		+	* a lovely but strong [http://shop.zynthian.org/shop/category/parts-v2-14 metal case]
		+	* all the needed wires with their already mounted connectors
		+
		+	Building an official kit is quiet easy and procedure is [[Building_a_Zynthian_Box_using_an_official_Kit_v4.1\|fullly described here]].
		+
		+	'''You will also need, and this is really important for having the best experience:'''
		+	* A good quality SD Card of at least 16Gb
		+	* a good Power Supply Unit (PSU) (5V 3A)
		+	* a strong usb powering cable
		+	Official Raspberry Pi PSU is highly recommended (can deliver 5.1V 3A and is shiped with an excellent USB cable) and is also [https://shop.zynthian.org/shop/product/raspberry-pi-15-3w-usb-c-power-supply-389?category=16 available in the shop].
		+
		+	= Other hardware =
		+	The Zynthian web configuration tool has several options to adapt the system to different kind of hardware but be aware that only the kit parts are officialy supported, other 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 Webconf tool and the kind of interface they use.
		+	* PiScreen 3.5 (v2) GPIO-only
		+	* PiScreen 3.5 (v1) GPIO-only
		+	* PiTFT 2.8 Resistive GPIO-only
		+	* PiTFT 2.8 Capacitive GPIO-only
		+	* PiTFT 3.5 Resistive GPIO-only
		+	* RPi-Display 2.8 GPIO-only
		+	* WaveShare 3.2B GPIO-only
		+	* WaveShare 3.2C GPIO-only
		+	* WaveShare 3.5A GPIO-only
		+	* WaveShare 3.5B GPIO-only
		+	* WaveShare 3.5B V2 GPIO-only
		+	* WaveShare 4A GPIO-only
		+	* WaveShare 4C GPIO-only
		+	* WaveShare 4 HDMI+GPIO
		+	* WaveShare 4.3 HDMI+GPIO
		+	* WaveShare 5 HDMI+GPIO
		+	* WaveShare 5 HDMI+USB
		+	* WaveShare 7 HDMI+GPIO 1024x600
		+	* WaveShare 7 HDMI+GPIO 800x480
		+	* WaveShare 7 HDMI+USB
		+	* Sainsmart 1.8 GPIO-only
		+	* MHS35 480x320 GPIO-only
		+	* MPI5008 800x480 GPIO-only
		+	* Pi 7 Touchscreen Display 800x480 DSI+GPIO
		+	* 5 inch DSI Display 800x480 DSI-only
		+	* Generic HDMI Display
		+	* Generic 4k HDMI Display
		+
		+	==Audio interface:==
		+	* HifiBerry DAC+ ADC PRO
		+	* HifiBerry DAC+ ADC
		+	* HifiBerry DAC+ light
		+	* HifiBerry DAC+ RTC
		+	* HifiBerry Digi
		+	* HifiBerry Amp
		+	* AudioInjector
		+	* AudioInjector Isolated
		+	* AudioInjector Ultra
		+	* IQAudio DAC
		+	* IQAudio DAC+
		+	* IQAudio Digi
		+	* PiSound
		+	* JustBoom DAC
		+	* JustBoom Digi
		+	* Fe-Pi Audio
		+	* Generic USB device
		+	* Behringer UCA222
		+	* Behringer UMC404HD
		+	* Behringer UMC1820
		+	* Steinberg UR22 MKII
		+	* Edirol UA1-EX
		+	* Yeti Microphone
		+	* RBPi Headphones
		+	* RBPi HDMI
		+
		+	'''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.=
		+	==Before you go for it==
		+	'''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 hassels and some will just not work at all.
		+
		+	'''Advice:''' Be carefull when trying to use any kind of "installer script" as they can overide a Zynthian configuration file. It is always a good idea to test these kind of harware on a stock Raspberry Pi OS and to study what's already done by the installer script.
		+
		+	==Displays:==
		+	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 ad the touch interface.
		+	'''Avoid displays that are using parallel, RGB or DPI interface'''.
		+
		+	==Audio Boards: ==
		+	Try to identify the DAC, ADC or CODEC chip
		+	* with pcm5102, pcm5102a or es9023 chips, boards should be supported as hifiberry-dac light.
		+	* With a pcm5122 chip boards should be supported as IQaudio DAC.
		+	* With SGTL5000 Fe-Pi audio board should be compatible.
		+
		+	==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.
		+	* 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 hassels.
		+
	=A deeper look at Zynthian Hardware architecture=		=A deeper look at Zynthian Hardware architecture=
	==Foreword==		==Foreword==