Kiwi TLG3901BV2 User manual

Gateway TLG3901B/BLV2
User Manual
V2.0.4
Deccember 2020

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
I
December 2020
Table of Contents
1. Introduction ....................................................................................................................... 3
2. Getting Started.................................................................................................................. 6
2.1. Hardware Setup ....................................................................................................................6
2.2. Software Setup......................................................................................................................7
3. Gateway Setting................................................................................................................ 8
3.1. Gateway Portal Overview......................................................................................................8
3.2. Channel Setup.....................................................................................................................10
3.3. LoRaWAN Packet Forwarder Setting ..................................................................................13
3.4. Node-RED Setting...............................................................................................................14
3.5. MQTT Setting......................................................................................................................15
3.6. System Settings ..................................................................................................................16
3.7. System Status.....................................................................................................................21
4. Application Development .................................................................................................25
4.1. LoRaScript ..........................................................................................................................25
4.1.1. LoRaScript API.............................................................................................................32
4.1.2. Parse LoRaWAN Packet ..............................................................................................37
4.1.3. Implement a Simple Protocol........................................................................................39
4.2. Node-RED...........................................................................................................................42
4.2.1. Node-RED Example: Receive LoRa Packet .................................................................42
4.2.2. Node-RED Example: Send LoRa Packet......................................................................44
4.2.3. Node-RED Example: Parse LoRaWAN Packet.............................................................46
5. MQTT Basic Concept and Demo .....................................................................................48
6. LoRa Packet Statistics and Logs .....................................................................................51
7. Troubleshooting ...............................................................................................................52
7.1. LoRaWAN Packet Forwarder Cannot Send Packets ...........................................................52
8. Revisions .........................................................................................................................54
8.1. V2.0.4..................................................................................................................................54
8.2. V2.0.3..................................................................................................................................54
8.3. V2.0.2..................................................................................................................................54
8.4. V2.0.1..................................................................................................................................54
8.5. V2.0.0..................................................................................................................................54
8.6. V1.4.0..................................................................................................................................54
8.7. V1.3.2..................................................................................................................................54
8.8. V1.3.1..................................................................................................................................54
8.9. V1.3.0..................................................................................................................................54
8.10. V1.2.0..............................................................................................................................54

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
II
December 2020
9. References.......................................................................................................................55
10.Certification ....................................................................................................................56

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
3
December 2020
1.Introduction
Kiwitec TLG3901B/BLV2 is hybrid LoRa Gateway which can provide the LoRa Concentrator
to receive all packets with different spreading factors at fixed frequencies. The Packet For-
warder can redirect packets to the Internet, and support Machine-to-Machine protocol MQTT
for connecting Internet of Things. You can access quickly TLG3901B/BLV2 through our Web
Portal; it also supplies online scripting LoRaScript and Node-RED for customizing data pro-
cessing. You can use modern browsers such as Chrome and Firefox to manage
TLG3901B/BLV2 to setup concentrator channel, packet forwarding, MQTT broker, and net-
work configuration and customize your plugins for designated purpose. The followings are
TLG3901B/BLV2’s software and hardware specification and its front view and right side view.
Software Specification
Table 1-1 Software Specification of TLG3901B/BLV2
Administration Portal
Support Chrome or Firefox
Discovery Tool
Windows 7 or above
M2M Protocol
MQTT
Packet Forwarder
Compatible with ANNWS.01.2.1.W.SYS Gateway to
Server Interface
Firmware Upgrading
Support Online Upgrading through Web browser
Network Interface
Support DHCP, Static IP and DHCP Server

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
4
December 2020
Hardware Specification
Table 1-2 Hardware Specification of TLG3901B/BLV2
Model
TLG3901BV2
TLG3901BLV2 (with LTE)
Transceiver
Semtech SX1308
CPU
MTK MT8516 (ARM Cortex-A35)
Memory
512 Mbytes
Flash
256 Mbytes
Connectivity
Ethernet 10/100 Mbps
Wireless
LTE (TLG3901BLV2)
Full duplex LoRa
Power Supply
DC5V through Micro-USB
wireless transmission
2.4GHz
LAN
Ethernet 10/100
LoRa Antenna
2dBi x 2
Wireless Antenna
4.44dBi
LTE Antenna (TLG3901BLV2)
0.53dBi @ 699~960MHz;
3.01dBi @ 1710~2700MHz
LED indication
PWR/LoRa Status/Wireless/LTE
Frequency Range
920.6 MHz ~ 928 MHz (Japan)
920 MHz ~ 925 MHz (Taiwan)
Modulation
LoRa (spreading spectrum)
Number of Channels
8
Operation Temp.
0 ~ 55°C
Storage Temp.
-20 ~ 70°C

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
5
December 2020
Figure 1-1 TLG3901B/BLV2 Gateway Front and Back View
Power
LED
LoRa
LED
Wireless
LED
Cellular
LED
Factory
Reset
Button
Micro-USB
DC5V IN
USB
RJ45
LoRa
Antenna
LoRa
Antenna

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
6
December 2020
2.Getting Started
2.1. Hardware Setup
Before starting to use TLG3901B/BLV2 gateway, the power and Ethernet need to be con-
nect well. The RJ45 is used to connect to a network router which can access Internet. The
power supply is through Micro-USB connector and supply with DC5V.
Figure 2-1 Setup
TLG3901BLV2 equips LTE module. To access Internet through LTE cellular network, a SIM
card (nano-sim) must be installed. The SIM card slot can be seen by opening cover at bot-
tom of TLG3901BLV2, Figure 2-2.
Figure 2-2 SIM Card Slot of TLG3901BLV2
DC5V IN
Network
Router

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
7
December 2020
2.2. Software Setup
The quick start to using TLG3901B/BLV2 Gateway as follows:
1. Search wireless SSID with TLG3901B- prefix, Figure 2-3, and connect it via laptop. The
default password for connecting wireless is "tlg3901b".
2. Open browser and input 10.42.43.1 at URL.
3. TLG3901B/BL’s administration portal can be seen in browser, as shown in Figure 2-4.
4. Enter username and password to login, the default username is "admin" and password
is "admin".
5. Go to System → Network Configuration to check the IP address of Ethernet and make
sure it can access Internet.
6. Go to Setup → Channel Setup to set up the LoRa concentrator, including receiving fre-
quency, spreading factor. For more detailed refers to section 3.2 Channel Setup.
7. Activate your LoRa Nodes and start to send packet.
8. Go to Status → LoRa Receive Log to observing status of receiving LoRa packets.
Figure 2-3 Search Wireless RSSI
Figure 2-4 TLG3901B/BLV2 Login

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
8
December 2020
3.Gateway Setting
3.1. Gateway Portal Overview
Kiwitec TLG3901B/BLV2 Gateway is a hybrid gateway for processing complexity LoRa
packet. Besides, receiving LoRa packet from fixed frequencies, it also provides the Lo-
RaWAN packet forwarding to transport packets to other machines or nodes, and MQTT for
machine-to-machine communication between IoT devices. For customized data processing,
TLG3901B/BLV2 also has its APP development environment, namely LoRaScript which is a
Kiwitec’s proprietary online scripting, and Node-RED with our particular components for vis-
ualizing deployment in a data flow.
Figure 3-1 TLG3901B/BLV2 Portal
Figure 3-1 is TLG3901B/BLV2 gateway portal overview; the portal provides concentrator
channel setup and LoRaWAN packet forwarder in Setup section. We also provide Concen-
trator and MQTT controlling for enable/disable concentrator and manage MQTT broker and
publisher status. A demonstration of MQTT is present in section 5.
For customization, TLG3901B/BLV2 support two JavaScript-based scripting approaches, the
LoRaScript and Node-Red, using them to process packets in a specific way and define pack-
et's next routing hop. For online statistics, TLG3901B/BLV2 has a LoRa Packet Statistics,
it accumulates packets number in each frequency. For examining packets in real-time, you

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
9
December 2020
can use the LoRa Receive Logs, it acts as virtual terminal and reveals all received packets
content on the fly. TLG3901B/BLV2 network configuration supplying three configurations,
DHCP client, Static IP, and DHCP server, you can choose any one of them in customizing
network environments. For security and system management, TLG3901B/BLV2 can change
its password and support online upgrading in the Change Password and System Status.
Section 3.3 describes LoRaWAN Packet forwarder Setup, section 3.4 and 3.5 introduces
Node-RED and MQTT settings, System settings and network configuration are illustrated in
3.6, and 3.7 presents System Upgrading and Reset on TLG3901B/BLV2.

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
10
December 2020
3.2. Channel Setup
Channel setup, as shown in Figure 3-2. To setup LoRa concentrator frequencies for receiv-
ing packets, there are some parameters must be set, such as using LoRaWAN or not, de-
fine Sync Word for identifying the packet prefix, choosing each radio’s central frequencies,
setup frequency bias in each channel, to define standard LoRa channel bandwidth and
other options. Table 3-1 describes each parameter’s options.
Figure 3-2 Channel Setup

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
11
December 2020
Table 3-1 Channel Setup Parameters
Name
Value
Comment
LoRaWAN
True / False
Use LoRaWAN or not.
Sync Word
Number in decimal
Set packet prefix Sync-Word for trigger-
ing gateway to receive packet.
If LoRaWAN is true, Sync-Word is fixed
to 52 (0x34).
radio_0 / radio_1
Set central frequency of radio 0 and radio 1.
chan_Lora_std
The LoRa standard channel setting includes interface hooking (ra-
dio_0 / radio_1) spreading factor, bandwidth and frequency bias.
The chan_Lora_std only accept packet in particular spreading factor
in that frequency. The actual frequency is shown in red color as last
field in Figure 3-2.
chan_multiSF
(0-7)
The general channel settings include enable / disable channel, inter-
face hooking (radio_0 / radio_1) and frequency bias.
The chan_multiSF_x will receive packets with all spreading factor
(SF7~SF12) in designated frequency. The actual frequency is shown
as red color at last field in Figure 3-2.
Note that chan_multiSF_x can only operate in 125K bandwidth.
Because radio_0 and radio_1 can only down-converts 1.0MHz spectrum, all channels must
be fitted in two 1.0MHz wide intervals, as shown in Figure 3-2. Figure 3-4 shows an example
that multiSF0 exceeds interval of radio 0. In this case, multiSF0 exceeding interval,
TLG3901B/BL would not start correctly.
912.5 MHz
radio 0
916.5 MHz
multiSF0
LoRaStd
multiSF1
multiSF2
multiSF3 multiSF4
multiSF5
multiSF6 multiSF7
1.0MHz
radio 1
1.0MHz
Figure 3-3 Frequency Setup Example

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
12
December 2020
912.5 MHz
radio 0
916.5 MHz
multiSF0
LoRaStd
multiSF1
multiSF2
multiSF3
multiSF4
multiSF5
multiSF6
multiSF7
1.0MHz
radio 1
1.0MHz
Figure 3-4 multiSF0 Exceeds Interval of radio 0
In addition, this two radio central frequencies can be set independently therefore
TLG3901B/BL can operate over two independent chunk of 1.0MHz, as shown in Figure 3-5.
The two 1.0MHz intervals can overlap without problem and the number of channels in each
interval is also arbitrary, as show in Figure 3-6.
915.7 MHz
radio 0
916.5 MHz
multiSF0
LoRaStd
multiSF1
multiSF2
multiSF3
multiSF4
multiSF5
multiSF6
multiSF7
1.0MHz
radio 1
1.0MHz
Figure 3-5 Overlap of Radio Interval
912.5 MHz
radio 0
916.5 MHz
multiSF0
LoRaStd
multiSF1 multiSF2 multiSF3 multiSF4
multiSF5
multiSF6 multiSF7
1.0MHz
radio 1
1.0MHz
Figure 3-6 All multiSFs in Single Interval

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
13
December 2020
3.3. LoRaWAN Packet Forwarder Setting
Figure 3-7 shows the LoRaWAN packet forwarder setting, all incoming and emitting packets
are forwarding according to the setting; the Gateway ID describes the TLG3901B/BL ID.
Server Address, and Server Port Up are used to set LoRaWAN server to forward packets.
All forwarding packets will through IP/UDP link to a destination. The Keepalive Interval, Sta-
tistic Interval, and Push Timeout define the aggressive connection policy and its refresh
time. If the Fake GPS enable, each forward packet would append the GPS information. The
Packet Forwarder Control provide user to stop or restart packet forwarder.
Figure 3-7 LoRaWAN Packet Forwarder Setting

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
14
December 2020
3.4. Node-RED Setting
Node-RED Setting is presented in Figure 3-8. Node-RED is a visual tool for wiring the Internet
of Things, referring http://nodered.org for detailed usage. The Node-RED provides an online
web-based editor; packet's processing task can be formed using wiring components in Node-
RED. For login Node-RED, the default login user account and the password are "admin",
however for a customizing, the password can reset through Reset Password. In the setting
page, the Status shows the Node-RED stopped or running. You can change Node-RED sta-
tus through Stop and Start button, but be patient, the initialization start time of the Node-RED
in TLG3901B/BLV2 is about 20 seconds. Because TLG3901B/BLV2 is an Ajax-based web
portal, restarting Node-RED may cause the web browser frozen; it will recover after Node-
RED startup.
Figure 3-8 Node-RED Setting

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
15
December 2020
3.5. MQTT Setting
TLG3901B/BLV2 provides MQTT setting (Figure 3-9) to link the machine-to-machine com-
munication in Internet of Things. MQTT broker is respond for transferring publishing message
and handle subscribing topics to all clients; it acts as a central transportation to move mes-
sages to subscribers in designated topics. MQTT Publisher is a charge of receiving LoRa
packets and publish message to MQTT broker. MQTT Subscriber subscribes transmit
packet from broker and emit the packet. The topic string for MQTT Publisher and MQTT
Subscriber can be set at Receive Packet Publish Topic and Transmit Packet Subscribe
Topic.
You can stop or restart MQTT broker or MQTT publisher/subscriber through control buttons
in MQTT management. The Status in each panel shows the MQTT service situation in the
TLG3901B/BLV2 gateway.
Figure 3-9 MQTT Management

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
16
December 2020
3.6. System Settings
Password Setting
You can change the password as shown in Figure 3-10. Fill the new password and press
Reset Password button, the new password applied in the next login. Instead of the default
password, which is admin, password needs to be at least 8 letters and must contain at
least one number and one uppercase alphabet.
Figure 3-10 Change Password

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
17
December 2020
Network Setting
TLG3901B/BLV2 provides three network configurations for Ethernet connection, DHCP (Fig-
ure 3-11), Static IP (Figure 3-12) and DHCP Server (Figure 3-13). To use the DHCP, enable
the DHCP checkbox. Static IP needs information about IP address, network mask, and de-
fault gateway. To act as DHCP Server, the IP address, network mask and DHCP start and
end address must be provided.
Figure 3-11 Network Configuration
Figure 3-12 Static IP Setup

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
18
December 2020
Figure 3-13 DHCP Server Setup
Wireless Network Setting
TLG3901B/BLV2 provides a wireless AP for connected by laptop. This wireless AP function
can be enable/disable from Wireless Network, Figure 3-14. The SSID is also shown on this
configuration page. The password for connecting to TLG3901B/BLV2 via wireless is
"tlg3901b".
Figure 3-14 Wireless Configuration

Gateway TLG3901B/BLV2 Series User Manual
V2.0.4
19
December 2020
Cellular Network Setting
TLG3901B/BLV2 also provides cellular network if the 3G/4G module is present. The setup of
cellular network is shown at Figure 3-15. Please contact your cellular operator for the setting
of APN, Username, and Password (some operator setting only needs APN). The Dial Num-
ber is usually "*99***1#" in most of countries. DONOT change APN if you are not sure the
number.
Figure 3-15 Cellular Network Setup