1-1. Installation of Mosquitto MQTT

It is recommended to install MQTT Explorer or a similar tool to review and troubleshoot any issues.
You can download MQTT Explorer from here.
https://mqtt-explorer.com/

 

1-2. Setup of MQTT Explorer

After installation, open the Windows Start menu, search for "MQTT Explorer," and launch the application.
1. When the application starts, the connection settings screen will appear.
2. Enter the required information:
   Hostname: MQTT broker address
   Port: MQTT port number (default: 1883)
   Username and Password (if required)
3. Click "Connect" to establish the connection.

 

 

1-3. Changing the Mosquitto Settings to Connect from Another PC

By default, Mosquitto operates in local mode (processing data only from itself), so it cannot accept connections from other computers.
The configuration file, "mosquitto.conf," is located in the installation directory (for 64-bit systems, C:\Program Files\mosquitto).

To allow connections from external sources, add a listener with the desired port number.
Add the following entry to mosquitto.conf:
listener 1883

 

1-4. Configuring the Firewall Settings to Connect from Another PC

Add port 1883 to the firewall.
Windows Firewall blocks external connections, so we will disable this setting.

・In [Protocol and Ports], select TCP and specify port 1883. This is the value set in the Listener section of mosquitto.conf.
　If you are using a different port, enter the same value as in mosquitto.conf.
　If multiple listeners are defined in mosquitto.conf, specify all the ports.
　Example: 1883, 1884, 1885

 

Once the setup is complete, it will be added under [Inbound Rules].

 

1-5. Using Username and Password in Mosquitto

1. Create a file named "password.txt" in the folder where the MQTT broker is installed (for 64-bit systems, C:\Program Files\mosquitto).
The contents of the file should be as follows:
AAA:BBB
(AAA is the Username, and BBB is the Password.)
To register multiple usernames and passwords, list them all:
Example:
AAA:BBB
CCC:DDD

2. This file will be encrypted.
Run the following command:
mosquitto_passwd -U password.txt

3. Edit the "mosquitto.conf" file in the folder where the MQTT broker is installed.
Add the following entries:
allow_anonymous false
password_file C:\Program Files\mosquitto\password.txt

4. Restart mosquitto.
Search for "Service" in the app search, find "Mosquitto Broker" in the list, and restart it.

 

2. Camera Setup

It is recommended to configure the camera before proceeding with the Luxriot EVO Server configuration.
1. Log in to your i-PRO camera via the browser.
2. Navigate to Setup -> Detailed setting -> Detailed setting screen.

3. From the left menu, select [Network] -> [Advanced], and then click [MQTT] in the top menu.
4. Enter the following MQTT settings:
　　a. MQTT broker IP address
　　b. Port number (1883 by default)
　　c. Protocol: Select "MQTT over TCP"
　　d. Username
　　e. Password

5. Scroll down and check the events you wish to monitor.  
You can also verify or change the "Topic" and "Payload" here.  
You will need this information when configuring events on the Luxriot EVO server.

6. Ensure alarms are enabled for the selected events.

After completing these steps, your i-PRO camera should be ready to send data to the MQTT broker.

 

3. Luxriot EVO Server Setup

Once the MQTT broker and camera are configured, you can start receiving notifications and respond to them using the full capabilities of the Luxriot EVO Events & Actions configurator.

 

3-1. MQTT Broker Registration with Server

The first step is to configure EVO to recognize the MQTT broker. Follow these steps:

1. Open Console -> Configuration -> MQTT Clients.
2. Click "+ New MQTT Client" at the top of the section.
3. Enter a meaningful name in the Title field.
4. Provide the necessary MQTT broker details: Host IP, Port, Username, and Password.
5. All other fields are optional and depend on your MQTT broker configuration.

Note: If your MQTT broker requires a secure connection, you may need to configure additional options.

 

3-2. Events & Actions Configuration

The final step is to configure Events & Actions. Follow these steps:

1. Go to Console -> Events & Actions -> Events.
2. Click the “+ New event” button at the top of the section.
3. In the new popup window, under the “External events” section, select the “Event triggered by MQTT notification.”

4. In the Event window, enter a meaningful Title and select your MQTT client as the Source.
5. Ensure that both the "Topic" and "Payload" match the settings configured in Step 5 of Section 2. Camera Setup.

 

3-3. Camera Registration

1. Go to Configuration -> Devices.
2. At the top of the section, click the “+ New device” button.
3. Enter a meaningful title in the “Title” field.
4. In the “Model” field, select a camera from the list.

5. Select "Network" from the left menu and enter the network details.

That concludes the process. 
You may now utilize the “Events and Actions configurator” to define your Rules.
A basic example is provided below; for further details, kindly refer to the Administration Guide.

 

3-4. Bringing Events to Life

1. Navigate to Events & Actions -> Rules.
2. At the top of the section, locate the “Open Configurator” button.
3. In the “Events and Actions configurator” window, find the Event you created and drag it to the Rules section in the center.
4. Under Actions -> Global Server, locate “Send event to client” and add it as an action for your MQTT event.
If "Send event to client" is unavailable, click the "+ Action" button, then find and add "Send event to client" from the "Select action type" screen.
5. You may also wish to specify the Target Channel for receiving notifications within the dedicated viewport.
6. Configure the behavior for when Luxriot EVO receives an alarm:
   Click the "Edit action" button and adjust the settings in the Details dialog.

After confirming the configuration, you may check the Luxriot EVO monitor to ensure everything is functioning correctly.
・Example of setting the behavior when Luxriot EVO receives an alarm.
　When {ADDITION_INFORMATION} is inserted as "Message" in the Details dialog.

The Topic and Message text will be displayed in the warning message box and notification panel on the Luxriot EVO monitor.

 

VMS Version 1.29.1.109