====== Linux Images ======

===== Downloading =====

The images that are currently available for the [[ ..:yocto:bblue ]], [[ ..:yocto:cb20 ]] and [[ ..:yocto:x86-rt ]] can be downloaded from the {{https://gitlab.ost.ch/tech/inf/public/yocto/meta-ost/-/packages | meta-ost Gitlab package registry}}.

Please note, that these images are built for development, see [[software:linux:yocto:meta-ost#ost-distro_vs_ost-devel_-_Development_vs_Production_Images|Development vs Production]]. For production images you have to built it with a full yocto installation, see [[software:linux:yocto:setup|Setup and Building]] or use the eSDK, see [[software:linux:yocto:sdks|SDK's]].


===== Extracting =====
The images for [[ ..:yocto:bblue ]] and [[ ..:yocto:x86-rt ]] are provided in ''gzipped'' and need to be decompressed using ''gunzip'' before use:
<code>
gunzip ost-image-*.wic.gz
</code> Note that ''gunzip'' will remove the original ''.wic.gz'' file and only the ''.wic'' file will be available after. ''gzip'' and ''gunzip'' should come preinstalled on most distributions, otherwise search for the ''gzip'' package in your distro's repositories.

Images for [[ ..:yocto:cb20 ]] are provided as *Tezi*.tar file. You have to unpack it before it is recognized by the easy installer. 
<code>
tar -xvf *Tezi*.tar
</code>


===== Flashing onto a SD Card or USB Stick ====
Linux script example for ''.wic'' image flashing onto an external storage device, e.g. an external SD card. <color #ed1c24>Beware: ''sdb'' has to be replaced with the correct device. Use ''lsblk'' command to discover the correct device!</color>. ''sdX'' where ''X'' is a small letter starting from ''a'' usually represents a SATA or USB drive, names starting with ''nvme'' represent NVME SSDs and SD cards usually start with ''mmcblk''.
These names represent the device as found in ''/dev'', so ''sda'' is found under ''/dev/sda''. ''lsblk'' uses a tree to show devices and their partitions. For example ''sda1'' is the first partition on ''sda'' and ''nvme1n1p1'' is the first partition of ''nvme1n1''. 

**WARNING: Writing the image to the USB Stick will erase all content! Make absolutely sure you have identified the correct device! dd will not hesitate to override your OS drive if you tell it to do!**

<code>
#!/bin/sh
umount /dev/sdb*
wipefs -a /dev/sdb
dd if=ost-ros-image-melodic-bblue.wic of=/dev/sdb bs=1M status=progress
eject /dev/sdb
</code>


===== Using the Images =====

==== Installing =====

The process for installing images is dependent on the target hardware.
Hence, see section "Installing Images" in

^  Hardware       ^  Installation instructions  ^
|  CB20         |  [[ ..:yocto:cb20 ]]        |
|  BBBlue       |  [[ ..:yocto:bblue ]]       |
|  CX2020       |  [[ ..:yocto:x86-rt ]]      |
|  C6930        |  [[ ..:yocto:x86-rt ]]      |
|  generic x86  |  [[ ..:yocto:x86-rt ]]      |

==== Configuring the Network ====

See [[software:linux:linux_os:network|General Network Settings]] for help to setup necessary network connections.