Data upload using the WebSocket plugin

Data upload using the WebSocket plugin

In this tutorial, we show how to upload data collected from south devices to a WebSocket server using the Neuron WebSocket plugin.

Requirements

We use two PCs connected in a local area network in this tutorial. One is a Linux machine with Neuron installed, the other is a Linux machine with a WebSocket server. Consult the the installation instruction on how to install Neuron.

	PC 1	PC 2
Operating System	Linux	Linux
IP address	192.168.1.152	192.168.1.107
Software	Neuron	Python 3.7
Network	Connected	Connected

We need a WebSocket server for demonstration. You may use any server software you like as long as it speaks the WebSocket protocol. To make things simple, we will use a simple python program in this tutorial. Our python server program requires Python >= 3.7, and depends on the websockets package (opens new window).

Run the following command to install the dependencies.

$ pip install websockets

WebSocket server

Following is our python server program, it listens at tcp port 8000.

#!/usr/bin/env python
import asyncio
import websockets
async def echo(websocket):
    async for message in websocket:
        print(message)
async def main():
    async with websockets.serve(echo, "0.0.0.0", 8000):
        await asyncio.Future()  # run forever
asyncio.run(main())

Start the server program:

$ python websockets.py

Setup Neuron

South devices

We need some south devices to collect data from. Any Neuron south bound plugin will do for this tutorial, for example the Modbus TCP plugin. In this tutorial, we will use the File plugin to create south devices collecting data from local files. This make things simple since we don’t need an actual device and we can fake tag data by just modifying file contents.

Add the file node

In the Neuron dashboard, click Configuration -> South Devices -> Add Device to add a node using the File plugin.

Fig.1 - Add file node in Neuron dashboard

Click the Device configuration icon to configure the file node.

Fig.2 - Neuron dashboard sourth devices tab

Using the default configuration is enough. Click Submit.

Fig.3 - Configure the file node in the Neuron dashboard

Create a group

The file node should be in Connected state once configured. Click the file node to enter the Group List tab, then click Create to create a group.

Fig.4 - Neuron dashboard sourth devices tab showing file node connected

We set the group name to grp and the interval to 1000.

Fig.5 - Add a group to the file node in Neuron dashboard

Add tag

Click the created grp group to enter the Tag List tab, then click Create to create a tag.

Fig.6 - Neuron dashboard group list

We name the tag tag0 with type STRING. The tag address is set to hello.txt which represents the file in the working directory of the Neuron process.

Fig.7 - Add a tag to the file node in Neuron dashboard

North app

Add the websocket node

In the Neuron dashboard, click Configuration -> North Apps -> Add Application to add a node using the WebSocket plugin.

Fig.8 - Add websocket node in Neuron dashboard

Click the Application Configuration icon to configure the websocket node.

Fig.9 - Neuron dashboard north apps tab

We set the host parameter to 192.168.1.107 and port to 8000, which is the address of our WebSocket server.

Fig.10 - Configure websocket node in Neuron dashboard

Once the configuration is submitted, the websocket node connects to the WebSocket server successfully.

Fig.11 - Neuron dashboard north apps tab showing websocket node connected

Click the websocket node to enter the Subscription tab. Then click Add subscription, select the file node and the grp group.

Fig.12 - websocket node subscribe to file node

Validate server output

After subscribing to the grp group of the file node, the websocket node will begin pushing data to the WebSocket server. In the Neuron dashboard, click Monitoring -> Data monitoring, then select the file node and the grp group. We see that Neuron reports an error code 1011 indicating the file hello.txt does not exist.