Skip to content

Portal

Device Management Portal aims at managing operations with the devices.

Registration

The user receives an invitation on email, follows it and creates a new password.

Gateways

Meshtech assigns the gateways to the customers or the customers claim their gateways. They are available in Gateways section. One customer can have several users. Each one of them have access to the same gateways.

Tags are created to simplify filtration.

Example

Such tags as lab1-gw and lab2-gw can be added to the GWs to distinguish their location inside of the same building.

Filtration fields are not case sensitive.

New jobs can be added from this section as well.

Claim can be used by a customer to claim a gateway if it's not yet assigned. If a gateway is already assigned, claiming will result in an error. Gateway id should always start with "bmac-".

The gateway's ID is clickable and contains information about the selected gateway, network tree, the connected and unconnected devices nearby.

Information

Sync is used to refresh information about the selected gateway.

Revoke token is used to revoke a provisioning token in case of a hard reset of the provisioned gateway with a license key.

Example

If the provisioning token is lost, the provisioned gateway with a license key cannot be connected. The new provisioning token should be revoked in order to turn the gateway on again.

Release means that any other customer will be able to claim the gateway.

Network

In Network the hierarchy of the devices connected to the selected gateway can be requested.

Pin to Parent tab in Interact multiple dialog is used to pin a chosen devices to a preferred parent.

Firmware tab in Interact multiple dialog can be used to collectively upgrade devices' firmware.

Network tree representation is configurable and can be changed to horizontal, vertical or tree in Change view.

It is possible to read/write properties in decoded and hex modes. In a menu next to the device's MAC, select a property in a drop-down menu Interact.

In Firmware, the device firmware can be upgraded immediately or applied later. The "return" button refreshes the firmware upgrade status.

In Ping, the time used to get a response from the chosen device.

Devices

In Devices, all of the devices that are connected to a selected gateway, plus unconnected devices nearby can be requested.

Statistics

In Statistics, such metrics are presented as:

Time - is an hour the statistics is for

Node/Beacon connection timeout is a leaf node/beacon in the network tree disconnects because of a lost connection due to timeout

Backend disconnect is a number of times the backend was disconnected

BLE GW reset is a number of times a GW was reset

Accelerometer configuration is a number of accelerometer config errors

Temporary connection timeout is a number of connection timeout for temporary connections

Management disconnect is a number of times the chosen device disconnected from Device Management Backend

MT messages sent is a number of MT messages that were sent to the chosen device

MT messages received is a number of MT messages that were received from the chosen device

Error code events is a number of error code events

Console

In Console, there are logs shown.

Jobs

Jobs section lists running and completed jobs. Job is an operation over a gateway. Naming a job is optional.

To create a new job, select one or more gateways in the Gateways section by ticking the checkbox in the left column and click the New job button on top.

Note

It's only possible to select several gateways of the same type to create one job for them.

Example

Several gateways can be firmware upgraded at once if they have the same type - for example, MeshConnect 2011.

To firmware upgrade the gateway:

  • Go to Gateways tab
  • Select a gateway(s) to upgrade
  • Create a new job
  • Name a job "Firmware upgrade" (optional)
  • In Firmware Upgrade section, choose the desired version of FW
  • Submit

The new job is created and added to the list of all jobs with its type, creation date, status and the list of gateways, where it's possible to see which gateways are queued, in progress, succeeded, failed, canceled, rejected, removed or timed out.

If Show all is checked, beta FW versions also appear.

It is possible to add any backend, gateway, diagnostics or telnet file while choosing an upgrade option. The backend config file can be generated in Configuration Wizard.

Configuration Wizard

Configuration Wizard section simplifies generating the gateway configs.

  • Choose Backend config
  • Click Create
  • Choose the type
  • Indicate the server (i.e. mqtt.meshtech.no)
  • Choose the port
  • Write your userName and password
  • Choose the mode
  • Enable Use TLS if needed
  • Add Root Certificates if needed
  • Write Topic Prefix if needed
  • Select Disable Subscribe if needed
  • Click View config
  • Save to file or continue editing parameters

The new generated backend config was saved. To use it, switch to Gateways section. Choose one or more gateways, create job and select a Backend file in Configurations section.

Firmware

In Firmware version there are official and beta versions for the devices available for download and further use.

License Keys

Meshtech's partners have a possibility to provision the gateways on their own. License Keys page contains a list of the license keys.

Settings

In Settings it is possible to change an account's email and subscribe to email notifications if there are new releases for chosen devices.

Example

Set Backend Config

Example of how to set the backend server from Device Management Portal.

  • Choose Configuration Wizard section
  • Choose Backend config
  • Click Create

In a new backend configuration window:

  • Choose 'MT2' Type
  • Write 'mqtt.meshtech.no' to Server
  • Choose '1883' Port
  • Write userName
  • Write password
  • Choose 'raw' mode
  • Click View config
  • Click Save to file

The new backend config file backend.json is saved. In order to change the GW's config, go to Gateways section:

  • Select the gateway(s) to configure
  • Click New job
  • Write Backend config in Job name (optional)
  • In Configurations section, click Choose File and navigate to and select to upload the saved backend.json
  • Click Submit

The job has appeared in the list with a Job type setGatewayBackendConfig, a date when created, a Job status COMPLETED and 1 device in DEVICES SUCCEEDED column.

Read/Write Property

Example of how to read/write properties on Device Management Portal.

  • Select a gateway in Gateways
  • Choose Network or Devices section
  • Click Request
  • Choose a device
  • Click on ID or click option button and choose interact with a device

To read, in a new Read/Write properties window:

  • Select a property 'device-mode' in a drop-down menu
  • Click Read
  • Receive a value "connected"

To write, in the Read/Write properties window:

  • Select a property "led-0-control"
  • Write 1000
  • Wait for a device's red LED light