The MQTTspB Simulator is integrate with the Data Explorer Tools. 

We are releasing an MQTT Client simulator (with Sparkplug) to make testing easier and faster – testing for projects in general, testing for communication with the software platform MQTT Client, and for testing our new Dynamic Tag Provider functionality with MQTT.

Why struggle with multiple tools? With this simulator, you can easily publish 30k simulated values to the MQTT Broker – all from the same design environment.

Overview

This document has information on the MQTTspB Simulator configuration and Runtime Behavior.

System Requirements

This simulator application comes with the default installation of product version 10. The executable file can be found under the ../fx-10/Protocols/MQTTspBSimulator.exe directory.

Make sure to execute the file from inside this folder to ensure all dependencies are satisfied.

Simulator Configuration

When you click on the icon next to the command buttons, it opens the MQTTspB Simulator Configuration dialog. This configuration dialog has the following fields:

Refer to the MQTTspB Simulator for detailed information.

Editing MQTT Data Structure

This configuration popup in the MQTTspB Simulator allows users to define and customize the data payload that the simulator will publish to the MQTT broker. Here is a detailed description and explanation of each section and its components:

NodeIDs

NumberOfNodes: Specifies the number of nodes (or groups of devices) included in the data structure. Default value is set to 4, meaning there are four groups of devices.

Node List: Lists the node names. By default, the nodes are named "Barcelona," "Bilbao," "Madrid," and "Sevilha." Users can add or remove nodes using the add (+) and remove (–) buttons.

DeviceIDs

Device List: Lists the devices under the selected node. By default, the devices are named "Panel_1," "Panel_2," and "Panel_3." Users can add or remove devices using the add (+) and remove (–) buttons.

Tags

Tags Table: Defines the tags associated with each device. Each row represents a variable with the following columns:

Name: The name of the variable (e.g., "Name," "State," "Latitude," "Longitude").

Type: The data type of the variable (e.g., "String," "Boolean," "Double").

VariationFlag: Indicates whether the variable should vary over time. When checked, the variable's value will change according to the specified range.

Min: The minimum value of the variable when it varies.

Max: The maximum value of the variable when it varies.

InitialValue: The initial value assigned to the variable when the simulation starts.

Controlling the Simulator

The Simulation Control in the MQTTspB Simulator allows users to manage the data publication process. Here is an explanation of each control option available:

Publish One Data Sample: Initiates publishing a single data sample to the MQTT broker. It is useful for testing and verifying if the data structure and connection are configured correctly. By publishing one sample, users can ensure the data is sent and received as expected without starting a continuous data flow.

Publish Continuous Data: Starts the continuous publication of data to the MQTT broker. When active, the simulator will repeatedly send data samples at specified intervals. This is useful for simulating real-time data streams and stress testing the MQTT infrastructure. Continuous data publishing also helps evaluate how the system handles sustained data loads.

Stop Publishing Data: Stops the data publication process, whether a single or continuous data sample. It controls the data flow and stops the simulation when necessary. Stopping data publication can be used to adjust configurations, analyze received data, or halt the simulation after a specific testing period.

Simulator Configuration

The MQTTspB Simulator is divided in three main regions. Configuration (Connection Parameters and Payload Settings), SimulationControl and View (DataBrowser and EventLog).

Connections Parameters displays configurations options defined on MQTTspB Simulator Configuration, such as the Broker URL, Port, Username, Password, Start Minimized, Block Configuration Field, Connect On Startup and Publish Data On Startup.

The Payload Settings of the MQTTspB Simulator Configuration dialog allows users to manage settings related to the data payload being sent, such as GroupID, Number of NodesIDs and the Edit Data Structure button. 

GroupID: Specifies a unique identifier for a group of clients or devices. This identifier helps organizing and managing clients within the same group.

Number Of NodeIDs: Indicates the number of nodes or individual devices within the specified group. This value helps structuring the data to be sent, ensuring that the correct number of nodes is included in the payload.

Edit Data Structure: This button allows users to modify the data structure that will be used in the payload. Clicking this button opens a configuration popup where users can define or adjust the data points, types, and hierarchical organization of the data to be published.

This window has buttons to connect and disconnect. It also has two tabs: Connection Parameters and Payload Settings.

Connection Parameters

Here is configured the necessary information required to establish a connection to a Broker.

• Broker URL: MQTT Broker (Server) Default value is loopback (local) ip (127.0.0.1).
• Port Number: MQTT Broker listening port Default value is 1883.
• Username: Username defined on the Broker. This will be requested if the Broker needs this configuration (optional).
• Password: Password defined on the Broker. This will be requested if the Broker needs this configuration (optional).
• Start Minimized: Application starts minimized (valid for the next time the application is started).
• Connect On Startup: MQTTspB Client tries to connect to Broker automatically when application is started (valid for the next time the application is started).
• Publish Data On Startup: MQTTspB Client tries to publish Data to Broker automatically when application is started (valid for the next time the application is started).
• Block All Configuration Fields: Make configuration fields read-only.
  

Payload Settings

In this tab, you will be able to configure the Payload Structure to be published.

The structure is defined based on a hierarchical structure illustrated below:

<GroupID Name="<GroupName>">
|-- <NodeIDs>
|   |-- <NodeID Name="<NodeName>">
|   |   |-- <DeviceIDs>
|   |   |   |-- <DeviceID Name="<DeviceName>">
|   |   |   |   |-- <Variables>
|   |   |   |   |   |-- Var1
|   |   |   |   |   |-- ... 
|   |   |   |   |   |-- VarN
|   |   |   |-- <DeviceID Name="<DeviceName2>">
|   |   |       |-- <Variables>
|   |   |   |   |   |-- Var1
|   |   |   |   |   |-- ... 
|   |   |   |   |   |-- VarX
|   |-- <NodeID Name="<NodeName2>">
|       |-- <DeviceIDs>
|       |   |-- <DeviceID Name="<DeviceName>">
|       |   |   |-- <Variables>
|   |   |   |   |   |-- Var1
|   |   |   |   |   |-- ... 
|   |   |   |   |   |-- VarY
|       |   |-- <DeviceID Name="<DeviceName>">
|       |       |-- <Variables>
|   |   |   |   |   |-- Var1
|   |   |   |   |   |-- ... 
|   |   |   |   |   |-- VarZ

To edit the structure, click on the Edit Data Structure button and customize your Payloas at the dialog window.

There are some properties to be defined for Variables:

• Type: Define the Variable DataType. Options are:

• • Double
  • Integer
  • Boolean
  • String

• VariationFlag: Flag that indicates if variable value will be simulated every second in Runtime.
• Min: Defines the minimum value for simulated data.
• Max: Defines the maximum value for simulated data.
• InitialValue: Defines an initial value for the variable.

Simulation Control

This section is used to define the simulator behavior in runtime.

• Publish One Data Sample: Sends one DDATA message for each Device created in the session.
• Publish Continuous Data: Sends continuous DDATA messages with a time rate of 1 second.
• Stop Publishing Data: Stop publishing continuous data.

Data Browser

In this region, you will be able to see the Payload Structure existing in the Broker.

EventLog

This log displays useful information regarding the MQTTspB Simulator activity.

Command Line Parameters

The MQTTspB Simulator can be executed with custom parameters through the command line. The syntax is as follows:

"..\MQTTspBSimulator.exe" /param1:<param1Value> ... /paramN

The existing parameters are listed below:

• Minimized: Application starts minimized.
• ConnectOnStartup: MQTTspB Client tries to connect to Broker automatically when application is started
• PublishDataOnStartup: MQTTspB Client tries to publish Data to Broker automatically when application is started
• BlockConfigurationFields: Make configuration fields read-only.
  
• BrokerUrl: MQTT Broker URL
  
• Port: MQTT Broker listening port
  
• UserName:  Username defined on the Broker. This will be requested if the Broker needs this configuration (optional)
• Password:  Password defined on the Broker. This will be requested if the Broker needs this configuration (optional).
  
• GroupId: Defines the initial GroupID for the Payload Structure.
  
• Config: Full path for *.xml configuration file with Server Configuration and custom DataStructure. More details on the syntax for the *.xml file in section 4.
• Path: Full path of a FrameworX solution directory in which a configuration file can be found

Usage:

"..\MQTTspBSimulator.exe" /Minimized /AutoStart
                         /Config:"C:\Documents\CustomConfig.xml"

Custom Configuration(*.xml)

With a custom configuration file, you will be able to define your own Broker Configuration and DataStructure. The syntax for the configuration is described below:

<?xml version="1.0" encoding="utf-8"?>
<MQTTspBSimulator>
	<ConnectionParameters>
		<BrokerUrl>127.0.0.1</BrokerUrl>
		<BrokerPort>1883</BrokerPort>
		<UserName></UserName>
		<Password></Password>
	</ConnectionParameters>
	<PayloadSettings>
		<GroupID Name="GroupID">
			<NodeIDs>
				<NodeID Name="NodeID1">
					<DeviceIDs>
						<DeviceID Name="DeviceID1">
							<Variables>
								<Variable Name="Name" Type="string" VariationFlag="false" InitialValue="City"/>
								<Variable Name="State" Type="boolean" VariationFlag="true"/>
								<Variable Name="Latitude" Type="double" VariationFlag="true" Min="-5" Max="2" InitialValue="0"/>
								<Variable Name="Longitude" Type="double" VariationFlag="true" Min="40" Max="43" InitialValue="40"/>
								<Variable Name="PanelPower" Type="double" VariationFlag="true" Min="200" Max="500" InitialValue="200"/>
								<Variable Name="PanelVoltage" Type="double" VariationFlag="true" Min="-220" Max="220" InitialValue="0"/>
								<Variable Name="PanelCurrent" Type="double" VariationFlag="true" Min="-10" Max="10" InitialValue="0"/>
								<Variable Name="TemperaturePort" Type="integer" VariationFlag="true" Min="15" Max="35" InitialValue="0"/>
							</Variables>
						</DeviceID>
						<DeviceID Name="DeviceID2">
							<Variables>
								<Variable Name="Name" Type="string" VariationFlag="false" InitialValue="City"/>
								<Variable Name="State" Type="boolean" VariationFlag="true"/>
								<Variable Name="Latitude" Type="double" VariationFlag="true" Min="-5" Max="2" InitialValue="0"/>								
							</Variables>
						</DeviceID>
					</DeviceIDs>
				</NodeID>
				<NodeID Name="NodeID2">
					<DeviceIDs>
						<DeviceID Name="DeviceID1">
							<Variables>
								<Variable Name="Name" Type="string" VariationFlag="false" InitialValue="City"/>
								<Variable Name="State" Type="boolean" VariationFlag="true"/>
								<Variable Name="Latitude" Type="double" VariationFlag="true" Min="-5" Max="2" InitialValue="0"/>
								<Variable Name="Longitude" Type="double" VariationFlag="true" Min="40" Max="43" InitialValue="40"/>
								<Variable Name="PanelPower" Type="double" VariationFlag="true" Min="200" Max="500" InitialValue="200"/>
								<Variable Name="PanelVoltage" Type="double" VariationFlag="true" Min="-220" Max="220" InitialValue="0"/>
								<Variable Name="PanelCurrent" Type="double" VariationFlag="true" Min="-10" Max="10" InitialValue="0"/>
								<Variable Name="TemperaturePort" Type="integer" VariationFlag="true" Min="15" Max="35" InitialValue="0"/>
							</Variables>
						</DeviceID>
						<DeviceID Name="DeviceID2">
							<Variables>
								<Variable Name="Name" Type="string" VariationFlag="false" InitialValue="City"/>
								<Variable Name="State" Type="boolean" VariationFlag="true"/>
								<Variable Name="Latitude" Type="double" VariationFlag="true" Min="-5" Max="2" InitialValue="0"/>
							</Variables>
						</DeviceID>
					</DeviceIDs>
				</NodeID>
			</NodeIDs>			
		</GroupID>		
	</PayloadSettings>
	<SimulatorControl>
		<ConnectOnStartup>false</ConnectOnStartup>
		<PublishDataOnStartup>false</PublishDataOnStartup>
		<Minimized>false</Minimized>
		<BlockConfigurationFields>false</BlockConfigurationFields>
	</SimulatorControl>
</MQTTspBSimulator>

MQTTspB Simulator with the fxAssetsMonitor demo project

Additional Information:

Solution for when the configurations from the XML MQTTspBSimulator-Demo9.2.exe.config are applied and the tags do not appear.

When you are using the demo project fsAssetsMonitor via the MQTTspB Simulator, it's necessary that the file "MQTTspBSimulator-Demo9.2.exe.config" be copied and pasted into the folder along with the project "fxAssetsMonitor.tproj". Upon opening the project, you can verify in Edit>Scripts>Classes, within the class CheckStatus that this class contains a method called StartMqttSimulator(). When running the project this method will fetch some arguments and together with the .config file, and from these configured arguments, the MQTTSpb Simulator will be called to run the values that are configured within this .config. When running the project this will be done automatically, without needing to manually open the simulator.

The original file "MQTTspBSimulator.exe.config" within the product's installation folder comes with default values for simulation and can be modified to generate new simulation values. To add new attributes, you can follow the pattern of the other attributes in the file.

In this section: