This protocol is made by two parts:<\/p>\n
- \n
- The client\u00a0<\/strong>(someone connecting to a broker).<\/li>\n
- The broker\u00a0<\/strong>(the one who has the credentials of all the users and allow you to connect and trade information with components that can work with MQTT protocol).<\/li>\n<\/ol>\n
You can find more information about the MQTT protocol\u00a0here<\/a>.<\/p>\n[\/et_pb_text][et_pb_text _builder_version=”4.17.0″ global_colors_info=”{}”]\n
\nIn the picture below is explaned how the MQTT works with EVE system.
\nAll our systems, X1 server, virtual machine and raspberry pi are able to work as brokers and servers.<\/div>\n<\/div>\n[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/Mqtt-Eve.png” alt=”Come funziona il protocollo MQTT sul sistema domotico EVE” title_text=”MQTT con sistema domotico” show_in_lightbox=”on” admin_label=”Immagine” _builder_version=”4.16″ custom_margin=”50px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.27.4″ min_height=”30px” custom_padding=”||0px|||” global_colors_info=”{}”]HOW TO SET MQTT IN ILEVIA MANAGER:<\/strong>
\n<\/br><\/p>\nBefore starting verify these parameter to be correctly set:<\/p>\n
<\/p>\n
- \n
- Create a new gateway and set it in\u00a0MQTT broker<\/strong>.<\/li>\n<\/ul>\n
<\/p>\n
- \n
- \u00a0The default client id should be set to: \u201ceve-mqtt-client<\/strong>\u201c.
Anyway you can call it as you like, if you need to create more then one client make sure you choose a different name from the default one.<\/li>\n<\/ul>\n<\/p>\n
- \n
- \u00a0The default open port in the server should be: \u201c1883<\/strong>\u201c.<\/li>\n<\/ul>\n
<\/p>\n
- \n
- \u00a0The default parameter used to maintain the istance open should be: \u201cKeep alive<\/strong>\u201d (even if you are not sending any command).<\/li>\n<\/ul>\n
<\/p>\n
- \n
- \u00a0Set Quality of Service (QoS) to: \u201cexactly once<\/strong>\u201d (This option guarantees that each message is received only once by the intended recipients).<\/li>\n<\/ul>\n[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/mqtt-gateway.png” alt=”Ilevia software di autoamzione ” title_text=”Software di domotica ” show_in_lightbox=”on” _builder_version=”4.18.0″ custom_margin=”||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.18.0″ custom_margin=”50px||50px|||” custom_padding=”||0px|||” global_colors_info=”{}”]Step 1:<\/strong><\/p>\n
Add a component within my components area, make sure it has the MQTT protocol<\/b> selected as shown in the picture below.<\/p>\n[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/mqtt-switch.png” alt=”Software di automazione | Come impostare l’MQTT gateway all’interno del software di supervisione EVE manager” title_text=”software di supervisione gateway MQTT” show_in_lightbox=”on” _builder_version=”4.16″ custom_margin=”50px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_divider _builder_version=”4.17.0″ _module_preset=”default” global_colors_info=”{}”][\/et_pb_divider][et_pb_text _builder_version=”4.16″ custom_margin=”20px||0px||false|false” global_colors_info=”{}”]HOW DO THE PAYLOAD AND THE TOPIC WORKS?<\/strong>
\n[\/et_pb_text][et_pb_text _builder_version=”4.16″ custom_margin=”30px||0px||false|false” custom_padding=”||4px|||” global_colors_info=”{}”]\nTOPICS<\/strong><\/p>\n
The topics are: read, event, wirte and response.
Each topic has a different type of message that the MQTT broker uses to filter messages for each connected client,\u00a0 the topics are composed in levels divided by slash<\/p>\nExample<\/b>: home\/livingroom\/light<\/p>\n[\/et_pb_text][et_pb_text _builder_version=”4.16″ custom_margin=”26px|||||” custom_padding=”0px|||||” global_colors_info=”{}”]Here is a description of\u00a0 the four automation software topics:<\/strong>
\n[\/et_pb_text][et_pb_text _builder_version=”4.27.5″ custom_margin=”-6px||-4px|||” custom_padding=”0px||19px|||” hover_enabled=”0″ global_colors_info=”{}” sticky_enabled=”0″]\nTopic read<\/strong>: Is used\u00a0to retreve the status of the devices.<\/p>\n
Topic response<\/strong>: Is the device reply to the automation server read request.<\/p>\n
Topic write<\/strong>: This topic is used to set the value of\u00a0 a device parameter.<\/p>\n
Topic event<\/strong>: This topic display the status of the device in case it changes.<\/p>\n[\/et_pb_text][et_pb_text _builder_version=”4.16″ custom_margin=”20px||30px||false|false” global_colors_info=”{}”]PAYLOAD<\/strong>
\n[\/et_pb_text][et_pb_text _builder_version=”4.16″ custom_margin=”-17px||-7px||false|false” custom_padding=”||5px|||” global_colors_info=”{}”]\nA payload is a piece of code that contains a javascript function.
For each topic is executed a javascript function to process the topic payload.<\/p>\n[\/et_pb_text][et_pb_text _builder_version=”4.16″ custom_margin=”30px||||false|false” custom_padding=”||0px||false|false” global_colors_info=”{}”]json string example<\/strong>:<\/p>\nvar data = JSON.parse(payload);var color = {“mode”:”color”,”red”:data.r,”green”:data.g,”blue”:data.b}; return JSON.stringify(color);
\n[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/12\/payload-1.png” alt=”payload example” title_text=”payload example” show_in_lightbox=”on” show_bottom_space=”off” _builder_version=”4.17.0″ custom_margin=”30px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_divider _builder_version=”4.17.0″ _module_preset=”default” global_colors_info=”{}”][\/et_pb_divider][et_pb_text _builder_version=”4.27.2″ custom_margin=”0px||||false|false” global_colors_info=”{}”]Step 2:<\/strong><\/p>\n\u201cTopic responce<\/strong>\u201c:\u00a0 In here you have to write the correct topic base on the device you want to control (you can find all shelly topics from this\u00a0page<\/a>).[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/response-topic-1.png” alt=”Come funziona il topic responce all’interno del software di supervisione domotica EVE manager” title_text=”software di supervisione EVE manager topic responce” show_in_lightbox=”on” _builder_version=”4.16″ custom_margin=”50px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.18.0″ custom_margin=”||50px|||” global_colors_info=”{}”]Step 3:<\/strong><\/p>\n
\u201cTopic write<\/strong>\u201c: In here you have to write the correct topic base on the device you want to control (you can find all shelly topics from this\u00a0page<\/a>).[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/topic-write-1.png” alt=”Come funziona il topic write all’interno del software di supervisione EVE manager” title_text=”software di supervisione domotica topic write ” show_in_lightbox=”on” _builder_version=”4.16″ custom_margin=”50px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.18.0″ custom_margin=”||50px|||” global_colors_info=”{}”]Step 4:<\/strong><\/p>\n
\u201cTopic event<\/strong>\u201c:\u00a0 In here you have to write the correct topic base on the device you want to control (you can find all shelly topics from this\u00a0page<\/a>).[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/topic-event-1.png” alt=”Come funziona il topic event all’interno del software di supervisione EVE manager” title_text=”software di automazione topic event” show_in_lightbox=”on” _builder_version=”4.16″ custom_margin=”50px||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.18.0″ custom_margin=”||50px|||” custom_padding=”||6px|||” global_colors_info=”{}”]Step 5:<\/strong><\/p>\n
- \u00a0Set Quality of Service (QoS) to: \u201cexactly once<\/strong>\u201d (This option guarantees that each message is received only once by the intended recipients).<\/li>\n<\/ul>\n[\/et_pb_text][et_pb_image src=”https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/11\/mqtt-gateway.png” alt=”Ilevia software di autoamzione ” title_text=”Software di domotica ” show_in_lightbox=”on” _builder_version=”4.18.0″ custom_margin=”||50px||false|false” box_shadow_style=”preset2″ global_colors_info=”{}”][\/et_pb_image][et_pb_text _builder_version=”4.18.0″ custom_margin=”50px||50px|||” custom_padding=”||0px|||” global_colors_info=”{}”]Step 1:<\/strong><\/p>\n
- \u00a0The default parameter used to maintain the istance open should be: \u201cKeep alive<\/strong>\u201d (even if you are not sending any command).<\/li>\n<\/ul>\n
- \u00a0The default open port in the server should be: \u201c1883<\/strong>\u201c.<\/li>\n<\/ul>\n
- \u00a0The default client id should be set to: \u201ceve-mqtt-client<\/strong>\u201c.
- The broker\u00a0<\/strong>(the one who has the credentials of all the users and allow you to connect and trade information with components that can work with MQTT protocol).<\/li>\n<\/ol>\n
![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/11\/shelly_rgb_ok.png\")
[\/et_pb_slide][et_pb_slide heading=”SHELLY DIMMER” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/mqtt-protocol-shelly-dimmer-in-eve-automation-software\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ background_color=”#ffffff” background_enable_color=”on” custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” background_layout=”light” link_option_url=”https:\/\/support.ilevia.com\/shelly\/mqtt-protocol-shelly-dimmer-in-eve-automation-software\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/01\/Shelly-dimmer-thumbnail-1-300x199.png\")
![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/12\/thumbnailshelly-em-1-300x199.png\")
![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/01\/Shelly1-1-300x199.png\")
![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/01\/shelly-4-300x199.png\")
![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2019\/12\/shelly-plug-300x199.png\")
<\/p>\n[\/et_pb_slide][et_pb_slide heading=”SHELLY FLOOD” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/mqtt-protocol-shelly-flood-eve-automation-software\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ background_color=”#ffffff” background_enable_color=”on” custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” background_layout=”light” link_option_url=”https:\/\/support.ilevia.com\/shelly\/mqtt-protocol-shelly-flood-eve-automation-software\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/01\/shelly-flood-img-1-300x199.png\")
[\/et_pb_slide][et_pb_slide heading=”SHELLY 2.5″ button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-2-5-inside-the-home-automation-software-eve-manager-pro\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-2-5-inside-the-home-automation-software-eve-manager-pro\/” global_colors_info=”{}” sticky_transition=”on”]\n![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2020\/11\/shelly-2.5_logo_giusto.png\"){kind=logo}
<\/p>\n[\/et_pb_slide][et_pb_slide heading=”SHELLY H&T” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-ht-inside-the-home-automation-configuration-software-eve-manager-pro\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-ht-inside-the-home-automation-configuration-software-eve-manager-pro\/” global_colors_info=”{}” sticky_transition=”on”]\n![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/Shelly-ht-1.png\")
<\/p>\n[\/et_pb_slide][et_pb_slide heading=”SHELLY DOOR\/WINDOW” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-door-windows-2-with-mqtt-protocol-inside-the-home-automation-system-eve\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-door-windows-2-with-mqtt-protocol-inside-the-home-automation-system-eve\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/Shelly-door-window_v2-1.png\")
[\/et_pb_slide][et_pb_slide heading=”SHELLY I3″ button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-i3-inside-the-home-automation-configuration-software-eve-manager-pro\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-i3-inside-the-home-automation-configuration-software-eve-manager-pro\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/Shelly-i3.png\")
[\/et_pb_slide][et_pb_slide heading=”SHELLY DUO BULB” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-duo-bulb-inside-in-order-to-make-it-work-with-mqtt-protocol-inside-the-home-automation-software-eve-manager\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/how-to-set-up-the-shelly-duo-bulb-inside-in-order-to-make-it-work-with-mqtt-protocol-inside-the-home-automation-software-eve-manager\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/Shelly-bulb-logo.png\"){kind=logo}
[\/et_pb_slide][et_pb_slide heading=”SHELLY TRV” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/all\/shelly-trv-device-integration-with-the-ilevia-system\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/all\/shelly-trv-device-integration-with-the-ilevia-system\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/Shelly-trv-1.png\")
[\/et_pb_slide][et_pb_slide heading=”SHELLY PLUS 1″ button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/ilevia-shelly-plus-1-integration-with-the-ilevia\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/ilevia-shelly-plus-1-integration-with-the-ilevia\/” global_colors_info=”{}” sticky_transition=”on”]\n![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/04\/shelly-plus-1-logo.png\"){kind=logo}
<\/p>\n[\/et_pb_slide][et_pb_slide heading=”SHELLY MOTION 2″ button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/shelly-motion-integration-with-ilevia\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/shelly-motion-integration-with-ilevia\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/08\/Shelly-motion-logo.png\"){kind=logo}
[\/et_pb_slide][et_pb_slide heading=”SHELLY PLUS H&T” button_text=”DOCUMENTATION” button_link=”https:\/\/support.ilevia.com\/shelly\/shelly-plus-ht-integration-with-ilevia\/” arrows_custom_color=”#000000″ dot_nav_custom_color=”#000000″ _builder_version=”4.20.4″ _module_preset=”default” header_text_color=”#000000″ custom_button=”on” button_bg_color=”#000000″ button_use_icon=”on” button_icon=”||divi||400″ button_icon_placement=”left” button_custom_margin=”30px||75px||false|false” link_option_url=”https:\/\/support.ilevia.com\/shelly\/shelly-plus-ht-integration-with-ilevia\/” global_colors_info=”{}” sticky_transition=”on”]![\"\"](\"https:\/\/support.ilevia.com\/wp-content\/uploads\/2023\/08\/Shelly-plus-HT-logo.png\"){kind=logo}
[\/et_pb_slide][\/et_pb_slider][et_pb_cta title=”Discover more about our shelly solution.” button_url=”https:\/\/zfrmz.com\/c8bT6AKFYgE9PARNCiIK” url_new_window=”on” button_text=”Get in touch with us” admin_label=”Call To Action” _builder_version=”4.16″ custom_margin=”37px||||false|false” custom_padding=”84px||84px||false|false” locked=”off” global_colors_info=”{}”][\/et_pb_cta][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ inner_shadow=”on” admin_label=”section” _builder_version=”4.24.0″ background_color=”#fafafa” parallax=”on” min_height=”280px” custom_margin=”30px||||false|false” global_module=”59323″ locked=”off” collapsed=”off” global_colors_info=”{}”][et_pb_row admin_label=”row” _builder_version=”4.16″ background_size=”initial” background_position=”top_left” background_repeat=”repeat” global_colors_info=”{}”][et_pb_column type=”4_4″ _builder_version=”4.16″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”][et_pb_text _builder_version=”4.27.4″ _module_preset=”default” global_colors_info=”{}”]\n