Here you can find the most important steps to get your RevPi up and running.
▷ Observe the specifications for the intended use.
▷ Familiarize yourself with the safety instructions before commissioning.
Mounting and Connecting #
The RevPi was developed for use in a control cabinet. Observe the specifications for the intended use.
|
Warning
|
Danger to life due to electrical shock
There is a risk of fatal electrical shock when working on devices in the switch cabinet with 230 V mains voltage. ▷ Operations in the switch cabinet may only be carried out by qualified electricians. ▷ Before carrying out any operations in the switch cabinet, switch off the power supply properly. |
Carry out the installation and connection in the following order:
-
Mount the RevPi base module and all expansion modules on a DIN rail.
-
Connect all expansion modules via PiBridge plug connectors.
-
If applicable, connect the RevPi Con modules via ConBridge plug connectors.
-
Connect all other devices such as sensors and actuators.
-
Finally, connect the power supply.
Mounting the Device on a DIN Rail #
|
Caution
|
Damage to the device due to overheating
The ambient temperature in the switch cabinet must not exceed the maximum permissible operating temperature. ▷ Keep ventilation slots clear. ▷ Observe the installation clearances. ▷ Mount the device in the intended orientation. ▷ Do not place appliances with high input power directly next to each other. ▷ Regularly remove dust and dirt from the area around the appliance. |
You require:
✓ A switch cabinet with DIN rail 35 × 7.5 mm in accordance withDIN EN 60715 (TH35)
✓ A small slotted screwdriver
▷ Use the slotted screwdriver to open the black locking clips on the back of the RevPi housing.
▷ Hold the RevPi with the back against the DIN rail.
▷ Observe the installation distances:
-
Min. 20 mm to the right and left
-
Min. 30 mm upwards and downwards
▷ Close the locking clips.
▷ Check whether the RevPi is firmly connected to the DIN rail.
Rules for the Arrangement of Devices #
The RevPi base module forms the starting point for a Revolution Pi system and determines the maximum possible number of expansion modules on the left and right sides.
| Left Side | Base Module | Right Side |
|---|---|---|
5 × RevPi I/O module or |
RevPi Connect 5 |
5 × RevPi I/O module or |
5 × RevPi I/O module |
RevPi Connect 4 |
5 × RevPi I/O module |
5 × RevPi I/O module |
RevPi Connect SE |
1 × RevPi Con CAN + 1 × RevPi Con M-Bus |
5 × RevPi I/O module or |
RevPi Connect+ |
1 × RevPi Con CAN + 1 × RevPi Con M-Bus |
– |
RevPi Flat S |
– |
Connecting Expansion Modules #
|
Caution
|
Damage to the device due to installation under voltage supply
While the RevPi device is connected to a power source, no other devices may be connected or disconnected, as this may cause damage to the devices. ▷ Do not connect the power supply until all other devices are connected correctly. ▷ Switch off the power supply before disconnecting a device from the system. |
|
Caution
|
Damage to the device due to different grounding
▷ Refer all connections to the same system ground. ▷ Connect external voltage inputs or outputs with different grounding externally. |
|
Caution
|
Damage to the devices due to mix-up of the plug connectors
▷ Only connect RevPi I/O modules and RevPi gateways to the system via the black PiBridge plug connectors. ▷ Only connect RevPi Con M-Bus and RevPi Con CAN to the system via the gray ConBridge plug connectors. |
The RevPi I/O modules and RevPi Gateways are connected to the respective neighboring module via PiBridge plug connectors. The PiBridge is a backplane bus via which all data is transmitted from module to module via a signal line. A PiBridge plug connector is included with the expansion module or can be ordered from the store (item no. 100204).
▷ Make sure that all devices are disconnected from their power supplies.
▷ Observe the Rules for the Arrangement of Devices.
▷ Mount all RevPi devices next to each other on the DIN rail.
▷ Connect the RevPi devices with the black PiBridge plug connector on the top of the housings.
Connecting RevPi Con Modules #
|
Caution
|
Damage to the device due to installation under voltage supply
While the RevPi device is connected to a power source, no other devices may be connected or disconnected, as this may cause damage to the devices. ▷ Do not connect the power supply until all other devices are connected correctly. ▷ Switch off the power supply before disconnecting a device from the system. |
|
Caution
|
Damage to the devices due to mix-up of the plug connectors
▷ Only connect RevPi I/O modules and RevPi gateways to the system via the black PiBridge plug connectors. ▷ Only connect RevPi Con M-Bus and RevPi Con CAN to the system via the gray ConBridge plug connectors. |
RevPi Con modules can only be connected on the right-hand side of the following base modules.
| Left Side | Base Module | Right Side |
|---|---|---|
5 × RevPi I/O module |
RevPi Connect SE |
1 × RevPi Con CAN + 1 × RevPi Con M-Bus |
5 × RevPi I/O module or |
RevPi Connect+ |
1 × RevPi Con CAN + 1 × RevPi Con M-Bus |
The RevPi Con modules are connected to a RevPi Connect S/SE/+ via gray ConBridge plug connectors and supplied with power. A plug connector is included in the scope of delivery of a RevPi Con module or can be ordered via the store (item no. 100297).
▷ Make sure that all devices are disconnected from their power supplies.
▷ Mount the RevPi Con module to the right of the RevPi Connect S/SE/+ on the DIN rail.
▷ Connect the RevPi devices with the gray ConBridge plug connector^] on the top of the housing.
Connecting the Power Supply #
|
Warning
|
Danger to life due to electrical shock
There is a risk of fatal electrical shock when working on devices in the switch cabinet with 230 V mains voltage. ▷ Operations in the switch cabinet may only be carried out by qualified electricians. ▷ Before carrying out any operations in the switch cabinet, switch off the power supply properly. |
|
Caution
|
Damage to the device due to impermissible power supply
▷ Observe the maximum voltage supply of 28.8 V DC. ▷ Only use the supplied plug and a suitable power supply unit. ▷ Ensure correct polarity when connecting. ▷ Ensure a stable power supply. |
|
Caution
|
Damage to the device due to installation under voltage supply
While the RevPi device is connected to a power source, no other devices may be connected or disconnected, as this may cause damage to the devices. ▷ Do not connect the power supply until all other devices are connected correctly. ▷ Switch off the power supply before disconnecting a device from the system. |
|
Caution
|
Damage to the device due to different grounding
▷ Refer all connections to the same system ground. ▷ Connect external voltage inputs or outputs with different grounding externally. |
Wiring via the power connector (X4) is required for the power supply.
You require:
✓ One power supply unit (see maximum power consumption in the data sheet)
✓ Cable with cross-section 0.35 … max. 2.5 mm²
✓ Stripping and crimping pliers
✓ If you use stranded wire, apply suitable wire end sleeves
✓ A small slotted screwdriver
▷ Disconnect all connected devices from their respective power supply.
▷ Connect a supply for the power supply of typ. 24 V DC (10.8 … 28.8 V DC) to the pin marked 24V.
▷ Connect the 0 V supply to the pin marked 0 V.
▷ Optional: connect the functional earth (FE) to the correspondingly marked pin:
|
Note
|
Usually, the functional earth (FE) connection can remain unconnected in standard installations. |
▷ Check all connected devices for correct polarity.
▷ Switch on the power supply unit.
❯❯ The RevPi starts the boot process.
Access to the Device #
The RevPi is accessed in two steps:
Alternatively, access without a network is possible, see Desktop Mode.
Establishing a Network Connection #
|
Caution
|
Security risk due to network connection
The device may be accessed without authorization via the Internet if a network connection is established. ▷ Secure the network connection. ▷ Change the initial device password after the first login on the device. ▷ Use a strong password. ▷ Access via the network only from known devices. |
To be able to access the RevPi base module, you must connect it to a network.
▷ Connect the power supply to the RevPi base module.
▷ Connect the RevPi to a DHCP-capable router using an Ethernet cable at the RJ-45 socket.
❯❯ The network connection is established.
❯❯ If the DHCP router is connected to the Internet and no router settings prohibit a connection, the RevPi is also connected to the Internet.
❯❯ The RevPi was then automatically assigned an IP address.
To connect the RevPi to a network without DHCP, a static IP address must be configured for the device.
Login on the Device #
If the RevPi base module and your PC are in the same network, you can access the RevPi via a web browser. As of RevPi Bookworm (10/2024) you can login via Cockpit.
✓ RevPi Bookworm or higher is installed on the RevPi.
✓ There is a network connection between the RevPi and your PC.
▷ Open a web browser.
▷ Call up Cockpit via the web browser with revpi[serial number].local
You can find the serial number on the front of the housing.
Alternatively, you can enter the IP address of the RevPi in the web browser.
❯ A security warning may appear in the browser.
▷ Accept the security exception to continue with the login.
❯ The login screen for Cockpit appears.
▷ Log in with user name pi and the device password.
You can find the device password on the sticker on the side of the RevPi housing.
|
Note
|
From the RevPi Bookworm Image (08/2025), after 3 failed login attempts, access is locked for 10 minutes. |
❯ When you log in for the first time, Cockpit asks you to assign a new password.
▷ Enter the new password twice and confirm with Set password.
❯ Cockpit opens in limited access mode.
▷ Select Limited access in the top main navigation bar to switch to the administrative access mode.
▷ Authenticate yourself with the new password.
❯❯ With this administrative access, you now have superuser rights and can configure the RevPi.
|
Caution
|
▷ Change the initial device password after the first login to prevent unauthorized access. ▷ Use a strong password. |
There are alternative login methods:
-
Login via RevPi Status (until RevPi Bullseye (04/2024))
See also:
Installing Updates #
|
Caution
|
▷ Check at regular intervals whether updates are available. ▷ Install updates promptly to close security gaps. |
Updates can be installed directly via the Cockpit menu Software updates.
Alternatively, updates can be installed via a terminal.
The RevPi Update Tracker provides up-to-date information on security patches and updates.
Configuration #
The RevPi is configured in two steps:
|
Note
|
CODESYS and PiCtory cannot be used in parallel for configuration. An existing configuration via PiCtory will be overwritten by a configuration via CODESYS. The virtual devices OPC UA Server and MQTT Client can only be used via PiCtory. |
|
Note
|
Until RevPi Bullseye (04/2024), the RevPi base module is configured via the RevPi Status application. |