569
edits
Changes
Modbus TCP Slave Send SMS example (view source)
Revision as of 14:43, 2 August 2023
, 14:43, 2 August 2023no edit summary
<p style="color:red">The information on this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.03.2'''] firmware version.</p>
==Introduction==
==Introduction==
'''Modbus''' is a serial communications protocol. Simple and robust, it has become a de facto standard communication protocol and is now a commonly available means of connecting industrial electronic devices.
'''Modbus''' is a serial communications protocol. Simple and robust, it has become a de facto standard communication protocol and is now a commonly available means of connecting industrial electronic devices.
Lets continue with the configuration, now we will configure Modbus TCP Master on the same device. Navigate to '''Services → Modbus → Modbus TCP Master'''. Press the button '''ADD''' and follow the steps provided below:
Lets continue with the configuration, now we will configure Modbus TCP Master on the same device. Navigate to '''Services → Modbus → Modbus TCP Master'''. Press the button '''ADD''' and follow the steps provided below:
[[File:Networking rut configuration modbus tcp master v2.png|border|class=tlt-border|1100px]]
[[File:Networking rut configuration modbus tcp master v3.png|border|class=tlt-border|1100px]]
'''Explanation:'''
'''Explanation:'''
Now that we have '''Modbus TCP Master''' and '''Modbus TCP Slave''' configurated, we will need to create '''Request Configuration'''. The Request configuration will be used to store the SMS message and the number of the recipient. Lastly, we will send the SMS message to the recipient with the set Command.
Now that we have '''Modbus TCP Master''' and '''Modbus TCP Slave''' configurated, we will need to create '''Request Configuration'''. The Request configuration will be used to store the SMS message and the number of the recipient. Lastly, we will send the SMS message to the recipient with the set Command.
To store Phone numbers and SMS messages we will use '''ASCII''' and '''HEX''' Data Types, you can configure either one of them, and both of them will work.
To store Phone numbers and SMS messages we will use '''ASCII''' and/or '''HEX''' Data Types, you can configure either one of them, and both of them will work.
----
----
So first of all, we will create a Request in which we will store the Recipient number and SMS message, we will use '''ASCII Data Type''', '''Set Multiple holding registers(16) Function''' and '''398 Register'''.
So first of all, we will create a Request in which we will store the Recipient number and SMS message, we will use '''ASCII Data Type''', '''Set Multiple holding registers(16) Function''' and '''398 Register'''.
The first 10 registers are reserved for the phone number ('''1 register = 4 symbols''') additionally you will require to put in front '+' which is equal to 00 here. If your number (together with 00) does not take 10 registers we will require you to fill out the left registers with 0 values, that's why we use the '''\u0000 symbol''', which means 0 value.
The first 10 registers are reserved for the phone number ('''1 register = 2 symbols''') additionally you will require to put in front '+' which is equal to 00 here. If your number (together with 00) does not take 10 registers we will require you to fill out the left registers with 0 values, that's why we use the '''\u0000 symbol''', which means 0 value.
Here we will explore two examples, one for the ASCII data type and one for the HEX.
----
----
'''Example Message request:'''
'''Example Message request for ASCII:'''
003706xxx1594\u0000\u0000\u0000\u0000\u0000\u0000\u0000test
003706xxx1594\u0000\u0000\u0000\u0000\u0000\u0000\u0000test
'''Explanation:'''
'''Explanation:'''
* 00 = + symbol
* '''00''' - + symbol
* 3706xxx1594 = phone number
* '''3706xxx1594''' - phone number
* \u0000\u0000\u0000\u0000\u0000\u0000\u0000 - our number only takes up to 3 registers, all other registers will be filled with 0 value
* '''\u0000\u0000\u0000\u0000\u0000\u0000\u0000''' - our number only takes up to 6 and a half registers(2 symbols = 1 register), all other registers will be filled with 0 value
* test - the message that will be sent
* '''test''' - the message that will be sent
----
'''Second example Message request for HEX:'''
30 30 33 37 30 36 78 78 78 31 35 39 34 00 00 00 00 00 00 00 74 65 73 74
----
'''Explanation:'''
* '''30 30''' - equals to 00(+ symbol)
* '''33 37 30 36 78 78 78 31 35 39 34''' - equals to 3706xxx1594 number (keep in mind that 78 in hex equals '''x''' symbol, this whole part has to be changed in accordance to your phone number)
* '''00 00 00 00 00 00 00''' - our number only takes up to 3 registers(4 symbols = 1 register), all other registers will be filled with 0 value
* '''74 65 73 74''' - equals to 'test' in HEX
For this example you will need to use ASCII to HEX converter which will convert your number and message to HEX format, the one used in this example was: '''https://www.utilities-online.info/ascii-to-hex'''
Example of the conversion:
[[File:Networking rut configuration modbus tcp master ascii to hex v1.png|border|class=tlt-border|1100px]]
----
===Finishing the configuration===
Lastly we will need a Request which would send the text message that we loaded previausly, to do so you will need to create a send Request. The Send Request should look like this:
[[File:Networking rut configuration modbus tcp master send request v1.png|border|class=tlt-border|1100px]]
'''Explanation:'''
Firstly, we select '''Set single holding register''', then we select Register '''397''' and value to '''1''' which will send the loaded message.
==Testing the configuration==
Now that we have everything configurated, we need to test the configuration.
First of all, we will execute '''Test''' Request, which will store the phone number and message "test" into the registers and then we will send the message to provided phone number with '''Test_send''' Request.
Execute the first request, if everything was configurated correctly you should receive the confirmation message after that execute the '''Test_send''' request which will send the message to your phone number.
[[File:Networking rut configuration modbus tcp master send request test v2.png|border|class=tlt-border|1100px]]
----
----
'''The example of message received:'''
[[File:Networking rut configuration modbus tcp master send request test meessage v1.jpg|border|class=tlt-border|500px]]
==References==
* '''https://wiki.teltonika-networks.com/view/RUT955_Modbus#Set_Parameters''' Modbus Set Parameters manual
* '''https://www.utilities-online.info/ascii-to-hex''' ASCII to HEX converter
[[Category:Modbus]]