KKM KGateway - User Manual

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

Summary

Revision History

1. Purpose

2. Introduction

3. External interface

3.1 Network interface

Explains how the KGateway connects to the internet via Wi-Fi, Ethernet, or Cellular.

3.2 Power supply interface

Describes the available power supply options: macro USB and Ethernet POE port.

3.3 LED indicator

Explains the meaning of the KGateway's LED indicators for status monitoring.

3.4 Insert LTE USB dongle SIM card (If needed)

4. Configuration

4.1 Connect to KGateway

Details the initial steps to connect to the KGateway using its Wi-Fi hotspot.

4.2 Network interface

Configures the gateway's network connections for internet access.

4.2.1 Configure WAN interface

4.2.1.1 Connect to internet by Ethernet

Configures the KGateway to connect to the internet using an Ethernet cable.

4.2.1.2 Connect to internet by Wi-Fi

Configures the KGateway to connect to the internet wirelessly via Wi-Fi.

Connect to an hidden Wi-Fi AP

4.2.1.3 Connect to internet by Cellular

4.2.2 View the WAN interface status

Displays current status information for the gateway's WAN connection.

4.2.2.1 Ethernet status

4.2.2.2 Cellular status

4.2.1 Configure KGateway Wi-Fi AP

4.3 Service configuration

4.3.1 Advertisement Upload Parameters

Sets parameters for how beacon advertisement data is uploaded.

4.3.2 MQTT without SSL configuration

4.3.3 MQTT with SSL configuration

4.3.4 HTTP configuration

4.4 Modifying the Web Portal Login Password

5. Quickly verify KGateway API

5.1 How to verify HTTP API

Details steps to verify the HTTP API connection and data posting.

5.2 How to verify MQTT API

Provides instructions for verifying the MQTT API using third-party tools.

6. Trouble shooting

6.1.1 The KGateway flash red LED

Troubleshoots the red LED status, indicating a connection failure.

6.1.1.1 Step1: Check if the network connection is normal

6.1.1.2 Step2: Check the connection between KGateway and cloud server

6.1.1.3 Check if the HTTP;MQTT server running normal

Scenario 1: Using MQTT server

Troubleshooting MQTT server connection and installation issues.

Scenario 2: Using HTTPs server

Troubleshooting HTTPs server connection using curl.

6.1.2 The Cellular signal was very pool

7. Appendix1 Advertisement Upload Filter for different scenario

7.1 Scenario 1: Only upload nearby beacon advertisement

Filters to upload only advertisements from nearby beacons.

7.2 Scenario 2: Reduce advertisement message to clouds

Optimizes data transmission by reducing advertisement messages.

7.3 Scenario 3: Only upload specific MAC address to clouds

Uploads advertisements only from specified MAC addresses.

7.4 Scenario 4: Only upload iBeacon advertisement

Filters to upload only iBeacon protocol advertisements.

7.5 Scenario 5: Only upload Eddystone advertisement

Filters to upload only Eddystone protocol advertisements.

7.6 Scenario 6: Filter advertisement packet by service ID

Filters beacon packets based on their Service ID.

7.7 Scenario 7: Beacon Location

Monitors beacon RSSI and MAC for location tracking purposes.

8. Appendix2 Setup your own MQTT Server

KKM KGateway Specifications

General

Brand	KKM
Model	KGateway
Category	Gateway
Language	English