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.
This manual suits for next models
1
Table of contents
Other Kiwi Gateway manuals
Popular Gateway manuals by other brands
LST
LST M500RFE-AS Specification sheet
Kinnex
Kinnex Media Gateway quick start guide
2N Telekomunikace
2N Telekomunikace 2N StarGate user manual
Mitsubishi Heavy Industries
Mitsubishi Heavy Industries Superlink SC-WBGW256 Original instructions
ZyXEL Communications
ZyXEL Communications ZYWALL2 ET 2WE user guide
Telsey
Telsey CPVA 500 - SIP Technical manual
