Overview

Threads can be remotely monitored with the Thread Diagnostics page of the Thread Connection, allowing the user to remotely update the Threads via the FOTA (Firmware Over-The-Air) firmware update system, as well as providing users with some additional remote controls and for troubleshooting or diagnosing the Thread. This article will explain available tools and guide the user in their use.

Note: The Thread Diagnostics page will only be accessible for users with an Admin role in the Organization.

Navigating to the Thread Diagnostics Page

1. From the Connectivity Module, click on the Thread name within the Connections column on the left side of the screen. 

2. Click on the "Diagnostics" tab on the left side of the screen. The user will then be presented with the Diagnostics panel illustrated below.

Updating Thread Firmware

Thread information, including the FW version, is listed on the left side of the Diagnostics panel below the Thread name. Clicking the cogwheel icon next to the Firmware version will open a window allowing the user to view the latest Firmware version available for transmission to the Thread via FOTA. Clicking update will close the window and begin the update. A status bar will be visible in place of the Firmware version on the Diagnostics page. When the Thread is finished updating, it will turn off and reboot before reconnecting to the application.

After clicking on the cogwheel a pop up window will appear with a dropdown of available Firmware versions. The higher the number of the version the newer the Firmware is, the newest version of firmware will be found at the bottom of the dropdown list. It is recommended to always update your Thread device to the newest available Firmware version.Clicking update will close the window and begin the update. A status bar will be visible in place of the Firmware version on the Diagnostics page. When the Thread is finished updating, it will turn off and reboot before reconnecting to the application.

Firmware Update Best Practice Notes: The Thread must be on in order to take the Firmware update command and receive the update data packet. The Customer Success team recommends turning the Thread to Always On in order to take the firmware update. If updating an Endpoint Thread, ensure that the Gateway Thread the Endpoint Thread is connecting to is updated first and that both Threads are in Always On before pushing the FOTA update to the endpoint Thread.

Remote Thread Commands

Commands can be pushed to a Thread remotely if the Thread is On and connected to the application. The command can be used to remotely manipulate the Thread in the event that a Thread is not behaving in an expected manner. The Command can be accessed by clicking the Kebab icon in the upper right portion of the Diagnostics window. If you have any additional questions or concerns about remote Thread commands, please reach out to the Bentley Customer Success team.

Flush Redis and Reboot- This command turns the Thread hardware off and back on before booting the Thread back up.

Thread Logs

Thread Logs can be a useful analytical and troubleshooting tool to help Bentley Customer Success remotely determine a Thread's behavior. This tool is only available for Threads acting as Gateways. To access Thread logs, click on the dropdown above the window in the middle of the Diagnostics page. The user can select from "Warn", Info", "Debug", and "Trace". Each of the first three selections will provide Thread information with only that coding note, while Trace will provide all Thread information. Once selected, the Thread Logs will begin streaming in the window. Selecting the "Download" button will download a copy of the Thread Logs, which will then be accessible in the Asset Documents portion of the Documents Module.