This is an old revision of the document!


OS Images

This section contains OS images for our controllers.

Mervis OS are versioned the same way as Mervis IDE releases. Eg. Mervis OS 2.3.0.x will work with IDE 2.3.0 but might not work with IDE 2.2.0. Mervis IDE 2.3.0 requires Mervis OS 2.2.0.x at least, but also requires update of the Mervis RT. Compatibility with Mervis OS older than 2.2.0 is not guaranteed.

If you uploaded a new OS image into your controller, it will automatically update its internal firmware during the first startup. That said, make sure to wait a few minutes after starting up the PLC. Disconnecting the power during the firmware update would cause the firmware to be corrupted. In such a case, the controller would have to be shipped back to the manufacturer for firmware re-flash.

Unipi Axon

  • To install the Mervis OS into these controllers, you can use one of Flashing the OS methods.

Unipi Neuron/1.1

  • Installation on these controllers is indirect, as the OS is burned onto an mSD card with the card insterted into the PLC afterwards. Full description of the process is available in the Mervis on Unipi Neuron / 1.1 tutorial.

Every PLC with Mervis OS 2.3.0 and newer requires a license.

If the PLC is not licenced, it will run in demo mode. The demo mode does not limit the functionality, but the program will run only for 20 minutes. After that time, the program will stop running and RUN LEDs will start blinking in a 2-second interval (on/off).

Make sure to Update Runtime at first and then license the PLC.

The factory default Debian-based OS for Patron controllers. Pre-installed by default on all Patron controllers

Patron OpenSource OS

Image for development or OEM use. Includes ModbusTCP&SysFS drivers.

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

The factory default Debian-based OS for Axon controllers. Pre-installed by default on all Axon controllers

Axon Mervis OS

Contains Mervis tools and default ModbusTCP & SysFS drivers.

Up-to-date Mervis OS image for Axons

Axon Node-RED OS

To make the Node-RED installation process as easy as possible, we created a pre-assembled OS image containing everything that's needed for a successful Node-RED launch. The OS is based on Debian OS and included all required drivers for Axon controllers (kernel driver, overlay, RTC support, Modbus TCP, SysFS, EVOK).

A quick-start and installation guide is available at this link

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

Axon OpenSource OS

Image for development or OEM use. Includes ModbusTCP&SysFS drivers. EVOK should be installed using the apt, according to the guide on its GitHub page.

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

Neuron Mervis OS

An up-to-date Mervis OS image to be deployed to a SD card for Neuron controllers running Mervis RT.

Previous images only for Neuron controllers

Previous images of Mervis OS for Neuron and also UniPi 1.

To install this OS, it is necessary to have an SD card with a capacity of at least 2GB in the device. Since Mervis OS v1.7 the SSH is disabled by default and can be enabled by placing a file named ssh, without any file extension, onto the boot partition of the SD if needed. The username is “unipi” and password is “unipi.technology”.


Neuron Node-RED OS

To make the Node-RED installation process as easy as possible, we created a pre-assembled OS image containing everything that's needed for a successful Node-RED launch. The OS is based on Debian OS and included all required drivers for Neuron controllers (kernel driver, overlay, RTC support, Modbus TCP, SysFS, EVOK).

A quick-start and installation guide is available at this link

To install this OS, it is necessary to have an SD card with a capacity of at least 4GB in the device. The SSH is enabled by default. The username is: unipi and password is: unipi.technology.


Neuron OpenSource OS

Image for development or OEM use. Includes ModbusTCP&SysFS drivers. Evok should be installed using the apt, according to the guide on its GitHub page.

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

To install this OS, it is necessary to have an SD card with a capacity of at least 2GB in the device.


Extension FW upgrade OS for Neurons

This is a special image for Neurons whose only purpose is to upgrade inner firmware of Extensions (xS10,xS30,xS50) and Neuron controllers to work properly with Mervis UniPi device prototypes v2.0.

It automatically tries to detect UniPi Extensions on RS485-1 at 9600/19200/115200bps having Modbus addresses 1-31 only using 8N1.

The process of FW upgrade is indicated by flashing upper and lower rows of diodes.

Do not disconnect the power supply nor from Neuron and Extension until the LEDs stops blinking! Otherwise, the devices might be bricked!

Operating systems for Unipi Gate are based on the Debian OS. Gate series devices are shipped with the Node-RED image by default.

Gate Node-RED OS

To make the Node-RED installation process as easy as possible, we created a pre-assembled OS image containing everything that's needed for a successful Node-RED launch. The OS is based on Debian OS and included all required drivers for Unipi Gates.

A quick-start and installation guide is available at this link

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

Gate OpenSource OS

A clean OS image for development or OEM use.

The SSH is enabled by default. The username is: unipi and password is: unipi.technology.

Unipi 1.1 Mervis OS

An up-to-date Mervis OS image to be deployed to a SD card for UniPi 1 controllers (Unipi 1.1 and Unipi 1.1. lite) running Mervis RT.

Previous Mervis OS images only for Unipi 1.1/Lite

In the previous Mervis OS versions, the Unipi 1.1 controllers shared OS image with the Neuron line. See Neuron - UniPi Mervis OS.

To install this OS, it is necessary to have an SD card with a capacity of at least 2GB in the device.

Unipi 1.1 Node-RED OS

To make the Node-RED installation process as easy as possible, we created a pre-assembled OS image containing everything that's needed for a successful Node-RED launch. The OS is based on Debian OS and included all required drivers for Unipi 1.1 controllers (kernel driver, overlay, RTC support, Modbus TCP, SysFS, EVOK).

A quick-start and installation guide is available at: this link

To install this OS, it is necessary to have an SD card with a capacity of at least 4GB in the device. The SSH is enabled by default. The username is: unipi and password is: unipi.technology.


Opensource images

We do not provide the ready opensource image (Like UniPian) for the first generation of UniPi. Please use the standard Raspbian Lite with Evok installed according to the guide on its GitHub page.

FHEM software image (obsolete)