search

Cumulocity-IoT / apama-cumulocity-raspberrypi

Apama reading temperature data from Raspberry Pi sensehat and sending it to Cumulocity IoT for real-time analysis. Developed by Global Presales.
Apache License 2.0
4 stars 2 forks source link
analytics apama cumulocity cumulocity-agent cumulocity-example cumulocity-iot global-presales iot-analytics raspberry-pi real-time real-time-analytics realtime sensehat temperature

readme

Apama Raspberry Pi Python Plugin with Cumulocity

In this demo, Apama 10.3 is being used to read data from a Raspberry Pi fitted with a Sensehat.

Apama is running a python plugin which is reading the temperature from the Sensehat.

The temperature data is being converted into Cumulocity Measurement events and is then sent to the Cumulocity tenant.

The Temperature data is also being converted into a Industry Analytics Kit Data event which is being fed through a 'Spike' Analytic to generate Moving Average, UpperBand and LowerBand for the temperature value. This additional data is being converted into Measurement events which are sent to Cumulocity.

Installation

  1. Download and install the latest Raspian image from https://downloads.raspberrypi.org/raspbian_full_latest

  2. Download and install the Cumulocity Agent for the Raspberry Pi. This is available from https://cumulocity.com/guides/device-tutorials/raspberry-pi-4/

  3. Download and install the “Apama Community Edition” from https://downloads.apamacommunity.com/apama-core/10.3.0.2/apama_core_10.3.0.2_armv7_linux.tar.gz

  4. Download and install the Cumulocity Transport for Apama from https://downloads.apamacommunity.com/apama-core/10.3.0.2/apama_cumulocity_transport_10.3.0.2.zip

  5. As Apama requires Python3.6, this will need to be downloaded and built before a python plugin can be used inside Apama. The instructions for this are available from https://github.com/kpalf/ApamaSenseHat/tree/master/HelloWorld (See section “Building and setting up Python 3.6”)

  6. Download the ApamaRaspPiPythonPluginCumulocity code from this repository and install onto your Raspberry Pi.

Upfront Preparation

Once the “RaspberryPiPythonPlugin” code has been unzipped, you will need to make a few configuration changes to ensure that it is sending the Sensehat Temperature data to the correct device inside your Cumulocity tenant.

  1. Cumulocity Client Configuration The Cumulocity connection settings are stored in : \RaspberryPiPythonPlugin\config\connectivity\CumulocityClient9.0+\CumulocityIoT.properties. Edit the “CumulocityIoT.properties” file. This file will need to be updated with the tenant, username, password and appkey for your Cumulocity tenant

  2. Find the managedObjectId for your Cumulocity device Once you have installed the Cumulocity Agent onto your Raspberry pi and have registered the device with your Cumulocity tenant, it will be allocated a unique managedObjectId. To find this id, log into your Cumulocity tenant and locate your device inside ‘DEVICE MANAGEMENT’. In the ‘Info’, tab, the managedObjectId is displayed in the ‘DEVICE DATA’ section as the ‘ID’

  3. Update the demo with your managedObjectId for your device To update the code to your managedObjectId, open “\RaspberryPiPythonPlugin\monitors\RaspberryPi.mon” Search for “constant string managedObjectId :=” Ensure that the managedObjectId you found above is updated here

Running the demo

To run the demo

  1. Open a terminal window on your raspberry pi and cd into your ‘RaspberryPiPythonPlugin’ folder

  2. Type : correlator --config . This will start up the Raspberry Pi Demo.

    Temperature readings will be sent every 10 seconds to the device identified by the managedObjectId inside your Cumulocity Tenant

These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.

For more information you can Ask a Question in the TECHcommunity Forums.

You can find additional information in the Software AG TECHcommunity.