Khomp ITG 200Indoor User manual

User Manual
ITG 200 Indoor

2
Índice
1. About this manual …………………………………………………………………………………………………………………
2. Presentation ………………………………………………………………………………………………………………………….
2.1. Technical information ……………………………………………………………………………………………….
2.2. General information …………………………………………………………………………………………………..
2.2.1. Sensors supported directly on the ITG ports ….……………………………………….
2.3. Front view …………………………………………………………………………………………………………………….
2.4. Rear view ………………………………………………………………………………………………………………………
2.5. Schematic of 1-Wire connector ……………………………………………………………………………..
2.6. Reset Button - Recovery Mode ………………………………………………………………………………
2.7. LCD display information …………………………………………………………………………………………..
2.7.1. Button functions ……………………………………………………………………………………………..
2.7.2. Initial display information ………………………………………………………………………………..
2.7.3. Diagnosis interface …………………………………………………………………………………………
2.7.4. Ethernet network diagnosis ………………………………………………………………………….
2.7.5. Mobile network (3G) diagnosis ……………………………………………………………………
2.7.6. Enable DHCP ……………………………………………………………………………………………………
3. Installation ………………………………………………………………………………………………………………………………
3.1. Ethernet network connection …………………………………………………………………………………
3.2. Modules connection (optional) ……………………………………………………………………………….
3.2.1. 3G network module ………………………………………………………………………………………..
3.2.1.1. 3G network SIM card connection …………………………………………………….
3.2.2. IEEE 802.15.4 module …………………………………………………………………………………….
3.2.3. LoRa® module ………………………………………………………………………………………………..
4. Web Interface access ………………………………………………………………………………………………………..
4.1. Introduction to the Web Interface ………………………………………………………………………….
4.1.1 Dashboard ………………………………………………………………………………………………………….
4.1.2. Devices ………………………………………………………………………………………………………………
4.1.3. Network …………………………………………………………………………………………………………….
4.1.3.1. Ethernet network configuration ………………………………………………………..
4.1.3.2. 3G Modem configuration …………………………………………………………………..
4.1.3.3. DNS configuration ………………………………………………………………………………..
4.1.3.4. OpenVPN configuration ……………………………………………………………………….
4.1.3.5. Send by interface ………………………………………………………………………………….
4.1.4. IEEE 802.15.4 network ……………………………………………………………………………………
4.1.4.1. IEEE 802.15.4 network hub ………………………………………………………………..
4.1.4.2. Update IEEE 802.15.4 devices …………………………………………………………….
4.1.4.3. Map ………………………………………………………………………………………………………....
4.1.5. LoRa®…………………………………………………………………………………………………………………
4.1.5.1. LoRa® Radio …………………………………………………………………………………………
4.1.5.2. LoRa® network server ……………………………………………………………………….
4.1.5.3. Registering LoRa® devices ……………………………………………………………..
4.1.5.4. LoRa® commands ………………………………………………………………………………..
4.1.6. Cloud integration ……………………………………………………………………………………………….
4.1.6.1. HTTP ………………………………………………………………………………………………………..
4.1.6.2. MQTT ……………………………………………………………………………………………………….
4.1.7. Configurations …………………………………………………………………………………………………..
4.1.7.1. Date and time ………………………………………………………………………………………….
4.1.7.2. Logs configuration ………………………………………………………………………………….
4.1.7.3. Import and export configurations ……………………………………………………...
4.1.8.System …………………………………………………………………………………………………………………
4.1.8.1. Information ……………………………………………………………………………………………..
4.1.8.2. Web Interface disgnosis ……………………………………………………………………..
4.1.8.3. Logs ………………………………………………………………………………………………………….
4.1.9. Update IoT application …………………………………………………………………………………..
4.1.9.1. Notifications …………………………………………………………………………………………...
página 4
página 4
página 4
página 4
página 4
página 5
página 5
página 5
página 6
página 6
página 6
página 6
página 6
página 7
página 7
página 7
página 7
página 7
página 8
página 9
página 9
página 10
página 10
página 11
página 11
página 11
página 12
página 14
página 15
página 15
página 17
página 17
página 18
página 18
página 18
página 18
página 19
página 21
página 21
página 22
página 23
página 24
página 24
página 25
página 27
página 28
página 28
página 29
página 29
página 30
página 30
página 31
página 32
página 32
página 34

3
4.1.10. Firmware update ………………………………………………..…………………………………………
5. Integration protocol ……………………………………………………………………………………………………………….
6. Device registration guidelines ……………………………………………………………………………………………..
6.1. Device registration on the LoRa® network …………………………………………………………...
6.2. Device registration on the IEEE 802.15.4 Network ………………………………………………
7. Attachments …………………………………………………………………………………………………………………………..
7.1. ITG 200 LoRaServer.io integration …………………………………………………………………………..
7.1.1. Procedure …………………………………………………………………………………………………………..
7.2. IT release for the ITG 200 Gateway ………………………………………………………………………
7.2.1. MQTT send ………………………………………………………………………………………………………..
7.2.2. HTTP send …………………………………………………………………………………………………………
7.2.3. External Network Server send ……………………………………………………………………….
7.2.4. Connectivity Management ……………………………………………………………………………..
7.2.5. OpenVPN Khomp ……………………………………………………………………………………………..
7.2.6. Remote Update ………………………………………………………………………………………………..
7.2.7. PING test …………………………………………………………………………………………………………..
7.3. Data consumption ……………………………………………………………………………………………………..
8. Obtaining access to documents ……………………………………………………………………………………….
Índice
página 36
página 36
página 36
página 36
página 36
página 37
página 37
página 37
página 39
página 39
página 39
página 39
página 39
página 40
página 40
página 40
página 40
página 41

1. About this manual
This manual contains the necessary information for the installation, configuration,
monitoring and diagnosis of the ITG 200.
2. Presentation
The ITG 200 is a telemetry gateway aimed at integration with IoT solutions. It supports
wireless sensor networks that implement the LoRa® or IEEE 802.15.4 protocols. In addition, it has
two 1-Wire ports for connection to DS18B20 temperature probes. These ports can also be used for
contact sensors.
The ITG 200 gateway connects to the integrator's system and sends the data collected
from the sensors through an HTTPs or MQTTs API. Your internet access can be made through wired
Ethernet connection or via 3G mobile network, increasing your reliability in data delivery.
2.1 Technical information
Currently the ITG 200 operates with the following sensors:
●Temperature probe - Model DS18B20
●Dry contact probe
Measuring unit of read values:
The data read by the sensors are expressed in units of measurement based on the "SI"
(International System of Units).
It is possible to view this information in the "Dashboard" menu on the gateway's Web
Interface.
Item Descrição
Network 2 x RJ45 fast Ethernet 10/100 Mbps
1-Wire / Dry contact 2 x RJ11
3G 2 x SIM card slot (internal)
Dimensions (W x H x L) 202 x 42 x 101 mm
Approximate weight
(without packaging) 590 g
Power supply 12 VDC
Wireless sensor networks LoRa®, IEEE-802.15.4
2.2 General information
2.2.1 Sensors supported directly on the ITG ports
4

2.3 Front view
1. LCD Display.
2. Navigation menu buttons
3. Energy LED - Steady green: ITG is on.
4. System status LED - Steady red: The boot
system has been initialized.
2.4 Rear view
1. Connector for auxiliary 3G antenna.
2. Power supply connector.
3. ETH0 RJ45 fast Ethernet port.
4. ETH1 RJ45 fast Ethernet port.
5. 1-Wire port 1.
6. 1-Wire port 2.
7. Reset button / recovery mode.
8. Wireless sensor antenna.
9. 3G modem antenna.
2.5 Schematic of 1-Wire connector
1. NC - No connection (Not Connected).
2. 1-wire.
3. NC - No connection (Not Connected).
4. Binary sensor.
5. GND (grounding).
6. 3,3 V - 5 V.
5

2.6 Reset Button - Recovery Mode
It is possible to enter recovery mode via the back button on the gateway. To do this, you
must turn the gateway on with the button pressed, for about 5 seconds, until "Fail Safe" appears on
the display. Upon entering this mode, the gateway's network settings return to their initial values, and
from the default IP it is possible to access the gateway's firmware update page (with factory reset).
On this page it is also possible to restore the factory settings of the gateway, deleting all settings and
device registration, clicking the "Reset device to factory state" button.
Note By briefly pressing the reset button, the gateway will only be restarted.
2.7 LCD display information
The ITG 200 has a front display to show the status of the gateway and the Ethernet
network. It also has 4 buttons for navigation in the menu, which allows diagnosing and resetting the
gateway.
2.7.1 Button functions
The buttons allow navigation in the menu shown on the display.
●Right arrow: Advance or select the option marked in the menu. It allows accessing the ITG
200 menu if it is in the initial interface.
●Up arrow and down arrow: Allows you to select the options available in the menu.
●Left arrow: Returns to the previous menu, or to the home interface if there are no more
options.
2.7.2 Initial display information
The initial interface displays useful information for identifying the state of the gateway and
the defined IP address.
●Version: Version of the software that is installed on the ITG 200.
●IP: IP address assigned to the ITG 200. Access to the Web Interface is through this IP
address.
●Network: Indicates mobile communication mode
●HSPA: Indicates that the ITG is communicating via 3G, and appears on the Ethernet Down
display
●HSDPA: Indicates that the ITG is communicating via Ethernet, and appears on the Ethernet
UP display
●Signal: Modem signal quality.
●Ethernet: Indicates whether the Ethernet network is active (UP) or inactive (DOWN).
●Date and Time: Date and time.
2.7.3 Diagnosis interface
To access the diagnosis menu on the front display, press the right button once.
The following option will be displayed:
●Diag. Cable Net - Ethernet network diagnosis.
●Diag. Mobile Net - 3G mobile network diagnosis.
●Configure Net. DHCP - Enable DHCP
●Reboot Gateway - Restart the gateway. 6

2.7.4 Ethernet network diagnosis
The Ethernet network diagnosis, shows the result in the form of a sum of the failed
operations. It also displays the HTTP protocol status returned from attempting to send a connection
status over the Ethernet network to the server.
Test Failure value
Ping default gateway 1
Ping DNS 1 2
Ping DNS 2 4
Ping proxy IP (if any) 8
Ping IP from server 16
HTTP POST == 200 (use proxy if one exists) 32
2.7.5 Mobile network (3G) diagnosis
The modem diagnosis performs a series of AT commands and shows its results. The AT
commands covered by the modem diagnosis are:
●Modem signal quality (AT+CSQ).
●Network registration status (AT+CREG).
●Network you are registered with (AT+COPS).
●Registration status (AT+CGREG).
●SIM card ICCID (AT+CCID).
2.7.6 Enable DHCP
This option allows the user to enable automatic obtaining of the network IP. To select it is
necessary to click on the right button once and then go to the Yes option and again click on the right
button.
3. Installation
3.1 Ethernet network connection
The ITG 200 has two fast Ethernet network interfaces (10/100 Mbps) for connection to
different networks. The two interfaces have the same IP address and therefore must not be
connected to the same data network.
It is possible to access the Web Interface through either of the two network ports when the
gateway is in its factory settings.
Attention Each network interface must be connected to a separate data network.
7

3.2 Modules connection (optional)
Optional modules are:
●3G Network module.
●IEEE 802.15.4 module.
●LoRa® module.
The modules must be installed inside the ITG 200 and the following materials are required
for installation:
●Phillips screwdriver No. 1
●Fixed Wrench No. 8 (wrench)
For installation follow the steps below:
1. Turn off the ITG 200, if it is on.
2. Remove the side screws from the cabinet. Each side has a screw. Slide towards the rear of
the cab to remove it.
3. Fit the module in its respective internal slot to the gateway, as shown in the image below
and screw it.
4. Secure the slot to the gateway using two screws, as shown in the image below.
5. Close the case and screw it again.
6. The gateway should automatically recognize the installed module and display it in the ITG
200 web application menu.
1. 3G network module.
2. IEEE 802.15.4 module.
3. LoRa® module.
8

3.2.1 3G network module
Note
Before attaching the 3G Network module, connect the antenna to the MAIN connector as
shown. This connector faces downwards when the module is installed, which makes it difficult
to access it later.
3.2.1.1 3G network SIM card connection
The two slots for the 3G modem are located inside the ITG 200, if the 3G network module
is installed on the gateway.
1. Turn off the ITG 200, if it is on.
2. Remove the side screws from the cabinet. Each side has a screw.
3. Insert the SIM card into the slot, as shown in the image below. If you have only one SIM
card, install it in slot 1.
4. Close the case and screw it again.
Attention
If the equipment is not turned off, handling the SIM card may be harmful to its function.
9

3.2.2 IEEE 802.15.4 module
3.2.3 LoRa® module
If the module is LoRa®, the Laird board must be attached to the main board and fixed with
two screws, as shown in the images below.
The arrows indicate the location where the spacers will be installed for the correct fixing of
the module. Remove the existing screws and screw the spacers before fitting the module.
The LoRa® module, similar to the 3G network module, needs to be connected to an
antenna. This must be installed in its respective slot at the back of the gateway and connected to the
Laird board.
10

4. Web Interface access
The ITG 200 has a Web Interface for configuration, diagnosis and monitoring. To access
the Web Interface while the ITG 200 is in its factory settings, configure your computer with the same
IP address range and subnet mask noted below. Use a web browser of your choice to access.
IP Address 10.10.10.100
Subnet mask 255.0.0.0
User admin
Password khomp
4.1 Introduction to the Web Interface
The ITG 200 Web Interface displays a menu to the left of the interface with configuration
options, a panel for monitoring the sending of data collected by the sensors and diagnostic options
for debugging possible failures in the data transmission media.
At the end of this menu, there is the Reset button, which is used for certain changes in the
gateway settings to be applied.
4.1.1 Dashboard
To view the data read by the sensors, access the "Dashboard" menu.
This is the first interface that the user sees after login. Here, the data read by the sensors
are displayed.
11

Latest sensor readings
Reports the latest readings of all sensors connected to the gateway. The table contains the
following information:
Field Description
Device Identifies the address of the device that contains the sensor that performed the
measurement
Name Identifies the variable name of the measurement type read
Value Value read by the sensor
Unity Unit of measurement of the value read by the sensor
Date and time Date and time the gateway received the device information
4.1.2 Devices
This page lists all devices that exchanged information with the gateway on the network, as
well as their associated sensors. Both sensors and devices can be deleted from the list. This list also
shows the model, version (if available), address and registration date of each device, among other
configuration options specific to each device.
Note
The ITG 200 itself will appear in the Device List as soon as it receives a reading from any
sensor connected directly to its RJ11 input. Removing the ITG from the Device List is only
possible if all sensors connected to its inputs are removed.
Filters
Allows you to modify the content displayed on the panel of latest sensor readings. The
fields are defined as follows:
Field Description
Device Filters content to display only readings from a device with field text. Empty field to
disable this filter
Name
Filters content to display only sensor readings with the name containing the field text.
Considers difference between upper and lower case. Miscellaneous field to disable this
filter.
Lines Allows you to choose the number of lines displayed on each page of the table.
12

Configure All
It allows you to configure certain general aspects of Khomp's devices and sensors.
By selecting a measurement type, it is possible to enable / disable the sending of that
measurement type to the cloud (on all devices). To do this, simply select the type, modify the "Send to
cloud" field and Submit Configuration.
In "Edit Device", options to modify the settings are shown according to the device model. A
description of the fields that can be shown are shown below.
To LoRa® devices
Field Description
Device address Field for editing the device address (DEVADDR)
Network session key Field for editing the device network session key (NWKSKEY)
Application Session Key Field for editing the device application session key (APPSKEY)
Downlink counter Field for editing the device's downlink counter
Reporting Period Field for editing the period of sending messages from the device to the
gateway
To IEEE 802.15.4 (Zigbee) devices
Field Description
Reporting Period - Internal Allows you to change the sending time of the internal sensors
Reporting Period - External Allows you to change the sending time of the external sensors
Note
By clicking on "Save Device" the gateway will update the registration of the device locally. In
the event of a change in the Reporting Period, a command will be sent to the device with the
new settings.
In "Sensors", the list of sensors associated with the device is displayed. It is possible to
configure an alias for each of the sensors; this alias will be used in sending the sensor data to the
cloud, as well as in its presentation on the Gateway Panel.
By checking the "Send to Cloud" box and clicking on the floppy disk icon, it is possible to
indicate whether or not sensor information should be sent to the cloud.
13

4.1.3 Network
The network settings menu provides four configuration options: Ethernet network
configuration (wired network), 3G modem configuration (mobile network), DNS configuration and
OpenVPN configuration.
Note
●Any deletion action once confirmed cannot be undone.
●IEEE 802.15.4 devices will only be removed from the list when they confirm their exit from
the network.
●Removing an IEEE 802.15.4 device from the network using the device's physical button
will remove it from that list, if the ITG is on.
14

In the wired network settings, the user can choose several network configuration options.
Network configurations require the gateway to be reset to apply them.
There are two modes for configuring the Ethernet network: static IP or DHCP. See the
description of the options available in the table below.
Field Description
Use DHCP Indicates whether the gateway should use an IP address through a DHCP server available on
the network
IP If static IP address is used, this is the field used to assign the IP address that the ITG 200
should use
Subnet mask If static IP address is used, this is the field used to assign the subnet mask that the ITG 200
should use
Default Gateway If static IP address is used, this is the field used to assign the default gateway of the data
network that the ITG 200 should use
MAC address It is the MAC address of the ITG 200 in case it is necessary to clone this address
Configure static IP address
1. Disable the Use DHCP option.
2. Enter the IP address, subnet mask and default network gateway.
3. Click the Submit Configuration button.
4. The gateway must be restarted for the new settings to be applied. Click the Restart button,
located on the side menu.
Configure dynamic IP address
1. Enable the "Use DHCP" option.
2. Click the "Submit Configuration" button.
3. The gateway must be restarted for the new settings to be applied. Click on the "Restart"
button located on the side menu.
Note The front interface displays the defined IP address.
To configure the Ethernet network, access the menu "Network" → "3G modem".
This menu allows you to configure the properties of the 3G modem. You can select the
default SIM card and configure the APN.
4.1.3.2 3G Modem configuration
4.1.3.1 Ethernet network configuration
To configure the Ethernet network, access the menu "Network" → "Ethernet".
15

Enabling SSL
It should be enabled only when HTTP authentication is made from SSL certificates.
Automatic failover
When activated, it allows a SIM card transition to take place, that is, the modem can
automatically use the second SIM card and vice versa, whenever it identifies any connectivity
problem with the SIM card currently in use.
APN configuration
It is necessary to configure the APN of the SIM card according to the telephone operator.
Contact your telephone operator for the APN address, username and password. Then follow the
procedure below.
1. Register the APN address, username and password provided by the telephone operator.
2. Select the position in which the operator's SIM card is inserted that corresponds to APN.
3. Restart the gateway for this information to take effect.
It is possible to register up to 4 APN's.
Note When changing the APN settings, it is necessary to restart the ITG 200.
SIM card selection
Sets the default SIM card. The ITG 200 allows you to use up to 2 SIM cards. It is necessary
to define the standard SIM card to be used in case of an Ethernet network failure.
Click the SIM card 1 or SIM card 2 button to switch between SIM cards inserted in the
gateway.
If it is identified that the default SIM card does not have the mobile network active, it is
necessary to change the default SIM card in this option.
Note It is not necessary to restart the ITG 200 to change the default SIM card if both have data.
16

To configure DNS, access the menu "Network" → "DNS".
Allows you to view or define the DNS server manually. When the ITG 200's network
configuration is operating over DHCP, the "Nameserver" field displays the DNS address assigned to it.
Edit DNS settings for fixed IP
This panel displays the fields for inserting other DNS servers manually. It is possible to
insert other DNS servers to be used with fixed IP even if the network is operating in DHCP mode.
1. Click the "Add new DNS" button.
2. Enter the address of the DNS server. If you need to enter another DNS server, click the "Add
new DNS" button again and repeat the procedure.
3. Click the "Submit Configuration" button.
4. Restart the ITG 200.
To configure Openvpn, access the menu "Network" → "Openvpn".
1. Enter the server address, the connection port on the
server and choose the desired interface.
2. Upload the files: ca.crt, gateway.crt and gateway.key.
3. Enable Operational key to activate OpenVPN.
4. Enable Administrative key to make OpenVPN reconnect
at each restart of the gateway.
5. Enable the OpenVPN Logs key to print the Logs in the
application Logs file.
6. Press the "Submit Configuration" button.
4.1.3.3 DNS configuration
4.1.3.4 OpenVPN configuration
17

Menu related to the functionalities of the standard IEEE 802.15.4 network.
It is possible to open the network for the entry of new devices, as long as they are looking
for one to connect. When you click on the "Open Network" button, the network will be open for 254
seconds, which can be monitored through a countdown timer and its status indicator.
It is possible to remotely update the firmware of the devices connected to the network using the
following steps:
1. Clicking on the "Search Files ..." button, search for the file in the ".ota" format with the
firmware update of the routers or the file with the update of the end devices.
2. Click on the "Import" button.
3. The IEEE 802.15.4 network should update devices automatically.
The file in the ".ota" format will be available by Khomp as soon as there is a new firmware
version.
Attention
For the update procedure to take place correctly, check the following indications before
starting the update:
●The connected Endpoints must be powered by USB and / or new batteries.
●Low battery endpoints can fail to update and corrupt your internal memory.
●The update process takes time depending on the number of devices
associated with it.
4.1.4 IEEE 802.15.4 network
4.1.4.1 IEEE 802.15.4 network hub
4.1.4.2 Update IEEE 802.15.4 devices
Allows you to choose the policy for sending data from the ITG 200 to the cloud. The
options are:
1. Automatic. The gateway will preferably send via the ethernet network, using the modem as
a fallback, if available.
2. Ethernet. Exclusive shipping via ethernet cable.
3. Modem. Exclusive sending by modem.
4.1.3.5 Send by interface
18
Upon entering the network, messages
sent to the gateway will be displayed on the Panel
automatically and the device can be seen in the
Device List in the Devices menu.
The network can be closed at any time by
pressing "Close Network".
Once the "Open Network" button is
pressed, the ITG 200 will create an IEEE 802.15.4
network using the channel with the best signal
quality.
The IEEE 802.15.4 network MAC is also
shown for identification purposes by the MQTT API.

When clicking on this menu item, two new options will be displayed. They allow the user to
view in real time the way the devices that make up the network are interconnected, as well as the
signal level between them. Are they:
●Network diagram: It allows a more interesting visual experience, because it allows the user
to zoom in and out of the diagram, as well as move the devices on the screen as he sees
fit. It is worth remembering that this interaction is only visual and does not alter in any way
the way in which the devices are really interconnected.
4.1.4.3 Map
The identification of the devices is carried out as follows:
●Green: Network coordinator
●Purple: NIR21IR
●Dark Blue: ITEs
●Blue: NIRs
●Orange: NITs
●Red: NITs and NIRs with low battery (less than 2.3 volts)
●Grey: NIRs oru NITs which have not yet been implemented in the network. This
status must be momentary until the network reordering is completed.
●Lilás:Other devices different of NIRs e NITs
It can be seen that the NITs are identified by the circles displayed and the repeaters (NIRs,
ITEs and NIR21IR) by the ellipses.
19

●Node table: This table is simple and as objective as the network diagram. The information
is practically the same and what changes is only the format in which it is displayed. The big
difference of the table in relation to the diagram, is that in it, the numbers of NIRs and NITs
are automatically counted. There, low battery devices are not identified. Thus, NIRs are
displayed in Orange, NITs in Blue and other devices in Lilac.
The Address (network) column is a unique identification associated with devices each time
they enter the network, that is, if, for any reason, a particular device leaves or is removed from the
network, the next time it is added to it network will most likely get a different (network) address.
The Coordinator of the 802.15.4 network is the one who provides all the information so
that both the diagram and the table of nodes are drawn up and the unit associated with the displayed
signal level is dBm.
20