FREEWAVE FUSION SATELLITE User Guide

: June 3, 2024
: FREEWAVE

Table of Contents

Overview
YOU WILL NEED
PURCHASES REQUIRED
Purpose Of This Guide
Configure FreeWave Edge Polling
Add Modbus Device
Add Modbus Registers
Configure Satellite Store & Forward
Download Your Data from the Cloud
Automatically Send Data to SCADA
- Account Setup
Web hook Usage
Appendix
- Advanced Configuration Notes
Important! Data Plan Note
Other Useful Links
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

FREEWAVE FUSION SATELLITE User Guide

Overview

The Fusion Satellite with support for Free Wave Edge & Modbus allows you to automatically publish your industrial equipment data from any location to your SCADA system.

Free Wave provides a cloud portal to make it easy to download the satellite data and automatically move the data to your Enterprise, Cloud, or SCADA system.
Product Overview

YOU WILL NEED

A computer running Windows with an available USB port and USB-C cable
A Fusion Satellite with Free Wave Edge Software
A Modbus Device

PURCHASES REQUIRED

Fusion Satellite
- Includes Free Wave Edge & Modbus
- Includes Free Wave Cloud Portal

Purpose Of This Guide

This guide will walk you through the end-to-end data flow for connecting a Modbus Device to Fusion Satellite and retrieving your data from the FreeWave Cloud Portal.
This guide assumes you have a deployed and connected Fusion Satellite device.
For the Fusion Satellite Quick Start Guide – https://www.freewave.com /getting-started-with-fusion/

Configure FreeWave Edge Polling

All Protocol Drivers in FreeWave Edge are separated into a “Device” which typically represents each PLC or

Flow Computer or RTU or other industrial field equipment.
Under each Device are the “Sensors” also known as Tags or Registers associated with that device.
Configure Free Wave

Add Modbus Device

Go to the Protocol Tab for Edge > Sensors > Protocol.
Add a Device using the “Add Device” button
Enter the IP Address and connection details for your device
Make sure to set your polling interval for your device. All tags or sensors created under this device will use this same polling interval.

Add Modbus Registers

To add tags manually, under each Device, use the “Add Sensor” button to add the relevant sensor & register details for each of your Sensors/Registers/Tags
Use the “Last Readings Column” and the “Refresh Last Readings” button to ensure that the Edge
software is correctly reading from your device.

OPERATION NOTE: Once you are seeing correct “Last Readings” on the Sensors tab, that indicates that data is being received and is stored in the database and is ready for Store & Forward.

Configure Satellite Store & Forward

Go to the “Store & Forward” Tab
Choose Your Store & Forward Interval
The default data plan supports a 1 Hour Interval.
Choose Your Sensors to Include
- Use the checkboxes to select the most important data you want included in your data payloads.
- The green “Message Size” bar shows how many bytes in each message are used, or if the total
  data size will go to more than 1 message.

Operation Note: Make sure to take a note or screenshot of the Satellite Store & Forward Page with the Sensor IDs, Sensor Names, and Asset IDs. The Cloud Data Exports will only include Sensor ID numbers at this time.
Configure Satellite Store & Forward

Download Your Data from the Cloud

On the Device List in the FreeWave Provided cloud portal at portal.modusense.com
Click the “Edit” button and “Data Export” tab
You can view a snapshot of the most recent messages on the page.
Click the Export button to select the data you wish to export
The Excel file with your selected data will be e-mailed to your account (check your spam folders if necessary)

Automatically Send Data to SCADA

Your external Cloud, Enterprise, or SCADA server can receive new data via the Cloud REST API or Web hooks REST API is a Request/Response paradigm and is useful for retrieving data history in batches Web hook is a Push or Event- Based paradigm and is useful for immediate publishes of new data.

If your cloud, SCADA, or enterprise apps needs the new data as soon as it is published, we recommend using Web hooks.

There are many web development tools such as https://webhook.site, which can be used for testing web hooks before integrating into your own application.

Account Setup

Web hooks can be setup in the portal by clicking your profile in the bottom left and navigating from there.
Account Setup

Web hook Usage

You will create a web hook in your SCADA system that will be configured to receive data from the cloud.

Every time new satellite data is available, it will be pushed to the web hook you created within your SCADA system and assigned to your account or device in the FreeWave portal. Web hooks can be assigned either globally to all devices in your account or to only certain devices.

All web hooks are sent from the outgoing IP address 103.14.216.238.
All messages are sent as Json and will have the user-agent ms-consumer. Requests will accept encoding gzip.

A webserver that is receiving these messages should return a 200 OK as a response once a message is received. If a 200 is not received the message will be placed onto the queue and retried after a delay. This delay will increase on repeated failure up to a maximum of 1 week, where the message will then be dropped.

Data Format

Appendix

Advanced Configuration Notes

Claim Your Device In Cloud Portal
As part of the Fusion Satellite Quick Start Guide, you should have created your Portal Account and Claimed Your Device. If you haven’t, that is required before downloading your data.

To do this you need to register and log on to your account in the Free Wave Data Portal at portal.modusense.com

Once logged in, you can use the ‘Claim a Device’ function to adopt the Gateway.
To do this you will need the unique, one-time Claim Token – found on the card included in the box.

Once a message has been sent from the Fusion device to the satellite, it will be relayed to the cloud and appear under your account in the data portal. To view it, login to the portal, find your device under “Devices”.
You should see a “Last Seen” field that represents when your device last sent a message from the satellite.
Appendix

Important! Data Plan Note

If you choose an Interval greater than once per hour, you will receive multiple warnings that you will exceed 750 messages per month (which is the max allowed for 1 data plan).

If you have purchased more data plans/stacked plans (up to 4) you can do figure the math and select a faster Store & Forward interval for your deployment scenario. In all cases, the system will still send messages at the interval you choose, and you are responsible for any overage charges.

Example: 30 Minute Interval
Data Plan Note

Example: Max Tags for 1 Data Plan with 1 Hr Interval
You can Double or Triple your Sensors by reducing message interval to 2 or 3 hours, or by stacking data plans.

Selected Datasets	Max Float32 Tags in 1 Message
All Statistics, All GPS	12 Tags
All Statistics, No GPS	13 Tags
Last Readings, All GPS	32 Tags
Last Readings, No GPS	36 Tags

The Free Wave provided cloud portal by default will save data for the last seven (7) days. Please download, or connect your enterprise system, to store and save the data in your own system.

For Free Wave custom dashboards for your operation, which include longer data storage time periods, please contact your Free Wave Sales Representative.