Table of Contents
Flash / backup the OS
Unipi 1.1
Pro spuštění operačního systému na zařízení Unipi 1.1 je nejprve nutné nahrát obraz OS na SD kartu. Vhodným nástrojem pro OS Windows je open-source program BalenaEtcher.
Program BalenaEtcher je možné stáhnout z oficiálních stránek.
Upozornění!
Při výběru disku je nezbytně nutná maximální opatrnost. Výběr nesprávného úložiště by měl za následek ztrátu dat na jiném, než požadovaném úložišti.
Poznámka:
Pro bezproblémový provoz Mervis OS na zařízení Unipi 1.1 budete potřebovat úložiště o kapacitě alespoň 2 GB.
Pokud se rozhodnete pro jinou platformu než Mervis, doporučujeme použití úložiště o kapacitě alespoň 4 GB.
Vždy doporučujeme použití průmyslové pSLC SD karty.
Flashing OS image from a file
When running BalenaEtcher, there are three options in the main menu, selecting the first Flash from file will bring up a file explorer to select a disk image. This disk image can either be directly in *.img or *.raw format, or it can be packaged in a ZIP archive.
After successful selection of the OS image, the next option Select target is possible to select a suitable storage. When selecting, please note the caution in the introduction of the article.
Flashing the OS image to storage will start after clicking on Flash!
Flashing OS image from an URL
BalenaEtcher also allows you to upload an OS image directly from a URL link to an .img or .zip file (with an OS image). In the main menu there is a choice of Flash from URL.
The field labeled Enter a valid URL (under the heading Use Image URL) is used to enter the address of the OS image.
OS image URL can be obtained by right click on “Download” button and selecting Copy Link from context menu.
If the image source requires a login credentials, a username and password can be entered in the Authentication section.
The selection of the suitable storage to which the OS image is to be written is possible by checking the checkbox. When selecting, please note the caution in the introduction of the article.
Flashing the OS image to storage will start after clicking on Flash!
Cloning a disk with an OS image (backup the OS)
Attention:
After time some hardware parameters of compute module can be updated (different RAM, different eMMC).
This can require firmware update of compute module for correct functionality.
All devices are always shipped with up-to-date firmware for compute module.
When restoring the backup from older device, the older firmware might be incompatible with a newer compute module and the device might not run properly. It is recommended to regularly update and maintain the backup of the devices to be compatible with the newest version. The backups will then be usable for newer devices. For more information follow the PCN from the compute module manufacturer (https://pip.raspberrypi.com/).
If a situation happens, where backup cannot be restored (the device is not starting), it is necessary to restore the backup on some other older device and update the system. Then create a backup from the newly updated system. This new backup will work on newer devices.
The last option in BalenaEtcher is to clone the storage. Cloning is especially useful for creating a backup before the final placement of the Unipi device and start of operation. In the main menu, this is the third option Clone drive.
The selection of source storage will appear. When selecting, please note the caution in the introduction of the article.
To select a target storage (or multiple storages), click Select target. When selecting, please note the caution in the introduction of the article.
Select the target storage, which should be rewritten with the backup from source storage.
Flashing the OS image to storage will start after clicking on Flash!
Before running the OS on a Unipi device
Note:
After finishing the flash, or after the storage drive is reinserted into the PC, Windows OS may detect it as a new storage device that it cannot recognize and may request formatting. Close the formatting prompt by clicking on Cancel.
The Windows OS may also display notification that the storage is unavailable. This message can be ignored.
Inserting password for SSH
It is necessary for the first login to insert a user password onto the SD card. For further information see Passwords.
Here are the instructions for setting the user password:
- Choose a new password and using the tool below generate hash from your password
- Open the SD card in file explorer
- Create a new file named PWD_HASH_USER in the root directory of the boot FAT32 partition. It is important the file has no file extension, do not add .txt at the end. Open the newly created file in a text editor and paste the generated hash
- Download and save the file with hash to the root directory into the boot FAT32 partition of the SD card
- Eject the SD card and insert it into the device
- After the device starts, the new password will be set. It will now be possible to log in over SSH with the password entered in step 1.
Note:
This process can only be done once, if the device is in factory settings (newly flashed SD card). If the user password was previously set on the SD card this process will not work.
Hash generator
*
*
*
Note:
If you are offline, this tool can also be found in the FAT32 partition of the Neuron and Unipi 1.1 image.
Note for Debian 12 and older:
If the OS image has been successfully flashed, the storage will be identified with the name boot when re-inserted into the PC.
If the Mervis OS has been flashed on the storage, there is one last step possible: enabling SSH. SSH can be activated directly in the Mervis IDE by changing the RunTime configuration, see section Uploading a RunTime configuration (RT) - unipi specific. For non-Mervis OS, the SSH connection is enabled by default and does not need to be enabled in this way.
After SSH is enabled, you can connect with, for example, Putty.
Running the OS on a Unipi device
At this moment, the OS is ready on a storage (with SSH enabled). After removing it from the computer, the storage can be inserted into the Unipi device.
Attention:
Disk storage can ONLY be inserted when the device power supply is unplugged!
Note:
Insert the SD card back side up into the slot (i.e. the gold connectors towards the technician). Plug the power supply in.
Attention:
Booting the device with the newly flashed OS will take a little longer - about 3 minutes. This is due to the necessary configuration of the OS.