mirror of
https://github.com/naruxde/revpimodio2.git
synced 2026-03-31 15:08:09 +02:00
Sven Sager
3294c5e980
Revised various sections across multiple documentation files to reflect updated methods (`run_plc` replacing manual setup with `cycleloop`) and adjust for new default parameters (e.g., `autorefresh`). Enhanced descriptions for timers, Cycletools usage, and new method explanations. Removed outdated or redundant examples and updated system requirements. Signed-off-by: Sven Sager <akira@narux.de>
89 lines
1.8 KiB
ReStructuredText
89 lines
1.8 KiB
ReStructuredText
============
|
|
Installation
|
|
============
|
|
|
|
System Requirements
|
|
===================
|
|
|
|
* Python 3.2 or higher
|
|
* Revolution Pi hardware (Core, Core3, Connect, Compact, Flat)
|
|
* piCtory configuration tool
|
|
|
|
Prerequisites
|
|
=============
|
|
|
|
User Permissions
|
|
----------------
|
|
|
|
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.
|
|
|
|
Installing RevPiModIO
|
|
=====================
|
|
|
|
RevPiModIO is preinstalled on your Revolution Pi. It is distributed as debian package and will be
|
|
updated by `apt`.
|
|
|
|
Using pip
|
|
---------
|
|
|
|
Install from PyPI::
|
|
|
|
pip install revpimodio2
|
|
|
|
From Source
|
|
-----------
|
|
|
|
Clone the repository and install::
|
|
|
|
git clone https://github.com/naruxde/revpimodio2.git
|
|
cd revpimodio2
|
|
pip install .
|
|
|
|
Verify Installation
|
|
===================
|
|
|
|
Test the installation::
|
|
|
|
python3 -c "import revpimodio2; print(revpimodio2.__version__)"
|
|
|
|
Optional Components
|
|
===================
|
|
|
|
RevPiPyLoad
|
|
-----------
|
|
|
|
For advanced features like XML-RPC server and MQTT integration::
|
|
|
|
sudo apt-get update
|
|
sudo apt-get install revpipyload
|
|
|
|
Configure XML-RPC Server
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Edit ``/etc/revpipyload/revpipyload.conf``::
|
|
|
|
[XMLRPC]
|
|
xmlrpc = 1
|
|
|
|
Configure access permissions in ``/etc/revpipyload/aclxmlrpc.conf``, then restart::
|
|
|
|
sudo service revpipyload restart
|
|
|
|
RevPi Commander
|
|
---------------
|
|
|
|
RevPi Commander provides a GUI for testing I/O without programming:
|
|
|
|
1. Download from `revpimodio.org <https://revpimodio.org/quellen/revpicommander/>`_
|
|
2. Configure connection via File → Connections with your RevPi's IP address (port: 55123)
|
|
3. Use "PLC watch mode" to monitor sensors and control outputs
|
|
|
|
Next Steps
|
|
==========
|
|
|
|
After installation, proceed to :doc:`quickstart` to write your first program.
|