Mervis on Unipi Neuron


The Mervis OS image can be written to an SD card using the open-source BalenaEtcher tool (for Windows OS) and then run on Unipi Neuron.

You can download BalenaEtcher from official web pages.

The next step is to download the latest version of the image of the OS you selected. An archive with pre-assembled OS is available on webpage: Mervis OS for Unipi Neuron.

Extreme caution is essential when choosing a disc. Selecting the wrong storage medium could result in data loss on a storage other than the desired one.

For trouble-free Mervis OS usage on Unipi Neuron, you will need storage with capacity of at least 2 GB.

We always recommend using industrial SLC SD cards.

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 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!

Before running the OS on a Unipi device

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.

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. The easiest way to do this is to create a file called ssh.txt, or just ssh without the suffix, in the main boot directory of the storage. Alternatively, 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.

If SSH is enabled, the operating system must be secured, otherwise unauthorized interference may occur!

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.

Disk storage can ONLY be inserted when the device power supply is unplugged!

Insert the SD card back side up into the slot (i.e. the gold connectors towards the technician). Plug the power supply in.

Booting the device with the newly flashed OS will take a little longer - about 2 minutes. This is due to the necessary configuration of the OS.

Download the latest version of Mervis from our download section and run the installation package.

The installation process displays the welcome screen, which you can confirm by clicking on Next.

In next dialog, you have to confirm the License agreement and click on Next

In next dialog, we can select parts of Mervis for installation. The IDE is the editor, in which we will create and debug programs for Unipi unit. The Windows RT is a simulator of a unit, if you don't have one. Typically, you will need only the IDE.

In older Mervis version, there was also option for installing HMI editor. In current version, the HMI editor has been merged into IDE.

Last two dialogs are just for confirmation of the installation process and finishing it. Just hit Install and then Finish.