05/15/2025- Initial Draft - KS
10/23/2025- Added notes about tags - KS
Summary: The RFID Spot truck project consists of Fixed RFID readers & ET Tablets. The RFID readers are mounted on trucks and track trailers throughout the yard. The tablet runs their application and draws data from our Yard tracking RFID use case, but does not run our software on tablet. The RFID Readers will be configured and tested with cellular, including activation of SIMs via contact with Capstone prior to shipping. The ET Tablets will be enrolled in SOTI and also tested with cellular, including activation prior to shipping.
*Notes: ET85 only for use in high temperature sites (IE: Amarillo) where the ET65 will be used in standard deployments going forward to allow them to use android where possible.
**Any RFID tags that are sent with orders need to be inventoried. These are sometimes noted on the outside of the box, but sometimes may require manual scanning of the barcode/RFID. Please consult with Kyle if you have any question.
Staging Document attached here and also located in Customer Files / Capstone / Spot Truck / Staging. Once hardware is received, it should be asset tagged and SIM cards inserted. All that information should be scanned into the document and sent to: solbrisa.robinson@capstonelogistics.com
-Allow 24 hours for Capstone team to activate SIMs
It should be sent to SSTIDAssetNotifications@capstonelogistics.com with new entries when a site is configured and shipped. This should be sent when completed with tracking info.
Associate asset tag and sim card to each device - FXR90, ET45, ET65, and ET85
Scan PN, SN, IMEI, Capstone Asset ID, and ICCID into Capstone SpotTruck Staging Running template
Email running template to group email for SIM activation solbrisa.robinson@capstonelogistics.com, cc: capstonespottruck@sstid.com
Activation completed email received proceed to staging
OS Load latest
Zero Touch Enrollment
SOTI staging
Group move to Spot Truck group
QA
Staging Completed - Release email for shipping and asset tag details notification - SSTIDAssetNotifications@capstonelogistics.com cc: capstonespottruck@sstid.com
Copy the tenantId. In this document we’ll assume tenantId abcd12345678901234567890
Gather the hostnames of the devices you need to stage (in lowercase)
Go to the MQTT page, on the Users tab:
If there is no userName for the tenant yet, add a new MQTT User:
UserName: tenantId
Description: Tenant Name
Password: Create something good, but keep a copy somewhere securely
Confirmation: Repeat password
Tenant: Select the tenant from the dropdown menu
Save
Got to the Access Tab add a new entry:
Username: tenantId
Description: Tenant Name
Permission “allow”
Action: “all”
Tenant: Select the tenant from the dropdown menu
Topics: Add the following 4 values exactly (including $s and curly brackets):
dataCollection/tagHistory/${username}/${clientid}
deviceManagement/device/${username}/${clientid}/+
+/dataCollection/tagHistory/${username}/${clientid}
+/deviceManagement/device/${username}/${clientid}/+
Save
This creates a user account on MQTT that will allow posting JUST to the device’s tenant only.
Add each device you are going to add:
IP address: doesn’t matter
Hostname: required: all lowercase
Type: recommended
Description: recommended
Max # antennas: 2, 4, 8
You can add the actual antenna configurations later. When you do, set the cooldown as high as possible. IoT Connector will treat this value slightly differently: IF the tag is in range when that cooldown ends, it will send another read. Regardless of whether the tag has left the antenna range or not. For conveyor belt setups, where the tag is not expected to return, set this to something very high like 2 hours.
Note: The default login for a device is “admin/change” for anything in production that should have been changed. Change the timezone to the correct timezone, update the time/date, and use an NTP server if available. If the device is new (or factory reset) you are required to set the region (US FCC)
Login on the device
Go to “Settings" in the bottom right
This should dump you to the ENDPOINT tab
Fill in the following information:
For Management:
Endpoint type: 'MQTT'
Endpoint name: 'Tenant Name - Environment' (IE: Duke Energy - Prod)
Endpoint Description: <blank>
Server: Production is app-emqx.sstid.com
Port: 8084
Protocol: Secure Web Socket
Client Id: hostname (all lowercase!)
Clean Session: Unchecked
Debug: Unchecked
BASIC Authentication: Checked
Keep Alive 60
QOS: 1
-Click the Topic Tab
Command Topic: deviceManagement/device/{tenantId}/{deviceName}/mgmt
IE: deviceManagement/device/675b45ded853781441c057/fxr90c60982/mgmt
Response Topic: deviceManagement/device/{tenantId}/{deviceName}/mgmtResponse
IE: deviceManagement/device/675b45def4d8781441c057/fxr90c60982/mgmtResponse
-Click the Certificates Tab
Use Installed Certs: Checked
Certificate: Server
USA CA Certs from Store: Checked
Cert Algorithm: RS256
Cert Format: PEM
Verify Server Certificate: Unchecked
Verify Host Name: Checked
-Click the Control Bubble:
Endpoint type: 'MQTT'
Endpoint name: 'Tenant Name - Environment' (IE: Duke Energy - Prod)
Endpoint Description: <blank>
Server: Production is app-emqx.sstid.com
Protocol: Secure Web Socket
Client Id: hostname (all lowercase!)
Clean Session: Unchecked
Debug: Unchecked
BASIC Authentication: Checked
Keep Alive 60
QOS: 1
-Click the Topic Tab
Command Topic: deviceManagement/device/{tenantId}/{deviceName}/control
IE: deviceManagement/device/675b45f4d853781441c057/fxr90c60982/control
Response Topic: deviceManagement/device/{tenantId}/{deviceName}/controlResponse
IE: deviceManagement/device/675b45d4d853781441c057/fxr90c60982/controlResponse
-Cick the Tag Data 1 Bubble
Endpoint type: 'MQTT'
Endpoint name: 'Tenant Name - Environment' (IE: Duke Energy - Prod)
Endpoint Description: <blank>
Server: Production is app-emqx.sstid.com
Protocol: Secure Web Socket
Client Id: hostname (all lowercase!)
Clean Session: Unchecked
Debug: Unchecked
BASIC Authentication: Checked
Keep Alive 60
QOS: 1
-Click the Topic Tab
Response Topic: dataCollection/tagHistory/{tenantId}/{deviceName}
IE: dataCollection/tagHistory/675b45def4d3781441c057/fxr90c60982
-Click the Certificates Tab
Use Installed Certs: Checked
Certificate: Server
USA CA Certs from Store: Checked
Cert Algorithm: RS256
Cert Format: PEM
Verify Server Certificate: Unchecked
Verify Host Name: Checked
-Click the Batching and Retention tab
Reporting Interval:1000
Max Payload Size (in bytes): 256000
Throttle(in events per second): 10
No. of Events: 150000
Event Retention Time(in minutes): 1440
-Click the Management Events Bubble
Endpoint type: 'MQTT'
Endpoint name: 'Tenant Name - Environment' (IE: Duke Energy - Prod)
Endpoint Description: <blank>
Server: Production is app-emqx.sstid.com
Protocol: Secure Web Socket
Client Id: hostname (all lowercase!)
Clean Session: Unchecked
Debug: Unchecked
BASIC Authentication: Checked
Keep Alive 60
QOS:
-Click the Topic Tab
Response Topic: deviceManagement/device/{tenantId}/{deviceName}/events
IE: deviceManagement/device/675b45def4d853781441c057/fxr90c60982/events
-Click the Certificates Tab
Use Installed Certs: Checked
Certificate: Server
USA CA Certs from Store: Checked
Cert Algorithm: RS256
Cert Format: PEM
Verify Server Certificate: Unchecked
Verify Host Name: Checked
-Click the Batching and Retention tab
Reporting Interval:1000
Max Payload Size (in bytes): 256000
Throttle(in events per second): 10
No. of Events: 150000
Event Retention Time(in minutes): 1440
-Click Publish
After publishing, you should see the something like the following in the logs:
Dec 13 16:27:24 FXR90C60982 cloud_agent[93074]: [MGMT, CTRL, EVENTS, DATA#1]: connection success (connect onSuccess called)
Dec 13 16:27:24 FXR90C60982 cloud_agent[93074]: [MGMT, CTRL, EVENTS, DATA#1]: subscribing to topic (deviceManagement/device/675b45xxxd853781441c057/fxr90c60982/mgmt)
Dec 13 16:27:24 FXR90C60982 cloud_agent[93074]: [MGMT, CTRL, EVENTS, DATA#1]: subscribing to topic (deviceManagement/device/675b45xxxd853781441c057/fxr90c60982/control)
Dec 13 16:27:24 FXR90C60982 cloud_agent[93074]: [MGMT, CTRL, EVENTS, DATA#1]: successfully subscribed to topic (deviceManagement/device/675b45dxxx53781441c057/fxr90c60982/mgmt)
Dec 13 16:27:24 FXR90C60982 cloud_agent[93074]: [MGMT, CTRL, EVENTS, DATA#1]: successfully subscribed to topic (deviceManagement/device/675b45xxxd853781441c057/fxr90c60982/control)
If you now check in Backbone RFID, the device should show as “online”
Go to the Applications tab in the FXR90
Install the latest filter reads (1.6.2 as of 6/11/2025)
Set the application to autostart
Reboot the reader.