All pages
Powered by GitBook
1 of 1

Loading...

MQTT / QwantiFi Configuration (device settings)

Editorial note, delete before publishing Goes under: API & Command Reference › DynaFlex Programmer's Manual › Properties(new subpage — this is the one piece of QwantiFi content that belongs inside the device Programmer's Manual, because it is device-command/configuration material)

This page documents the on-device settings that put a DynaFlex / MMS reader onto the QwantiFi MQTT broker. These are device configuration properties — part of the device command protocol — which is why they live in the Programmer's Manual rather than with the cloud-side QwantiFi material. For the end-to-end feature and the cloud side, start at the QwantiFi Overview (→ Services › QwantiFi).

How these are applied in practice. In a normal deployment you do not hand-author these settings. RMS generates the exact command sequence and the QwantiFi tooling applies it to the device — see the RMS MQTT Configuration API Reference (→ API & Command Reference › QwantiFi › RMS MQTT Configuration API). This page documents what each setting is so the generated commands and the device's reported configuration can be understood.

Configuration groups

QwantiFi provisioning writes two related configuration groups to the device:

  1. MQTT configuration — the broker connection and topic settings (below).

  2. Trust configuration — the TLS trust material (certificate) the device uses to validate the broker connection when TLS is in use.

Both are delivered as secured commands. The command envelope, sequencing (WAIT), and secured-command mechanics are the standard ones described in Send Secured Command to Device (→ API & Command Reference › DynaFlex Programmer's Manual › Commands › Security › Send Secured Command to Device) and Set Property (Secured) (→ API & Command Reference › DynaFlex Programmer's Manual › Commands › Settings and Information › Set Property (Secured)).

Each row is one settable property. Values shown are examples.

Setting
Meaning
Example

When TLS is used, a Trust configuration command loads the TLS trust material (a certificate) onto the device so it can validate the broker. RMS supplies this as a secured command carrying the certificate payload. Non-TLS and TLS trust profiles are maintained separately on the RMS side (see Web RMS Service). (→ Services › QwantiFi › Web RMS Service)

The device reports its current MQTT settings when queried (the QwantiFi tooling's Get Config action, and RMS's Claims object, both reflect these properties). Reading properties from the device uses <mark style="color:red;"><strong>Get Property</strong></mark> (→ API & Command Reference › DynaFlex Programmer's Manual › Commands › Settings and Information › Get Property).

WlanProtocol

Selects the WLAN transport mode (e.g. MQTT vs. WebSocket Server).

00

Broker

MQTT settings

Device topics vs. POS topics. The device is provisioned to listen on the concrete …/{sn}/SendCommand leaf and to publish on …/device/publish/{sn}. This is the device's side of the same topic model the POS uses from the other direction — see the topic model in the POS Integration Guide. (→ Guides › QwantiFi › POS Integration)

Trust (TLS) configuration

Reading the current configuration back

Broker host the device connects to.

dev-mqtt.magensa.dev

Port

Broker port (1883 plain, 8883 TLS).

8883

QoS

MQTT quality of service for the device's messages.

1

SubscribeTopic

The command topic the device listens on (…/{sn}/SendCommand).

MagTek/13204/2026213/B563215/SendCommand

SubscribeTopicExtended

Optional secondary subscribe topic.

PublishTopic

The topic branch the device publishes responses to (…/device/publish/{sn}).

MagTek/13204/2026213/device/publish/B563215

PublishTopicExtended

Optional secondary publish topic.

ClientId

The device's MQTT client identifier (typically the serial number).

B563215

Username

The device's MQTT username ({reseller}-{customer}-{sn}).

13204-2026213-B563215

Password

The device's MQTT password. Masked in responses.

******

PeerCommonName

Expected TLS certificate common name (when TLS is used).

dev-mqtt.magensa.dev

KeepAlive

MQTT keep-alive interval.

OperatingMode

Transport hint reported by the device.

mqtt