Document History Rev. Modifications Author Date Validation Date CREATION 10/05/2012 14/05/2012 § 3.2.1.2 Screw connectors and § 6.7 Input / Output Interface la pin 19 O4-is actually O3- § 5.2.1.1 Definition of course of actions in a scrip adding this paragraph. §...
USING THE GENIP 30I .......................... 24 IP 30 ......................24 TARTING WITH THE 5.1.1 Assembling and disassembling the GenIP 30i ..............24 5.1.2 SIM card Access ........................25 5.1.2.1 Insertion Carte SIM......................25 ...
Page 4
Remarks about syntax of acknowledgements, Macro Commands, patterns or frames received upon action starting ......................39 5.2.5.1 Reaction of the GenIP 30i in case of authorized sources and syntax error....39 5.2.6 Macro Commands ........................40 ...
Page 5
EG_GenIP30i_1016_UG_004_UK Page 5 / 143 5.2.18 Remarks concerning the management of the network gateway or LAN ....... 70 5.2.19 Remarks concerning the management of the DNS service ..........71 5.2.20 Remarks concerning the tools ................... 71 ...
Page 6
IP 30 ......................... 111 EDS OF THE 5.5.1 PWR led of the GenIP 30i ...................... 111 5.5.2 CONF led of the GenIP 30i ....................111 5.5.3 GSM led of the GenIP 30i ...................... 111 ...
Page 7
EG_GenIP30i_1016_UG_004_UK Page 7 / 143 7.2.6.1 Analog Outputs in voltage (0-24V) ................134 7.2.6.2 Analog Outputs in Current (0-25mA) ................135 7.2.7 External power supply V ..................... 137 7.2.8 Output Input and External Power supply behavior ............137 ...
Page 8 / 143 Presentation Entirely dedicated to the most critical and sensible industrial applications, the GenIP 30i with its aluminum Din-rail casing associates the wired connections of high and very high speed (Ethernet / USB) with the wireless world (GSM / GPRS / and 3G).
- For any functioning, the casing must be closed. - No internal part can be repaired by the user. The GenIP 30i must be returned to the factory for any repair. - The GenIP 30i must be placed in a normally ventilated area, out of sources of heat.
The reproduction, transfer, distribution or storage of part or the totality of the contents of this document, in any form, without the prior written authorization of ERCOGENER is strictly prohibited. GenIP 30i is a trademark of ERCOGENER. Hayes is a registered trademark of Hayes Microcomputer Product Inc. The names of products and companies mentioned in this document may be names or trademarks of their respective holders.
EG_GenIP30i_1016_UG_004_UK Page 11 / 143 1 References 1.1 Referred documents Software update Procedure: EG_GenIP30i_1016_UP_xxx_UK GSM reference documents: ● GSM 07.05. ● GSM 07.07. 1.2 Abbreviations Abbreviations Definition Alternative Current Accumulated Call Meter Attention (prefix for modem commands) Base Transceiver Station ClocK CMOS Complementary Metal Oxide Semiconductor...
Page 12
EG_GenIP30i_1016_UG_004_UK Page 12 / 143 Light Emitting Diode MAXimum Mobile Equipment MICrophone Micro FIT Family of connectors from Molex MINimum Microcom Networking Protocol Mobile Originated Mobile Station Mobile Terminated NOMinal Output Pascal (for speaker sound pressure measurements) PBCCH Packet Broadcast Control Channel Personal Computer Power Control Level Packet Data Protocol...
EG_GenIP30i_1016_UG_004_UK Page 13 / 143 1.3 Symbols The following symbols are used to highlight the important information of this user guide. A symbol for the essential information concerning the module integration and performance. A warning symbol indicates the actions that could harm or damage the module Descriptions and non-contractual illustrations in this document are given as an indication only.
- a pluggable connection female 22 pts with spring Push-In of 3.84mm, - GSM hinged antenna (SMA-M), - a technical sheet (Instructions Sheet). Packing case The external dimensions of the GenIP 30i packing case are: -.Width .... : 163 mm, - Height ... : 66 mm, - Length ..
- Height: 37 mm, - Length: 70 mm. 2.3 Modem labels Under the GenIP 30i, there is a label providing the following information: - The ERCOGENER logo, - The product name, - The IP address and the subnet mask by default,...
EG_GenIP30i_1016_UG_004_UK Page 16 / 143 3 General presentation 3.1 Description Description of the GenIP 30i: Front side Sub D 9pin/F connector SMA/F antenna connector Ethernet and LAN Connector SIM reader USB Connector LEDS LEDS Connector Reset Button - RS485 Supply Connector...
This connector is for the power supply. Pin N° Signal + VDC - GND Pluggable connection with 22 male pins: This connector of the GenIP 30i is a connector for the RS485, the digital and analog Inputs/Outputs. Pin N° Signal Pin N° Signal RS485 B–...
106 – PAE – CTS Ring indicator 125 – IA – RI By default, all the outgoing signals are in high level. To dialog with the GenIP 30i, only the TXD, RXD and ground signals are essential. The other signals are not necessary. 3.2.1.4 RJ45 Ethernet LAN connector The RJ45 connector is used for the Ethernet LAN connection.
From now on, the factory parameters are reloaded. Procedure for reloading the reference configuration: To work, there must have been a reference configuration saved in the GenIP 30i. If there was no reference configuration saved, then the factory configuration will be loaded.
8 wires RJ45+S/R (YUS-01) 3.2.2.3 GSM hinged antenna (SMA-M) A GSM hinged antenna (SMA Male connection) is supplied with the GenIP 30i. It is possible and advised to use an antenna with cable for swerving needs. Component Characteristics Dimension straight : 90 mm GSM hinged antenna Dimension bent at 90°C : 30 x 70 mm...
EG_GenIP30i_1016_UG_004_UK Page 22 / 143 4 Technical characteristics and Options The GenIP 30i is a gateway Ethernet, RS232, RS485 to GSM / GPRS / 3G. 4.1 Technical characteristics The GSM/GPRS/3G characteristics and the functions are summarized in the table hereunder.
Tropicalization (*) Options, contact us. 4.3 Backup battery The GenIP 30i is equipped with a battery which maintains the real-time clock. This battery has a 20-week autonomy, with the equipment OFF. The charging time is 4 days. When it is discharged, it does not affect the good working of the equipment. Only a clock updating will be necessary when powering ON the GenIP 30i.
EG_GenIP30i_1016_UG_004_UK Page 24 / 143 5 Using the GenIP 30i 5.1 Starting with the GenIP 30i 5.1.1 Assembling and disassembling the GenIP 30i By default, the modem is provided with a Din-Rail fixing clip (35mm) directly assembled on the modem.
When the "PWR" led flash, The GenIP 30i is ready. To set the parameters of the different functions of the GenIP 30i, the use of an internet browser is advised. Descriptions and non-contractual illustrations in this document are given as an indication only.
Using the GenIP 30i with the browser To use and configure the GenIP 30i, the IP address and the subnet mask must be entered. This window is in the Control Panel / Internet and Network Connections / Connection to local network / Internet Protocol (TCP/IP) / Properties Example under XP.
Page 28
EG_GenIP30i_1016_UG_004_UK Page 28 / 143 In the window Internet Protocol Properties (TCP/IP), enter an IP Address and the subnet mask (see hereunder) and validate with OK Use a browser (Internet Explorer for example) and enter the IP address by default of the GenIP 30i.
Page 29
To be taken into account it has to be validated. The GenIP 30i will warn you that it has to be restarted so that the new parameters can be taken into account. Once the GenIP 30i has restarted, it is advised to make a WAN connection and to send a SMS to validate the GSM and WAN connectivity.
Page 30
EG_GenIP30i_1016_UG_004_UK Page 30 / 143 WAN Connection In the section “My actions / Action Management / Actions List”, validate connect_me_to_WAN_now. The page refreshes, then click on the section “Status” and place the mouse on the section “My Communications”. Once connected to the WAN network, a dynamic IP address is given (for example hereunder: 90.94.237.5). Click "Status"...
Page 31
EG_GenIP30i_1016_UG_004_UK Page 31 / 143 Sending a SMS In the section “My actions / Action Management / Actions List”, click on SMS_a_test_SMS. In the window “Add or Edit an Action”, enter the telephone number of the addressee and validate In the section “My actions / Actions Setting / Action to fire”, validate SMS_test. After a few seconds depending on the operator, the addressee will receive the following message: test.
As well, if you use a data or DTMF connection, the SMS and email reading cannot be done. 5.2.1 Actions In the GenIP 30i, on the menu My actions and Actions management, you will find some predefined actions and you can add your actions. An action is what the GenIP 30i will do after an event.
EG_GenIP30i_1016_UG_004_UK Page 33 / 143 5.2.1.2 Pilot an action in DTMF It is possible to activate an action by a DTMF command with the following syntax: Example : *3* *Action number* The ' Action number ' is the number that appears in the list of actions of the web interface. By default, this feature is not active.
EG_GenIP30i_1016_UG_004_UK Page 34 / 143 5.2.2 Events An event can be characterized by a local frame coming from the ports, an incoming SMS, an incoming email or a temporal logic or analog input triggering. These events can be associated to one or several actions. Example: On a TCP or RS port, we can watch a frame like ALARM If it appears, we decide to send a SMS to one or several numbers 5.2.2.1...
Page 35
EG_GenIP30i_1016_UG_004_UK Page 35 / 143 Some actions can be planned. To reduce the consumption of CPU resource, checking this acknowledgment is done by default every 60 seconds It is possible to change this frequency through the next hidden page. http://vvv.xxx.yyy.zzz/actions_management_advanced.php You choose the right compromise.
EG_GenIP30i_1016_UG_004_UK Page 36 / 143 5.2.3 Pattern A pattern can be a character or frame character AXCII or Hexa For example, if we receive the following information on the RS232: ABCD123456789AZERTY You can search : Character : D Frame character : D123 5.2.3.1 Management of characters in the buffer When viewing the contents of the buffer, some characters in the ASCII table are substituted.
For the acknowledgements syntax, see the table of Macro Commands (paragraph 5.2.6 Macro Commands). Example of acknowledgements: The GenIP 30i is protected by a password adminremote and we want to acquitter the alarm code 1. Through a command port, you will have to send the following information: password adminremote;...
Acknowledgement via DTMF With a telephone, call the GenIP 30i on the voice number. On receipt of the call, the GenIP 30i answers and sends series of vocal frequencies. After that, you can acknowledge an alarm with the following syntax:...
Macro Commands appear. 5.2.5.1 Reaction of the GenIP 30i in case of authorized sources and syntax error In relation to the command channels and the Macro Commands syntax, the reaction of the GenIP 30i will be: Action Result...
Do not forget the semi colon after each command and the “end;” which marks the end of the Macro commands to do. On the Web interface of the GenIP 30i, you will find a Macro command builder which will help you to enter these Macro commands.
Page 41
EG_GenIP30i_1016_UG_004_UK Page 41 / 143 Macro define apn From software release > V450 define apn Format Define temporarily the apn. Description Remarks sur les Useful if you forget to set apn into the Gen IP Macro commands define apn name apn;end; Example define apn name apn Remarks sur les...
Page 42
EG_GenIP30i_1016_UG_004_UK Page 42 / 143 Macro email receive email receive Format Triggers the reading of e-mails Description Via the Data link, the action will be done after hanging-up the Data communication Remarks about and in this case, no message is sent back. Macro commands email receive;end;...
Page 43
EG_GenIP30i_1016_UG_004_UK Page 43 / 143 Macro ftp get file From software release > V408 Ftpget file {ftp server port} {file path} {account} {password} {unsaved_user_file_name} Format Receive a file using FTP and store it into the GenIP Description Maximum storage 100 méga bytes in RAM Remarks about Maximum storage 1 méga bytes in NVRAM.
Page 44
EG_GenIP30i_1016_UG_004_UK Page 44 / 143 Macro ftp put text ftp put text {ftp server address} {ftp server port} {file path} {account} {password} {text Format content} Send text to server FTP Description Remarks about File < 20 Ko Macro commands ftp put text linux.fr.oleane.com 21 FCO/fabien.txt myusername mypassword test Example message;end;...
Page 45
EG_GenIP30i_1016_UG_004_UK Page 45 / 143 Macro last_macro_command_result last_macro_command_result Format Save the result of the last order. Description last_macro_command_result return 1 for OK or 0 for ERROR If you use this command, it is interesting to use the command no all for not have a Remarques sur les duplicate reporting Macro commandes...
Page 46
EG_GenIP30i_1016_UG_004_UK Page 46 / 143 Macro no all no all Format Remove both echo and reporting commands Description Remarks about Macro commands no all; version;end; Example Message sent after 0.xx execution of the action Macro no command no command Format removes echo Description Remarks about...
Page 47
EG_GenIP30i_1016_UG_004_UK Page 47 / 143 Macro password password {my password} Format On the side of the command channels, if a password was activated, it allows accessing to the GenIP in order to send Macro Commands. Description This combines with the validated sources. If a password was activated, it must be sent before each action or chain of action.
Page 48
EG_GenIP30i_1016_UG_004_UK Page 48 / 143 Macro register dyndns register dyndns Format Get register dyndns Description Remarks about Macro commands register dyndns;end; Example Message sent after register dyndns execution of the action Macro reset modem reset modem Format Reset the GSM modem Description Remarks about Macro commands...
Page 49
EG_GenIP30i_1016_UG_004_UK Page 49 / 143 Macro send email send email {adresse email} {message} Format Transmission of email Description Remarks about The support can be WAN or Gateway. Defined in the Email settings. Macro commands send email xxx.yyy@zzz.com message Example Message sent after send email xxx.yyy@zzz.com message execution of the action...
Page 50
EG_GenIP30i_1016_UG_004_UK Page 50 / 143 Macro send rs485 text send rs485 text message Format Send text on RS 485 Description Remarks about Macro commands send rs485 text envoi sur port RS485;end; Example send rs485 text envoi sur port RS485 Message sent after 26 bytes execution of the action...
Page 51
EG_GenIP30i_1016_UG_004_UK Page 51 / 143 Macro set time with ntp set time with ntp Format Setting time of GenIP via the NTP server "pool.ntp.org" Description It is possible to change server. If GenIP is connected to WAN then this connection is used. Remarks about If it is not connected to the WAN then the LAN is used through the gateway.
Page 52
EG_GenIP30i_1016_UG_004_UK Page 52 / 143 Macro update software update software {link} {ftp server address} {ftp server port} {file path} {account} Format {password} Upload firmware update from FTP server Description Will be applied after reboot Remarks about Macro commands update software wan linux.fr.oleane.com 21 FCO/fts.zip myusername Example mypassword;end;...
Page 53
Recieve informations in HTTP execution of the action Macro command chaining example: wan connect ;wait 10 ;get lan ip ;get wan ip ;wan disconnect ;end; Indicates to the GenIP 30i to do the following actions: • Connect to WAN • Wait 10 seconds •...
EG_GenIP30i_1016_UG_004_UK Page 54 / 143 5.2.7 Dynamic messages To access the messages click on "My actions" and then drag the mouse over "Dynamic messages" 5.2.7.1 Identifications and states messages The messages below correspond at identification of the GenIP. They cannot be changed. Identifications messages list Descriptions and non-contractual illustrations in this document are given as an indication only.
EG_GenIP30i_1016_UG_004_UK Page 55 / 143 5.2.7.2 Systems messages The System messages below are used by the GenIp. These can be changed via the web interface, the control port Service port (default: 1224) or via macro command. Some messages that correspond to the entries are read-only. All massages can be changed except 133-139 Once entered and validated, these messages are saved automatically.
Page 56
EG_GenIP30i_1016_UG_004_UK Page 56 / 143 System messages list Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications. Dct_427_02...
EG_GenIP30i_1016_UG_004_UK Page 57 / 143 5.2.7.3 Users messages The Users messages below are for the user. They can be changed via the web interface, the control port Service port (default: 1224) or the macro command. Unlike identifications messages and systems messages, these messages are not saved. $ message_name$ is case sensitive (Respect the lowercase and UPPERCASE).
Page 58
EG_GenIP30i_1016_UG_004_UK Page 58 / 143 Users messages list Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications. Dct_427_02...
EG_GenIP30i_1016_UG_004_UK Page 59 / 143 5.2.8 Script Curently it is possible to write script in GenIP language and PHP language. The maximum capabilities in GenIP language is 35 K octets. The maximum capabilities in PHP language is 100 K octets. 5.2.8.1 Creation of a script in GenIP language A script is a sequence of macro commands for performing an operation.
Page 60
EG_GenIP30i_1016_UG_004_UK Page 60 / 143 Using the macro command builder In the list "I want to" select the action to complete, fill in the fields that appear, then "Add to script". Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications.
Page 61
EG_GenIP30i_1016_UG_004_UK Page 61 / 143 Example of creating a script for sending an SMS 1 - Set the name of the script, 2 - In the list choose "Unclassified / Send a SMS", 3 - Inform the telephone number, 4 - Fill in the message content, 5 - "Add to script", 6 - "Apply".
EG_GenIP30i_1016_UG_004_UK Page 62 / 143 5.2.8.2 Creation of a script in PHP language See to PHP manuel. 5.2.8.2.1 Header function dedicaded to GenIP <?php $stringsys=systemelog; $stringuser=systemeuser; $stringdata=systemeData; send_to_system_log($stringsys); send_to_user_log($stringuser); send_to_data_log(phplog, $stringdata); // execute a defined action // call the action using the name defined in the actions management page run_action("send_a_test_SMS");...
By default, the sequence of scripts is sequential. It means that a script can operate only if the current script is completely done. The GenIP 30i provides the possibility to proceed to a sequence of several scripts in parallel. It means that they operate at the same time.
Page 64
EG_GenIP30i_1016_UG_004_UK Page 64 / 143 Example: The action on input 1 executes the script-1 which sends a file to a server. The action on input 2 executes the script-2 which sends a SMS Sequential Access Parallel Access Application : In the script below, information is sent to a server in function of the value of CUSTOM_MESSAGE_0. A second script must run in parallel, which updates the value of CUSTOM_MESSAGE_0.
In the case where the GenIP 30i is in DHCP server, the attributed lease is 2 days. DHCP range should be before or after the IP address of the GenIP 30i, it should not be any overlap with the IP address of GenIP 30i.
5.2.9.4 Definition of Masquerade When the masquerade is active, the WAN address obtained by the GenIP 30i is replaced by the GenIP 30i address on LAN side. This function is used when the equipment connected on the LAN network cannot provide the gateway address.
If you accept them, your parameters must be positioned in accordance with the ones of the GenIP 30i. When we change only the IP address of the GenIP 30i, the Web interface of the GenIP 30i will be accessible again with the new IP address of the GenIP 30i.
EG_GenIP30i_1016_UG_004_UK Page 68 / 143 5.2.13 Notes about the definition and the behavior of the actions An action with no acknowledgement request can lead to one or several other actions in the following cases: • Action in parallel • Action if success (An action is considered as a success if it succeeded) (Example SMS sent, WAN connection established...).
It is advised to inform yourself about connection rules (time of connection limited as well as on ports supported in TCP/UDP/FTP/HTTP... depending on subscriptions and operators.). 5.2.16 Remarks of WAN connection disconnection of the GenIP 30i The GenIP works with a connection disconnection meter which can be visualized on the system log.
So if we want to reach the GenIP via the LAN gateway, the GenIP must be disconnected from the WAN. A change in the bridge requires a reboot of the GenIP 30i. Descriptions and non-contractual illustrations in this document are given as an indication only.
Ethernet parameters. 5.2.20 Remarks concerning the tools The GenIP 30i provides some analysis or tracks tools like bytes meter, signal level measure, possibility to track some modem commands, manual ping.
EG_GenIP30i_1016_UG_004_UK Page 72 / 143 5.2.20.3 System log tracks It is possible to recover the tracks of the system and user diary via a UDP link orientated towards a port and a machine address which present on the LAN. If this function is not active, it is still possible to download the log. 5.2.21 Remarks concerning Allowed sources By default, no sources are authorized in order to avoid inopportune connections In the case of authorization and in order to avoid problems of excessive communications, you...
EG_GenIP30i_1016_UG_004_UK Page 73 / 143 5.2.22.1 SSL Tunnel The GenIP allows to open only one tunnel at the same time. All information is directed inside the tunnel, consequently when the tunnel is open, only the SMS function remains available. All other functions that do not use the SSL tunnel is not available. For the installation, see the application note AN068, or use the action defined by default.
EG_GenIP30i_1016_UG_004_UK Page 74 / 143 5.2.23 Data Logging There are 10 different records (USB and internal memory) with a limit size for each record: - 1 MB internal memory (10 MB total) - 1 GB on USB key (10 GB total) 5.2.24 IPSec Tunnel The GenIP allows to open 5 tunnels at the same time.
EG_GenIP30i_1016_UG_004_UK Page 75 / 143 5.2.25 User Management and Password This menu is used to set "Users" who have access to GenIP 30i. 5.2.25.1 Creating a User Enter the different fields and "Apply" In the fields "Name" and "Password" use only the characters - A à...
EG_GenIP30i_1016_UG_004_UK Page 76 / 143 The maximum number of users is 20 5.2.25.2 Change Password Enter the old password, the new password, confirm the password and then "Apply". Only the "User" connected can change their password. 5.2.25.3 Hierarchy There are two possible levels of hierarchy: Level 1 .....
Page 77
- Create users level 1 to 4 - Delete Users 3 and 1 In the example below "User1" "is connected to GenIP 30i. He can only do the consultation and cannot change his "Password" Descriptions and non-contractual illustrations in this document are given as an indication only.
EG_GenIP30i_1016_UG_004_UK Page 78 / 143 5.2.26 Remarks about the function Bridge The GenIP provides the Bridge function between the RS ports. The possible combinations are: RS232 RS232 RS485 RS485 RS232 RS485 NB: We cannot make a RS towards two RS. We cannot make a RS towards two RS.
EG_GenIP30i_1016_UG_004_UK Page 79 / 143 5.2.28 Inactivity Timer It is possible using the system message $WAN_TX_TRAFFIC$, $WAN_RX_TRAFFIC$ (see § 5.2.7.2 Systems messages) and using a script to create a inactivity timer on the traffic of the WAN link. Application : In this example below a counter of 10 seconds is initiated by an action and it is refreshed every second.
EG_GenIP30i_1016_UG_004_UK Page 80 / 143 5.3 Information about the function ModBus The GenIP offers the possibility of gateway ModBus RTU ModBus TCP on the links RS, LAN and WAN and it also includes the following features. • Modbus master. This function is under the form of a dynamic variable. It can be integrated inside the message of a SMS, an email or TCP.
Page 81
EG_GenIP30i_1016_UG_004_UK Page 81 / 143 Access to the different parameters of configuration of the Modbus "Mes protocoles/Modbus" (My protocols/Modbus) Then, cross the case "Modbus" Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications. Dct_427_02...
EG_GenIP30i_1016_UG_004_UK Page 82 / 143 5.3.1 Configuration List of configuration parameters associated to the slave Modbus: • Modbus slave address: 01 – 247. • Listening port TCP, internal on the GenIP. The selection of this port is provided to the user in order not to conflict with a port number that he wants to affect to another function.
Page 83
EG_GenIP30i_1016_UG_004_UK Page 83 / 143 Configuration of the RS485 serial link Configuration of the link TCP gateway Modbus List of Modbus equipments defined on the gateway (Example) Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications.
Page 84
EG_GenIP30i_1016_UG_004_UK Page 84 / 143 Creation of Modbus equipment for the gateway Setting the GenIp in Modbus slave. Security code allows to secure the access to the actions and macro commands. Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications.
EG_GenIP30i_1016_UG_004_UK Page 85 / 143 5.3.2 Modbus Master This function is under the form of a dynamic variable. It can be integrated in a message of a SMS, an email or TCP server. The result can be posted on a FTP or TCP server, data-logged in a file stored on USB or in the flash memory or send to SMS or Mail.
EG_GenIP30i_1016_UG_004_UK Page 86 / 143 Example $MODBUS_02_03_00_01_UINT$ Allows to read a register at the address 0 of the slave Modbus address 2 by using the function code 3. The return is of type entire not signed. The variable is replaced by the character string ‘5982’. REGISTER FORMAT Heading...
EG_GenIP30i_1016_UG_004_UK Page 87 / 143 5.3.2.3 Format of data and number of registers that can be read The format of the response can be with the following format: Format Description Number of registers that can be read: 1, 2 or 4. Format: entire signed.
EG_GenIP30i_1016_UG_004_UK Page 88 / 143 5.3.2.4 Example of use of a variable The dynamic variable Modbus can be used in any action that sends a message. For example, to send the Modbus response by SMS, email, TCP/UDP, ftp in a text file. It is also possible to data log the responses in a file stored on a USB key or inside the flash memory of the GenIP.
Page 89
EG_GenIP30i_1016_UG_004_UK Page 89 / 143 Data-logging Example Create a file of data-logging, in the page My actions->Data logger. Create an action which adds a message to a data registration, by selecting the file previously created. The content of the message can be: $DATE_LOCAL$GenIp_Site_North:$MODBUS_01_01_00_02_UINT$$CR$$LF$ Create a periodic event in Administration->Time which calls the action previously created.
Page 90
EG_GenIP30i_1016_UG_004_UK Page 90 / 143 The event created is cyclically called. At each execution of the action, a line will be added in the USB key. Example of Comparison Create a script: $IF_$CMP_$MODBUS_01_03_00_01_UINT$_== 3$ #send sms 0102030405 Door Open GenIp Site North##;end;...
EG_GenIP30i_1016_UG_004_UK Page 91 / 143 List of operators can be used Operator Description equality non equality < lesser <= lesser or equal > greater >= greater or equal 5.3.3 Structure of messages Modbus RTU Request @ Slave Function code @ register Nb register to read CRC 16 Designation...
EG_GenIP30i_1016_UG_004_UK Page 92 / 143 5.3.4 Structure of messages Modbus TCP The message Modbus TCP is made of a heading TCP followed by the classical frame Modbus RTU without CRC. Request Designation TCP Idle Protocol Nb of byte to follow Modbus Frame without CRC Size 2 Bytes...
EG_GenIP30i_1016_UG_004_UK Page 93 / 143 5.3.5.2 Reading of N bits of input Read of N bits of input @Modbus slave function code = 0x02 Address H Address of the bit to read Request Address L Nb bit H Number of bit to read Nb bit L @Modbus slave function code = 0x02...
EG_GenIP30i_1016_UG_004_UK Page 94 / 143 5.3.5.4 Reading of N registers of input Read of N registers of input @Modbus slave function code = 0x04 Address H Address of register to read Request Address L Nb reg H Number of register to read Nb reg L @Modbus slave function code = 0x04...
EG_GenIP30i_1016_UG_004_UK Page 95 / 143 5.3.5.7 Writing of N bit of output Writing of N bit of output @Modbus slave Request Function code = 0x0F Address Hi Address of the bit to write Address Lo Nb bits MSB Number of bit to write Nb bits LSB Nb bytes Number of byte to write...
EG_GenIP30i_1016_UG_004_UK Page 96 / 143 5.3.5.8 Writing of N registers of exploitation Writing of N registers of exploitation @Modbus slave Request Function code = 0x10 Address Hi Address of the register Address Lo Nb registers Hi Number of consecutive register to write Nb registers Lo Nb bytes (Nb registers * 2) Number of byte that follow...
EG_GenIP30i_1016_UG_004_UK Page 97 / 143 5.3.6 Error codes Modbus The example below is given with the following slave address: 0x01 @ Slave Function Code Error Code CRC 16 Designation 1 Byte 1 Byte 1 Byte 2 Bytes Msb - Lsb Size Example 8C03...
EG_GenIP30i_1016_UG_004_UK Page 98 / 143 5.3.7 Addressable memory of the GenIp Address 0x0000 Bit0:Logical INPUT 1 Simple inputs Bit1:Logical INPUT 2 Digital inputs 0x0001 to 0x003F Not used 0x0040 to 0x0043 Logical INPUT 1 Counting inputs 0x0044 to 0x0047 Logical INPUT 2 0x0048 to 0x007F Not used 0x0080...
EG_GenIP30i_1016_UG_004_UK Page 99 / 143 5.3.8 Register of configuration register address Size Access 0x0900 to 0x0907 16 bits Not used Value = Configuration analog input 1 0x0908 16 bits 0x0000 : Not used 0x0001 : in current Configuration analog input 2 0x0909 16 bits 0x0002 : in tension...
EG_GenIP30i_1016_UG_004_UK Page 100 / 143 5.3.9 Reading of digital inputs The inputs 1 and 2 respectively correspond to the bit 0 and 1 of the register at the address 0x0000. The authorized function codes Modbus are 0x02, 0x03 and 0x04. Normally, in respect with the standards, the only function code authorized should be ‘02’, but or flexibility reasons, all reading function codes are authorized.
EG_GenIP30i_1016_UG_004_UK Page 101 / 143 5.3.10 Inputs of counting 2 meters corresponding to the inputs 1 and 2 are accessible on the addresses 0x0040 and 0x0044. The counting value is saved on 32 bits. Even if an input is set for counting, its value is still available in the reading registers of the digital inputs.
EG_GenIP30i_1016_UG_004_UK Page 102 / 143 5.3.11 Reading/Writing of digital outputs The outputs 1 and 2 respectively correspond to the bit 0 and 1 of the register at the address 0x0080. The outputs value is accessible in reading mode. The value read is the one of the latest instruction;...
EG_GenIP30i_1016_UG_004_UK Page 103 / 143 Writing of output 2 Access Request Response Status of input 010101005188 Closed 010100100001AC0A 010101019048 Open Reading of outputs 1 and 2 Status of outputs Access Request Response 010101005188 Closed Closed 010101019048 Open Closed 0101000000029801 01010102D049 Closed Open 010101031189...
EG_GenIP30i_1016_UG_004_UK Page 104 / 143 The examples below are given with the following slave address: 0x01 Example of frame Reading the configuration of analog inputs Inputs Request Response Config. of input 01030200017984 µA 0103090800010654 01030200023985 010402000178F0 µA 010409080001B394 010402000238F1 01030200017984 µA 0103090900015794 01030200023985...
Page 105
EG_GenIP30i_1016_UG_004_UK Page 105 / 143 Example of frame Reading the configuration of analog outputs Output Request Response Config. of input 01030200017984 µA 010309280001079E 01030200023985 010402000178F0 µA 010409280001B25E 010402000238F1 01030200017984 µA 010309290001565E 01030200023985 010402000178F0 µA 010409290001E39E 010402000238F1 Writing the analog outputs Output Request Response...
EG_GenIP30i_1016_UG_004_UK Page 106 / 143 5.3.14 Triggering of actions A master Modbus can at any time trigger an action defined in the web interface, by sending the security code (defined on the web interface), followed by the name of the action to do, whose size must not exceed 64 bytes.
Page 107
EG_GenIP30i_1016_UG_004_UK Page 107 / 143 Structure of the message Triggering of Actions @Modbus slave Request Function code = 0x10 Address Hi Address Lo Nb registers Hi Nb of consecutive registers to write Nb registers Lo Nb bytes (Nb registers * 2) Security code 0 Lo Security code 1 It corresponds to the value in hexadecimal of the code entered...
EG_GenIP30i_1016_UG_004_UK Page 108 / 143 5.3.15 Execution of Macro command A master Modbus can at any time trigger the execution of a Macro command which was previously written in a buffer Modbus of the GenIP. The management of Macro commands has the same restrictions as the commands port;...
Page 109
EG_GenIP30i_1016_UG_004_UK Page 109 / 143 Structure of the message Execution of Macro commands @Modbus slave Request Function code = 0x10 Address Hi Address Lo Nb registers Hi Nb of consecutive registers to write Nb registers Lo Nb bytes (Nb registers * 2) Security code 0 Lo Security code 1 It corresponds to the value in hexadecimal of the code entered...
EG_GenIP30i_1016_UG_004_UK Page 110 / 143 If the "Size of return data" @ 0x0600 is different from 0, the return information is available in the buffer "Return data" @ 0x601. Reading the information of return Request Response 01030601000C1487 010318 76657273696F6E0D0A3030303235390D0A0D0A4F4B0A2873 After decoding, the information is Information Decoding version...
GSM led of the GenIP 30i The attachment to the GSM network is given by the GSM Led status placed in front of the GenIP 30i. The table hereunder describes the signification of the different available status for the LED GSM.
5.6 Procedure for updating the GenIP 30i In order to benefit of the latest functions of the GenIP 30i, an updating procedure can be used for the change of the software embedded in the GenIP 30i. This procedure consists in downloading the Firmware of the GenIP in the internal Flash memory of the GenIP via the LAN link available via the RJ45 Ethernet connector, or can be run from a remote.
• Check that the CONF led is OFF • Check that you are on the same IP range as the GenIP 30i • With the Ping command under Invite command, launch a Ping and check that you get a reply.
EG_GenIP30i_1016_UG_004_UK Page 114 / 143 6 Functional Description 6.1 Architecture The GenIP intelligence is the heart of the de GSM/WAN Ethernet gateway. This part allows the GenIP to work in autonomy thanks to the parameters saved in it through components like the Flash, EEPROM...
EG_GenIP30i_1016_UG_004_UK Page 115 / 143 Power supply The GenIP must be powered by a DC external tension (VALIM) between +9 and +54VDC. The regulation of the du GenIP power supply is done with an internal DC/DC converter, in order to supply all the necessary internal DC tensions.
It takes around thirty seconds. In normal operation, if we press the Reset button, the reference configuration is reloaded in the GenIP 30i. For that, press the button Reset and wait until the PWR led is fixed on, and release the button.
EG_GenIP30i_1016_UG_004_UK Page 117 / 143 Available on the connector on the front side. Pin N° Signal Pin N° Signal 6.8 External Supply V The GenIP provides an external supply output of 5, 10, 19 or 24 V (by default : 5 V ) driven by software to provide power to an external sensor for example.
Waterproof level The diagram hereunder shows the dimensions of the GenIP including the clearances necessary for the installation of the GenIP 30i. Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications.
ERCOGENER advises to use a referenced power supply for its GSM products (for example the power supply 12V 1A – order code 0471210700). The following table describes the consequences of over-voltage or insufficient voltage on the GenIP 30i. Table: Effects of power supply default Then: ▪...
EG_GenIP30i_1016_UG_004_UK Page 120 / 143 7.2.1.1 Consumption The curves below indicate the limits of consumption of the GenIP 30i, • Limit I : (in green), The GenIP 30i MIN. - is not connected to the Ethernet, GSM network - is not connected on RS232, USB port, Input/Output.
EG_GenIP30i_1016_UG_004_UK Page 121 / 143 7.2.1.2 Consumption in 'Idle' mode For information, in 'IDLE' mode • Is registered on the GSM, WAN network but not in communication, • Is not connected to the Ethernet network, and there is no IP traffic, •...
EG_GenIP30i_1016_UG_004_UK Page 122 / 143 7.2.1.3 Consumption in GSM communication mode For information, in GSM communication mode, the • Is registered on the GSM, WAN network, • Is connected on the Ethernet network, with IP traffic, • The RS 232, RS 485 are connected, •...
EG_GenIP30i_1016_UG_004_UK Page 123 / 143 7.2.2 RS485 link The GenIP provides a RS485 link, on which we can: • Cancel the termination resistance, • Cancel the resistances of PullUp and PullDown, • Invert the signals polarity: A+ becomes A- and B- becomes B+, By moving the internal straps (Contact us).
EG_GenIP30i_1016_UG_004_UK Page 124 / 143 Example of assembly No protection is insured. The user must respect the values of the table above. 7.2.2.1 Position of straps Below are the different positions of jumper settings. Table: positions of jumper Configuration Without resistor STANDARD Without polarization Load resistor...
EG_GenIP30i_1016_UG_004_UK Page 125 / 143 7.2.3 Digital Inputs opto-coupled (I3, I4) The GenIP provides 2 digital inputs (TOR =Tout Ou Rien). These inputs are activated upon a contact closing or by a tension. Table: Characteristics of the opto-coupled Inputs @ 25 °C Characteristics Symbols Conditions...
Page 126
EG_GenIP30i_1016_UG_004_UK Page 126 / 143 Example of assembly In the command voltage range of 3.6V to 4V, the logic output of the opto-coupler is undetermined. The maximum command voltage is: -19V ≤ V ≤ 28 V Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications.
EG_GenIP30i_1016_UG_004_UK Page 127 / 143 7.2.4 Digital opto-coupled Output (O3, O4) The GenIP provides 2 digital outputs (TOR = Tout Ou Rien). Table: Characteristics of the Output @ 25 °C Characteristics Symbols Conditions Min. Typ. Max. Unit Tension Charging current AC/DC Current Peak 10 ms max.
Page 128
EG_GenIP30i_1016_UG_004_UK Page 128 / 143 Logical state Example of assembly No protection is ensured. The user must respect the values of the table above. Descriptions and non-contractual illustrations in this document are given as an indication only. ERCOGENER reserves the right to make any modifications. Dct_427_02...
EG_GenIP30i_1016_UG_004_UK Page 129 / 143 7.2.5 Analog Input (I1, I2) The GenIP provides 2 analog inputs. Via software, these inputs can be independently programmed in voltage mode (0-25V) or current mode (0- 25mA). By default: Voltage Mode 0-25V. It is strongly advised: •...
Page 130
EG_GenIP30i_1016_UG_004_UK Page 130 / 143 The GenIP provides in output, an analog voltage V (programmable by software of 5V, 10V, 19V or 24V) which may be used to supply power to the sensor. It can provide a current of 50 mA max. It is strongly advised : •...
EG_GenIP30i_1016_UG_004_UK Page 131 / 143 7.2.5.2 Analog Inputs in current (0-25mA) Table: Characteristics of analog inputs in current @ 25 °C Characteristics Symbols Conditions Min. Typ. Max. Unit Voltage Current Conversion range 0.46 Resolution 8 bits µA/bit Precision Range 0.46 to 25 mA -8.8 Capacity f = 1KHz...
Page 132
EG_GenIP30i_1016_UG_004_UK Page 132 / 143 Example of assembly The GenIP provides in output, an analog voltage V (programmable by software of 5V, 10V, 19V or 24V) which may be used to power supply to the sensor. It can provide a current of 50 mA max. Do not applied up to 8.6 voltage on I1 I2 It is strongly advised : •...
EG_GenIP30i_1016_UG_004_UK Page 133 / 143 7.2.5.3 Analog input in logical mode with contact This mode works only in tension. The GenIP sees the analog input: • 1 when the voltage is ≥ 3.5 volts • 0 when the voltage is ≤ 1.5 volts To see the limits of use in §...
EG_GenIP30i_1016_UG_004_UK Page 134 / 143 7.2.6 Analog Outputs (O1, O2) The GenIP provides 2 analog outputs. Via software, these outputs can be independently programmed in voltage mode (0-24V) or current mode (0- 25mA). By default: Voltage mode 0-24V. It is strongly advised : •...
EG_GenIP30i_1016_UG_004_UK Page 135 / 143 The GenIP provides in output, an analog voltage V (programmable by software of 5V, 10V, 19V or 24V) which may be used to supply power to the sensor. It can provide a current of 50 mA max. It is strongly advised : •...
Page 136
EG_GenIP30i_1016_UG_004_UK Page 136 / 143 Example of assembly passive mode For a good functioning, the 0 Volts (GND) of the external supply and the GenIP must be different. Example of assembly active mode The level current and resistor are set through the web page. To get a maximum range value you must set supply voltage out to 24 Volts.
EG_GenIP30i_1016_UG_004_UK Page 137 / 143 7.2.7 External power supply V Value by default: 5 V Table: Characteristics of the supply output @ 25 °C Characteristics Symbols Conditions Min. Typ. Max. Unit Output voltage Current @ 5 V - 50 mA ±...
The output +5V is protected by a re-armable fuse. During a frank short-circuit on the power supply, the time of reaction of the fuse causes a reset of the GenIP 30i. 7.2.10 SIM Interface Table: Characteristics of the SIM card supply tension SIM card 3 V or 1.8 V...
See chapter 9, for the GSM antennas recommended by ERCOGENER. 7.3 Environmental characteristics To ensure a correct functioning of the GenIP 30i, the limits listed in the table hereunder must be respected. Table: Environmental characteristics -20 °C to +60 °C Operating temperature -40 °C to +85 °C...
EG_GenIP30i_1016_UG_004_UK Page 140 / 143 8 Security recommendations 8.1 General security It is important to respect the specific regulations concerning the use of radio equipment, in particular with the possible risks of interference due to radio frequency (RF). Please respect carefully the following security advices.
EG_GenIP30i_1016_UG_004_UK Page 141 / 143 8.2 Care and maintenance The suggestions hereunder will help you to preserve this product for many years. Do not expose the modem to the extreme environments, to high temperature or high humidity. Do not use or store the modem in dusty or dirty places, it could be damaged. Do not try to disassemble the modem, at the risk of cancelation of the guarantee.
EG_GenIP30i_1016_UG_004_UK Page 142 / 143 9 Recommended accessories The accessories recommended by ERCOGENER for the GenIP 30i, are shown on our website in the section Products/Accessories. For more information, contact our sales department. 10 Client support ERCOGENER ensures the client support for all its products sold. You will then have access to:...
Need help?
Do you have a question about the GenIP 30i and is the answer not in the manual?
Questions and answers