Difference between revisions of "Assembling Zynthian Kit V5.1"

From ZynthianWiki
Jump to navigation Jump to search
(Undo revision 14603 by Jofemodo (talk))
Tag: Undo
 
(102 intermediate revisions by 3 users not shown)
Line 20: Line 20:
 
* Rubber Feet (4 units)
 
* Rubber Feet (4 units)
 
* Wiring
 
* Wiring
** RBPi5 DSI display flat cable: 20cm long, 1.6cm wide, 1mm/0.5mm pitch
+
** RBPi5 DSI display flat cable: 20cm long, 1.6cm wide, 1mm/0.5mm pitch, black or orange
** Control Board flat cable: 15cm long, 1cm wide, 0.5mm pitch
+
** Control Board flat cable: 15cm long, 1cm wide, 0.5mm pitch, black or grey
** USB-C adapter + flat cable: 5cm long, 1cm wide, 0.5mm pitch
+
** USB-C adapter + flat cable: 5cm long, 1cm wide, 0.5mm pitch, black or grey
** uSD-card adapter with flat cable: 5cm long, 1cm wide, 1mm pitch
+
** uSD-card adapter with flat cable: 5cm long, 1cm wide, 1mm pitch, grey
 
* Screws
 
* Screws
 
** 12 x ISO7380 M2.5x5mm black zinc-plated steel (the smaller ones with round head)
 
** 12 x ISO7380 M2.5x5mm black zinc-plated steel (the smaller ones with round head)
Line 113: Line 113:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4112_fixed_wiki.JPG|600px|right]]
+
[[File:build51_case_bottom_01.jpeg|600px|right]]
 +
 
 +
[[File:build51_case_bottom_02.jpeg|600px|right]]
  
 
'''1.''' Look for the aluminum case bottom part in the "V5" case package:
 
'''1.''' Look for the aluminum case bottom part in the "V5" case package:
Line 125: Line 127:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4118_fixed_wiki.JPG|600px|right]]
+
[[File:build51_case_bottom_rubber_feet.jpeg|600px|right]]
  
 
'''3.''' Stick the 4 x rubber feet to the aluminum case bottom part. This will prevent scratches during the assembly process.
 
'''3.''' Stick the 4 x rubber feet to the aluminum case bottom part. This will prevent scratches during the assembly process.
Line 131: Line 133:
 
<br clear=all>
 
<br clear=all>
  
=='''Plug the display ribbon cable into the RPi4'''==
+
=='''Plug the display ribbon cable into the RPi5'''==
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4123_fixed_wiki.JPG|600px|right]]
+
[[File:build51_display_cable_rpi5.jpg|600px|right]]
  
'''1.''' Look for the display ribbon cable in the "Screen and Bits" case. It's 20cm long and 1.6cm wide:
+
'''1.''' Look for the display ribbon cable in the "Screen and Bits" case. It's not inside any plastic bag but it's laying in the cardboard box. It's 20cm long and 1.6cm wide, having different terminations on each side. Most probably it will be labeled as "Display cable 200mm", white text over black or orange cable.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4090_fixed_wiki.JPG|600px|right]]
+
[[File:build51_rpi5.jpg|600px|right]]
  
'''2.''' Look for the RPi4 compute module in the "Accessories" case.
+
'''2.''' Look for the RPi5 in the "Accessories" case.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4135_fixed_wiki.JPG|600px|right]]
+
[[File:build51_rpi5_display_cable_plugged_01.jpg|600px|right]]
 +
 
 +
[[File:build51_rpi5_display_cable_plugged_02.jpg|600px|right]]
  
'''3.''' Open the RPi4's DSI connector by softly pulling both sides of the tiny black tongue at once. When it's totally open, push the ribbon cable inside, straight, with the blue side facing out. '''All flat cables in the V5 kit are reversible, so you can take any of the 2 caps''', while taking care of placing the blue side facing out. When the cable is tightly inserted, close the connector by pushing the tongue with 2 fingers, one of each hand. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
+
'''3.''' Open the RPi5's DSI connector by softly pulling up on both sides of the tiny black/grey tongue at once. It opens only about 2mm. When it's totally open, push the ribbon cable inside, straight down, with the black shiny side at the end of the cable facing out (towards the HDMI printed on the RPi5 board). The contacts on the end of the cable that are pushed into the connector should be facing the RPi5 Ethernet socket, while taking care to have the black shiny side facing away from the Ethernet socket. When the cable is tightly inserted, close the connector by pushing down on the tongue with 2 fingers, one of each hand. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
  
 
<br clear=all>
 
<br clear=all>
Line 164: Line 168:
 
<br clear=all>
 
<br clear=all>
  
Zynthian V5.1 gets a 25% extra power from the RPi5 by overclocking the CPU up to 3 GHz. For this to work properly, we need to remove the heat generated by the RPi5's components. As we don't want a noisy fan, prone to failure,  pushing dust inside our nice case, we are using the aluminum case as a huge heat-sink. This is achieved by the thermal block, a solid aluminum block that closely contacts with the RPi5's chips and serves as a heat-highway to the aluminum case bottom, and from there, to the rest of the aluminum case. When your zynthian V5.1 is working hard, or when external temperature is high enough, you will note the aluminum case getting hot. This is good because it means the thermal block is doing its job of transferring heat from the inside to the aluminum case body, where it's dissipated to the ambient environment.  
+
The RBPi5 has a fast CPU that runs at 2.3 GHz and we need to remove the heat generated by its components. As we don't want a noisy fan, prone to failure,  pushing dust inside our nice case, we are using the aluminum case as a huge heat-sink. This is achieved by the thermal block, a solid aluminum block that closely contacts with the RPi5's chips and serves as a heat-highway to the aluminum case bottom, and from there, to the rest of the aluminum case. When your zynthian V5.1 is working hard, or when external temperature is high enough, you will note the aluminum case getting hot. This is good because it means the thermal block is doing its job of transferring heat from the inside to the aluminum case body, where it's dissipated to the ambient environment.
 +
 
 +
Zynthian V5.1 could get a 20% extra power from the RPi5 by overclocking the CPU up to 3 GHz. By default overclocking is disabled because not all RPi5 boards support overclocking, but you can try, and luckily, you will get an extra power boost. Obviously, installing correctly the thermal block will increase the chance of overclocking successfully your zynthian.
  
Having understood all this, you may realize '''this is a key step for getting your V5.1 working at 100%''' of its capacity, so don't be in a hurry and take your time to do a good job. Let's start!
+
Having understood all this, you may realize '''this is a key step for getting your V5.1 working at 100% (or more!)''' of its capacity, so don't be in a hurry and take your time to do a good job. Let's start!
  
 
<br>
 
<br>
 
--------------
 
--------------
 
<br>
 
<br>
[[File:capture000005_fixed_wiki.JPG|600px|right]]
+
[[File:build51_thermal_block_01.jpg|600px|right]]
  
 
'''1.''' Look for the thermal block in the accessories case.
 
'''1.''' Look for the thermal block in the accessories case.
Line 178: Line 184:
  
 
[[File:IMG_4045_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4045_fixed_wiki.JPG|600px|right]]
[[File:thermal_pad_cut_v51.png|450px|right]]
+
[[File:thermal_pad_cut_v51.png|570px|right]]
 
[[File:IMG_4142_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4142_fixed_wiki.JPG|600px|right]]
  
Line 185: Line 191:
 
<br>
 
<br>
  
'''3.''' Using the rule-meter and the scissors or cutter, cut 4 little pieces of thermal pad with these recommended sizes:
+
'''3.''' Using the rule-meter and the scissors or cutter, cut 4 little pieces of thermal pad with these apr sizes:
  
 
<br>
 
<br>
 
* 20 x 28 mm
 
* 20 x 28 mm
* 19 x 12 mm
+
* 19 x 12 mm => This is the most important!
 
* 14 x 9 mm
 
* 14 x 9 mm
 
* 11 x 11 mm
 
* 11 x 11 mm
Line 195: Line 201:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4156_fixed_wiki.JPG|600px|right]]
+
[[File:build51_thermal_block_02.jpg|600px|right]]
  
'''4.''' Remove the blue protective sheet from the 3 smaller pieces and stick them to the inner side of the thermal block, the one that makes contact with the RPi4. You'll recognize it because it has 3 small rectangular islands that fit the size of the 3 smaller pieces you cut out. You can use your finger to press the thermal pad and stick it. Use your fingernail to cut off the excess, if any.
+
'''4.''' Remove the blue protective sheet from the 3 smaller pieces and stick them to the inner side of the thermal block, the one that makes contact with the RPi5. You'll recognize it because it has 3 small rectangular islands that fit the size of the 3 smaller pieces you cut out. You can use your finger to stick it, pressing and extending the thermal pad. Use your fingernail to cut off the excess, if any.
  
 
<br clear=all>
 
<br clear=all>
Line 207: Line 213:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4163_fixed_wiki.JPG|600px|right]]
+
[[File:build51_rpi5_thermal_back.jpg|600px|right]]
  
 
'''6.''' Remove the transparent protective sheet from the 3 pieces of thermal pad and fix the RBPi4 compute module to the thermal block using the 4 x ISO7380 M2.5 screws.
 
'''6.''' Remove the transparent protective sheet from the 3 pieces of thermal pad and fix the RBPi4 compute module to the thermal block using the 4 x ISO7380 M2.5 screws.
Line 213: Line 219:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4188_fixed_wiki.JPG|600px|right]]
+
[[File:build51_rpi5_thermal_display_cable_bending_00.jpg|600px|right]]
 +
[[File:build51_rpi5_thermal_display_cable_bending_03.jpg|600px|right]]
 +
[[File:build51_rpi5_thermal_display_cable_bending_01.jpg|600px|right]]
 +
[[File:build51_rpi5_thermal_display_cable_bending_02.jpg|600px|right]]
 +
[[File:build51_rpi5_thermal_display_cable_bending_04.jpg|600px|right]]
 +
 
 +
'''7.''' Before installing the "RPi5 + thermal block" assembly in the main board, you must fold the display cable adequately, so it goes in the right direction. You must fold it twice, putting attention to the pictures and using your "common sense". The first fold is straight and the second one is at 45º, so you get the cable going out the RPi5 with the text "Display-cable-200mm" on the down side. We show several pictures from different angles. Zoom in as needed until you have clear how to proceed. Take your time and think twice to do once.
 +
 
 +
<br clear=all>
 +
 
 +
[[File:build51_rpi5_thermal_finished.jpg|600px|right]]
  
'''7.''' Finally, stick the remaining piece of thermal pad (27 x 20 mm) on the contact surface in the external side of the thermal block. That is, on top of the "tower" with 2 tiny holes. Follow the same procedure you already did with the 3 smaller pieces, but don't remove the transparent protective sheet yet. This will be done later, when installing the module in the aluminum case bottom.
+
'''8.''' Finally, stick the remaining piece of thermal pad (27 x 20 mm) on the contact surface in the external side of the thermal block. That is, on top of the big "tower" with 2 tiny holes. Follow the same procedure you already did with the 3 smaller pieces, but don't remove the protective sheet yet. This will be done later, when installing the module in the aluminum case bottom.
  
 
<br clear=all>
 
<br clear=all>
Line 223: Line 239:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4108_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard.jpg|600px|right]]
  
 
'''1.''' Take the main board from its case.
 
'''1.''' Take the main board from its case.
 +
 +
<br clear=all>
 +
 +
[[File:build51_holder_cover.jpg|600px|right]]
 +
 +
'''2.''' Look for the ''SD-card holder cover'' in the wiring bag. This little piece of plastic is just to make sure you can't accidentally push the SD card into the gap between its slot and the case, thus losing it.
 +
But ... can this happen? Well, it's not easy, but we provide this nice piece of plastic for a reason ;-)
 +
 +
<br clear=all>
 +
 +
[[File:build51_mainboard_holder_cover_detail.jpg|600px|right]]
 +
 +
[[File:build51_mainboard_holder_cover.jpg|600px|right]]
 +
 +
'''3.''' Plug the ''SD-card holder cover'' on top the SD-card holder. Please, put attention to the orientation. The tiny plastic feet must get inside the 2 corresponding tiny holes, then push slowly until it's totally inserted. It should get clipped. Once it's inserted, don't try to remove it or you probably would break the little plastic feet. This is a one-time operation.
  
 
<br clear=all>
 
<br clear=all>
Line 231: Line 262:
 
[[File:IMG_4191_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4191_fixed_wiki.JPG|600px|right]]
  
'''2.''' Take 4 x ISO7380 M2.5 screws. They are the smaller ones with rounded head.
+
'''4.''' Take 4 x ISO7380 M2.5 screws. They are the smaller ones with rounded head.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4226_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard_rpi5.jpg|600px|right]]
[[File:IMG_4230_fixed_wiki.JPG|600px|right]]
 
  
'''3.''' Plug the RBPi4 (with the thermal block attached) on the Main Board's RBPi4 socket, the big one with 2 rows of 20 pin-holes each. Pay attention to not bend any pins. Also note that the display flat cable should pass through the rectangular hole in the main board, as seen in the photos (zoom in if you have doubts).
+
'''5.''' Plug the RBPi5 (with the thermal block attached) on the Main Board's RBPi socket, the big one with 2 rows of 20 pin-holes each. Pay attention to not bend any pins. Also note how the display flat cable should go out from the RPi5, as seen in the photos (zoom in if you have doubts).
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4195_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard_rpi5_bottom_secured.jpg|600px|right]]
  
'''4.''' Fix the thermal block to the main board from the backside using the 4 x M2.5 screws.
+
'''6.''' Fix the thermal block to the main board from the backside using the 4 x M2.5 screws.
  
 +
<br clear=all>
  
{{NoteBox| At this point, you can do these steps in advance: [[#Plug_SD-card_adapter|3.6]] and [[#Plug_USB-C_adapter|3.7]]. Some people will find it more comfortable to plug in the SD-card & USB-C adaptors before assembling the main board in the aluminum case. It's up to you!}}
+
{{NoteBox| At this point, '''it's recommended to do steps [[#Plug_SD-card_adapter|3.6]] and [[#Plug_USB-C_adapter|3.7]] in advance'''. Most people find more comfortable to plug the SD-card & USB-C adaptors before assembling the main board in the aluminum case. Up to you!}}
  
 
<br clear=all>
 
<br clear=all>
Line 253: Line 284:
 
[[File:IMG_4221_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4221_fixed_wiki.JPG|600px|right]]
  
'''5.''' Take 7 x ISO7380 M3 screws. They are the mid-size ones with rounded head.
+
'''7.''' Take 7 x ISO7380 M3 screws. They are the mid-size ones with rounded head.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4202_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard_alucase.jpg|600px|right]]
[[File:IMG_4276_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard_alucase_secured.jpg|600px|right]]
  
'''6.''' '''Remove the transparent protective sheet''' from the piece of thermal pad stuck to the thermal block bottom and softly place the main board in the aluminum case bottom. You will find it more comfortable to grab the thermal block to do this operation. Fix it using the 7 x ISO7380 M3 screws.
+
'''8.''' Remove the protective sheet from the piece of thermal pad stuck to the thermal block bottom and softly place the main board in the aluminum case bottom. You will find it more comfortable to grab the thermal block to do this operation. Fix it using the 7 x ISO7380 M3 screws. Please, note that the mainboard have some spare mounting holes that are not used with the V5 alucase. You could easily guess the right mounting holes because they should match the 7 alucase's mounting stands.
  
 
<br clear=all>
 
<br clear=all>
Line 270: Line 301:
 
[[File:IMG_4270_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4270_fixed_wiki.JPG|600px|right]]
  
'''1.''' Look for the SD-card adapter in the wiring bag.
+
'''1.''' Look for the SD-card adapter in the wiring bag.  
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4282_fixed_wiki.JPG|600px|right]]
+
[[File:build51_sdcard_adapter_01.jpg|600px|right]]
  
 
'''2.''' Carefully, using 2 fingers, one on each hand, pull the main board's SD-card connector tongue until it's totally open.
 
'''2.''' Carefully, using 2 fingers, one on each hand, pull the main board's SD-card connector tongue until it's totally open.
Line 280: Line 311:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4286_fixed_wiki.JPG|600px|right]]
+
[[File:build51_sdcard_adapter_02.jpg|600px|right]]
  
'''3.''' Insert the SD-card adapter's ribbon cable. It must be inserted straight, with the blue side facing down.
+
'''3.''' Insert the SD-card adapter's ribbon cable. It must be inserted straight, '''with the metal contacts side facing up'''.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4289_fixed_wiki.JPG|600px|right]]
+
[[File:build51_sdcard_adapter_03.jpg|600px|right]]
  
'''4.''' When it's totally inserted, push the tongue with 2 fingers at once and close the connector. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
+
'''4.''' When it's totally inserted, push the tongue with 2 fingers at once and close the connector. Pay attention to ensure the cable does not move out of the connector. If it's not fully inserted or not straight enough, repeat the operation until it's OK.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4296_fixed_wiki.JPG|600px|right]]
+
[[File:build51_sdcard_adapter_04.jpg|600px|right]]
  
'''4.''' Plug the SD-card adapter into the RPI4's SD-card holder.
+
'''5.''' Plug the SD-card adapter into the RPI5's SD-card holder. The connector is rotated 90º respect to the cable, so you must softly bend the ribbon cable to get it plugged-in. Check the pictures and proceed slowly, always using the minimum amount of force. Don't force the cable, bend it softly, please.
 +
 
 +
'''THIS IS A CRITICAL STEP''' to get the main board SD-card slot working right. Extreme your care because the SD-card adapter's cable is delicate and easy to damage, specially the join between the flat cable and the SD-card plug.
  
 
<br clear=all>
 
<br clear=all>
Line 316: Line 349:
 
[[File:IMG_4294_fixed_wiki.JPG|600px|right]]
 
[[File:IMG_4294_fixed_wiki.JPG|600px|right]]
  
'''3.''' Insert the USB-C adapter's ribbon cable. It must be inserted straight, with the blue side facing down.
+
'''3.''' Insert the USB-C adapter's ribbon cable. It must be inserted straight, '''with the metal contacts side facing up'''.
  
 
<br clear=all>
 
<br clear=all>
Line 327: Line 360:
 
<br clear=all>
 
<br clear=all>
  
[[File:IMG_4300_fixed_wiki.JPG|600px|right]]
+
[[File:build51_mainboard_usbc_adaptor_02.jpg|600px|right]]
 
+
[[File:build51_mainboard_usbc_adaptor_01.jpg|600px|right]]
'''5.''' Plug the USB-C connector into the RPI4's USB-C socket.
 
 
 
<br clear=all>
 
 
 
=='''Stick the SD-card holder cover'''==
 
 
 
<br clear=all>
 
 
 
This little piece of plastic is just to make sure you can't accidentally push the SD card into the gap between its slot and the case, thus losing it.
 
But ... can this happen? Well, it's not easy, but we provided this nice piece of plastic for a reason ;-)
 
 
 
<br clear=all>
 
 
 
[[File:capture000029_fixed_wiki.JPG|600px|right]]
 
 
 
'''1.''' Look for the SD-card holder cover in the wiring bag.
 
 
 
<br clear=all>
 
 
 
[[File:capture000030_fixed_wiki.JPG|600px|right]]
 
 
 
'''2.''' Remove the protective sheet.
 
 
 
<br clear=all>
 
 
 
[[File:capture000034_fixed_wiki.JPG|600px|right]]
 
  
'''3.''' Stick it on the main board's SD-card holder, so it is well-adjusted, touching the aluminum case.
+
'''5.''' Plug the USB-C connector into the RPi5's USB-C socket.
  
 
<br clear=all>
 
<br clear=all>
Line 393: Line 400:
  
 
'''1.''' Take the control board from its case. You don't need the silicone buttons yet.
 
'''1.''' Take the control board from its case. You don't need the silicone buttons yet.
 
<br clear=all>
 
 
[[File:capture000090_fixed_wiki.JPG|600px|right]]
 
 
'''2.''' If you don't want your Zynthian V5 to behave like a rattle, please, remove the nuts and rings from the rotary encoders. You don't need these, so you can throw them away or keep them in the screws tray.
 
  
 
<br clear=all>
 
<br clear=all>
Line 404: Line 405:
 
[[File:capture000071_fixed_wiki.JPG|600px|right]]
 
[[File:capture000071_fixed_wiki.JPG|600px|right]]
  
'''3.''' Take the 8 x brass spacers 10mm and 8 x ISO7380 M3 screws (the mid-size ones with round head).
+
'''2.''' Take the 8 x brass spacers 10mm and 8 x ISO7380 M3 screws (the mid-size ones with round head).
  
 
<br clear=all>
 
<br clear=all>
Line 410: Line 411:
 
[[File:capture000068_fixed_wiki.JPG|600px|right]]
 
[[File:capture000068_fixed_wiki.JPG|600px|right]]
  
'''4.''' Secure the 8 x spacers on the control board's top side. To do this, insert the bolt from the back side and while holding it with your finger, fasten the spacer with the other hand until it's tight. You don't need a wrench for this, but you can use one if you like.
+
'''3.''' Secure the 8 x spacers on the control board's top side. To do this, insert the bolt from the back side and while holding it with your finger, fasten the spacer with the other hand until it's tight. You don't need a wrench for this, but you can use one if you like.
  
 
<br clear=all>
 
<br clear=all>
Line 420: Line 421:
 
[[File:capture000072_fixed_wiki.JPG|600px|right]]
 
[[File:capture000072_fixed_wiki.JPG|600px|right]]
  
'''1.''' Take the display from its case. It should have 2 protective sheets. The first one is thin and baggy and the second one is thicker and it fits the LCD panel except for a small green tab. Remove the first protective sheet (the thin and baggy one) and leave the second one untouched. After this, flip the display and remove the 4 yellow protective sheets from the outer spacers. You can use your fingernail or a cutter for this operation.
+
'''1.''' Take the display from its case. Don't remove the protective sheet yet. Flip the display and remove the 4 yellow protective sheets from the outer spacers. You can use your fingernail or a cutter for this operation.
  
 
<br clear=all>
 
<br clear=all>
Line 443: Line 444:
 
[[File:capture000142_fixed_wiki.jpg|600px|right]]
 
[[File:capture000142_fixed_wiki.jpg|600px|right]]
  
'''1.''' Look for the control flat ribbon cable in the wiring bag. It's grey with blue tips, 15cm long and 1cm wide.
+
'''1.''' Look for the control flat ribbon cable in the wiring bag. It's 15cm long and 1cm wide. Contacts are crossed, with one side faced up and the other side faced down. Be warned that your cable color could be different than those shown in the pictures. It could be '''grey with blue tips''' or '''black with black tips'''. If it's black, do not confuse this cable with display cable!
  
 
<br clear=all>
 
<br clear=all>
Line 453: Line 454:
  
 
<br clear=all>
 
<br clear=all>
 +
 +
{{NoteBox| Please, note that the white JST connector shown on the pictures at left may not be soldered in you control board. Don't worry about it as it's not need it for normal operation. }}
  
 
[[File:capture000086_fixed_wiki.jpg|600px|right]]
 
[[File:capture000086_fixed_wiki.jpg|600px|right]]
  
'''3.''' Insert the ribbon cable into the FPC connector. It must be inserted straight, with the blue side facing down. '''All flat cables in the V5 kit are reversible, so you can take any of the 2 caps''', while taking care of placing the blue side facing down.
+
'''3.''' Insert the ribbon cable into the FPC connector. It must be inserted straight, with the metal contacts side facing up. '''This cable is reversible, so you can take any of the 2 caps''', while '''taking care of placing the metal contacts side facing up'''.
  
 
<br clear=all>
 
<br clear=all>
Line 512: Line 515:
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000103_fixed_wiki.jpg|600px|right]]
+
[[File:build51_both_parts_separated.jpg|600px|right]]
  
 
'''8.''' Congratulations! We are ready to join everything together.
 
'''8.''' Congratulations! We are ready to join everything together.
Line 530: Line 533:
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000106_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_display_01.jpg|600px|right]]
  
'''1.''' Place the two parts one aside the other, forming 90º angle, as shown in the picture.
+
'''1.''' Take the cardboard box labeled as V5, which contained the aluminum case. We will use it as a mounting tool in this step. Place it at right side of the zynthian's bottom part forming a 90º angle, as shown in the picture.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000109_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_display_02.jpg|600px|right]]
  
'''2.''' Using two fingers, one on each hand, softly pull the display's FPC tongue until it's open. Insert the flat ribbon cable coming from the RPi4 into the bottom's part. Do it straight, without bending or twisting it in any way, so the blue side is face down.
+
'''2.''' Place over the box the zynthian's top part, with the display surface touching the cardboard and the display connector at left. Just like shown in the picture.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000110_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_display_03.jpg|600px|right]]
  
'''3.''' When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
+
'''3.''' Using two fingers, one on each hand, softly pull the display's connector tongue until it's open. Insert the flat ribbon cable coming from the RPi5 into it so '''the black side is face down and the copper contacts face up'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[File:build51_join_parts_display_04.jpg|600px|right]]
 +
 
 +
'''4.''' When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
  
 
<br clear=all>
 
<br clear=all>
 +
 +
{{NoteBox|Probably you are thinking that we could use longer cables so these final steps would be easier. And you are right, it would be easier to assemble, but the resulting device wouldn't be so good. Longer cables means more EMI (Electro-Magnetic Interference). The DSI signal coming out the RPi is specially noisy and although the DSI cable we use already include some EMI shielding, the audio circuitry is close, just a few centimeters, and we prefer to reduce EMI to the minimum. Think that you assemble your zynthian once, but you (hopefully!) will use it for years and i'm pretty sure you want the highest quality of sound, so it's worth the extra effort to connect shorter cables.}}
  
 
=='''Plug the control flat cable into the main board'''==
 
=='''Plug the control flat cable into the main board'''==
Line 552: Line 563:
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000113_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_control_01.jpg|600px|right]]
 +
[[File:build51_join_parts_control_02.jpg|600px|right]]
  
'''1.''' Rotate the top part until it's parallel to the bottom part, as shown in the picture.
+
'''1.''' Relocate the zynthian's top part so it's partially fitted with the bottom part, forming a 90º angle. Please, move it slowly and take special care of not forcing the display cable that you just connected in the step above. You can remove the cardboard box as it's not longer needed.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000114_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_control_03.jpg|600px|right]]
[[File:capture000115_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_control_04.jpg|600px|right]]
  
'''2.''' Using two fingers, one on each hand, softly pull the main board's control-1 connector tongue until it's open. Insert the flat ribbon cable coming from the control board (top part). Do it straight, without bending or twisting it in any way, so the blue side is face down.
+
'''2.''' Using two fingers, one on each hand, softly pull the main board's control-1 connector tongue until it's open. Insert the flat ribbon cable coming from the control board (top part). Do it straight, without bending or twisting it in any way, so '''the metal contacts side is facing up'''.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000116_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_control_05.jpg|600px|right]]
  
 
'''3.''' When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
 
'''3.''' When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.
Line 575: Line 587:
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000120_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_close_01.jpg|600px|right]]
 
 
'''1.''' Fit the upper part into the lower part forming a 90º angle, as shown in the picture.
 
 
 
<br clear=all>
 
 
 
[[File:capture000121_fixed_wiki.jpg|600px|right]]
 
  
'''2.''' Note the way the display flat cable naturally bends. You should force this bending by pressing with your fingers and marking a 45º fold. Zoom into the picture to see the detail.
+
'''1.''' Without moving the parts from the last position, you are ready to close the case. Now you are really close to finish the assembling process!
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000123_fixed_wiki.jpg|600px|right]]
+
[[File:build51_join_parts_close_02.jpg|600px|right]]
  
'''3.''' Close the case slowly, taking care that the cables are not being trapped.
+
'''2.''' Close the case slowly, taking care that the cables are not being trapped. Probably you would need to ''help'' the control flat cable to get into the case while closing it.
  
 
<br clear=all>
 
<br clear=all>
  
[[File:capture000158_fixed_1024.jpg|600px|right]]
+
[[File:Oram splash 1.jpeg|600px|right|frame|First boot splash screen]]
  
'''4.''' '''Before securing the case top and the knobs''', it's a good time to '''[[Zynthian Software|burn a SD-card with the latest zynthian software image]]''' and check everything is working OK.  
+
'''3.''' '''Before securing the case top and inserting the knobs''', it's a good time to '''[[Zynthian Software|burn a SD-card with the latest zynthian software image]]''' and check everything is working OK.  
 
Please, use a good quality SD-card and follow the [[Zynthian Software|instructions]] carefully.
 
Please, use a good quality SD-card and follow the [[Zynthian Software|instructions]] carefully.
  
First boot could take some time. Don't be impatient and wait until you see the splash screen with the logo. If the display remains black after 1 minute, please, re-check the [[Zynthian Software|instructions]] and re-burn the SD-card again. If this still don't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi4 status LEDs].
+
First boot could take some time. After a minute or so, you will see the display fill with upside-down text, then a login prompt, which will automatically continue. Don't be impatient - wait perhaps 5 minutes until you see the splash screen with the logo. If the display remains black after 1 minute (no upside-down text is displayed), please re-check the [[Zynthian Software|instructions]] and re-burn the SD-card again. If this still doesn't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi5 status LEDs].
  
Once you see the splash screen, it could take some minutes until the system is ready. You deserve a beer, or at less some some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.
+
Once you see the splash screen, it could take a few more minutes until the system is ready. You deserve a beer, or at least some some tea or coffee. When the first-boot process finishes, the Zynthian will reboot and you will be in the main menu, ready to play.
  
 
<br clear=all>
 
<br clear=all>
Line 607: Line 613:
 
[[File:capture000125_fixed_wiki.jpg|600px|right]]
 
[[File:capture000125_fixed_wiki.jpg|600px|right]]
  
'''5.''' If everything worked fine and your zynthian booted, finish the task before start exploring your new zynthian V5. Take the remaining 6 x ISO7380 M3 screws and secure the case, 3 on each side. Tighten enough, but not too much.
+
'''5.''' If everything worked fine and your zynthian is alive, please, finish the task before start exploring your new zynthian V5.1. Take the remaining 6 x ISO7380 M3 screws and secure the case, 3 on each side. You should place all the 6 screws before tightening any of them. Tighten enough, but not too much.
  
 
<br clear=all>
 
<br clear=all>
 +
[[File:build51_join_parts_close_03.jpg|600px|right]]
  
 
=='''Attach and secure the knobs'''==
 
=='''Attach and secure the knobs'''==
Line 647: Line 654:
  
 
[[File:capture000140_fixed_wiki.jpg|600px|right]]
 
[[File:capture000140_fixed_wiki.jpg|600px|right]]
 +
 +
 +
'''6.''' '''Congratulations!''' Your Zynthian V5.1 is ready to boot for the first (or second??) time. '''If you didn't yet''', it's time to '''[[Zynthian Software|burn a SD-card with the latest zynthian software image]]'''. Please, use a good quality SD-card and follow the [[Zynthian Software|instructions]] carefully.
 +
 +
<br clear=all>
 +
 
[[File:capture000158_fixed_1024.jpg|600px|right]]
 
[[File:capture000158_fixed_1024.jpg|600px|right]]
  
'''6.''' '''Congratulations!''' Your Zynthian V5 is ready to boot for the first (or second??) time. '''If you didn't yet''', it's time to '''[[Zynthian Software|burn a SD-card with the latest zynthian software image]]'''. Please, use a good quality SD-card and follow the [[Zynthian Software|instructions]] carefully.
+
Note that the wiring kit should include a little tool to help inserting/removing the SD-card. It's a small rectangular piece of black-anodized aluminum with the zynthian logo, like shown in the picture:
  
First boot could take some time. Don't be impatient and wait until you see the splash screen with the logo. If the display remains black after 1 minute, please, re-check the [[Zynthian Software|instructions]] and re-burn the SD-card again. If this still don't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi4 status LEDs].
+
<br clear=all>
 +
 
 +
='''First Boot'''=
  
Once you see the splash screen, it could take some minutes until the system is ready. You deserve a beer, or at less some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.
+
First boot could take some time. Don't be impatient and wait until you see the splash screen with the logo. If the display remains black after 1 minute, please, re-check the [[Zynthian Software|instructions]] and re-burn the SD-card again. If this still don't work, try with a different SD-card before reporting in the [https://discourse.zynthian.org forum]. For solving SD-card issues, it could be useful to [https://raspberrytips.com/green-and-red-light-on-raspberry-pi check the RPi5 status LEDs].
  
'''It's time to take a look to the [[Zynthian UI User Guide - V5 | user's guide]]!'''
+
Once you see the splash screen, it could 1-2 minutes to finish the configuration process. You deserve a beer (hey!! don't abuse if you already took one!!), or at less some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.
  
 +
'''It's time to remove the display's protective sheet (''please, do it!!'') and take a look to the [[Zynthian_UI_User%27s_Guide_-_Oram | user's guide]]!'''
  
 
<br clear=all>
 
<br clear=all>
 +
 +
If the first boot did not finish right and you did not get into the zynthian user interface, you should carefully re-check the wiring before trying again:
 +
 +
* '''If the display remains black''', you should check the display cable connection.
 +
* '''If you get the ERROR screen''', most probably your control board is not being detected and you should check the control-1 cable connection.
 +
 +
You should check both sides of connection. Check that orientation is correct, the cable is well inserted and the connector totally closed. If it still doesn't work, you could look for damaged cable contacts, solder bridges on the PCB connectors, etc.
 +
<br>
 +
 +
{{WarningBox|AFTER A FAILED FIRST BOOT, YOU SHOULD NOT BOOT AGAIN WITH THE SAME SD-CARD AS IT IS.}}
 +
 +
<br>
 +
If hardware can't be detected, the SD-card is configured as "custom hardware" and first boot is disabled. You must re-burn the SD-card or reset the SD-card from the terminal with this command:
 +
 +
set_first_boot.sh
 +
 +
You can reach the terminal from webconf or using SSH.
 +
 +
From the terminal, you can check the first boot log with this command:
 +
 +
cat /root/first_boot.log
 +
 +
This could help you to understand what is going wrong. You should include this log when asking for help in the forum.
 +
Also, when reporting first boot issues, it could be very helpful to include the output of this command:
 +
 +
i2cdetect -y 1
 +
 +
When everything is OK you should get something like this:
 +
 +
    0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
 +
00:                        -- -- -- -- -- -- -- --
 +
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
20: 20 21 -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
40: -- -- -- -- -- -- -- -- -- -- UU -- -- UU -- --
 +
50: -- -- UU -- -- -- -- -- -- -- -- -- -- -- -- --
 +
60: UU -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
70: -- -- -- -- -- -- -- --                       
 +
 +
If things are not working OK, you could get something like this, for instance
 +
 +
    0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
 +
00:                        -- -- -- -- -- -- -- --
 +
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
40: -- -- -- -- -- -- -- -- -- -- 4a -- -- 4d -- --
 +
50: -- -- 62 -- -- -- -- -- -- -- -- -- -- -- -- --
 +
60: 60 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
 +
70: -- -- -- -- -- -- -- --                       
 +
 +
Note the absence of the chips addressed in 20 & 21 (2 x MCP23017). This means your control board is not being detected and most probably is not well connected.
 +
 +
<br clear=all>
 +
 +
='''V5 KITS SOLD BEFORE 2025-06-01 - Fixing FFC connectors'''=
 +
 +
Recently we have detected a little defect (thanks @simmeah!) that could be the cause of some rare issues reported from time to time. We never experienced these issues in any of the builds we realized in zynthian labs and this is the reason we haven't detected the problem until now.
 +
 +
<br>
 +
{{WarningBox|All kits sold after 2025-06-01 are fixed and free from this defect.}}
 +
<br>
 +
 +
'''The symptoms'''
 +
 +
* Control board connection issues, like:
 +
** Control board not being detected on first boot (see [[Assembling_Zynthian_Kit_V5.1#First_Boot | section 6]]).
 +
** Some buttons or knobs behave erratically or don't work.
 +
* SD-card extender doesn't work or it's not stable enough.
 +
 +
<br>
 +
'''and:'''
 +
<br>
 +
 +
* '''YOU HAVE DOUBLE CHECKED''' the build tutorial and you are sure you followed the instructions carefully and everything is according to them.
 +
* You are using '''good quality SD-cards of the right sizes (32 or 64GB)'''. Also, check the SD-card extender is not broken nor damaged.
 +
 +
<br>
 +
{{NoteBox|'''This should be a last-resource action''' before considering to replace the board.}}
 +
<br>
 +
 +
'''The defect'''
 +
[[File:FPC-issue-bent-cable.jpeg|800px|right]]
 +
 +
The FFC connectors soldered on main and control boards doesn't fit perfectly the standard ribbon cables we include in the V5 kit, causing the cable to bent when closing the latch and potentially causing bad contact or, at worst case, damaging the flat cable.
 +
 +
The reason is we accidentally choose a wrong part number and didn't realize until now because the difference is really small and it works most of times. Indeed I never suffered the issue in any build I did here, in zynthian labs, and I did a few!
 +
 +
We have already fixed the BOMs so next boards will be manufactured with the right part number. Also, we are fixing all boards we have stocked so:
 +
 +
<br clear=all>
 +
 +
{{NoteBox|'''ALL V5 KITS SOLD AFTER 2025-06-01 ARE FREE FROM THIS DEFECT''' and you don't need to fix this because we already did. If you have issues, the cause is not this.}}
 +
<br>
 +
 +
'''The fix'''
 +
[[File:FPC-issue_plastic_bumps_redcircles.jpg|800px|right]]
 +
 +
Anyway i would like to offer a solution for those having issues with this. Indeed, the solution is simple and it has been already explained by @simmeah in the forum:
 +
 +
'''Use a cutter or scalpel to cut the 2 tiny plastic bumps that cause the issue.'''
 +
 +
The bumps are really tiny and you probably need good eyes or magnifying glasses. The tool must be well sharpened, so the plastic bumps can be cut will minimal force. Be extremely careful to not worsen things by breaking the FFC's latch.
 +
 +
<br clear=all>
 +
 +
You must repeat the operation for all FFC connectors used by V5. They are:
 +
 +
[[File:V5.1_main_fpc_issue_01.jpg|800px|right]]
 +
* '''Main Board'''
 +
** CONTROL-1
 +
** USB-C1
 +
** SDCARD-RBPi1
 +
 +
<br clear=all>
 +
 +
[[File:V5.1_control_fpc_issue_01.jpg|800px|right]]
 +
* '''Control Board'''
 +
** CONTROL-1
 +
 +
<br clear=all>
 +
 +
May the force be with you and remember: '''better asking than crying!!'''

Latest revision as of 23:20, 5 June 2025

1 Previous Requirements


1.1 BOM V5.1 kit


IMG 4251 fixed wiki.JPG
  • V5.1 Aluminum Case
    • Bottom
    • Top
  • Main Board
  • Control Board
  • Display
  • Raspberry Pi5
  • Thermal Block
  • Thermal Pad (1 piece of 6 x 2 cm)
  • Silicone Keypad
  • Rubber Feet (4 units)
  • Wiring
    • RBPi5 DSI display flat cable: 20cm long, 1.6cm wide, 1mm/0.5mm pitch, black or orange
    • Control Board flat cable: 15cm long, 1cm wide, 0.5mm pitch, black or grey
    • USB-C adapter + flat cable: 5cm long, 1cm wide, 0.5mm pitch, black or grey
    • uSD-card adapter with flat cable: 5cm long, 1cm wide, 1mm pitch, grey
  • Screws
    • 12 x ISO7380 M2.5x5mm black zinc-plated steel (the smaller ones with round head)
    • 21 x ISO7380 M3x5mm black zinc-plated steel (the slighty bigger ones with round head)
    • 10 x DIN7991 M3x6mm black zinc-plated steel (the ones with conic head)
    • 4 x DIN916 M3x4mm black zinc-plated steel (the headless ones)
    • 8 x Hexagonal Spacer M3x10mm brass
  • Mechanized Aluminum Knobs (4 units)
  • Power Supply: 24V, 1.5 Amp (1 unit)
  • SD-Card >= 32GB (NOT included in V5.1 kit)
  • Optional: CR2032 lithium battery (NOT included in V5.1 kit)


WARNING!!

For working, the V5.1 needs a SD-card with the ZynthianOS software. Learn how to download the SD-image and prepare your SD-card.


1.2 Tools Required


  • Allen Spanner 1.5 mm
  • Allen Spanner 2.0 mm
  • Scissors or Cutter (NOT included in V5 kit)
  • Rule meter (NOT included in V5 kit)


1.3 Time Required


Depending on your skills and ability it may take 1 to 3 hours.


2 General Advice


  • Read and follow carefully the assembling instructions. Don't ignore any guidance or recommendations. We are quite lazybones, so we should have had some important reason to write them.
  • Use the browser's zoom to magnify the details in the pictures. They have good resolution and will allow you to see all details you need.
  • Prepare the working space and the needed tools. A clean 120 x 60 cm table will be big enough. More is always welcome. Less is not recommended. Remove all stuff you don't need from the surface and prepare the tools you will need.
  • Ensure you have good lighting in the working area. Having good lightning will ease delicate operations, especially those involving smaller parts.
  • Please, be extremely delicate when manipulating the flat cable connectors (FPC). They are the weakest parts and can be easily broken. Look carefully at the photos/videos and proceed just in the way we recommend. Use 2 hands, one finger from each hand. Avoid manipulating the connectors with a single hand or finger and don't use any tool for this.
  • Don't be impatient. If you have doubts or you don't know how to go on, please, stop assembling and ask in the forum or send an email to support@zynthian.org. It's better to wait some hours to get an answer than waiting for days/weeks to get a replacement part.
  • Keep your hands clean so you can enjoy a nice unit after finishing.


WARNING!!

DON'T USE FORCE! NEVER! Some parts are really delicate, especially flat cable connectors (FPC), and you can easily break something if you are brute. Assembling the V5 unit is not difficult at all, but it's a clock-maker work. A beginners one that almost everyone can do, but clock-maker's task anyway. If you are not very used to manipulate this kind of stuff, please, proceed slowly. Thinking twice will let you build it once.


3 BOTTOM PART


3.1 Dump the screws from the bag in a suitable receptacle


Capture000028 fixed wiki.JPG

Be careful when opening the screws bag. Some of them are really small and you can easily lose them. Please, don't dump them on the table's surface or on top a piece of paper. We recommend to dump the bag's content in a small tray, so you can look at and take out the parts easily while getting them well confined so they can't be lost.

Pay special attention to the 4 tiny headless screws used to secure the knobs. They are really small!! You can screw them into the knobs as a first step to avoid losing them during the build process.

Now is a good time to familiarize yourself with the different screw models available. Take a close look at the content of the screws bag and try to identify:

  • 12 x ISO7380 M2.5x5mm black zinc-plated steel => the smaller ones with round head
  • 21 x ISO7380 M3x5mm black zinc-plated steel => the slighty bigger ones with round head
  • 10 x DIN7991 M3x6mm black zinc-plated steel => the ones with cone-shaped head
  • 4 x DIN916 M3x4mm black zinc-plated steel => the headless ones
  • 8 x Hexagonal Spacer M3x10mm brass => they are the only brass parts



3.2 Stick the rubber feet to the aluminum case bottom


Build51 case bottom 01.jpeg
Build51 case bottom 02.jpeg

1. Look for the aluminum case bottom part in the "V5" case package:


IMG 4041 fixed wiki.JPG

2. Look for the 4 x rubber feet inside the wiring bag, in the "Screen and Bits" case:


Build51 case bottom rubber feet.jpeg

3. Stick the 4 x rubber feet to the aluminum case bottom part. This will prevent scratches during the assembly process.


3.3 Plug the display ribbon cable into the RPi5


Build51 display cable rpi5.jpg

1. Look for the display ribbon cable in the "Screen and Bits" case. It's not inside any plastic bag but it's laying in the cardboard box. It's 20cm long and 1.6cm wide, having different terminations on each side. Most probably it will be labeled as "Display cable 200mm", white text over black or orange cable.


Build51 rpi5.jpg

2. Look for the RPi5 in the "Accessories" case.


Build51 rpi5 display cable plugged 01.jpg
Build51 rpi5 display cable plugged 02.jpg

3. Open the RPi5's DSI connector by softly pulling up on both sides of the tiny black/grey tongue at once. It opens only about 2mm. When it's totally open, push the ribbon cable inside, straight down, with the black shiny side at the end of the cable facing out (towards the HDMI printed on the RPi5 board). The contacts on the end of the cable that are pushed into the connector should be facing the RPi5 Ethernet socket, while taking care to have the black shiny side facing away from the Ethernet socket. When the cable is tightly inserted, close the connector by pushing down on the tongue with 2 fingers, one of each hand. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.


WARNING!!

When possible, use 2 hands to manipulate the fragile FPC connectors. You will control the applied force a lot better compared to just using a single hand. If you can't use both hands, take extreme care. Indeed, you should always take extreme care while manipulating FPC connectors.


Note:

If you break an FPC's connector tongue, you could work around the problem using a hot glue gun. Not nice, but it works quite well!


3.4 Install the thermal block


The RBPi5 has a fast CPU that runs at 2.3 GHz and we need to remove the heat generated by its components. As we don't want a noisy fan, prone to failure, pushing dust inside our nice case, we are using the aluminum case as a huge heat-sink. This is achieved by the thermal block, a solid aluminum block that closely contacts with the RPi5's chips and serves as a heat-highway to the aluminum case bottom, and from there, to the rest of the aluminum case. When your zynthian V5.1 is working hard, or when external temperature is high enough, you will note the aluminum case getting hot. This is good because it means the thermal block is doing its job of transferring heat from the inside to the aluminum case body, where it's dissipated to the ambient environment.

Zynthian V5.1 could get a 20% extra power from the RPi5 by overclocking the CPU up to 3 GHz. By default overclocking is disabled because not all RPi5 boards support overclocking, but you can try, and luckily, you will get an extra power boost. Obviously, installing correctly the thermal block will increase the chance of overclocking successfully your zynthian.

Having understood all this, you may realize this is a key step for getting your V5.1 working at 100% (or more!) of its capacity, so don't be in a hurry and take your time to do a good job. Let's start!




Build51 thermal block 01.jpg

1. Look for the thermal block in the accessories case.


IMG 4045 fixed wiki.JPG
Thermal pad cut v51.png
IMG 4142 fixed wiki.JPG

2. Look for the piece of thermal pad in the wiring bag, in the "Screen and Bits" case. It is a piece of approximate size of 60 x 20 mm, gray on one side and blue on the other.


3. Using the rule-meter and the scissors or cutter, cut 4 little pieces of thermal pad with these apr sizes:


  • 20 x 28 mm
  • 19 x 12 mm => This is the most important!
  • 14 x 9 mm
  • 11 x 11 mm


Build51 thermal block 02.jpg

4. Remove the blue protective sheet from the 3 smaller pieces and stick them to the inner side of the thermal block, the one that makes contact with the RPi5. You'll recognize it because it has 3 small rectangular islands that fit the size of the 3 smaller pieces you cut out. You can use your finger to stick it, pressing and extending the thermal pad. Use your fingernail to cut off the excess, if any.


IMG 4191 fixed wiki.JPG

5. Take 4 x ISO7380 M2.5 screws. They are the smaller ones with rounded head.


Build51 rpi5 thermal back.jpg

6. Remove the transparent protective sheet from the 3 pieces of thermal pad and fix the RBPi4 compute module to the thermal block using the 4 x ISO7380 M2.5 screws.


Build51 rpi5 thermal display cable bending 00.jpg
Build51 rpi5 thermal display cable bending 03.jpg
Build51 rpi5 thermal display cable bending 01.jpg
Build51 rpi5 thermal display cable bending 02.jpg
Build51 rpi5 thermal display cable bending 04.jpg

7. Before installing the "RPi5 + thermal block" assembly in the main board, you must fold the display cable adequately, so it goes in the right direction. You must fold it twice, putting attention to the pictures and using your "common sense". The first fold is straight and the second one is at 45º, so you get the cable going out the RPi5 with the text "Display-cable-200mm" on the down side. We show several pictures from different angles. Zoom in as needed until you have clear how to proceed. Take your time and think twice to do once.


Build51 rpi5 thermal finished.jpg

8. Finally, stick the remaining piece of thermal pad (27 x 20 mm) on the contact surface in the external side of the thermal block. That is, on top of the big "tower" with 2 tiny holes. Follow the same procedure you already did with the 3 smaller pieces, but don't remove the protective sheet yet. This will be done later, when installing the module in the aluminum case bottom.


3.5 Assemble the Main Board into the aluminum case bottom


Build51 mainboard.jpg

1. Take the main board from its case.


Build51 holder cover.jpg

2. Look for the SD-card holder cover in the wiring bag. This little piece of plastic is just to make sure you can't accidentally push the SD card into the gap between its slot and the case, thus losing it. But ... can this happen? Well, it's not easy, but we provide this nice piece of plastic for a reason ;-)


Build51 mainboard holder cover detail.jpg
Build51 mainboard holder cover.jpg

3. Plug the SD-card holder cover on top the SD-card holder. Please, put attention to the orientation. The tiny plastic feet must get inside the 2 corresponding tiny holes, then push slowly until it's totally inserted. It should get clipped. Once it's inserted, don't try to remove it or you probably would break the little plastic feet. This is a one-time operation.


IMG 4191 fixed wiki.JPG

4. Take 4 x ISO7380 M2.5 screws. They are the smaller ones with rounded head.


Build51 mainboard rpi5.jpg

5. Plug the RBPi5 (with the thermal block attached) on the Main Board's RBPi socket, the big one with 2 rows of 20 pin-holes each. Pay attention to not bend any pins. Also note how the display flat cable should go out from the RPi5, as seen in the photos (zoom in if you have doubts).


Build51 mainboard rpi5 bottom secured.jpg

6. Fix the thermal block to the main board from the backside using the 4 x M2.5 screws.


Note:

At this point, it's recommended to do steps 3.6 and 3.7 in advance. Most people find more comfortable to plug the SD-card & USB-C adaptors before assembling the main board in the aluminum case. Up to you!


IMG 4221 fixed wiki.JPG

7. Take 7 x ISO7380 M3 screws. They are the mid-size ones with rounded head.


Build51 mainboard alucase.jpg
Build51 mainboard alucase secured.jpg

8. Remove the protective sheet from the piece of thermal pad stuck to the thermal block bottom and softly place the main board in the aluminum case bottom. You will find it more comfortable to grab the thermal block to do this operation. Fix it using the 7 x ISO7380 M3 screws. Please, note that the mainboard have some spare mounting holes that are not used with the V5 alucase. You could easily guess the right mounting holes because they should match the 7 alucase's mounting stands.


3.6 Plug SD-card adapter


IMG 4270 fixed wiki.JPG

1. Look for the SD-card adapter in the wiring bag.


Build51 sdcard adapter 01.jpg

2. Carefully, using 2 fingers, one on each hand, pull the main board's SD-card connector tongue until it's totally open.


Build51 sdcard adapter 02.jpg

3. Insert the SD-card adapter's ribbon cable. It must be inserted straight, with the metal contacts side facing up.


Build51 sdcard adapter 03.jpg

4. When it's totally inserted, push the tongue with 2 fingers at once and close the connector. Pay attention to ensure the cable does not move out of the connector. If it's not fully inserted or not straight enough, repeat the operation until it's OK.


Build51 sdcard adapter 04.jpg

5. Plug the SD-card adapter into the RPI5's SD-card holder. The connector is rotated 90º respect to the cable, so you must softly bend the ribbon cable to get it plugged-in. Check the pictures and proceed slowly, always using the minimum amount of force. Don't force the cable, bend it softly, please.

THIS IS A CRITICAL STEP to get the main board SD-card slot working right. Extreme your care because the SD-card adapter's cable is delicate and easy to damage, specially the join between the flat cable and the SD-card plug.


3.7 Plug USB-C adapter


IMG 4258 fixed wiki.JPG

1. Look for the USB-C adapter in the wiring bag.


IMG 4291 fixed wiki.JPG

2. Carefully, using 2 fingers, one on each hand, pull the main board's USB-C connector tongue until it's totally open.


IMG 4294 fixed wiki.JPG

3. Insert the USB-C adapter's ribbon cable. It must be inserted straight, with the metal contacts side facing up.


IMG 4303 fixed wiki.JPG


4. When it's totally inserted, push the tongue with 2 fingers at once and close the connector. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.


Build51 mainboard usbc adaptor 02.jpg
Build51 mainboard usbc adaptor 01.jpg

5. Plug the USB-C connector into the RPi5's USB-C socket.


3.8 Secure the thermal block to the aluminum case bottom


Capture000079 fixed wiki.jpg

1. Look for 2 x DIN7991 M3 screws. They have countersunk flat heads.


Capture000081 fixed wiki.jpg

2. Flip the aluminum case bottom and look for the 2 countersunk holes. Using the Allen wrench, punch the thermal pad through the holes.


Capture000082 fixed wiki.jpg

3. Screw the 2 bolts and tighten them well enough, but not too much.


4 TOP PART


4.1 Secure the top-spacers on the control board


Capture000060 fixed wiki.JPG

1. Take the control board from its case. You don't need the silicone buttons yet.


Capture000071 fixed wiki.JPG

2. Take the 8 x brass spacers 10mm and 8 x ISO7380 M3 screws (the mid-size ones with round head).


Capture000068 fixed wiki.JPG

3. Secure the 8 x spacers on the control board's top side. To do this, insert the bolt from the back side and while holding it with your finger, fasten the spacer with the other hand until it's tight. You don't need a wrench for this, but you can use one if you like.


4.2 Assemble the display on the control board


Capture000072 fixed wiki.JPG

1. Take the display from its case. Don't remove the protective sheet yet. Flip the display and remove the 4 yellow protective sheets from the outer spacers. You can use your fingernail or a cutter for this operation.


IMG 4191 fixed wiki.JPG

2. Take 4 x ISO7380 M2.5 screws (the smaller ones with round heads).


Capture000076 fixed wiki.JPG
Capture000073 fixed wiki.JPG

3. Secure the display to the control board's top side using the 4 x small M2.5 screws. Don't tighten these bolts yet!!! The display must be loose to get a good fit with the aluminum case top part. You will tighten these screws later. Pay attention to the display orientation. The display FPC connector for the flat cable must be accessible through the main board's square hole.


4.3 Plug the flat ribbon cable into the control board


Capture000142 fixed wiki.jpg

1. Look for the control flat ribbon cable in the wiring bag. It's 15cm long and 1cm wide. Contacts are crossed, with one side faced up and the other side faced down. Be warned that your cable color could be different than those shown in the pictures. It could be grey with blue tips or black with black tips. If it's black, do not confuse this cable with display cable!


Capture000084 fixed wiki.jpg
Capture000085 fixed wiki.jpg

2. Carefully, using 2 fingers, one on each hand, pull the control board's FPC connector tongue until it's totally open.


Note:

Please, note that the white JST connector shown on the pictures at left may not be soldered in you control board. Don't worry about it as it's not need it for normal operation.

Capture000086 fixed wiki.jpg

3. Insert the ribbon cable into the FPC connector. It must be inserted straight, with the metal contacts side facing up. This cable is reversible, so you can take any of the 2 caps, while taking care of placing the metal contacts side facing up.


Capture000087 fixed wiki.jpg

4. When it's totally inserted, push the tongue with 2 fingers at once and close the connector. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.


4.4 Secure the control board, silicone buttons and display to the aluminum case top


Capture000039 fixed wiki.jpg

1. Look for the aluminum case top part.


Capture000099 fixed wiki.jpg

2. Look for 8 x DIN7991 M3 screws. They have countersunk flat heads.


Capture000089 fixed wiki.jpg

3. Place the silicone button pad on top the control board. Note the tiny silicone studs in the bottom of the pad and pay attention to make them fit into the small positioning holes on the control board. Once it's done, softly push the button pad to the side to check whether it sits snug in it's place. The pad shouldn't move when you try pushing it to the side.


Capture000094 fixed wiki.jpg

4. Use the "Screens & Bits" case as a mounting stand and place the control board on it, as shown in the picture.


Capture000095 fixed wiki.jpg

5. Place the aluminum case top part over the control board taking care of orientation and proceeding slowly. It's a good time to remove the display's protective sheet, or at least, fold the green tab out of the way so the display makes a good fit into the case's window.


Capture000101 fixed wiki.jpg

6. Secure the control board with the 8 x M3 countersunk screws. Again, tighten enough, but not too much.


Capture000102 fixed wiki.jpg

7. Flip the top part and place it over the carton-stand again. Now is the right moment to tight the 4 display screws from step 4.2 (do you remember?).


Build51 both parts separated.jpg

8. Congratulations! We are ready to join everything together.


5 JOINING BOTH PARTS AND CLOSING THE CASE


If you want to place a CR2032 lithium battery for the RTC (Real Time Clock), this is a good moment. If not, don't worry, you can open the case and do it later.


5.1 Plug the display flat cable into the display


Build51 join parts display 01.jpg

1. Take the cardboard box labeled as V5, which contained the aluminum case. We will use it as a mounting tool in this step. Place it at right side of the zynthian's bottom part forming a 90º angle, as shown in the picture.


Build51 join parts display 02.jpg

2. Place over the box the zynthian's top part, with the display surface touching the cardboard and the display connector at left. Just like shown in the picture.


Build51 join parts display 03.jpg

3. Using two fingers, one on each hand, softly pull the display's connector tongue until it's open. Insert the flat ribbon cable coming from the RPi5 into it so the black side is face down and the copper contacts face up.


Build51 join parts display 04.jpg

4. When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.


Note:

Probably you are thinking that we could use longer cables so these final steps would be easier. And you are right, it would be easier to assemble, but the resulting device wouldn't be so good. Longer cables means more EMI (Electro-Magnetic Interference). The DSI signal coming out the RPi is specially noisy and although the DSI cable we use already include some EMI shielding, the audio circuitry is close, just a few centimeters, and we prefer to reduce EMI to the minimum. Think that you assemble your zynthian once, but you (hopefully!) will use it for years and i'm pretty sure you want the highest quality of sound, so it's worth the extra effort to connect shorter cables.

5.2 Plug the control flat cable into the main board


Build51 join parts control 01.jpg
Build51 join parts control 02.jpg

1. Relocate the zynthian's top part so it's partially fitted with the bottom part, forming a 90º angle. Please, move it slowly and take special care of not forcing the display cable that you just connected in the step above. You can remove the cardboard box as it's not longer needed.


Build51 join parts control 03.jpg
Build51 join parts control 04.jpg

2. Using two fingers, one on each hand, softly pull the main board's control-1 connector tongue until it's open. Insert the flat ribbon cable coming from the control board (top part). Do it straight, without bending or twisting it in any way, so the metal contacts side is facing up.


Build51 join parts control 05.jpg

3. When it's totally inserted, softly push the tongue using 2 fingers, one on each hand, until it's totally closed. Pay attention to ensure the cable does not move out of the connector. If it's not well inserted or not straight, repeat the operation until it's OK.


5.3 Close the aluminum case


Build51 join parts close 01.jpg

1. Without moving the parts from the last position, you are ready to close the case. Now you are really close to finish the assembling process!


Build51 join parts close 02.jpg

2. Close the case slowly, taking care that the cables are not being trapped. Probably you would need to help the control flat cable to get into the case while closing it.


First boot splash screen

3. Before securing the case top and inserting the knobs, it's a good time to burn a SD-card with the latest zynthian software image and check everything is working OK. Please, use a good quality SD-card and follow the instructions carefully.

First boot could take some time. After a minute or so, you will see the display fill with upside-down text, then a login prompt, which will automatically continue. Don't be impatient - wait perhaps 5 minutes until you see the splash screen with the logo. If the display remains black after 1 minute (no upside-down text is displayed), please re-check the instructions and re-burn the SD-card again. If this still doesn't work, try with a different SD-card before reporting in the forum. For solving SD-card issues, it could be useful to check the RPi5 status LEDs.

Once you see the splash screen, it could take a few more minutes until the system is ready. You deserve a beer, or at least some some tea or coffee. When the first-boot process finishes, the Zynthian will reboot and you will be in the main menu, ready to play.


Capture000124 fixed wiki.jpg
Capture000125 fixed wiki.jpg

5. If everything worked fine and your zynthian is alive, please, finish the task before start exploring your new zynthian V5.1. Take the remaining 6 x ISO7380 M3 screws and secure the case, 3 on each side. You should place all the 6 screws before tightening any of them. Tighten enough, but not too much.


Build51 join parts close 03.jpg

5.4 Attach and secure the knobs


Capture000131 fixed wiki.jpg

1. Take the 4 x mechanized aluminum knobs from the wiring bag and the 4 x super-tiny DIN916 M3 screws (headless screws).


Capture000132 fixed wiki.jpg
Capture000133 fixed wiki.jpg

2. Insert the headless screw in the allen wrench and screw it partially into the knob side hole, until its head is slightly over the knob side.


Capture000135 fixed wiki.jpg

3. Repeat the step for the 4 knobs.


Capture000136 fixed wiki.jpg

4. Turn the 4 x rotary encoders until the flat cotter is pointing outside.


Capture000137 fixed wiki.jpg

5. Tighten the headless screws. Enough but not too much.


Capture000140 fixed wiki.jpg


6. Congratulations! Your Zynthian V5.1 is ready to boot for the first (or second??) time. If you didn't yet, it's time to burn a SD-card with the latest zynthian software image. Please, use a good quality SD-card and follow the instructions carefully.


Capture000158 fixed 1024.jpg

Note that the wiring kit should include a little tool to help inserting/removing the SD-card. It's a small rectangular piece of black-anodized aluminum with the zynthian logo, like shown in the picture:


6 First Boot

First boot could take some time. Don't be impatient and wait until you see the splash screen with the logo. If the display remains black after 1 minute, please, re-check the instructions and re-burn the SD-card again. If this still don't work, try with a different SD-card before reporting in the forum. For solving SD-card issues, it could be useful to check the RPi5 status LEDs.

Once you see the splash screen, it could 1-2 minutes to finish the configuration process. You deserve a beer (hey!! don't abuse if you already took one!!), or at less some tea or coffee. When the first-boot process finishes, the zynthian will reboot and you will be in the main menu, ready to play.

It's time to remove the display's protective sheet (please, do it!!) and take a look to the user's guide!


If the first boot did not finish right and you did not get into the zynthian user interface, you should carefully re-check the wiring before trying again:

  • If the display remains black, you should check the display cable connection.
  • If you get the ERROR screen, most probably your control board is not being detected and you should check the control-1 cable connection.

You should check both sides of connection. Check that orientation is correct, the cable is well inserted and the connector totally closed. If it still doesn't work, you could look for damaged cable contacts, solder bridges on the PCB connectors, etc.

WARNING!!

AFTER A FAILED FIRST BOOT, YOU SHOULD NOT BOOT AGAIN WITH THE SAME SD-CARD AS IT IS.


If hardware can't be detected, the SD-card is configured as "custom hardware" and first boot is disabled. You must re-burn the SD-card or reset the SD-card from the terminal with this command:

set_first_boot.sh

You can reach the terminal from webconf or using SSH.

From the terminal, you can check the first boot log with this command:

cat /root/first_boot.log

This could help you to understand what is going wrong. You should include this log when asking for help in the forum. Also, when reporting first boot issues, it could be very helpful to include the output of this command:

i2cdetect -y 1 

When everything is OK you should get something like this:

    0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:                         -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
20: 20 21 -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- UU -- -- UU -- -- 
50: -- -- UU -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: UU -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- -- --                         

If things are not working OK, you could get something like this, for instance

    0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:                         -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- 4a -- -- 4d -- -- 
50: -- -- 62 -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: 60 -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- -- --                         

Note the absence of the chips addressed in 20 & 21 (2 x MCP23017). This means your control board is not being detected and most probably is not well connected.


7 V5 KITS SOLD BEFORE 2025-06-01 - Fixing FFC connectors

Recently we have detected a little defect (thanks @simmeah!) that could be the cause of some rare issues reported from time to time. We never experienced these issues in any of the builds we realized in zynthian labs and this is the reason we haven't detected the problem until now.


WARNING!!

All kits sold after 2025-06-01 are fixed and free from this defect.


The symptoms

  • Control board connection issues, like:
    • Control board not being detected on first boot (see section 6).
    • Some buttons or knobs behave erratically or don't work.
  • SD-card extender doesn't work or it's not stable enough.


and:

  • YOU HAVE DOUBLE CHECKED the build tutorial and you are sure you followed the instructions carefully and everything is according to them.
  • You are using good quality SD-cards of the right sizes (32 or 64GB). Also, check the SD-card extender is not broken nor damaged.


Note:

This should be a last-resource action before considering to replace the board.


The defect

FPC-issue-bent-cable.jpeg

The FFC connectors soldered on main and control boards doesn't fit perfectly the standard ribbon cables we include in the V5 kit, causing the cable to bent when closing the latch and potentially causing bad contact or, at worst case, damaging the flat cable.

The reason is we accidentally choose a wrong part number and didn't realize until now because the difference is really small and it works most of times. Indeed I never suffered the issue in any build I did here, in zynthian labs, and I did a few!

We have already fixed the BOMs so next boards will be manufactured with the right part number. Also, we are fixing all boards we have stocked so:


Note:

ALL V5 KITS SOLD AFTER 2025-06-01 ARE FREE FROM THIS DEFECT and you don't need to fix this because we already did. If you have issues, the cause is not this.


The fix

FPC-issue plastic bumps redcircles.jpg

Anyway i would like to offer a solution for those having issues with this. Indeed, the solution is simple and it has been already explained by @simmeah in the forum:

Use a cutter or scalpel to cut the 2 tiny plastic bumps that cause the issue.

The bumps are really tiny and you probably need good eyes or magnifying glasses. The tool must be well sharpened, so the plastic bumps can be cut will minimal force. Be extremely careful to not worsen things by breaking the FFC's latch.


You must repeat the operation for all FFC connectors used by V5. They are:

V5.1 main fpc issue 01.jpg
  • Main Board
    • CONTROL-1
    • USB-C1
    • SDCARD-RBPi1


V5.1 control fpc issue 01.jpg
  • Control Board
    • CONTROL-1


May the force be with you and remember: better asking than crying!!