Senquip Portal

The Senquip Portal is a secure, cloud-based platform hosted on Amazon Web Services (AWS), designed to provide powerful management and visualisation tools for your Senquip devices.

The Portal enables users to:

  • View dashboards that display data across groups of devices

  • Access detailed device pages showing real-time and historical sensor data

  • Perform device management including configuration and firmware updates

  • Handle user management with role-based access control

  • Maintain long-term data storage for historical analysis and compliance

  • Manage events with configurable warnings and alarms

  • Manage device subscriptions

The Senquip Portal provides a streamlined and scalable interface used to monitor, manage, and respond to field data from anywhere in the world.

Senquip Vision Dashboard

Senquip Vision Dashboard

Senquip device data page

Senquip Device Data Page

Create a Senquip Portal Account

If you do not have an account on the Senquip Portal, you will need to create one. There are no charges for creating an account on the Senquip Portal and a credit card is not required.

  1. Go to <https://portal.senquip.com>`_ and select the Signup button.

Senquip Portal signup link

Create a Senquip Portal account

  1. Complete the required fields and then press Signup.

Fields required to complete account application

Complete the required fields

  1. A verification email will be sent to the email address provided. Click on the link in the email to verify your account. The email address must be verified as important system updates, alerts, warnings, and alarm messages will be sent to the email address.

Email confirmation

Your email must be verified

Note

The email may end up in your spam folder or may be blocked by your company firewall.

  1. To activate your account, login to the Senquip Portal once.

Senquip Portal login page

You must login to activate your account

Creating a Group

Storing devices in groups facilitates:

  • Dashboards that display device data in a way that is meaningful for the application

  • User management across a group of devices

  • Simultaneous configuration of multiple devices

To create a group:

  1. Select the Add Group button

Adding a new group to your Senquip Portal account

Create a new Group

  1. Select a name for your group that will be meaningful to the indented user group and press Create. The group name can be changed later in the Group Settings.

Adding a new group to your Senquip Portal account

Select a meaningful name

Add Devices to a Group

You can add devices to a group by either:

  1. By pressing the Add Device button and entering the device ID. If you are adding a new device to your account, you will be required to enter the setup password.

Adding a device to a group

Adding a single device to a group

  1. Copying or moving devices from another Group for which you have administrator permissions.

  2. Requesting that another user give you access to a device or a group of devices.

Note

Your account will need to be active for another user to add devices

Note

If you have no groups, and devices are added, they will be placed in the default Ungrouped Group.

Finding Devices and Groups

Use the search bar at the top of the page to find devices and groups. Search by group name, device ID, or device name. The Favourites button can be used to identify the last few devices and groups accessed, and to mark devices and groups as favourites.

Device search bar

Search by group, name , or device id

Group Management

Group functionality simplifies the management of large numbers of devices.

  • Groups are collections of devices.

  • Devices can belong to multiple groups.

  • Private Groups only have one user.

  • A group becomes a Public Group when a second user is added to the group.

Groups enable the following functionality:

  • Management of user permissions for multiple devices at the same time

  • Changing the configuration of multiple devices with a single action

  • The standardisation of device data pages across a group

  • The creation of dashboards to simplify decision making

Groups are managed by selecting the Group Settings button from where group settings, devices, and users can be managed.

Group settings menu

Change Group settings

Device Management

The Group Devices option allows devices to be added to the group, copied or moved to another group, or deleted from the group.

Group device management window

Manage devices in a Group

User Management

The Group Users option allows users to be added or removed from a group. Where users are added, they must be allocated appropriate permissions for the group.

Allowed Permission

Admin

User

Operator

View

View data

Yes

Yes

Yes

Yes

Trigger device actions

Yes

Yes

Yes

View users

Yes

Yes

Change device settings

Yes

Yes

View or edit script*

Yes

Yes

View server log

Yes

View device passwords

Yes

Add or remove group users

Yes

Add or remove group devices

Yes

Import and export settings

Yes

Note

If you have created a private group and want to share that group, you will need to have administrator permissions for all devices in that group.

Note

Users should be added with the minimum permission level required to perform their function.

Warning

Anyone who has the device ID and setup password can add the device to their account with Admin permissions.

In the example below, Senquip Test0 is the owner of the group and has Administrator access to all devices in the group. Senquip Test1 has been added to the group with permission level User.

An example of group permissions

Grant appropriate permisions to group users

Device Configuration Management

Bulk configuration of devices allows for settings to be changed across many devices at the same time. Bulk device configuration will be released in 2025.

Senquip Vision Dashboards

Senquip Vision is a powerful, customisable dashboard that enables businesses to monitor and analyse key operational metrics across a group of devices. Designed for management, maintenance and operational users, it provides a clear and intuitive interface for tracking real-time data, historical trends, and device status, all in one place.

The following are key elements of a Senquip Vision Dashboard:

Example Senquip Vision dashboard showing features

Fully cusomisable Senquip Vision dashboard

Key

Element

Description

1

Dashboard Name

A name that is meaningful to the target user group.

2

Group Settings

Manage the group and perform bulk user management and device configuration.

3

Period

The time range over which data in the dashboard is calculated and shown.

4

View

Multiple views can be created to accommodate users with different roles (e.g. management and maintenance views)

5

Headline Number

Displays key metrics aggregated across all devices in a group.

6

Summary Chart

Visualises data trends over the selected time period.

7

Summary Table

Shows metrics for all devices in the group, calculated over the selected time period.

8

Map

Displays current device locations, with colour indicating device status.

Views

When a new Group is created, a default display with table and map will be generated. Users can then create different views for management, operational, maintenance and other functions. Headline numbers, a customised table, charts, and a map can be added to a view.

Example showing multiple views on a dashboard

Create a different view for each user function

Key

Element

Description

1

Views

Select between the various views that have been created for the dashboard

2

Period

Select the period of time over which data should be calculated and displayed

3

Edit View

Views can be edited by pressing the view settings icon on the right of the view toolbar to expose add, edit, and delete options.

Period

A period of interest can be selected that aligns with the function of the view. For example, when considering rainfall data, month to date may be the most meaningful period. When considering productivity, the last 7 days may be more useful. When a period is selected, calculations on data (metrics) are performed over that time, and data is displayed for that period. Available periods are shown in the table below. Additional periods and previous periods can be selected using the Custom Range option.

Period

Description

Last 24 hours

Rolling window of 24 hours

Last 7 days

Rolling window of 7 days

Last 30 days

Rolling window of 30 days

Week to date

Fixed 7-day period, staring at 00:00 on Monday

Month to date

Fixed period staring on the 1st of the month at 00:00

Custom Range

Select your own range

Metrics

Metrics refer to data measured by a device, or values derived from that data by applying operations such as average, total, difference, and others. Metrics are shown in the summary table, on charts, and are the basis for headline numbers. Available metrics include latest data, minimum, maximum, total, difference, accumulation, and time weighed average. Metrics are selected for a measurement when columns are added to the summary table.

How to add a metric to the summary table

Min, max, average, total, difference, and latest metrics are available

Metrics are calculated at the end of each hour for the data collected in that hour and are then collated for the selected period.

Maximum and Minimum

The highest and lowest value measured over the selected period.

Example applications:

  • lowest temperature in the last 24 hours

  • Lowest tank level so far this month

  • Highest engine temperature this week

  • Highest engine RPM over the past 24 hours

Note

If no samples are available in the period, this value is undefined.

Note

If only one sample is available in the period, the minimum and maximum are the same.

Note

Maximum and minimum up till the end of the last complete hour.

Latest Data

The latest value measured by the device.

Example applications:

  • Current engine hours

  • Current tank level

  • Current temperature

  • Current machine state

Note

If there is no current data, then the last available data will be displayed.

Time Weighted Average

The time weighted average considers how long each value was applicable when calculating the average. If for instance, only a few samples are taken in a day, the Time Weighted Average will assume that the previous sample was valid until a new one arrives. This ensures that values occurring for longer durations contribute proportionally more to the average.

In the example below, a dam level is monitored. Actual level samples arrive sporadically. In the absence of a sample, the previous sample is assumed to still be valid. The time weighted average will be the area under the chart divided by the period. Notice that the first sample is 2-Jan-2025 0:00:00 which represents midnight on the 1st Jan. Likewise, the last point is the 1-Feb-2025 0:00:00 which represents midnight on the 31st Jan.

Example of time weighted average

Time weighted average works well where there are missing samples

Example applications:

  • Average dam level over a month

  • Average flow over a month

Note

If there is no previous data at the start of the period, the last sample from the previous period will be used.

Note

If there is no previous sample, then the first sample will be assumed to have been the value at the beginning of the period.

Total Over a Period

Calculates the total of all the measured samples over a period. In the figure below, daily rainfall is totalised for the month. Notice that the first sample is 2-Jan-2025 0:00:00 which represents midnight on the 1st Jan. Likewise, the last point is the 1-Feb-2025 0:00:00 which represents midnight on the 31st Jan.

Example of total

Total, sums all data values

Example applications:

  • Total rainfall over a period

  • Number of times that the pressure has dropped below a threshold.

  • How many times a gate has been opened.

Creating a metric to process totals based on historic data simplifies device configuration by offloading totalisation over a period function from the device to the Senquip Portal.

Note

If no samples are available in the period, this value is zero.

Note

The sum over a period is calculated up to the end of the last complete hour.

Difference Over a Period

The difference between the most recent data and the same data at the end of the previous period. Example of use:

  • Change in dam level over the past month

  • Change in engine hours over the past week

  • Change in idle hours over the last 7 days

Note

If no samples are available in the period, this value is undefined.

Note

If no samples are available in the previous period, this value is undefined.

Note

The difference over a period is calculated up to the end of the last complete hour.

Accumulation Over a Period

Calculates the total increase in a parameter over the selected period, regardless as to whether the source parameter is reset. For instance, if an engine hour meter is replaced or reset, and returns to zero, the accumulation will not be reset and will continue to climb. In the figure below, engine hours are being read from an hour meter. As the hour meter rises, so does the accumulation. When the hour meter is reset, the accumulation does not change and continues to climb. Accumulation is a good measure of a total where the source data may reset.

Example of accumulation

Accumulation calculates increase even is the source parameter is zeroed

Example:

  • Engine run time where the engine hour meter may be replaced

  • Engine idle time where the counter resets to zero when the engine is powered off

  • Total distance travelled based on a trip distance meter

  • Total flow where the flow meter may get zeroed

Note

If no samples are available in the period, the value will remain the same as end of the previous period.

Note

If no samples are available in the previous period, the start value will be assumed to be zero.

Note

The accumulation over a period is calculated up to the end of the last complete hour.

Summary Table

The summary table widget is the primary element on a view. It shows metrics over the period for all devices in a view. In the example below, we see that fuel is low on some machines, indicated by the cells being marked red. On 2 machines, the fuel is very low, and alert messages are active. Idle hours when compared with the previous period are down on three machines as marked by the green down arrows. Run hours on 3 machines are up, a good outcome.

Click a device in the table to inspect the device data page.

Example of a Senquip Vision dashboard summary table

Device summary table showing alarms on the fuel level

Columns are added, removed, and edited using the table editor. In the example below, metrics have been filtered by temp, and the minimum, and average temperature have been chosen to be added to the summary table.

Example of adding metrics to a Senquip Vision dashboard summary table

Adding metrics to a Device Summary Table

The features of table columns can be changed by pressing the edit button at the top of each column in the table editor. Warning and alarm levels can be applied, which when selected will change the cell colour to orange or red. Red and green indicator arrows can be enabled in each cell to show whether a value has increased or decreased when compared to the previous period.

Editing a Senquip Vision dashboard summary table

Press the edit button on each column to edit functionality

In this example summary table, a warning has been placed when engine hours increase above 6000, and an alarm has been placed on low fuel. Indicator arrows are indicating that idle are down on 3 machines, and run hours are up in most cases.

Example Senquip Vision dashboard summary table

Example Device Summary Table showing warnings and alarms

Filters

Filters are used to single out devices from all the devices in the group. Permanent filters can be applied in the table editor, or temporary filters can be applied in the live view. For example, a group may be created that contains all the off-highway assets at a quarry. Different views can then be created to show lighting towers, pumps, and crushers by adding a filters on asset type in the table associated with each view.

Warning

Remember to save your settings before returning to the view.

Headline Numbers

Headline numbers show data based on all devices in the current view. In the example below, total idle hours and total run hours across the 4 devices in the table are shown as headline numbers. We can immediately see that idle hours are up over the last 7 days when compared to the previous period, the good news is that run hours are also up. Increased idle hours are bad and are marked with a red up arrow. Increased run hours are good and are marked with a green up arrow. Hover on the arrow to see the value for the previous period.

Example Senquip Vision dashboard headline numbers

Headline numbers show metrics across all devices in the view

Headline numbers are added using the Edit View button. Headline numbers perform operations on all devices in the view. Available operators are:

  • Total: Sum a metric across all devices in the view

  • Average: Calculate the average across a metric, for all devices in the view

When creating a headline the following steps must be taken:

  1. Select the data source from all available metrics. In the example below, the data source chosen is Internal Temperature Average.

  2. Choose the operator from either total or average. In the example below, average is chosen and so the headline number will show the average of all the internal temperatures across all devices in the view.

  3. Chose a meaningful title, a unit, the number of decimal places to show

  4. Select a trend arrow, if required, being careful to chose whether up and down are good or bad

Configuring Senquip Vision dashboard headline numbers

Headline numbers total and average a source metric across all devices in the view

Warning

Remember to save your settings before returning to the view.

Charts

Charts can be added to show trend data across the period of interest. Charts show metrics as calculated at the end of each hour. In the example below, a stacked line chart is used to show total fuel used across all machines by the hour. It can been seen that the water cart used 12.09 litres of fuel for the hour ending at 07h00.

Example Senquip Vision dashboard chart

Charts show trend data across multiple devices

Charts are added using the Edit View button. When creating a chart, the following steps must be taken:

  1. Select the data source from all available metrics. In the example below, the data source chosen is the average of Custom 11. In this case, Custom 11 is a custom parameter that has been generated in a script on a device and measures instantaneous fuel consumption.

  2. Choose the chart type as either line or area, and select whether it is stacked.

  3. Chose a meaningful chart name and configure the y-axis.

Adding Senquip Vision dashboard chart

A stacked chart shows cumulative contribution of multiple data series over time

Warning

Remember to save your settings before returning to the view.

Map

A map will be added to the view by default; it can be removed using the options activated by pressing the Edit View button.

Example Senquip Vision map

Clusters of device seperate as the zoom level increases

Where the are many devices in the same area, they will cluster and be shown as the total number of devices in that area. As the zoom level is increased, the devices will separate.

The colour of the labels on the map indicates if there are any current alerts associated with the device.

  • Grey: No alerts

  • Blue: Alerts

  • Orange: Warnings

  • Red: Alarms

Click a device on the map to inspect the device data page.

Customising Layout

Senquip Vision allows you to customise the size and position of dashboard widgets for optimal viewing on desktop, tablet, and mobile screens.

To adjust widget layout:

  1. Press the Edit View button and select Edit Widgets.

  2. Choose a display mode: Desktop, Tablet, or Mobile.

  3. Reposition widgets by dragging them using the arrow handle at the bottom-left corner.

  4. Resize widgets by dragging the bottom-right corner of the widget.

  5. When finished, select Exit Edit to return to the dashboard view.

Changing the view layout for desktop, mobile, and tablets

Optimise the layout for different screen sizes

Example layout for mobile

Dashboard view optimised for mobile screens

Device Data Page

The Device Data Page offers a centralised and intuitive view of all real-time and historical measurements reported by a Senquip device. Data is shown in real time and can be visualised as numbers, gauges, charts, or infographics.

The following are key elements of the Device Data Page:

Example Senquip device Data Page

Device Data Pages provide a detailed view of measured data

Key

Element

Description

1

Device Name

The name associated with the Senquip device

2

Toolbar Icons

Provide quick access to device settings, scripting, raw data, and more

3

Asset Image

Optional application image

4

Map

Shows the current device location and historic track

5

Trigger Buttons

Allow for remove control by activating functions locally on a remote device

6

Events

Shows all active alerts, warnings, and alarms for a device

7

Infographic

User generated graphical widget that allows information to be shown in a meaningful way

8

Number

Widget displaying numerical data as a number

9

Utilisation

Pie chart showing asset utilisation

10

Gauge

Numerical data shown as a gauge

11

Chart

User generated chart showing trend data

12

Device Info

Shows information about the device

13

Raw Data

(Not shown) The raw JSON data for a device

The Device Data Page is also the central hub for managing device setup. From the toolbar icons on the page, you can select the following:

  • Asset Notes: Add notes and images associated with the device application and install.

  • Display Settings: Choose which measurements are displayed, and the order in which they are displayed. Create custom Graphical Widgets and Charts.

  • Scripting: Link to the device scripting page to customise device operation, create custom parameters, add trigger buttons, and configure states.

  • Diagnostics: View device diagnostics information, SIM information, signal strength and more.

  • Server Log: Show a log of all user activity including when settings were changed, and when users were added.

  • Settings: Change device settings, perform firmware upgrades, and configure events.

  • Raw Data: Download historical data and export to CSV if required.

Note

Available options will vary depending on user permissions.

Device Data Page Configuration

As measurements are enabled on the Senquip device, associated widgets will automatically appear on the Device Data Page. The widgets can be turned on and off, and the order of display can be changed.

Page Layout

Select the Display Settings icon to choose which measurements are displayed, and the order in which they are presented.

Configuring which widhets are shown and their order

Turn widgets on and off and configure the display order

Add Asset Image and Logo

Select the Asset Notes icon to upload an image of the asset being monitored, a brand logo, the install location, and to make notes about the install.

Change Widget Display Format

Press the eye icon at the bottom right of the widget to switch between various display formats. Available formats are:

  • Hidden - Hide the data if it is not relevant to the application

  • Trendline - The default graph that facilitates recognition of change. Allows the user to view longer term trends between date ranges.

  • Gauge - Useful when representing measurements that must exist within a range. Can be scaled so that the pointer is vertical under normal conditions. Warning and alarm levels can be set.

  • Digital - A simple ON or OFF display that shows the status of a measurement. The threshold at which the display switches from ON to OFF can be set.

Configuring format of widget display

Switch between numberic, gauge, and digital display modes

Click on the icon at the top right of each widget to show numerical data on a chart over a selected period. Click on a point on the chart to show values at that point.

Device data Page chart

Numeric data can be shown as a line chart

Historical Data

To view or download historical data, press the Raw Data button on the top right of the dashboard. A table showing all the data associated with the selected device will be shown. To download the data, press the Export to CSV button. The data will be saved to your downloads folder. The downloaded file can be opened and manipulated with any spreadsheet tool.

All data shown in a table

Data associated with the selected device shown in a table

Note

The timestamp in the timestamp column is in Unix Time; if you would like a GMT date and time field, enable the timestamp setting in endpoint settings.

Device User Administration

Use the User button to manage the users of each Senquip device. When a device is added to an account using the device ID and password, the user that added the device automatically becomes an admin for that device. Admin users can manage other user rights and have full permissions for the device. The different user types are detailed in the table below:

Allowed Permission

Admin

User

Operator

View

View data

Yes

Yes

Yes

Yes

Trigger device actions

Yes

Yes

Yes

View users

Yes

Yes

Change device settings

Yes

Yes

Add/remove users

Yes

Warning

Anyone who has the device ID and setup password can add the device to their account with Admin permissions.

Configuration via Senquip Portal

Settings associated with a Senquip device can be updated remotely via the Senquip Portal. To change the settings for a selected device, press the Settings button on the top right of the dashboard. The selected device settings will be shown and can be changed by clicking in the relevant fields. Once a setting has been changed, press the Save Settings button at the bottom of the page.

Senquip devices check for settings changes each time they make a connection to the Senquip Portal. If a device is set to transmit data once an hour, then the settings will be changed up to an hour after the changes have been made on the portal. If quicker changes are required, the device will need to be visited and the changes made via the integrated webserver in setup mode.

Remote setting changes

Remote update of device settings via the Senquip Portal

Note

In applications where power is available, a quicker transmit interval will mean that settings changes can be made more quickly.

Remote Firmware Updates

Senquip will routinely make firmware updates to enable new features, enhance security and fix bugs.

Device firmware can be updated via the Senquip Portal. To update the firmware, press the Update button on the settings page. You will be directed to a page asking for the firmware number. This number can be found in the Device Firmware Changelist on the Senquip website or through your preferred distributor.

Remote firmware updates

Remote firmware updates via the Senquip Portal

A Firmware Update typically takes about 5 minutes on Wi-Fi and 20 minutes on 4G LTE. During the update the green light will be off and the orange light will flash fast. Once the device has received the firmware update and is processing it, the lights may appear to freeze. This is normal behaviour. Please allow plenty of time for the device to finish the update and return to normal operation.

Note

There is always a risk that something may go wrong during a firmware update; it is not recommended that firmware be updated unless it is suggested by Senquip or a specific new feature is required.

Event Reporting

The Senquip Portal allows forwarding of alert, warning, and alarm events generated on a device to email or SMS endpoints. A Hosted plan is required for this feature. Use the Events page on the Senquip Portal to configure event reporting. Events can be configured to be sent once as they occur, or with a daily reminder.

Warning

Make sure to add no-reply@senquip.com to your safe senders list on you email client to prevent email events from going into spam or junk folders.

Setting event forwarding

Configure event forwarding

If an event is current, and the event escalates, for example a warning turns into an alarm, the more severe event will be forwarded. If an event is current and it de-escalates, for an example, an alarm turns into a warning, the event will not be forwarded. If a type of event is current, and a new type of event occurs, the new event will be forwarded. For instance, if a high current warning is active and has been forwarded to email or SMS, and a high temperature warning becomes active, the high temperature warning will also be forwarded.

Creating Custom Widgets

Users can create custom widgets that display data graphically in a way that is meaningful to the user. In the example below, the pressure and temperature of each tire on an axle is shown. In the example, the pressure on tyre 2 has dropped and so the pressure field has turned yellow as a warning to the user.

A graphical representation of the status of each tire on an axle

A graphical widget showing tyre status

To create a widget, select the Display Settings icon on the device data page and chose Add Custom Widget at the bottom left of the page. A new custom widget will be generated and you will be taken to the Widget Editor page to customise your widget. At the top of the Widget Editor page is your widget. It will default to a blank background with an example of how to display temperature shown. The text can be moved to a new location by clicking on it and dragging it.

A blank widget

Default blank widget showing temperature

As an example, we will generate a widget that shows the level of water in a water cart. In the Widget Setup window, we get to name our widget with something meaningful to the user. We will name our widget “Water Cart” We can also set the width of the widget in units of a standard Senquip Portal widget. We will leave the width as 1 unit wide. A background colour can be selected and a background image loaded. We will use the Choose File option to load a background image of a water cart. We can choose to show the units associated with values displayed on our widget, or to leave the units off and make the units part of the background image of the text that is displayed along with the value. We will turn off showing units. Selecting Dynamic Colour Change automatically changes the colour of values and associated text when a warning or alarm is associated with that value. We will leave this on.

Widget settings for our example

Settings for our water cart example

Note

Remember to save your changes.

The Widget Text window allows us to insert text and values on the image in the widget. When you created your widget, an example text entry was created “Drag Me! Temperature is ${data.ambient}”. In this example, the text “Drag Me! Temperature is” will be displayed along with the value of the ambient temperature. The most recent value of ambient temperature is inserted in the text string by using a dollar and curly bracket, followed by the data element, in this example ambient temperature, and a closing bracket “${data.ambient}”. In our example, we will create a script that has a custom variable cp20 called Water Level, and will use this in our example, inserting the unit kl in text as follows “${data.cp20} kl”.

Water Level widget on the device page

Water Level as shown on the device page.

We will choose Bold, 20px font size, and will make the default colour green.

Widget text settings

Water cart widget text settings.

Note

Because we have chosen Dynamic Colour Change, the colour of the text will change if there is a warning or alarm current on cp20.

Our widget now looks like the image below.

Water cart widget showing water level

Water cart widget with water level shown in green.

We will now use the Widget Elements window to add a dynamic level indicator to the tank on the water truck. We will associate the level indicator with the water level, cp20, and will set the width, height, and radius to match that of the tank on the water truck image. Since the water level parameter created in the script has a range of 0 to 20, we will set the minimum and maximum levels of the indicator to 0 and 20.

Settings for widget level inducator

Settings for water cart level element

We could also add a status indicator light to the image by adding a status indicator element. Status indicators can be associated with data values and can be set to change colour as the data value drops below a threshold.

Water tanker widget with dynamic level element

Completed water cart widget

Once saved, the water cart widget will appear on the device page alongside all the other enabled widgets.

Water tanker widget on the data page

Water cart widget shown on the Senquip Portal

To edit the widget, go to the Display Settings page and select the widget by clicking on the widget name.

Sizing of widget images

The width of a custom widget can be chosen as 1 to 4 standard widgets in width. The height of the widget is determined by the size of the image uploaded. In the water cart example above, the image was scaled to result in a widget that is the same height as most of the other standard widgets on the device page. This makes for a neat and consistent looking display. To create a widget the same height as most widgets on the Senquip Portal, use the following ratios for the background image.

Note

The image does not have to be these exact sizes as the width will auto scale. The ratio does however need to be correct.

Widget width

Image width

Image height

Ratio

1

320

178

1.8

2

670

178

3.8

3

1020

178

5.7

4

1370

178

7.7

Creating Custom Charts

Users can create custom line, area, and bar charts with multiple axis, and multiple series. In the example below, the number of particles of a particular size in oil is shown on a stacked area chart, with the total of the stack indicating the total number of particles.

Chart showing particles in oil

Brushed area chart showing particles in oil

Note

To speed up render time, all charts are downsampled to show 1000 points across the chart. The algorithm used to downsample the chart data has been selected to retain as many of the features of the original data as possible. It is however possible that details may be missed in a highly compressed timeline.

To create a custom chart, select the Display Settings icon on the device data page and chose Add Custom Chart at the bottom left of the page. A new custom chart will be generated and you will be taken to the Chart Editor page to customise your chart. At the top of the Chart Editor page is your custom chart. It will default to a simple chart with no series.

A blank custom chart

Default custom chart

We start by giving the chart a name, in this example, we will generate a chart showing temperature and pressure in a compressor and so we will call the chart “Compressor 2D”. We will choose a Line chart, and will give the chart a size of 2 widgets wide by 2 widgets high. We have chosen a time range of 10 minutes. If we had selected Brushed Chart, a magnifying window below the chart would appear that can be dragged left and right to scroll through chart data. The earlier oil particle chart is an example of a brushed chart. If we had selected a Stacked Series, the values of the various series would be summed. The example of the oil particle chart is a stacked chart.

Chart settings

Custom chart settings

We will now add the axis to the chart. We add 1 axis for temperature and 1 axis for pressure. We have added custom minimum and maximum values for the axis but if we had left them blank, axis values would have been assigned based on the available data. The tick interval has been left blank and will be calculated automatically. One decimal place has been selected for the axis labels, and a colour has been assigned to each axis. Custom axis settings are disabled if the Brush Chart option is selected. Only a single axis can be added if Stacked Series is selected.

Chart axis

Custom chart axis

We will now create a series and will assign an axis to each series. We first select the axis associated with the series. We then select a measurement. In our example, we will add compressor temperature and internal device temperature to the Temperature axis and pressure to the Pressure axis. We have selected the line type as Solid, have selected a line width of 2, and have chosen a colour for each series.

Chart series

Adding series to a custom chart

Note

Remember to save your settings.

We have now generated our first chart.

Example of chart generated by custom chart builder

Example chart showing generator temperature and pressure

The charts offer controls for zooming, panning, loading previous and new data, and enhancing a zoomed area. The enhance option is provided so that the user can zoom into an area and then select the option to load more data from the server to enhance the chart where the downsizing algorithm may have smoothed detailed features.

The process for creating a bar chart is similar except that the data to be displayed must be sent from the Senquip device as an array of numbers. The array must be turned into a JSON string object before being dispatched. Each element of the array represents the height of the associated bar.

For instance, the following vibration chart was created by reading 128 frequency bins from a vibration sensor and sending them as a stringified array. The required code is summaried below. Also in the example below, a goal value within which the vibration profile must remain is dispatched to the Senquip Portal. The goal data is static (does not change often), therefore it does not need to be dispatched on every cycle. To set a series as a goal, use the Mark as Goal option in the chart series menu.

...
let profile = readVibrationProfile();
SQ.dispatch(12,JSON.stringify(profile));
...
let goal =
[10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,20,30,50,70,90,110,120,120,120,120,
 120,120,120,120,120,120,120,120,120,120,120,120,110,90,70,50,30,20,10,10,10,10,10,
 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,
 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10];
if (cycle === 50) {SQ.dispatch(13,JSON.stringify(goal));}
...

Example - Reading a Vibration Profile and then Dispatching it to the Senquip Portal.

Bar chart showing a vibration profile

Example bar chart showing a vibration profile and goal

In the following example, each of the 5 series is dispatched as a stringified array with a single element.

Bar chart showing fault data

Example bar chart showing fault data

Management and Hosting on the Senquip Portal

The Senquip Portal offers hosting of data, a data visualisation dashboard, firmware upgrades, and device management including remote configuration and scripting. Every Senquip device purchased comes with a managed plan for the life of the product (10 years). Managed plans allow remote configuration and scripting on the Senquip Portal. Users have the option of purchasing a hosted plan to enable data hosting and data visualisation on the Senquip Portal. Hosted plans are available on a monthly, yearly, or lifetime basis (10 years), and can be purchased directly off the Senquip Portal or through distributors.

Basic

Managed plans are most suitable for users who are hosting their data on their own server and have their own dashboards. Features of the management plan include:

  • Configure devices from the Senquip Portal

  • Connection to a private server

  • View current data

  • 5 Minute updates to the Senquip Portal

  • 1 Day of data storage

  • Device Scripting

  • Access for 3 users

  • Firmware updates

Hosted

Hosted plans are for users who will use the Senquip Portal to store and visualise their data. Features of the hosted plan include:

  • Configure devices from the Senquip Portal

  • Connection to a private server

  • View current and historical data

  • 5 second data update limit

  • 2 years of data storage

  • Device scripting

  • Senquip Portal access for 50 users

  • Firmware updates

  • Export raw data

  • Trigger remote actions

  • Create custom data widgets

  • Create custom charts

  • Device to device messaging

  • 300 email alerts per month

  • 100 SMS alerts per month

  • Senquip Cloud API access

  • AEMP API access

Note

Every device includes 90 days of hosted access from the date of activation.

For the most up to date feature list and to purchase a hosted plan, please visit the Senquip Portal or contact your preferred distributor.