KKM KGateway Instruction sheet

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 1/ 33
KGateway(for KBeacon) Configuration
Manual
Revision History
Version
Date
Change Description
Author
V1.0
2017/7/1
initial
Ning
V1.1
2018/8/20
Add hidden Wi-Fi function
Hogen
V1.2
2018/12/1
Modify network architecture picture
Hogen
V1.3
2019/12/1
Add the Cellular info
Hogen
V1.31
2020/03/1
Add MQTT configuration example
Hogen

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 2/ 33
Catalogue
1. Purpose..................................................................................................................................3
2. Introduction...................................................................................................................................3
3. External interface..........................................................................................................................4
3.1 Network interface................................................................................................................4
3.2 Power supply interface........................................................................................................4
3.3 LED indicator......................................................................................................................4
3.4 Insert LTE USB dongle SIM card (If needed)....................................................................5
4. Configuration................................................................................................................................5
4.1 Connect to KGateway.........................................................................................................6
4.2 Network interface................................................................................................................7
4.2.1 Configure WAN interface........................................................................................7
4.2.2 View the WAN interface status..............................................................................10
4.2.1 Configure KGateway Wi-Fi AP.............................................................................11
4.3 Service configuration........................................................................................................12
4.3.1 Advertisement Upload Parameters.........................................................................12
4.3.2 MQTT without SSL configuration.........................................................................14
4.3.3 MQTT with SSL configuration..............................................................................15
4.3.4 HTTP configuration...............................................................................................18
4.4 Modifying the Web Portal Login Password......................................................................19
5. Quickly verify KGateway API....................................................................................................19
5.1 How to verify HTTP API..................................................................................................20
5.2 How to verify MQTT API.................................................................................................20
6. Trouble shooting.........................................................................................................................20
6.1.1 The KGateway flash red LED................................................................................20
6.1.2 The Cellular signal was very pool..........................................................................25
7. Appendix1 Advertisement Upload Filter for different scenario .................................................26
7.1 Scenario 1: Only upload nearby beacon advertisement ....................................................26
7.2 Scenario 2: Reduce advertisement message to clouds ......................................................27
7.3 Scenario 3: Only upload specific MAC address to clouds................................................28
7.4 Scenario 4: Only upload iBeacon advertisement ..............................................................28
7.5 Scenario 5: Only upload Eddystone advertisement...........................................................29
7.6 Scenario 6: Filter advertisement packet by service ID......................................................30
7.7 Scenario 7: Beacon Location ............................................................................................30
8. Appendix2 Setup your own MQTT Server.........................................................................31

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 3/ 33
1. Purpose
This document describes the basic functions and physical interfaces of the KGateway, which
are mainly used to guide users to install and configure.
2. Introduction
The KGateway is made of PC material and is waterproof and dustproof. It supports outdoor
installation and can be installed by wall mounting.
After the KGateway power on, it will periodically scan the KBeacon advertisement packet
then report the data through Wi-Fi or Ethernet. Also it can accept data command from the cloud
and forward the data to KBeacon, such as updating the KBeacon configuration. The KGateway
uses open MQTT + JSON API interface for third-party integration.
Specification
Power
POE or DC 5V
Scanning ability
> 240 beacon per 1 second (nRF52840)
> 120 beacon per 1 second (TI CC2640R2F)
Wireless distance
BLE5.0: > 200 meters
BLE4.0/4.1/4.2 > 100 meters
(depends on environment)
BLE
MAX TX power: 8dBm for nRF52840
5dBm for TI CC2640R2F
Receiver Sensitivity: –96 dBm
Protocol:BLE4.0/4.1/4.2/5.0
Antenna: omnidirectional
Antenna VSWR: < 1.3
Transmitting way
•ETH RJ45

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 4/ 33
•Wi-Fi
•Wi-Fi hopping
•3G/4G USB Dongle(optional)
API protocol
•HTTPS
•MQTT
Installation way
Screw
Waterproof/Dustproof
IP54
Size
173*90*40mm
Material
ABS
3. External interface
3.1 Network interface
The KGateway supports following ways to connect to the internet:
1. through Wi-Fi;
2. through the Ethernet cable;
3. Though Cellular network (optional, only available when the LTE usb dongle was insert);
4. The KGateway supports Wi-Fi Hopping, which means one KGateway can connect to
internet by another KGateway.
3.2 Power supply interface
There are two interfaces for power supply: macro USB interface and Ethernet POE port;
POE power supply, directly through the Ethernet cable interface, using POE(802.3af) to
supply power.
Macro USB power supply, powered by the 5V/1A DC.
Warning: The KGateway can only use one of the two power supplies at the same time.
Please don’t insert two power supplies at the same time, otherwise KGateway may be
damaged.
3.3 LED indicator
The gateway has 2 LED indicators. The specific meanings are as follows:

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 5/ 33
1. Red indicator light:
If the red led flash, it means the gateway connect to the cloud fails.
2. Green indicator light:
2-seconds or less frequency flash: indicates that the KGateway is successfully
connected to the cloud and report KBeacon advertisement packet success.
10-second frequency flash: indicating that the KGateway connect to the cloud success,
but it didn’t find any KBeacon devices.
3.4 Insert LTE USB dongle SIM card (If needed)
Please note: This procedure is only for KGateway with USB dongle and LTE module
installed.
Disassemble the gateway and insert the SIM card at the position indicated in the picture
below.
4. Configuration
The KGateway is configured in web portal mode. You can use an web browser to configure it.
Chrome browser is recommended to use for the configuration.

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 6/ 33
As shown above, each base station has two interfaces with different IP addresses. One of
these IP addresses (referred to as the WAN port) is used to connect to the internet network
(MQTT server), which has a series of firewall rule protection. The other IP address (referred to
as LAN port, also known as the intranet interface) is used for Wi-Fi hotspot broadcasting.
WAN Port: This interface supports Wi-Fi and ETH (network wire). KGateway can
connect to routers via Wi-Fi or network wire, where IP addresses are assigned by routers. The
base station is connected to the MQTT/HTTPs server through this interface, so you need to
ensure that the network between this interface and the MQTT server is interconnected. WAN
address IP address configuration see "4.3.2 configuration WAN port network connection".
LAN port: This interface only supports Wi-Fi. The default IP address of this interface is
192.168.8.1, PC can connect to this interface through Wi-Fi, or the next hopping KGateway can
connect to the internet by Upper level.
If you need to configure the gateway, you can only configure it through Wi-Fi, and you
cannot configure it through the network line (for security reasons, the network line interface
only supports the WAN interface).
4.1 Connect to KGateway
After power on, the KGateway will automatically broadcast Wi-Fi signal, and the default
Wi-Fi name is “beacongw_mac address”

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 7/ 33
The default Wi-Fi connection password is“12345678”
The default KGateway configuration IP address is 192.168.8.1
Login in to the gateway by typing http://192.168.8.1 in the browser.
5. Enter the user name: ‘admin’and password: ‘admin’
4.2 Network interface
4.2.1 Configure WAN interface
Tap on Network to go to the network configuration page. You can choose to connect to the
internet network using Wi-Fi /Ethernet/Cellular connection.

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 8/ 33
4.2.1.1 Connect to internet by Ethernet
The IP address can be assigned in DHCP or static configuration.
4.2.1.2 Connect to internet by Wi-Fi

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 9/ 33
Click on “Nearby WLAN”, then you can see the Wi-Fi name and the signal strength (0~100).
100 means the signal is very strong.
Connect to an hidden Wi-Fi AP:
You can see some Wi-Fi name like mac address; it means that Wi-Fi was hidden. You should
input the Wi-Fi name and password if you want to connect to it.
If your Wi-Fi AP name does not appear in the nearby WLAN list, please try to reboot
the KGateway. (In others page, you can reboot the device)

KKM Co.Ltd KGateway(for KBeacon) Configuration
Copyright by KKM Inc. public 10 / 33
4.2.1.3 Connect to internet by Cellular
Please make sure SIM card was insert into the KGateway.
4.2.2 View the WAN interface status
4.2.2.1 Ethernet status
The AP MAC was also printed in the KGateway shell.
WAN IP: The gateway IP address in WAN interface.
Router IP: Your router IP address.
UP time: How long the network interface was active.
RX Bytes: received data from WAN interface.
TX Bytes: sent data to WAN interface.