3,509
edits
Changes
→First Boot
Line 1:
Line 1:
−You can download the stable ZynthianOS SD-image from here:+ '''[https://os.zynthian.org/zynthianos-last-stable.zip Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.zip.md5 MD5-sum])+ +<br>
−The latest testing image, called Oram, is available here:+ +After downloading and unzipping the SD-image, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 16GB'''. You can use a bigger one if you like.+You can use [https://etcher.io/ Etcher], a free software that works on Mac, Windows and Linux, to write the image into the SD-card. There is a really good manual for this at [https://www.raspberrypi.org/documentation/installation/installing-images/ this link].+
−
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Once you see the splash screen, it could take some minutes until the system is ready. You deserve a beer, or at least 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.+
== Official ZynthianOS SD-Images ==
+== Stable ZynthianOS SD-image ==
−'''Full Version:'''
+ '''[https://os.zynthian.org/zynthianos-last-stable.img.xz Stable ZynthianOS - Oram (Bookworm arm64)]''' ([https://os.zynthian.org/zynthianos-last-stable.img.xz.md5 MD5-sum])
+'''Lite Version (reduced soundfont library):'''
+ '''[https://os.zynthian.org/zynthianos-last-stable-nosfz.img.xz Stable ZynthianOS - Oram (Bookworm arm64)]''' ([https://os.zynthian.org/zynthianos-last-stable.img-nosfz.xz.md5 MD5-sum])
−<!--
−== Testing ZynthianOS SD-image ==
−'''Full Version:'''
− '''[https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409.img.xz.md5 MD5-sum])
− '''[https://os.zynthian.org/test/2024-09-14-zynthianos-bookworm-aarch64-oram-2409.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-14-zynthianos-bookworm-aarch64-oram-2409.img.xz.md5 MD5-sum])
+'''Lite Version (reduced soundfont library):'''
+ '''[https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409-nosfz.img.xz Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-09-23-zynthianos-bookworm-aarch64-oram-2409-nosfz.img.xz.md5 MD5-sum])
<br>
<br>
Line 16:
Line 19:
<br>
<br>
+-->
== Unzipping ==
== Unzipping ==
Line 37:
Line 41:
== Preparing the SD-card ==
== Preparing the SD-card ==
−Latest SD-card image weight around 8 GB compressed and around 14 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits. Completely ready to use. Plug and play!
+Latest SD-card image weight around 7 GB compressed and around 16 GB unzipped. It includes all the software you need for your zynthian, properly configured for working out-the-box with the latest official kits.
+After downloading, you have to write it to a suitable SD-card. You need a good-quality SD-card with a '''minimum size of 32GB'''. You can use a bigger one if you like, but big SD-card can be more problematic than smaller ones. We don't recommend to go above 64GB. Please, use SD-cards from trusted sources and well-known brands and models. Sandisk Extreme & Pro are known to work fine. Samsung SD-cards also are good candidates. Kingston are more prone to fail.
−If you are a GUI guy, we recommend to use '''[https://www.raspberrypi.com/software/ RPi-Imager]''' to write the image into the SD-card. The '''Gnome Disk Tool''' also works fine, and probably others too. We don't recommend BalenaEtcher anymore because it's causing much trouble lately.
−If you are a terminal guy, ''dd'' or ''pv'' will do the task. Don't forget to uncompress the file, ''unmount'' the SD partition before burning and ''sync'' before extracting the card. With root privileges. Run something like this:
−If you are a terminal guy, ''dd'' or ''pv'' will do the task. Don't forget to ''unmount'' the SD partition before burning and ''sync'' before extracting the card. With root privileges, run something like this:
+ tar -xf zynthianos-last-stable.img.xz
umount /dev/sdc1
umount /dev/sdc1
− pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
+ pv zynthianos-last-stable.img.xz.img > /dev/sdc
sync
sync
or if you are a ''sudoer'':
or if you are a ''sudoer'':
+ tar -xf zynthianos-last-stable.img.xz
sudo umount /dev/sdc1
sudo umount /dev/sdc1
− sudo pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
+ sudo pv zynthianos-last-stable.img.xz.img > /dev/sdc
sudo sync
sudo sync
−{{NoteBox|RBPi2 is not supported by recent zynthian SD-images. If you want to use a RBPi2, you may need to build your own SD-image.}}
+{{NoteBox|RBPi2 is not longer supported by zynthianOS. If you want to use a RBPi2, you have to build your own SD-image.}}
<br>
<br>
Line 62:
Line 67:
== First Boot ==
== First Boot ==
−First boot could take some time. Be patient and wait until you see the splash screen with the logo. If you have a recent kit (V3, V4 & V5) and the display remains black after 1 minute, please, re-check the instructions above 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 RPi4 status LEDs].
+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].
+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>
+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>
<br>