Connecting a Raspberry Pi Board
Follow the instructions below to connect your device to the Cloud4RPi control panel.
It is advisable to update your system before installing.
sudo apt update && sudo apt upgrade -y
Install/update the required packages.
sudo apt install git python3 python3-pip -y
You can use alternative methods to install pip.
The Cloud4RPi library is compatible with Python 3.2+ and Python 2.7.9+ versions.
[Optional] Enable interfaces
- Open a section for configuring additional interfaces (
Interfacing Options | Configure connections to peripheralsdepending on the version).
- Enable I2C, 1-wire and other necessary interfaces.
- Reboot the device with the
Getting the Cloud4RPi Client Library
Install the library using your preferred Python version. The following command installs and integrates Cloud4RPi with your OS's default Python interpreter (usually Python 3):
sudo pip3 install cloud4rpi
If you are using Python 2, use the following command:
sudo python2 -m pip install cloud4rpi
For information on how to work with several versions of Python installed, see Python Documentation.
If you get an error while using pip, try to update the setuptools and pip packages.
sudo pip3 install --upgrade setuptools pip
Hacking Together some Code
We have prepared sample code for several platforms in the cloud4rpi-raspberrypi-python repository to demonstrate sending data to the Cloud.
Get Cloud4RPi examples for your device:
git clone https://github.com/cloud4rpi/cloud4rpi-raspberrypi-python.git && cd cloud4rpi-raspberrypi-python
Before running a sample (control.py), remember to replace the
__YOUR_DEVICE_TOKEN__ string with your real device token. Use a text editor (for instance,
nano) to replace
__YOUR_DEVICE_TOKEN__ with the token displayed at the top of the device page on cloud4rpi.io. If you have no token yet, open the Devices page, create a device using the New Device button in the top right corner, and use its token.
Execute the script with a Python interpreter, for example:
sudo python3 control.py
If you have installed Cloud4RPi to a non-default Python, use the version with the Cloud4RPi library.
If the script output looks right, open the Devices page to see if the device status has changed.
Installing as a Service
You can use our service templates to facilitate service installation. Pass the path to your Cloud4RPi-enabled Python script to the service_install.sh script as a parameter.
chmod +x service_install.sh sudo ./service_install.sh your_script.py
You need to replace 'your_script.py' with the actual path to your service script.