1. Manuals
  2. Brands
  3. Teracom Manuals
  4. I/O Systems
  5. TCG120-4
  6. User manual

Teracom TCG120-4 User Manual

4g lte wireless i/o module
Hide thumbs Also See for TCG120-4:
Table of Contents

Advertisement

Quick Links

Download this manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TCG120-4 and is the answer not in the manual?

Questions and answers

Related Manuals for Teracom TCG120-4

Summary of Contents for Teracom TCG120-4

  • Page 2: Short Description

    1. Short description TCG120-4 is a 4G LTE Cat.1 wireless I/O module. It supports also 3G and 2G wireless communication and provides data connectivity on LTE-FDD, DC-HSDPA, HSPA+, HSDPA, HSUPA, WCDMA, EDGE, and GPRS networks. The device has 2 digital inputs, 2 analog inputs, 1-Wire interface for external sensors and 2 relays. The relays can be activated either remotely (via SMS or HTTP API command) or locally - from the status of the monitored parameters.
  • Page 3 Ambient Relative Humidity: 5 to 85% (non-condensing) • Standards and Certifications Safety: EN 62368-1:2014 + EN 62368-1:2014/AC1-3:2015 + EN 62368-1:2014/A11:2017 + EN 62368-1:2014/AC:2017-03:2017, EN 62311:2008 EMC: EN 55032: 2015 + EN 55032: 2015/AC:2016-07 + EN 55032: 2015/A11:2020 EN 55024: 2010 + EN 55024: 2010/A1:2015 EN 61000-3-2: 2014 EN 61000-3-3: 2013 + EN 61000-3-3: 2013/A1:2019 RFU:...

  • Page 4: Installation

    Attention! Before installing the SIM card in the card slot, please ensure that the PIN code is disabled. 5.1. Mounting TCG120-4 should be mounted in a clean and dry location on a non-flammable surface. Ventilation is recommended for installations where the ambient air temperature is expected to be high.

  • Page 5: Power Supply Connection

    Connector 7, Pin3 – NO Relay1 5.2.1. Power supply connection TCG120-4 is designed to be supplied by adapter SYS1308-2412-W2E or similar, intended for use in the conditions of overvoltage category II. The power supply equipment shall be resistant to short circuits and overload in a secondary circuit.
  • Page 6 5.2.3. Digital inputs connection Attention! Digital inputs are NOT galvanic isolated. The TCG120-4 digital inputs can be used as “dry contact” only. The term “dry contact” means that to this input can be connected devices with an open drain or relay outputs - door contact switch, push-button, PIR detector, etc.

  • Page 7: Analog Inputs Connection

    The following picture illustrates how an alarm button can be connected to a digital input of TCG120-4. One side of the contact is connected to “Digital In” while the other side is connected to the “GND” terminal. The maximum cable length for a digital input should be up to 30 meters.

  • Page 8: Led Indicators

    When mechanical relays switch inductive loads such as motors, transformers, relays, etc., the current will arc across the relay contacts each time the contacts open. Over time, this cause wears on the relay contacts which shorten their life. When switching an inductive load, it is recommended that relay contact protection devices are used.
  • Page 9 – permanent hardware error. 7. Initial setup via USB The initial setup of TCG120-4 is done with a computer running Windows 7 or a newer Microsoft Windows operating system. After power-up, the module should be connected to the computer with a USB cable.
  • Page 10 The only file stored on the mass storage is a tool called “TConfig”. This tool enables communication between the TCG120-4 and PC. After starting the TConfig tool, the following program will appear: Pressing the “Start” button will start the browser and display the Monitoring page of your TCG120-4. TCG120-4_R1.3 – May 2022...

  • Page 11: Monitoring Page

    7.1. Monitoring page The monitoring page displays the current inputs/outputs status of TCG120-4. The page has 4 sections – “1-Wire sensors”, “Analog inputs”, “Digital inputs” and “Relays”. For every parameter (sensor, input, relay) there is a description of up to 15 characters. The descriptions can be changed on the “Setup-Input/Output”...
  • Page 12 7.1.3. Analog inputs section Analog inputs can be used for monitoring DC voltage sources – analog sensors, batteries, power supplies, solar panels, etc. Analog inputs are sampled faster, but the new actual value is changed in 0.5 seconds. All 250 readings between the value changes are averaged.
  • Page 13 . If all sensors are locked, removing one “in the middle” will not position change the positions of other sensors after reset. This option is very useful when TCG120-4 is used as a part of а monitoring and control system managed by HTTP API commands.

  • Page 14: Digital Inputs

    7.2.3.2. Digital inputs For every digital input, a description, up to 15 symbols and states up to 15 symbols can be set. These descriptions will appear in the monitoring page, conditions page, XML/JSON data, SMS, and e-mail alerts. 7.2.3.3. Analog inputs For every analog input, a description, up to 15 symbols can be set.

  • Page 15: Relay Outputs

    and offset. When we know them, we can calculate what relative humidity corresponds to every voltage in the working range. The multiplier (MU) is calculated as ΔY/ΔX, for this sensor ΔRH%/ΔV: MU = (75.3 - 0)/(3.198-0.826) = 75.3/2.372 = 31.745 %RH/V The offset is calculated from the already known multiplier and relation for one of the points: OF = MU * (0 –...
  • Page 16 7.2.4. Conditions This section is used for parameterization of trigger and alert conditions for sensors, analog, and digital inputs. 7.2.4.1. Sensors and analog inputs For every sensor two types of fields are presented – one for the trigger conditions (“Min”, “Max”, and “Hys.”) and another one for the wanted action.
  • Page 17 Example: TCG120-4, TST100, and an appropriate heater are used to control the room temperature. The wanted minimum temperature is 19°C. The initial temperature is 17°C. TST100 is assigned on the first position for 1-Wire sensors. For Relay1 local activation from Sensor1 is set.
  • Page 18 The “Max” value is set far enough from the wanted temperature to avoid trigger/alert conditions around it. For every sensor or analog input, there are 4 independent ways of alert when there is an alarm condition – email, SMS, post (HTTP Post with XML/JSON file) and MQTT publish. Each alarm notification method is activated by a checkbox.

  • Page 19: System Status

    In the time when the input is in an alarm state, on the „Monitoring page“, the appropriate input will be colored in red. There are two delays - low-to-high and high-to-low for digital input change. These delays are added to the standard delay of 30ms. They have 0.1-second resolution and by default are zero.

  • Page 20: General Setup

    7.2.5.2. Data connection setup This setting can be different for each mobile operator. By default, APN (Access Point Name) is “internet”. Some mobile operators may require also a username and password. 7.2.5.3. Mobile network connection reset For areas with low signal strength or where the mobile network frequently drops/blocks, automatic restarting of the network connection can be used.

  • Page 21: Device Restart

    7.2.5.5. Device restart In this section, there are buttons for device restart and reset to factory default settings. 7.2.6. NTP Internal RTC (real-time clock) of the module can be set only automatically. For automatic clock synchronization, the module supports NTP (Network Time Protocol) and all necessary parameters for automatic synchronization are available in this section.

  • Page 22: Smtp Setup

    Transport Layer Security protocol is used for secure communication with public mail servers. TCG120-4 supports TLS 1.0, TLS 1.1 and TLS 1.2 with RSA as a key exchange/agreement and authentication, which ensures successful operation with almost all public servers.
  • Page 23 The “Key” field is user-defined. Its value is available in XML/JSON file and can be used for device identification. If “Process Answer” is enabled, TCG120-4 will execute the commands, sent by the remote server as an answer of HTTP/HTTPS Post.
  • Page 24 7.4. MQTT Device supports MQTT 3.1.1. This page is for the MQTT settings. 7.4.1. MQTT General 7.4.2. MQTT Sensors topic 7.4.3. MQTT analog inputs topic TCG120-4_R1.3 – May 2022 Page 24...
  • Page 25 7.6.1. Backup/Restore TCG120-4 supports backup and restore of all user settings. All settings are saved in an XML backup file. This file can be used after this to restore the same settings on many devices. This is very useful for multiplying similar settings to a batch of modules.
  • Page 26 8. Setup via SMS TCG120-4 supports SMS commands for parameter change, status reports, and firmware update over the air. The commands will be executed only if they come from the phone numbers available in the section "SMS setup". The commands need different rights (master/user).
  • Page 27 • Set superuser rights for users - this message is used to activate/deactivate superuser rights for SMS users Rights: Master Syntax: set˽suser˽<user>=<cmd> Where <cmd> is “on” for activation or “off” for deactivation <user> can be u1, u2, u3 or u4 Example Command: set suser u1=on...
  • Page 28 • Status of system - requests main parameters of the device Rights: Master, Superusers, Users Syntax: status˽system Example Command: status system Answer: 06.01.2021,16:09:06,4G=y,ss=80%,fw=1.00 • Status of parameter - requests status of digital input (di), analog input (ai), relay (r) and sensor(s) Rights: Master, Superusers, Users Syntax:...
  • Page 29 Command: set pl1=on,pl2=on Answer: r1=on,r2=on Command: set pl1=on -w Answer: no answer Command: set pl1=on,pl2=on -w Answer: no answer • Post URL – sets URL for XML/JSON HTTP Post Rights: Master, Superusers Syntax: set˽purl=<link> or set˽purl2=<link> Where <link> is the address of remote server (domain or IP) Example Command: set purl=www.teracomsystems.com:8801/posttest.php...
  • Page 30 Syntax: set˽post=on Example Command: set post=on Answer: post=on,period=00:02:00 • Post off – sets XML/JSON HTTP Post off Rights: Master, Superusers Syntax: set post=off Example Command: set post=off Answer: post=off,period=00:02:00 • MQTT on – sets MQTT on Rights: Master, Superusers Syntax: set˽mqtt=on Example Command:...
  • Page 31 Example Command: set murl= www.teracomsystems.com Answer: mqtt=on,murl= www.teracomsystems.com,port=1883 • MQTT port – sets MQTT port Rights: Master, Superusers Syntax: set˽mport=<port> Where <port> is a MQTT port Example Command: set mport= 8883 Answer: mqtt=on,murl= www.teracomsystems.com,port=8883 • Set a time server Rights: Master, Superusers Syntax: set˽ts=url:port...
  • Page 32 Master, Superusers Syntax: update˽<URL> Where <URL> is a valid URL to public server, pointing update (.cod) file Example Command: update www.teracomsystems.com/docs/TCG120-4-v1.000-P-S.cod Answer 1: Downloading firmware... Answer 2: Firmware file downloaded. Updating... Following answers are also possible in different situations: Answer:...
  • Page 33 The HTTP Post period can be changed by the server with the appropriate HTTP command. This makes communication very flexible. 9.2.1. Commands The commands for TCG120-4 are sent in the answer’s body of HTTP Post request. The structure of command is: set yyy=xxx Where: yyy is the command;...
  • Page 34 This indicates that there are no pending commands and the session can be closed; • On next HTTP Post period, TCG120-4 sends a new HTTP Post request (5) to the server; • The server answers with “set FIN” (6) – there are no pending commands and the session can be closed.
  • Page 35 XML/JASON HTTP Post service can be tested following the steps below: • Save following code like post.php: <?php define("FILENAME", 'status.xml'); define("FOLDER", ''); define("SEPARATOR", ''); define("STR_SUCCESS", 'set FIN'); define("STR_ERROR", 'error'); if($_SERVER['REQUEST_METHOD'] == 'POST'){ $datePrefix = date('YmdHis', strtotime('now')); $pathname = FOLDER.SEPARATOR.$datePrefix.'_'.FILENAME; $postdata = file_get_contents("php://input"); $handle = fopen($pathname, 'w+');...
  • Page 36 9.3. List of HTTP API commands TCG120-4 supports following HTTP commands (case sensitive): Command Description rn=xxx Turn relay n ON (xxx=on) or OFF (xxx=off) (n is 1 or 2 for the respective relay) R1=on – will turn relay 1 ON R2=off –...

  • Page 37: File Structures

    More about MQTT can be read at www.mqtt.org. 10. Firmware update TCG120-4 supports firmware update over the WEB interface and over the air. For firmware update over the WEB interface please see 7.4.2. FW update. For firmware update over the air (needs 4GLTE/3G/2G connection) please follow the steps below: •...

  • Page 38: Factory Default Settings

    Master will receive a confirmation SMS message. The update procedure takes about 2 minutes. Once the firmware update is complete (about 5 minutes), TCG120-4 will restart. Attention! Don’t turn off the power supply during the update. Turning off the power supply will damage the device.

  • Page 39: Maintenance

    Joint part with external component shall have space for attachment/removal of the cable after installation. Teracom does not guarantee a successful operation of the product if the product was used under conditions deviating from the product specifications.
  • Page 40 <min>---</min> <max>---</max> <hys>---</hys> </item1> <item2> <value>---</value> <unit>---</unit> <alarm>0</alarm> <min>---</min> <max>---</max> <hys>---</hys> </item2> </S2> <S3> <description>S3</description> <id>0000000000000000</id> <type>1Wire</type> <item1> <value>---</value> <unit>---</unit> <alarm>0</alarm> <min>---</min> <max>---</max> <hys>---</hys> </item1> <item2> <value>---</value> <unit>---</unit> <alarm>0</alarm> <min>---</min> <max>---</max> <hys>---</hys> </item2> </S3> <S4> <description>S4</description> <id>0000000000000000</id> <type>1Wire</type> <item1> <value>---</value> <unit>---</unit>...
  • Page 41 <AI2> <description>Analog Input 2</description> <value>3.202</value> <unit>V</unit> <multiplier>1.000</multiplier> <offset>0.0000</offset> <alarm>0</alarm> <min>0.000</min> <max>30.000</max> <hys>1.000</hys> </AI2> </AI> <DI> <DI1> <description>Digital Input 1</description> <value>OPEN</value> <valuebin>1</valuebin> <alarmState>CLOSED</alarmState> <alarm>0</alarm> </DI1> <DI2> <description>Digital Input 2</description> <value>OPEN</value> <valuebin>1</valuebin> <alarmState>CLOSED</alarmState> <alarm>0</alarm> </DI2> </DI> <R> <R1> <description>Relay 1</description> <value>OFF</value> <valuebin>0</valuebin> <pulseWidth>0.1</pulseWidth>...
  • Page 42 <Latitude>43.835283</Latitude> <Longitude>25.965967</Longitude> </NetworkInfo> </Monitor> Where: <value>--- </value> and <unit>--- </unit> means no 1-Wire sensor on this position; <alarm>1</alarm> means there is a trigger condition. TCG120-4_R1.3 – May 2022 Page 42...
  • Page 43 Appendix B The JSON file (status.json)structure: "Monitor": { "DeviceInfo": { "DeviceName": "TCG120-4", "HostName": "TCG120-4", "ID": "862632040544279", "FwVer": "TCG120-4-v1.000", "MnfInfo": "www.teracomsystems.com", "SysContact": "info@teracomsystems.com", "SysName": "TCG120-4", "SysLocation": "Location" "S": { "S1": { "description": "S1:TST230", "id": "010140C6E8FFCE65", "type": "1W", "item1": { "value": "29.0", "unit": "°C",...
  • Page 44 "max": "---", "hys": "---" "item2": { "value": "---", "unit": "---", "alarm": "0", "min": "---", "max": "---", "hys": "---" "S4": { "description": "S4", "id": "0000000000000000", "type": "1W", "item1": { "value": "---", "unit": "---", "alarm": "0", "min": "---", "max": "---", "hys": "---" "item2": { "value": "---", "unit": "---",...
  • Page 45 "value": "OPEN", "valuebin": "1", "alarmState": "CLOSED", "alarm": "0" "R": { "R1": { "description": "Relay 1", "value": "OFF", "valuebin": "0", "pulseWidth": "0.1", "control": "0" "R2": { "description": "Relay 2", "value": "OFF", "valuebin": "0", "pulseWidth": "0.2", "control": "0" "HTTPPush": { "Key": "", "PushPeriod": "300"...
  • Page 46 Appendix C Fig.1 Fig.2 TCG120-4_R1.3 – May 2022 Page 46...

Table of Contents