QwantiFi Cloud Device Management (Tool Guide)
Introduction
QwantiFi Cloud Device Management is a browser tool for MagTek MMS / DynaFlex readers. Operators use WebHID over USB to open a device session, inspect identity and firmware, configure Wi-Fi on the reader, enter deployment Location details, and update QwantiFi (MQTT) configuration from Magensa RMS.
What You Can Do
Pair and open a USB WebHID session (including a multi-device picker by serial number)
View device model, serial number, and firmware versions
Enter Location / site address details used by Update Config
Read and write Wi-Fi settings (SSID, security, DHCP/static, protocol)
Read QwantiFi / MQTT settings from the device (Get Config)
Update QwantiFi configuration from RMS and report success/failure back to RMS
Send manual or batch commands and review the Output Console
Prerequisites
A supported MagTek DynaFlex / MMS reader connected by USB
Chrome or Microsoft Edge (WebHID enabled)
App served from
localhostor HTTPSNetwork access to the RMS gateway for Update Config
Valid ResellerID / CustomerID for RMS
AdditionalParameters
Main Layout
Device connection
Status
Dot + short text (Disconnected, Connected, Opened, Reconnecting…)
Open
WebHID picker / in-app multi-device list; loads Device Info and configs
Close
Ends the HID session
ResellerID / CustomerID
Sent as RMS AdditionalParameters (defaults 13204 / 2026213)
Open a Device
Attach the reader by USB.
Click Open.
If the browser shows a device chooser, select the MagTek reader and allow access.
If more than one granted device is available, pick by serial number in the Select Device modal.
Confirm status shows Opened and Device Info populates.
Close a Device
Click Close to end the WebHID session. Fields may retain last-known values until cleared or refreshed.
Device Info and Location
Device Info
After Open: Model, Serial Number, and MainApp / BLE / WLAN FW Version (when available). Use the copy icon on the section title to copy fields as text.
Location
Device Friendly Name
No
Stored as DeviceNickname in Update Config
Street 1
No
Primary street line
Street 2
No (optional)
Suite / unit
City
No
City name
State
No
US state dropdown (2-letter code)
ZIP
No
5 digits
ZIP+4
No (optional)
4 digits
Country
Defaults to US
Editable; defaults to US
Values persist in browser storage and are included in Update Config
AdditionalParameters.Clear (header, left of copy) empties all fields and resets Country to US.
Copy copies the Location fields as text.
There is no address geocode validation; empty fields are allowed.
Wi-Fi
SSID Name / Password
Yes
Primary credentials
Security Mode
Yes
PSK or EAP-PEAP (More info)
Address Mode
Yes
DHCP or Static IP
IP Address
No
Reported by the device
WLAN Protocol
Yes
MQTT or WebSocket Server
Save Config writes Wi-Fi values to the device and shows inline success/failure. Get Config (in QwantiFi) can refresh values from the reader.
QwantiFi Configuration (MQTT)
Get Config
Reads Wi-Fi and MQTT properties from the device (local HID)
Update Config
POST api/V2/Configs → apply Commands on device → POST UpdateDeviceStatus
Broker / Client ID / …
Read-only in UI; provisioned from RMS
Status under Update Config advances one step at a time (Connecting → Sending request → Getting response → Updating → success/fail). Location fields and ResellerID / CustomerID are sent in AdditionalParameters. The endpoints behind this panel are documented in the RMS MQTT Configuration API Reference.
Sample Update Config request body
(Example values shown.)
After Update Config
RMS may return Commands (
SENDCOMMAND,SENDFILE,WAIT,RESETDEVICE,DISPLAYMESSAGE).The app executes those commands on the device when enabled.
Success or failure is reported to RMS via
UpdateDeviceStatus.If
RESETDEVICEis included, the app waits and reopens the USB session when possible.
Tools & Support and Output Console
+ / − Tools & Support
Shows or hides the command / console strip
Command
Hex, SENDCOMMAND,…, or SENDFILE,…
Batch
Load a commands file (JSON Commands array or script lines)
Send Command
Runs one command or the batch file
Output Console
Dark terminal-style log
View Details / Clear
Full detail modal / clear history
Typical workflows
First-time pairing: Serve over HTTPS or localhost; attach a supported MMS reader by USB; click Open and grant the device (or pick by serial when multiple are attached); confirm Device Info fills in.
Enter Location: Fill Device Friendly Name and address fields as needed (Street 2 and ZIP+4 are optional); Country defaults to US; use Clear in the Location header to reset; values are saved locally and sent on the next Update Config.
Configure Wi-Fi: Open the device; optionally click Get Config to load current values; edit SSID / password and More info as needed; click Save Config and confirm the inline status.
Provision QwantiFi from RMS: Open the device; confirm ResellerID / CustomerID and Location fields; optionally Get Config to see what is on the reader; click Update Config and watch the step status; expand Tools & Support / Output Console for the full log; RMS receives success or failure via
UpdateDeviceStatus.Debug with a command or batch file — Expand Tools & Support; enter a hex /
SENDCOMMAND/SENDFILEline, or check Batch and choose a file; Send Command; expand the Output Console / View Details for responses.
Mobile layout
On tablets and phones the page stacks for scrolling. Controls remain the same; touch targets are sized for smaller screens.
Troubleshooting
Open does nothing / no devices
Use Chrome/Edge; serve localhost or HTTPS; check USB cable
Device Info stays empty
Confirm status is Opened; Close and Open again
Save Config fails
Verify SSID/password; expand Output Console for command errors
Update Config fails at Sending
Check RMS BaseUrl / network; confirm API key on server
Update Config fails during Updating
Inspect Commands in the log; retry after device reconnect
Multi-device picker hangs
Wait for serial probe timeout, or unplug unused readers
Need More Help
Last updated