2,718
edits
Changes
no edit summary
== Official ZynthianOS SD-Images ==
== Official ZynthianOS SD-Images ==
You can download the stable ZynthianOS SD-image from here:
'''[https://os.zynthian.org/zynthianos-last-stable.zip Last Stable ZynthianOS]''' ([https://os.zynthian.org/zynthianos-last-stable.zip.md5 MD5-sum])
'''[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:
'''[https://os.zynthian.org/test/2024-03-01-zynthianos-bookworm-aarch64-oram-2403.zip Testing ZynthianOS - Oram Bookworm 64]''' ([https://os.zynthian.org/test/2024-03-01-zynthianos-bookworm-aarch64-oram-2403.zip.md5 MD5-sum])
<br>
{{WarningBox| The testing version contains new features and a lot of fixes but it's not totally finished, so it's not recommended for production work.}}
<br>
== Unzipping ==
== Unzipping ==
The file you download is a zip file that must be unzipped to get a ''.img'' file that can be 'burnt' to the micro-SD card used by the zynthian device (Raspberry Pi). This process differs depending on the operating system you normally use: windows, mac or linux.
The file you download is a zip file that must be unzipped to get a ''.img'' file that can be 'burnt' to the micro-SD card used by the zynthian device (Raspberry Pi). This process differs depending on the operating system you use: windows, mac or linux.
<!--
<!--
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.
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].
{{NoteBox|RBPi2 is not currently supported by the latest official zynthian SD-images, so if you want to use a RBPi2, you may need to build your own SD-image.}}
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:
umount /dev/sdc1
pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
sync
or if you are a ''sudoer'':
sudo umount /dev/sdc1
sudo pv 2023-08-25-zynthianos-stable-2308.img > /dev/sdc
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.}}
<br>
== First Boot ==
First boot could take some time. Don't be impatient 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 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].
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.
<br>
== Configuration instructions ==
== Configuration instructions ==
Recent SD-images auto-detect latest official kits V3, V4 & V5. If you are using an older kit or a custom hardware, your first step after booting should be accessing the webconf and configuring your hardware.
* For accessing the webconf tool, [[Accessing_Zynthian_from_your_computer#Accessing_the_Web_Configuration_Tool|see here]]
* For accessing the webconf tool, [[Accessing_Zynthian_from_your_computer#Accessing_the_Web_Configuration_Tool|see here]]
* When everything is configured, you can reboot Zynthian using the System -> Reboot menu item
* When everything is configured, you can reboot Zynthian using the System -> Reboot menu item
== Build your own image ==
<br>
== Build your own SD-image ==
If you like, you can build your own SD image following these instructions:
If you like, you can build your own SD image following these instructions: