RevPi Images
RevPi base modules are delivered with a pre-installed RevPi image. The RevPi image is based on Raspberry Pi OS, which in turn is based on Debian. Adjustments were made to the Raspberry Pi OS for the RevPi images: unnecessary packages were removed, APT repositories were retrofitted and packages from KUNBUS were installed. For details, see GitLab in the Revolution Pi Image Bakery.
Compatibility
| Device | Image |
|---|---|
| RevPi Connect 5 | Bookworm |
| RevPi Connect 4 | Bullseye, Bookworm |
| RevPi Connect S/SE | Buster, Bullseye, Bookworm |
| RevPi Connect+ | Jessie, Stretch, Buster, Bullseye, Bookworm |
| RevPi Connect | Jessie, Stretch, Buster, Bullseye, Bookworm |
| RevPi Core S/SE | Buster, Bullseye, Bookworm |
| RevPi Core 3 | Jessie, Stretch, Buster, Bullseye, Bookworm |
| RevPi Core 3+ | Wheezy, Jessie, Stretch, Buster, Bullseye, Bookworm |
| RevPi Core 1 | Wheezy, Jessie, Stretch, Buster |
| RevPi Compact | Stretch, Buster, Bullseye, Bookworm |
| RevPi Flat S | Bullseye, Bookworm |
| RevPi Flat | Buster, Bullseye, Bookworm |
License Terms and Conditions
A RevPi image is derived from Raspberry Pi OS, whose components are subject to different open source licenses. In addition, proprietary software packages and software are supplied with the image. KUNBUS owns the copyrights for the following packages:
- revpi-webstatus
- revpi-repo
- revpi-tools
- pitest
- piControl.ko
- piserial
- pictory
- revpi-wallpaper
- revpi-modbus-client
- revpi-modbus-server
These packages, including the components for which KUNBUS holds the copyrights, are subject to the GNU General Public License, Version 2.
A RevPi image also contains open source components that have been created or modified by KUNBUS. The source codes of these open source components are made available at gitlab.com/revolutionpi. In accordance with the license conditions, these source texts are also made available by KUNBUS on data carriers, which are available on request at support@kunbus.com for a processing fee.
Components of the RevPi image that are taken from Raspberry Pi OS are subject to different open source licenses. The license conditions of each individual component are listed in the package directories under /usr/share/doc/ in the copyright.txt files.
Query Device Information
▷ Log in to the RevPi via a terminal.
▷ Enter one of the following commands to query device information:
| Command | Function |
|---|---|
revpi-device-info | Outputs the device information. Only for devices with HAT EEPROM. |
cat /etc/revpi/image-release | Returns the name of the most recently installed image version (.img). |
cat /etc/os-release | Displays the name and version of the Debian operating system used. |
Installing Updates
Check at regular intervals whether updates are available. Install updates promptly to close security gaps.
Install updates via Cockpit
▷ Start Cockpit.
▷ Click on Software updates in the menu to open the Status page.
▷ Click the Check for updates button to refresh the list of available updates.
▷ Click the Install all updates button to perform the available updates.
Install updates via terminal
▷ Log in to the RevPi via a terminal.
▷ Enter the following command to read and update all available package lists:sudo apt-get update
▷ Enter the following command to install all available updates:sudo apt-get upgrade
▷ Enter the following command to restart the RevPi:sudo reboot
Saving the Image
Save an existing image of a RevPi base module under Windows on an external data carrier such as a USB stick or hard disk.
You require:
✓ A cable USB-2.0 type A to Micro-USB or USB-C
✓ A data carrier with sufficient storage space, e.g. USB stick or hard disk
▷ Deactivate the watchdog if necessary.
▷ Shut down the RevPi and disconnect it from the power supply.
▷ Connect the RevPi to your PC via the micro USB or USB-C socket.
▷ Start the Windows installer RPi Boot.
▷ Connect your RevPi to the power supply.
❯ RPi Boot searches for the RevPi until a new drive is recognized as a removable disk.
▷ Click on Action for removable disk > No action.
❯ A drive letter is assigned to the RevPi as a removable disk, e.g. [D:\]
▷ Start the Win32 Disk Imager.
▷ Under Image file, select the prepared data carrier, e.g. the USB stick.
▷ Enter a name for the image. The name must have the file extension .img.
▷ Select the drive letter of the RevPi under Data carrier.
▷ Click to read.
❯❯ The backup of your image will be created. This process may take a few minutes.
Reinstalling the Image
Install a new RevPi image under Windows on the RevPi base module.
Download and check image
You require:
✓ MD5 checksum checker, e.g. WinMD5Free
▷ Unpack the RevPi image package (.zip).
❯ The zip contains the image file (.img), the MD5 file (.md5), release notes and license terms as PDF.
▷ Start the WinMD5Free program.
▷ Select the image file (.img) for the check.
❯ The checksum is calculated.
▷ Open the MD5 file (.md5) in an editor.
▷ Copy the contained checksum as original md5 value into WinMD5Free.
▷ Click the Verify button.
❯❯ The checksum is being verified.
❯❯ If Matched! is displayed, the unpacked image corresponds to the published checksum.
❯❯ If NOT Matched! is displayed, the RevPi image package must be downloaded and checked again.
Installing Checked Image
You require:
✓ A cable USB-2.0 type A to Micro-USB or USB-C ✓ Windows Installer RPi Boot ✓ Win32 Disk Imager
▷ Deactivate the watchdog if necessary.
▷ Shut down the RevPi and disconnect it from the power supply.
▷ Connect the RevPi to your PC via the micro USB or USB-C socket.
▷ Start the Windows installer RPi Boot.
▷ Connect your RevPi to the power supply.
❯ RPi Boot searches for the RevPi until a new drive is recognized as a removable disk.
▷ Click on Action for removable disk > No action.
❯ A drive letter is assigned to the RevPi as a removable disk, e.g. [D:\]
▷ Start the Win32 Disk Imager.
▷ Under Image file , select the new, checked image file (.img).
▷ Select the drive letter of the RevPi under Data carrier.
▷ Click on the Write button > Yes.
❯ The new image is installed on the RevPi. This process may take a few minutes. The message Writing was successful appears.
▷ Disconnect the RevPi from the power supply.
▷ Remove the USB cable. NOTICE! As long as the Micro-USB plug / USB-C plug is connected, the RevPi is in flash mode and can only be brought into operating mode by rebooting.
▷ Connect the power supply.
❯ The RevPi boots with the new image.
▷ After a new installation, log in with the Raspberry Pi default user pi and the default password raspberry.
NOTICE: Note the English keyboard layout when entering the password, i.e. y instead of z.
▷ Reboot RevPi.
▷ Log in with user name pi and the device password.
You will find the device password on the sticker on the side of the housing of the RevPi base module.
Change Device Password
Change the default password after the first login to the device to prevent unauthorized access. Use a strong password.
Change Device Password via Terminal
▷ Establish access to the RevPi base module via a terminal.
▷ Enter the command passwd and confirm with Enter.
▷ Enter the new password twice and confirm each time with Enter.
The password is not displayed under Linux.
❯❯ Password updated successfully appears in the terminal. The device password for user pi has been changed.
Change Device Password via Cockpit
▷ Start Cockpit.
▷ Click on Accounts in the menu to open the user administration.
▷ Click on the three-dot menu ⁝ for user pi and click on Edit user.
▷ Click button Set password.
▷ Enter the new password twice and confirm by clicking on button Set password.
❯❯ The device password for user pi has been changed.