• sales

    +86-0755-88291180

Modbus POE ETH Relay MQTT User Guide

Hardware Connection

  • Connect the Modbus POE ETH Relay to the LAN via a network cable and power it through the power port or through POE.


Software Preparation

Get Started to Communicate

  • Register an account to access the Alibaba Cloud IoT Platform and activate a public instance.


  • Click Device Management -> Products -> Create a product, enter the product name, the example name is Waveshare, and choose a custom category to belong to. Other defaults are available.


  • After creating the product, click View Product Details below to enter the product page and select the Topic category list to go to the Topic page to add a custom topic.


  • Select Topic class list -> Custom Topic -> Define Topic class, create a publish topic send to send data.


  • To subscribe to a topic and receive data.


  • Select Device Management -> Devices -> Add Device. Add a device named 'Relay', which is a relay module.


  • For testing, you can add a device named mqttx device, the Ali cloud web page can only send text data and can not send binary data, so use mqttx software to facilitate debugging.


  • After adding the devices, you can view two devices named "mqttx" and "relay" in the device list. Click on "View" to enter the page for the "Relay" device.


  • Select "Device Information" -> "MQTT Connection Parameters" to view the MQTT connection parameters.


  • Open Vircom -> Device Management -> left mouse click on the corresponding device -> Firmware and Configuration -> MQTT Configuration and enter the configuration page.


  • Configure the connection parameters based on the Relay device MQTT connection information. When the configuration is complete, select Save MQTT Settings and click Download again.



    • Note: You can get the AliCloud IP address by pinging mqttHostUrl.


    • Set the target IP and target port, and click Modify Settings to save. Note: If the local port is 0 then you need to modify a non-zero port, otherwise you cannot connect.


    • After a successful connection, you can see that the Relay device has gone from inactive to online.


    • Download the MQTTX software and install it, creat a new connection after successful installation.


    • Create a new connection based on the mqttx device MQTT connection parameters.


    • Add a subscription after a successful connection.


    • Enter the sent topic, select hex to send and hex display, and send the data.


    • Select Monitor Ops -> Log Services -> Cloud Operation Log to check the information received from the cloud and select hex to display.


    • At this point, both the Relay device and the mqttx device have been connected to the cloud platform, but it is not yet possible to control the relays through the mqttx software, and finally, message forwarding needs to be added.
    • Select Message Forwarding -> Cloud Product Flow -> Data Source -> Create Data Source, the data source name is mqttx-send.


    • Go to edit page, add Topic, select custom, waveshare product, mqttx device, user/send topic.


    • Select Message Forwarding -> Cloud Product Flow -> Data Source -> Create Data Source and then add a data source with the name of relay-send.


    • Go to edit page, add Topic, select custom, waveshare product, relay device, user/send topic.


    • Select Message Forwarding -> Cloud Product Flow -> Data Destination -> Create Data Destination, the data destination name is mqttx-receive.


    • Select Message Forwarding -> Cloud Product Flow -> Data Source -> Create a data source and then add a data destination with the name of relay-receive.


    • Select Message Forwarding -> Cloud Product Flow -> Parser -> Create a parser with the name mqttx-to-relay.


    • Open mqttx-to-relay edit page -> Data Source -> Associated Data Source,Data Source select mqttx-send


    • Data destination -> associate data destination->data destination selection relay-receive


    • Parser script, add the following code and publish, where 1005 is the relay-receive data destination ID, /ipl390TLRtl/Relay/user/receive is the relay receive topic, needs to be more practical to modify.
    //Through the payload function, get the message content reported by the device and convert the payload data into binary variables for pass-through
    var data = payload("binary");
    //Forwarding data to relays
    writeIotTopic(1005, "/ipl390TLRtl/Relay/user/receive", data);
    


    • Select Message Forwarding -> Cloud Product Flow -> Parser -> Create Parser then create a parser with the name relay-to-mqttx.


    • Open mqttx-to-relay edit page -> data source -> associate data source, data source select relay-send.


    • Data Destination -> Associate Data Destination -> Data Destination Select mqttx-receive.


    • Parser script, add the following code and publish, where 1004 is the mqttx-receive data destination ID, /ipl390TLRtl/mqttx/user/receive is the mqttx receive topic, need to be more practical to modify.
    //Through the payload function, get the message content reported by the device and convert the payload data into binary variables for pass-through
    var data = payload("binary");
    //Forwarding data to relays
    writeIotTopic(1004, "/ipl390TLRtl/mqttx/user/receive", data);
    


    • Finally, select Start Parser to implement data forwarding. Message forwarding is configured and enabled.


    • At this point, you can send commands to control the relays via MQTTX. Send the relay flip command as shown below. Under normal circumstances, the relay will be flipped and the command data will be returned.


    • The operation is now complete. You can try to send more Modbus commands to test. The data flow is shown below.
    • MQTTX sends the command -> AliCloud receives the data and forwards it to relay -> relay receives the data to execute the action and return the data to AliCloud -> Ali cloud receives data and forwards to mqttx -> MQTTX receives the return data.
    TAG: 800×480 ESP32 S3 Development Board 1.5 inch Round Rotary OLED TouchScreen Smart Knob Display 1.5inch Display 466x466 LVGL for Arduino 5inch USB Monitor Raspberry Pi 5 Raspberry Pi 5inch Display E-Paper USB to UART Spotpear Raspberry Pi PICO LoRa-HF Raspberry Pi Compute Module 4 CM4 PCIe to M.2 NVMe SSD 14 inch Dual LCD Computer PC Monitor Display Double Secondary Screen Type C Mini HDMI 1080P For Windows/MacOS Raspberry Pi DSI 800×480 ESP32-C3-Ornament-Trinket-LVGL-Astronaut-Clock-Watch-MINI-TV-1.69inch-Round-LCD-TouchScreen-ST7789-240x280 Raspberry Pi 5 Audio Card 2.13Inch E-Ink 2.13inch e Paper HAT+ Black-White 250x122 E-Ink For Raspberry Pi /Jetson Nano /Sunrise X3 Pi /Pwnago Electronic EYE 0.71 inch Round LCD Display Screen For Arduino Raspberry Pi ESP32 Pico STM32 Sipeed Tang Primer 25K GW5A RISCV FPGA Development Board Dock SDRAM GW5A-LV25MG121 Retro Game linux DeepSeek AI Voice Chat ESP32 S3 Development Board 1.8 inch AMOLED Display 368×448 1.8inch TouchScreen Programmable Watch QMI8658 /MIC /Audio /Battery ESP32-AI Series User Guide