Installation¶

System Requirements¶

On Bookworm images, users must belong to the picontrol group:

sudo usermod -a -G picontrol username

Log out and log back in for the group change to take effect.

RevPiModIO is preinstalled on your Revolution Pi. It is distributed as debian package and will be updated by apt.

Install from PyPI:

pip install revpimodio2

Clone the repository and install:

git clone https://github.com/naruxde/revpimodio2.git
cd revpimodio2
pip install .

Test the installation:

python3 -c "import revpimodio2; print(revpimodio2.__version__)"

For advanced features like XML-RPC server and MQTT integration:

sudo apt-get update
sudo apt-get install revpipyload

Edit /etc/revpipyload/revpipyload.conf:

[XMLRPC]
xmlrpc = 1

Configure access permissions in /etc/revpipyload/aclxmlrpc.conf, then restart:

sudo service revpipyload restart

RevPi Commander provides a GUI for testing I/O without programming:

Download from revpimodio.org
Configure connection via File → Connections with your RevPi’s IP address (port: 55123)
Use “PLC watch mode” to monitor sensors and control outputs

After installation, proceed to Quick Start to write your first program.