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. Email is not stored and is used to send an invitation only.

Devices

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

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 device if it's not yet assigned. If a device is already assigned, claming will result in an error. Device id should always start with "bmac-".

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

Information

Sync is used to refresh information about the selected device.

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

Example

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

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

Network

In Network Tree the hierarchy of the selected device can be requested.

Pin is used to pin a chosen devices to a preferred parent.

Upgrade 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 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

In Jobs section new jobs are created. Job is an operation over a device. Naming a job is optional.

Note

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

Example

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

To firmware upgrade the device:

  • Create a new job
  • Name a job "Firmware upgrade"
  • Select a device(s) to upgrade
  • In Firmware Upgrade section, choose the latest 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 devices, where it's possible to see which devices 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 also be generated in Configuration Wizard.

Configuration Wizard

Configuration Wizard section simplifies generating the device 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 Jobs section. Name a job "Backend config", choose a device and select a Backend file in Configutations 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 devices 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 Jobs section:

  • Click New job
  • Write Backend config in Job name
  • Select a device for backend config changes
  • In Job actions, 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 device in Devices
  • Choose Network Tree section
  • Click Request
  • Choose a device
  • Click option button and choose interaction 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