Raspberry Pi and ExoSense¶

This tutorial will walk through the steps to set up a Raspberry Pi with ExoEdge, connect it to an IoT Connector on Exosite's Murano Platform, and use this data with the ExoSense condition monitoring application.

Set-up an IoT Connector¶

For the Raspberry Pi to send data to Exosite's platform (as with any IoT connected device), an IoT Connector in your Exosite account is required, which provides the ability for devices to send data to your unique API URL using the Device API. Data flows from IoT Connector's to the ExoSense application.

If your account does not yet have a standard IoT Connector added, you can add one from the marketplace. Click Add IoT Connector or go to the marketplace directly and locate the ExoSense™️ Standard Connector Template element. Use the CREATE IOT CONNECTOR button from that elementand pick a name - for example 'myfirstconnector'.

This will create a new IoT Connector in your account. Use the menu on the right to manage your new IoT Connector

Link the IoT Connector to ExoSense¶

When creating a new IoT Connector, it needs to be linked to your ExoSense application. Use the Manage Application option from the more menu for your ExoSense instance in your account.

Using the IoT Connectors tab, click on ADD IOT CONNECTOR and add your specific connector.

Setup ExoEdge on your Pi¶

Configure the Raspberry Pi¶

• When using Raspberry Pi, the recommended OS is Raspbian LITE
• Make sure your Raspberry Pi is on and connected to the Internet
• Make sure your Raspberry Pi will allow for SSH connection

sudo raspi-config

Update the system and install pip¶

Run the following commands to update your Pi and install pip3. Note: Python3 and Pip3 may be installed already

sudo apt-get update
sudo apt-get upgrade
sudo apt install python3-pip

Install ExoEdge¶

Use the following commands to install ExoEdge and the ExoEdge's simulator source.

pip3 install exoedge
pip3 install exoedge_simulator

export PATH="$HOME/.local/bin:$PATH"

sudo apt-get install build-essential python-dev

Starting up ExoEdge¶

https://<iot_connector_fqdn>

On your Pi, run the following command to start ExoEdge up, where:

• <DEVICE_ID> is a unique identifier for the device. By default in Settings for your IoT Connector the "Allow devices to register their own identity" setting is enabled. If it is disabled, you will need to add (whitelist) the device identifier first.
• <ENDPOINT> is your unique IoT Connector FQDN (Device API Endpiont) (e.g. https://12345abcd1234.m2.exosite.io)

edged -s <DEVICE_ID> -H <ENDPOINT> -i <DEVICE_ID>.ini go

edged -s 0001 -H https://u4t4w6izz5es0320.m2.exosite.io -i 0001.ini go

Your device is now provisioned and connected to the IoT Connector. You should see it now in the IoT Connector's devices list.

Claim and Assign your Device in ExoSense¶

• Navigate to the 'Devices' page from the Navigation Panel.
• Locate your device in the "Unused Devices" tab
• Select the device and a group to add the device too
• Press the "ASSIGN TO GROUP" button

Configure ExoEdge from ExoSense¶

For the purposes of this guide, we'll first use the Simulator source for ExoEdge to begin generating data. Moving forward you can use Exosite's additional sources or build your own for your sensors and interfaces.

ExoEdge Simulator Information

Configure Simulator Device Channels¶

Locate and select your device in the devices tab. You'll see that it has no channels yet. Go to the Channels tab.

Add a new channel by selecting the button in the top-right corner of the channels tab.

Below is an example configuration to instruct ExoEdge to create a Sin Wave using the Simulator source you installed with ExoEdge above.

Copy the value for app_specific_config into that field, give it a channel name, description, data type (Number or anything you want), Application (Simulator in this case) and set the report rate and sample rate to 10000 for example for 10 second new value generation.

{
    "function": "sin_wave",
    "parameters": {
        "period": 120,
        "amplitude": 10,
        "offset": 100
    }
}

After clicking ADD for the new channel, make sure to SAVE the new configuration update. This new configuration will be pushed to ExoEdge via the config_io resource and ExoEdge will start reporting data back in a sin wave.

You should now see a new channel with live value updates.

Next Steps¶

Use the ExoSense guides and reference to create assets with signals sourced from your ExoEdge device channels, add signal rules, and build dashboards. Then move on to utilizating the ExoEdge Modbus Source or build your own sensor / IO interface on the Pi for ExoEdge

Create an Asset from your simulated device

Add a threshold rule

Build an asset dashboard