Difference between revisions of "Building Zynthian MINI V2"

From ZynthianWiki
Jump to navigation Jump to search
Line 1: Line 1:
 
[[File:Zynthian-on-piano-02.png|thumb]]
 
[[File:Zynthian-on-piano-02.png|thumb]]
 +
 +
<gallery>
 +
Example.jpg|Caption1
 +
Example.jpg|Caption2
 +
</gallery>
  
 
Zynthian Mini kit is a cost effective approach to build zynthian with intention to give opportunity:
 
Zynthian Mini kit is a cost effective approach to build zynthian with intention to give opportunity:
 
* to zynthian developers to get functional zynthian similar to v5 where they can do most of the testing
 
* to zynthian developers to get functional zynthian similar to v5 where they can do most of the testing
 
* to musician to get to know zynthian and learn their features before deciding to but the professional kit
 
* to musician to get to know zynthian and learn their features before deciding to but the professional kit
 
To save the cost of the build Zynthian MINI is lucking capabilities that some of professional musicians really need on stage such as audio-in, TRS audio connectors, best in class DAC for audio out or a rigid metal case.
 
  
 
The main features of zynthian MINI are:
 
The main features of zynthian MINI are:
Line 17: Line 20:
 
** full enclosure that can be 3d printed
 
** full enclosure that can be 3d printed
 
* all connectors are easy to reach (V1 does not have RPI connectors aligned to the edge of the PCB)
 
* all connectors are easy to reach (V1 does not have RPI connectors aligned to the edge of the PCB)
 +
 +
To save the cost of building the Zynthian MINI, we had to sacrifice certain features that some professional musicians would need on the stage such as:
 +
* no audio-in
 +
* no TRS audio connectors
 +
* not best in the class DAC for audio out
 +
* no rigid metal case
 +
* no zynaptik analog inputs
  
 
Zynthian is currently at version 2. Previous version 1 was more similar to official V4 kit with only 4 buttons but it is not maintained anymore.
 
Zynthian is currently at version 2. Previous version 1 was more similar to official V4 kit with only 4 buttons but it is not maintained anymore.
Line 166: Line 176:
 
* Package: RCA RS-234  
 
* Package: RCA RS-234  
 
* Quantity: 1   
 
* Quantity: 1   
* Where to buy: https://www.aliexpress.com/item/1005001629197904.html  
+
* Where to buy: https://www.aliexpress.com/item/1005001629197904.html
 +
 
 
=== Soldering ===
 
=== Soldering ===
  
Line 241: Line 252:
 
[[File:Rpi to pcb.png|400px]]
 
[[File:Rpi to pcb.png|400px]]
  
=== Configure Zynthian MINI V2 for testing ===
+
== Configure Zynthian MINI V2 for testing ==
 +
 
 +
Download the latest zynthian development branch from os.zynthian.org following this [https://os.zynthian.org/2024-05-04-zynthianos-bookworm-aarch64-oram-2405.zip link].
 +
 
 +
Flash this image to sd card with a size of at least 32GB.
 +
 
 +
Put the SD card into raspberry Pi and connect zynthian mini to power by connecting USB-C power adapter to Raspberry Pi board. Use correct power adapter.
 +
 
 +
Optionally you can also connect zynthian mini to network using network cable attached to Raspberry Pi.
 +
 
 +
Wait for zynthian to start. Zynthian screen will be wrongly oriented, encoders and their push button will not work. Also none of 20 additional push buttons will work. For all this to be configured we need first to get all latest software updates that will also include required options to configure zynthian mini v2.
 +
 
 +
=== Connect to zynthian web UI to update zynthian software ===
 +
 
 +
If you have not connected zynthian to your network using network cable you will need to configure zynthian wifi first. You can do this on the screen even though screen is wrongly oriented by
 +
* touching the top corner of the screen
 +
* selecting admin option
 +
* selecting wifi enable option
 +
* selecting your network
 +
* entering your wifi password
 +
 
 +
You will need to find out zynthian IP address by long touching top left corner of the screen where it says "Mixer" which will open the admin page and then scroll down to Network info. Select network info where you will be able to see IP address if zynthian is properly connected to your network.
 +
 
 +
Open browser on another computer and type zynthian IP addrese into browser's address bar. You will be prompted to login to zynthian web configuration UI. Oram default password is "opensynth".
 +
 
 +
=== Update zynthian oram software ===
 +
 
 +
After loging to zynthian web configuration UI click on "Software" from top navigation bar and click on "Update".
 +
 
 +
[[File:Config-step-01.png|400px]]
 +
 +
Wait until the software is updated. You need to make sure that it says "Update Complete" at the end of the logs.
 +
 
 +
[[File:Config-step-02.png|400px]]
 +
 
 +
Once you have updated the software restart the zynthian by clicking "System" option from top navigation and then selecting "Reboot".
 +
 
 +
[[File:Config-step-03.png|400px]]
 +
 
 +
[[File:Config-step-04.png|400px]]
 +
 
 +
=== Configuring zynthian mini v2 as a kit ===
 +
 
 +
Once zynthian oram software is updated and zynthian restarted you can configure most of zynthian MINI hardware simple by selecting the Mini V2 Kit. To do that click on "Hardware" from top bar navigation and select Kit option. On this screen select "Mini V2" kit and Save.
 +
 
 +
[[File:Config-step-05.png|400px]]
 +
 
 +
Once it is saved you will need to click on restart at the bottom of the Save page.
 +
 
 +
[[File:Config-step-06.png|400px]]
 +
 
 +
Now all hardware is configured and should work properly. Screen orientation should be correct, proper sound card selected, all encoders and switches should work properly. What is left is just few screen UI adjustments.
 +
 
 +
=== Adjusting UI for Zynthian layout ===
 +
 
 +
Zynthian Mini V2 has all encoders on the right and therefore corresponding UI widgets need to be always on the right instead of left and right that is default configuration. Also by default cursor is visible which is not necessary when there is a touch screen. To set these two options click on "Interface" from top navigation bar and select "UI options". On this screen set the field called "Graphic layout" to "Knobs at right side (Z2, V5, MINI)" and also deselect "Enable cursor" option.
 +
 
 +
[[File:Config-step-07.png|400px]]
  
 +
Restart the Zynthian mini after the all configuration is done.
  
 
Once everything is configured and working it is a time to put zynthian into the enclosure.  
 
Once everything is configured and working it is a time to put zynthian into the enclosure.  
  
=== Assembling Zynthian MINI V2 into 3d printable enclosure ===
+
== Assembling Zynthian MINI V2 into 3d printable enclosure ==

Revision as of 09:12, 6 May 2024

Zynthian-on-piano-02.png

Zynthian Mini kit is a cost effective approach to build zynthian with intention to give opportunity:

  • to zynthian developers to get functional zynthian similar to v5 where they can do most of the testing
  • to musician to get to know zynthian and learn their features before deciding to but the professional kit

The main features of zynthian MINI are:

  • include encoders and switches that controll zynthian software in the same way as official zynthian v5 kit using the MCP23017 i/o extender
  • include MIDI IN, MIDI OUT and MIDI THRU
  • include a I2S DAC for AUDIO OUT based on PMC5102 chip that is affordable to buy
  • does not need any cabling inside for easy assembling
  • does not need the case to test it but it include design of two type of enclosure
    • simple enclosure that only cover the top and bottom part of the device that can be also produced in the same way as PCBs
    • full enclosure that can be 3d printed
  • all connectors are easy to reach (V1 does not have RPI connectors aligned to the edge of the PCB)

To save the cost of building the Zynthian MINI, we had to sacrifice certain features that some professional musicians would need on the stage such as:

  • no audio-in
  • no TRS audio connectors
  • not best in the class DAC for audio out
  • no rigid metal case
  • no zynaptik analog inputs

Zynthian is currently at version 2. Previous version 1 was more similar to official V4 kit with only 4 buttons but it is not maintained anymore.

To assemble zynthian mini V2 version you will require:

  • PCB that need to be produced based on KiCad design that you can find in zynthian hardware repository.
  • Components that need to be soldered to this PCB.
  • 5" Screen
  • Raspberry Pi 4 with heatsink
  • optional: zynthian MINI V2 3d printable case

1 Assembling the PCB

NOTE: Do not be confused that some of the instruction images shown here do not fully align to V2 PCB layout. This is because they are taken with original MINI V2 PCB that had few issues that are now fixed and therefore some small change will be there. Always read the label of the component on the PCB if confused.

1.1 Components required

Components v2.jpg

1. Capacitors - Electrolytic - Polarized

2. Capacitor - Electrolytic - Polarized

3. Capacitor - Film - Non-Polarized

4. Capacitors - Ceramic - Non-Polarized 100n and 10n

5. Diode

6. MIDI Connectors - PCB mountable

7. Resistors

8. Resistor

9. Resistor

10. Digital Optocoupler

11. Hex inverting Schmitt trigger

12. Sound Card PCM5102

13. I/O Expander

14. 2x20 Pin Header - male and female

15. Encoder with a Switch

16. Encoder Cap

17. Push Button

18. 5" DSI Screen for Raspberry Pi

19. Raspberry Pi 4 4GB with heatsink

20. 1/4 Stereo jack

21. RCA Stereo jack

1.2 Soldering

First get PCB and all components sorted by their type. Check their values using digital multimeter to make sure that you have them properly sorted.

Heat up the solder iron and make sure that its tip is clean. If not put some solder on it and clean it with wet sponge. It has to be shiny silver tip.

Start by soldering back side of the PCB. Order of soldering is always from smallest to tallest components.

First solder resistors and diode and microchips such as Digital optocoupler (H11L1M), hex inverting schmitt trigger (74HCT14) and I/O Expander (MCP23017). Pay attention to orientation of these microchips.

Soldering-step-1.png

Solder the ceramic and film capacitors at the back of PCB (orientation not important - they are non polarized).

Soldering-step-2.png

Then solder film and ceramic capacitors at the front (orientation not important - they are non polarized).

Soldering-step-3.png

Then solder female and male headers

Soldering-step-4.png

Then solder two electrolytic capacitors. Pay attention to their orientation.

Soldering-step-5.png

Then solder sound card. First solder male header pins that came with the card and the solder it to PCB board.

Soldering-step-6.png

Make sure that you have cut sound card pins - they are too long and they will touch the screen if you leave them as it is.

Soldering-step-7.png

Then solder three MIDI connectors.

Soldering-step-8.png

Then solder the switches.

Soldering-step-9.png

Finally solder the encoders. After soldering them cut any excess wires because that side will be very close to RPI heatsink so any contact to it must be avoided.

Soldering-step-10.png

You have finished the hard part - soldering. Now you just need to assemble everything together.

1.3 Assembling the PCB for the test

This instruction here are just assembling everything for testing. You should test it before assembling into the case.

First remove two screen posts that are not necessary and could touch some of the PCB components.

Screen post removal.png

Then connect longer cable that comes with a screen to the screen and attach the screen to PCB.

Screen cable.png

Then screw appropriate hex mounts to PCB for Raspberry Pi. Do not connect Raspberry Pi yet. The type of hex mounts will depend on heatsink that you use. Also connect the screen cable to RPI.

Rpi screen cable.png

Then connect heatsink to raspberry pi.

Rpi cooler.png

Then connect raspberry Pi to PCB.

Rpi to pcb.png

2 Configure Zynthian MINI V2 for testing

Download the latest zynthian development branch from os.zynthian.org following this link.

Flash this image to sd card with a size of at least 32GB.

Put the SD card into raspberry Pi and connect zynthian mini to power by connecting USB-C power adapter to Raspberry Pi board. Use correct power adapter.

Optionally you can also connect zynthian mini to network using network cable attached to Raspberry Pi.

Wait for zynthian to start. Zynthian screen will be wrongly oriented, encoders and their push button will not work. Also none of 20 additional push buttons will work. For all this to be configured we need first to get all latest software updates that will also include required options to configure zynthian mini v2.

2.1 Connect to zynthian web UI to update zynthian software

If you have not connected zynthian to your network using network cable you will need to configure zynthian wifi first. You can do this on the screen even though screen is wrongly oriented by

  • touching the top corner of the screen
  • selecting admin option
  • selecting wifi enable option
  • selecting your network
  • entering your wifi password

You will need to find out zynthian IP address by long touching top left corner of the screen where it says "Mixer" which will open the admin page and then scroll down to Network info. Select network info where you will be able to see IP address if zynthian is properly connected to your network.

Open browser on another computer and type zynthian IP addrese into browser's address bar. You will be prompted to login to zynthian web configuration UI. Oram default password is "opensynth".

2.2 Update zynthian oram software

After loging to zynthian web configuration UI click on "Software" from top navigation bar and click on "Update".

Config-step-01.png

Wait until the software is updated. You need to make sure that it says "Update Complete" at the end of the logs.

Config-step-02.png

Once you have updated the software restart the zynthian by clicking "System" option from top navigation and then selecting "Reboot".

Config-step-03.png

Config-step-04.png

2.3 Configuring zynthian mini v2 as a kit

Once zynthian oram software is updated and zynthian restarted you can configure most of zynthian MINI hardware simple by selecting the Mini V2 Kit. To do that click on "Hardware" from top bar navigation and select Kit option. On this screen select "Mini V2" kit and Save.

Config-step-05.png

Once it is saved you will need to click on restart at the bottom of the Save page.

Config-step-06.png

Now all hardware is configured and should work properly. Screen orientation should be correct, proper sound card selected, all encoders and switches should work properly. What is left is just few screen UI adjustments.

2.4 Adjusting UI for Zynthian layout

Zynthian Mini V2 has all encoders on the right and therefore corresponding UI widgets need to be always on the right instead of left and right that is default configuration. Also by default cursor is visible which is not necessary when there is a touch screen. To set these two options click on "Interface" from top navigation bar and select "UI options". On this screen set the field called "Graphic layout" to "Knobs at right side (Z2, V5, MINI)" and also deselect "Enable cursor" option.

Config-step-07.png

Restart the Zynthian mini after the all configuration is done.

Once everything is configured and working it is a time to put zynthian into the enclosure.

3 Assembling Zynthian MINI V2 into 3d printable enclosure