Gambit's MIMIC Simulator is a rapid, multi-protocol simulation tool optimized for IoT. In a few steps, you can re-create a physical deployment, simulating real-world conditions such as GPS routes or sensor variables.

Requirements

Table of Contents

  • MQTT Lab Setup

  • Device Creation

  • Dashboard Creation

1. MQTT Lab Setup

Before starting, purchase the MQTT Lab of your preference, you will receive an email with the direct link to your lab when you finish the payment process.

Step 1: Click on the link you received via email, this link will open a tab in your browser with the lab view.

image.png

Step 2: Go to your Ubidots account and click on your profile, choose the API Credentials option, and copy your Default Token for the next steps.


image.png

Step 3: Back in the lab tab, click on Step 1: Setup...

image.png

Step 4: Paste the token that you copied above, into the Default Token field of the dialog. Then press OK.

image.png

Step 5: Once you click OK, a new Run Script Console tab will open with the output of the processing. If the Task completed message appears, and there are no error messages, your lab is configured to work with your Ubidots account with the authentication parameters supplied.

2. Device Creation

The following steps will configure the devices to Publish data to Ubidots according to to Ubidots MQTT Documentation.


image.png

Step 1: In the MIMIC Ubidots MQTT Lab, click on Ubidots Tutorial -> Step 2: Add Device...


image.png

Step 2: In the dialog window, type in the Prefix field the label of the device to be created in your Ubidots account.


image.png

Step 3: Once you click the OK button, a new Run Script Console tab is opened in the browser with the output of the processing. If the Task completed message appears, and there are no error messages, your new sensor device is configured in the MIMIC MQTT Lab, ready to connect to your Ubidots account. You can dismiss this tab, or switch back to the lab browser tab.


image.png

Step 4: Reload the MIMIC MQTT Lab window and the Device icon should have the label underneath.


image.png

Step 5: To start the device, select the icon(s) of the device(s) you want to start. Each selected device will have a blue indicator in the upper left. Then click on Ubidots Tutorial -> Step 3: Start Device(s) -> Go!


image.png

Step 6: The selected icon(s) will turn green as if you had turned the power on.


image.png

Step 7: In your Ubidots cockpit mimic-1 device page, to see the received telemetry you can click on the desired variable as shown below.


image.png

Now that it is running, you will see how the lab devices and your Ubidots are linked.

To check the configuration of the simulated device in MIMIC, select the device icon in the lab, then click on Ubidots Tutorial -> Step 4: Investigate -> MQTT Configuration...

image.png

The MQTT configuration parameters for the devices are the following:

  1. Config File - this defines the MIMIC simulation: what MQTT payload to send where and when. Here the publish is made every second.

  2. The Light value changes randomly and the Temperature values can be dynamically controlled to achieve on-demand, consistent, real-time results.

  3. Broker - Ubidots URL: industrial.api.ubidots.com

  4. Port - 1883

  5. ClientID - blank, meaning uses the default MIMIC client ID

  6. Username - Ubidots Default Token

  7. Password - not used

  8. TLS - set to false to use insecure MQTT

These are configurable parameters you would need to set up in your real-world device to communicate with Ubidots, in case you want to change any of them, please contact Gambit communications for advanced settings.

image.png

To interactively change the temperature value to simulate a device overheating or any other critical case, please follow the next steps.

Step 8: In the MIMIC lab window, select the icon(s) of the device(s) you want to manipulate and start it. Each selected device will have a green icon and a blue indicator in the upper left. Then click on Ubidots Tutorial -> Step 5: Change Telemetry...

image.png

Step 9: In the Change Telemetry dialog, change the Temperature value to the desired value. As soon as you slide the slider to a new value, the new temperature value is published. If you click OK, the value is preserved, if you click Cancel, the value goes back to what it was when you entered the dialog.

Finally, once you activate all the devices in the MIMIC MQTT lab, you will see in Ubidots the list of all the devices with the corresponding data.

image.png

3. Dashboard Creation

Now it’s time to build your own dashboard to start monitoring the data from your devices.

  1. Go to the Dashboard (Data -> Dashboard) section of your Ubidots account.

  2. Select the plus (+) icon located a the right-upper side of the page. Then select the widget types desired to display in your Ubidots’ Dashboard .

You can customize your Dashboards and application in just a few clicks, please refer to the following guides to learn how.

Did this answer your question?