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 The TCG120-4 is a 4G LTE Cat.1 wireless I/O module that also supports 2G communication, enabling data connectivity over LTE-FDD, EDGE, and GPRS networks. It features two digital inputs, two analog inputs, a 1-Wire interface for connecting external sensors, and two relays. The relays can be activated remotely via SMS, HTTP API commands, or MQTT messages, or locally based on the status of monitored parameters.

  • Page 3: Specifications

    Current consumption: 0.24A @ 12VDC • Cellular interface SIM card size: Standard Antenna connector: SMA-F Standards: LTE-FDD, EDGE and GPRS TCG120-4E (h2.xx) bands: 4G LTE: B1/B3/B5/B7/B8/B20 B3/B8 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 3...
  • Page 4 Maximum output current: 200 mA • Internal FLASH memory Endurance: 100,000 cycles (each relay status change or settings save counts as one memory cycle). TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 4...

  • Page 5: Installation

    Attention! Before inserting the SIM card into the device, ensure that the PIN code is disabled to avoid connectivity issues. 5.1. Mounting The TCG120-4 must be installed in a clean, dry location on a non-flammable surface. If the installation environment has high ambient air temperatures, ensure adequate ventilation around the device to maintain optimal operation.

  • Page 6: Power Supply Connection

    “Star” topology may be used as a last resort, but only for connecting up to four sensors with a total cable length not exceeding 10 meters: TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 6...

  • Page 7: Digital Inputs Connection

    PIR (passive infrared) detectors. To connect an alarm button to a TCG120-4 digital input, one side of the button contact should be connected to the "DIN" terminal, while the other side is connected to the "GND" terminal. A diagram below provides a visual representation of this connection.

  • Page 8: Relays Connection

    Connected to a network – once the module successfully connects to a mobile network, the STA indicator shows the type of connection, and the SIG indicator displays the signal strength. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 8...
  • Page 9 STA flashes once for 1 second: Master phone number is not set. STA flashes continuously for 1 second within a 2-second period: Permanent hardware error. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 9...
  • Page 10 7. Initial setup via USB The initial setup of the TCG120-4 is performed using a computer with Windows 10 or a newer version of Microsoft Windows. After powering up the module, connect it to the computer using a USB cable. Once connected, the operating system will automatically begin installing the necessary drivers for communication with the device.

  • Page 11: Monitoring Page

    These descriptions can be customized on the "Setup-Input/Output" page. 7.1.1. Sensors section The TCG120-4 module supports up to four sensors. All detected 1-Wire sensors are displayed in the "1-Wire sensors" section. These sensors need to be configured in the "1-Wire sensors setup"...
  • Page 12 Master’s phone number must be entered in the E.164 international format (ITU-T Recommendation) to ensure global uniqueness and proper routing of calls and messages. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 12...
  • Page 13 HTTP API commands, ensuring consistent sensor identification and positioning. 7.2.3. Input/Output 7.2.3.1. Sensors This section allows configuration of the parameters for 1-Wire sensors. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 13...

  • Page 14: Digital Inputs

    SV[Un] = RV * MU + OF Where: SV – scaled (displayed) value; Un – unit; RV – raw voltage from the source; MU – multiplier; OF – offset. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 14...

  • Page 15: Relay Outputs

    For each relay, a description of up to 15 characters can be set. These descriptions will appear on the monitoring page, in XML/JSON data, as well as in SMS and email alerts TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 15...
  • Page 16 - The value falls below (Max – Hys) after exceeding the "Max" threshold. • Hysteresis ("Hys"): This setting prevents frequent triggering due to minor fluctuations around the defined thresholds, ensuring stable operation. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 16...
  • Page 17 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 17...
  • Page 18 Example – room temperature control: In this example, the TCG120-4 module, a TST100 sensor, and a heater are used to maintain a room temperature of at least 19°C. The initial room temperature is 17°C. Configuration: The TST100 sensor is assigned to the first position for 1-Wire sensors.

  • Page 19: System Status

    This section provides details about the module's status regarding the mobile network, including information such as the IMEI number and firmware version of the module. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 19...
  • Page 20 When enabled, the device will automatically restart the network connection once per day. By default, this feature is disabled. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 20...

  • Page 21: General Setup

    • Period: 12 hours The functionality of the settings and the NTP service can be checked using tools in the NTP test section TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 21...

  • Page 22: Smtp Setup

    For secure communication with mail servers, the Transport Layer Security (TLS) protocol is employed. The TCG120-4 supports TLS versions 1.0, 1.1, and 1.2, using RSA for key exchange, agreement, and authentication. STARTTLS is not supported.
  • Page 23 HTTP/HTTPS requests (POST method). These files contain the current status of all monitored parameters along with additional system information. The format of the file (XML or JSON) can be selected from a drop-down menu. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 23...
  • Page 24 HTTP/HTTPS POST. An HTTP user header can be configured for services requiring additional header information. By default, this parameter is disabled. Note that this feature is available only for TCG120-4 with firmware version h2.xx or higher.
  • Page 25 This section allows you to configure the publishing parameters for digital inputs. Based on these settings, the specific topics for values and statuses will be as follows: • TRC/din/PanicButton/value • TRC/din/PanicButton/state • TRC/din/MainButton/value TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 25...
  • Page 26 The TCG120-4 supports the following operators for GSM geolocation services: • Google • Unwired Labs To use this service, registration with the chosen operator is required. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 26...
  • Page 27 7.4. Administration 7.4.1. Backup/Restore TCG120-4 allows for the backup and restoration of all user settings. These settings are saved in an XML backup file, which can be utilized for restoring configurations on multiple devices. This feature is particularly useful for applying similar settings across a batch of modules.
  • Page 28 Example Command: set suser u1=on Answer: m:+ 359885885885,su1:+359885887767,u2,u3,u4 Command: set suser u1=off Answer: m:+ 359885885885,u1:+359885887767,u2,u3,u4 Command: set suser u1=off,u2=on,u3=off,u4=off Answer: m:+ 359885885885,u1:+359885887761,su2:+359885887762, u3:+359885887763,u4:+359885887764 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 28...
  • Page 29 <user> can be e1, e2, e3, e4 or e5 Example Command: set email user e1:mail1@teracomsystems.com Answer: e1:mail1@teracomsystems.com Command: set email user e2:mail2@teracomsystems.com Answer: e2:mail2@teracomsystems.com Command: set email user e2: Answer: TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 29...
  • Page 30 Master, Superusers, Users Syntax: status˽<param> Where <param> is one of: di1, di2, ai1, ai2, r1, r2, s11, s12, s21, s22, s31, s32, s41, s42 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 30...
  • Page 31 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 Answer: purl=www.teracomsystems.com:8801/POSTtest.php,POST=on, period=00:01:00 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 31...
  • Page 32 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 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 32...
  • Page 33 <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 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 33...
  • Page 34 Answer: File corrupt or wrong version! Answer: Can't connect to server! Answer: Download time out! Answer: 4G/3G/2G is not connected! Answer: Connection lost! TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 34...
  • Page 35 Command: set ls11=n25.0,x35.0,y1.0 Answer: ls11=n25.0,x35.0,y1.0 Command: set ls11=n31.0 Answer: ls11=n31.0,x35.0,y1.0 Example: set of sensor 1 parameter 2 (humidity): Command: set ls12=n45.0,x60.0,y1.0 Answer: ls12=n45.0,x60.0,y1.0 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 35...
  • Page 36 An important consideration in this communication setup is the HTTP/HTTPS POST interval. A shorter interval increases data traffic but ensures that information and control of the device TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 36...

  • Page 37: Api Commands

    (n is 1,2,3 or 4 for the respective relay) r3=pl – will pulse relay 3 r1=pl&r2=pl&r3=pl&r4=pl pper=x XML/JSON HTTP POST period in seconds TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 37...
  • Page 38 Step 4: The server responds with a new HTTP/HTTPS response, which includes the “set FIN” command in the message body. This indicates that no further commands are pending, and the session can be closed. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 38...

  • Page 39: "Real-Time" Mode

    In order to enable “real-time” monitoring mode, upon receiving a periodic HTTP/HTTPS POST, the server should respond with the following two commands instead of a "set FIN" response: set ddly=xx get <filename> TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 39...
  • Page 40 POST requests for that specific server are suspended. If a second server is configured, it will continue to operate with periodic and alarm-related HTTP/HTTPS POST requests as usual. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 40...

  • Page 41: File Structures

    Press and hold the RESET button then turn on the power supply; • STA and SIG LEDs will turn ON; • Release the RESET button. The module will then restore its default settings. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 41...

  • Page 42: Operating Environment

    Ensure that there is sufficient space for attaching and removing cables after installation. Teracom does not guarantee the successful operation of the product if it is used under conditions that deviate from the product specifications.
  • Page 43 <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> <item1> <value>---</value> <unit>---</unit> <alarm>0</alarm> <min>---</min> <max>---</max> <hys>---</hys> </item1> <item2> TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 43...
  • Page 44 <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> TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 44...
  • Page 45 <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 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 45...
  • Page 46 "max": "---", "hys": "---" "S3": { "description": "S3", "id": "0000000000000000", "item1": { "value": "---", "unit": "---", "alarm": "0", "min": "---", "max": "---", "hys": "---" TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 46...
  • Page 47 "description": "Digital Input 1", "value": "OPEN", "valuebin": "1", "alarmState": "CLOSED", "alarm": "0" "DI2": { "description": "Digital Input 2", "value": "OPEN", "valuebin": "1", "alarmState": "CLOSED", "alarm": "0" TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 47...
  • Page 48 "NetworkInfo": { "Name": "A1 BG A1 BG", "SC": { "MCC": "284", "MNC": "01", "LAC": "28201", "CID": "3587", "SQ": "-71" “Latitude”: 43.835283, “Longitude” 25.965967 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 48...
  • Page 49 - set phone call number for user 1 Input/Output sdn=xxx Set sensor n description (n is 1,2,3 or 4 for the respective sensor) sd1=S1-Temp – set sensor 1 description TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 49...
  • Page 50 (p is 1,2,3 or 4 for the respective sensor t is 1 or 2 for the respective parameter of sensor) sy31=2.0 will set Hys for sensor 3, parameter 1 Conditions TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 50...
  • Page 51 (b=0) (n is 1 or 2 for the respective analog input) a1s=1 – sms alarm notification for analog input 1 is activated TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 51...
  • Page 52 Set password authentication for data connection aren=x Enable(x=1)/disable(x=0) automatic network connection reset timers=hh:mm:ss Time of automatic network connection reset (hh:mm:ss) tu=x Set temperature units – Celsius(x=0)/ Fahrenheit(x=1) TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 52...
  • Page 53 2 part 1 antopic=xxx MQTT analog inputs topic name atdn=xxx MQTT analog input n topic name atd1=1, set analog input 1 topic name TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 53...
  • Page 54 Multiply commands are sent concatenated with “&”. The commands are sent in the answer on XML/JSON or CSV HTTP POSTs. They are executed if “Process Answer” is enabled. TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 54...
  • Page 55 Appendix D Fig.1 Fig.2 TCG120-4 User manual | Revision R1.13, January 2025 | Applicable for FW V1.019 or later Page 55...

Table of Contents