Senquip Portal

The Senquip Portal is Senquip’s secure cloud solution that is powered by Amazon Web Services (AWS). The portal allows for:

  • Viewing of collected data,

  • Long term data storage,

  • Remote configuration,

  • Remote firmware updates,

  • SMS and email event setup,

  • User account management.

By default, access to the Senquip Portal is enabled; it is highly recommended that users retain this setting. If disabled, ORB settings may not be able to be changed remotely and important firmware changes will not be able to be performed. Two instances where access to the portal may disabled are in very power battery operated applications and where the ORB is connected to an alternate MQTT server.

Warning

Disabling communication with the Senquip Portal will mean that no settings or firmware updates will be able to be performed remotely using the Senquip Portal.

Connection with the Senquip Portal is achieved using an MQTT connection. To ensure the highest levels data security, Senquip uses a NIST validated, ultra-secure hardware crypto-element for key and certificate storage and cryptographic processing. The crypto-element is pre-loaded with certificates for AWS, allowing for immediate, out-of-the box, secure communication with the Senquip Portal.

Using the Senquip Portal

This section describes the various features of the Senquip Portal and how to use them.

Login to the Senquip Portal

The Senquip Portal can be accessed at: https://portal.senquip.com/. At the welcome page, you will need to Login or Sign Up to access the portal. If you choose sign-up, you will be asked for your email address, name and a password.

Note

Password must be at least 8 characters and contain uppercase letters, lowercase letters and numbers.

Welcome to the Senquip Portal

Welcome to the Senquip Portal

Device Summary

Once logged-in, on the summary page, a list of all ORB’s associated with your account is shown. From the summary page, new ORBs can be added to your account and ORBs can be grouped into logical categories. Where GPS on an ORB is enabled, that ORB will be shown on a map below the list of devices. Note that where exceptions are present, they will be shown in the Events column; to see detail on the exceptions, select the device. In the Contact column, the time since last successful contact is shown; use this column to check that all devices are communicating as expected.

View all devices associated with your account

View or add ORB’s

To add an ORB, click on the +Add button. You will be asked for the ID and password associated with the ORB. Enter the details and press Submit. The ORB will be added to the list of devices available on your user.

Note

The Device ID should look something like 7DA540190.

View ORB data

View the data associated with an ORB by clicking on the ORB’s Name or Device-ID. After a few seconds, a dashboard associated with the selected device will appear. Only interfaces on the ORB that are enabled and have transmitted data recently will be displayed. Any exceptions currently being experienced by the selected ORB will be shown in the first tile on the dashboard. Information associated with the selected ORB such as the model number and firmware version will be shown in the second tile. At the bottom of each tile, and indication is given as to how recent the associated data is.

Note

Any alerts, warnings or alarms currently present on the selected ORB will be shown in the first tile on the dashboard.

ORB dashboard

ORB Dashboard

Click on the graph icon at the top right of each tile to expose a graph of selected values. Data on the graph can be selected for time periods of an hour, day or week. Click on a point on the chart to show values at that point.

Example chart showing the days temperature

Example chart showing the days temperature

Data measured by the ORB can be visualised in various formats. To change the format in which data is visualised, press the eye icon on the bottom right of the tile. Formats available 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.

Data can be visualised in various formats

Data visualisation in different formats

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 ORB 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 ORB 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.

User Administration

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

Allowed Permission

Admin

User

View

View Data

Yes

Yes

Yes

View Users

Yes

Yes

Yes

Change Device Settings

Yes

Yes

Data Add/Remove Users

Yes

Warning

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

Configuration via Senquip Portal

Settings associated with an ORB can be updated remotely via the Senquip Portal. To change the settings for a selected ORB, press the Settings button on the top right of the dashboard. The selected ORB’s 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.

The ORB checks for settings changes each time it makes a connection to the Senquip Portal. If the ORB 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 ORB will need to be visited and the changes made via the integrated webserver in setup mode.

Remote setting changes

Remote update of ORB 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.

ORB 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 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 orange light on the ORB may stop flashing, or it may stay on. This is normal behaviour. Please allow plenty of time for the ORB 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

Use the Events page on the Senquip Portal to configure event reporting. Alert, warning and alarm conditions can be forwarded to users via email or as an SMS. Event can be configured to be sent never, once, every 10 minutes, hourly or daily. In all cases except never, the events will be forwarded as the event is reported and then at the period selected.

Setting event forwarding

Configure event forwarding

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 basic plan for the life of the product (10 years). Basic 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

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

  • Configure devices from the Senquip Portal

  • Connection to a private server

  • Device Scripting

  • Firmware updates

  • Senquip Portal access for 3 users

  • 1 Data message per day can be sent to the Senquip Portal for diagnostics

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

  • 5 second data update limit

  • 2 years of data storage

  • 300 email alerts per month

  • 100 SMS alerts per month

  • Senquip Portal access for 20 users

  • Firmware updates

  • Device scripting

  • Senquip Cloud API access

  • AEMP API access

Note

Every device includes 90 days of hosting 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.