DMS

dms.auto_start_enabled

Abbreviation

dm a

Access

get/set

Description

The dms.auto_start_enabled variable automatically starts the DMS websocket when the configured DMS interface is brought up. This is useful for SDK applications that need to use the DMS APIs but do not require other DMS plugins such as Command or Telemetry.

Note: This variable is not required if another DMS plugin is enabled such as dms.cmd.enabled or dms.telemetry.interval.

Arguments

1/0

Default

0

Platforms

Gecko OS Plugin

Get example

> get dm a
0

Set example

> set dms.auto_start_enabled 1
Set OK

dms.bundle_id

Abbreviation

dm b

Access

get

Description

Displays the DMS bundle ID of the firmware bundle currently loaded onto the device.

Arguments

None

Default

None

Platforms

Gecko OS Plugin

Get example

> get dm b
bc19d591-e96b-4017-9ac3-0459cb480706

dms.cmd.enabled

Abbreviation

dm c e

Access

get/set

Description

Enable support for issuing commands to the device from the DMS. When enabled, the device opens a secure websocket. With the websocket, asynchronous Gecko OS external commands can be sent to the device.

Note: The device must be claimed/activated for this feature to work.

To use this feature, set up the device with credentials for a WLAN connected to the Internet, set dms.cmd.enabled to 1, and reboot.

On rebooting the device opens a Websocket connection to the DMS. Log into the DMS as the user who has claimed the device, select the device, and in the Device Details page select the Console tab. The tab should display device connected. You can now issue commands to the device via the DMS device console.

> set dms.cmd.enabled 1
Set OK
> save
Saved
Success
> reboot
Rebooting
[2019-01-01 | 06:17:20: Disassociated]
[Ready]
SILABS-WGM160P-4.0.0, Gecko_OS-STANDARD-4.0.12-1198, WGM160P
> [Associating to SLA]
> Obtaining IPv4 address via DHCP
IPv4 address: 10.5.6.74
[Associated]
> Resolving host: dfu.zentri.com
Connecting (WS): 52.65.215.174:80
DMS stream opened

Arguments

0|false|off/1|true|on

where:

Default

0

Platforms

Properties

Gecko OS Plugin

Get example

> get dm c e
0

Set example

> set dm c e 1
Set OK

dms.connection.host

Abbreviation

dm c h

Access

get

Description

Return the DMS host name the device users to connect to the DMS. This value can be updated only with an appropriately configured DFU package.

Arguments

None

Default

None

Platforms

Gecko OS Plugin

Get example

> get dm c h
dms.zentri.com

dms.connection.port

Abbreviation

dm c p

Access

get/set

Description

Get or set the DMS socket port.

Arguments

1-65534

Range: 1 - 65534

Default

443

Platforms

Gecko OS Plugin

Get example

> get dm c p 
443

Set example

> set dm c p 8004
Set OK

dms.connection.timeout

Abbreviation

dm c t

Access

get/set

Description

Specifies the amount of time in seconds the device waits for DMS data before timing out.

This is useful for devices that have a poor connection to the DMS

Notes

This persists through factory resets.

Arguments

<seconds>

Range: 7 - 120

Default

20

Platforms

Gecko OS Plugin

Get example

> get dm c t
20

Set example

> set dm c t 40
Set OK

dms.interface

Abbreviation

dm i

Access

get/set

Description

Get or set the network interface to use when connecting to the DMS.

Arguments

wlan/ethernet

Default

wlan

Platforms

Properties

Gecko OS Plugin

Get example

> get dm i
wlan

Set example

> set dm i wlan
Set OK

dms.product_id

Abbreviation

dm p

Access

get

Description

Get the ID for the product to which the device is currently activated.

Arguments

None

Default

varies

Platforms

Gecko OS Plugin

Get example

> get dm p
8c1472a1-bd49-4991-ae10-d652c3d1893e

dms.provision.status

Abbreviation

dm v s

Access

get/set

Description

Determine the device provisioning status. See DMS Provisioning.

Platforms

Gecko OS Plugin

Get example

> get dms.provision.status
R000003
3

dms.provision.token

Abbreviation

dm v t

Access

set

Description

Set the device's DMS provisioning token. See DMS Provisioning.

Note: The token is set only if the device is not provisioned. If the device is already provisioned then this setter returns success and a message indicating it has already been provisioned.

Set arguments

<token>

where:

Default

None

Platforms

Gecko OS Plugin

Set example

Device already provisioned:

> set dms.provision.token <token>
Device already provisioned
Command failed

Device not yet provisioned:

> set dms.provision.token <token>
R000008
Set OK

dms.telemetry.adc_mask

Abbreviation

dm t a

Access

get/set

Description

Bitmask of ADCs to include in posted telemetry message to DMS.

Arguments

<bitmask>

where <bitmask> is a 32bit hex string. Each bit maps to an ADC number. e.g. 0x15 maps to ADCs 0, 2, 4.

Default

0x00

Platforms

Properties

Gecko OS Plugin

Get example

> get dms.telemetry.adc_mask
0x0

Set example

> set dm t a 0x1
Set OK

dms.telemetry.data_mask

Abbreviation

dm t d

Description

Bitmask of data to include in posted telemetry message to DMS.

Arguments

<bitmask>

where <bitmask> is a 32bit hex string with the following flags:

Flag BitDescription
0x0001WLAN SSID
0x0002WLAN BSSID
0x0004WLAN channel
0x0008WLAN RSSI
0x0010WLAN IP address
0x0020remote terminal port
0x0040firmware version
0x0080uptime
0x0100current time
0x0200system faults

Default

0x3FF

Platforms

Properties

Gecko OS Plugin

Get example

> get dms.telemetry.data_mask
0x3FF

Set example

> set dm t a 0x211
Set OK

dms.telemetry.gpio_mask

Abbreviation

dm t g

Access

get/set

Description

Bitmask of GPIOs to include in posted telemetry message to DMS.

Arguments

<bitmask>

where <bitmask> is a 32bit hex string. Each bit maps to a GPIO number. e.g. 0x15 maps to GPIOs 0, 2, 4.

Default

0x00

Platforms

Properties

Gecko OS Plugin

Get example

> get dms.telemetry.gpio_mask
0x0

Set example

> set dm t g 0x31
Set OK

dms.telemetry.interval

Abbreviation

dm t i

Access

get/set

Description

The period in seconds to post telemetry messages to the DMS.

When the device joins the WLAN network, Gecko OS posts a telemetry message immediately. Gecko OS posts a subsequent message every dms.telemetry.interval seconds.

Arguments

<seconds>

Default

0

Platforms

Properties

Gecko OS Plugin

Get example

> get dm t i
0

Set example

> set dms.telemetry.interval 10
Set OK