MOKO MKGW-mini Series User manual

Datash
MKGW-mini BLE to WIFI Gateway
User Manual
Version V1.0

www.mokosmart.com
1. About This Manual.................................................................................... 1
2. APP Guide.................................................................................................. 1
2.1 APP Download....................................................................................................1
2.2 Configure Server Information............................................................................ 1
2.2.1 Configure APP and Device connect to EMQTT............................................................ 1
2.2.2 Configure APP and Device connect to AWS iot........................................................... 4
2.3 Set the Gateway Scan BLE Device......................................................................5
2.4 Set the Filter Condition......................................................................................6
2.4.1 Beacon Type Filter....................................................................................................... 7
2.4.2 Beacon Data Filter....................................................................................................... 8
2.4.3 Duplicate Data Filter....................................................................................................9
2.4.4 Upload Data Option...................................................................................................10
2.5 Set Device Parameters..................................................................................... 11
2.5.1 LED Status Option......................................................................................................12
2.5.2 Data Report Timeout.................................................................................................12
2.5.3 Network Status Report Period...................................................................................12
2.5.4 Connection Timeout Option......................................................................................13
2.5.5 Scan Timeout Option.................................................................................................13
2.5.6 System Time.............................................................................................................. 13
2.6 OTA................................................................................................................... 14
2.7 Reboot Device.................................................................................................. 14
2.8 Reset Device.....................................................................................................14
2.9 Remove Device.................................................................................................15
3.Revision History........................................................................................15
Contents

www.mokosmart.com
1
1. About This Manual
MKGW-mini gateway supports connecting to the customer's own server, users can view the data
uploaded by the gateway and set the gateway parameters through the MQTT tool. MOKO also
provides a Demo APP for customers to quickly configure the gateway. This document will take the
MOKO APP as an example to guide users to configure the gateway to connect to their own server
and set the gateway to scan and obtain the required beacon data.
2. APP Guide
MKGW-mini gateway can connect to standard MQTT brokers (such as EMQTT, Mosquito, etc.), and
it can also work with AWS iot and Alibaba iot. This section will guide users to use MKScannerPro
APP to configure the gateway to connect to EMQTT and AWS iot.
2.1 APP Download
Scan the following QR code to download MKScannerPro APP. You can also search for the APP
directly in Google play or APP store.
2.2 Configure Server Information
2.2.1 Configure APP and Device connect to EMQTT
1. If the gateway is configured for the first time, after the gateway is powered, its Bluetooth will
advertise, and the indicator flashes green.
2. Run the MKScannerPro APP, click the icon in the upper right to enter the "Settings for APP"
page, fill in the configuration information and save it.

www.mokosmart.com
2
Type
Parameter
Description
Broker setting
Host
The IP address or domain name of your server.
Port
Server port number.
Client Id
MQTT client id, each device connected to the server
should have a unique client id.
Topics
Subscribe
The APP use it to subscribe message from the gateway, it
can be blank.
Publish
The APP use it to publish message to the gateway, it can
be blank.
General
Clean Session
Default: Enable, range: Enable/Disable
Qos
Quality of service. Default: 1, range: 0-2
Keep Alive
Default : 60, range: 10-120
User
Credentials
Username
If access to your server doesn’t require a username and
password, it can be blank.
Password
SSL/TSL
SSL/TLS
Enable means SSL mode
Disable means TCP mode
Certificates
It supports three type of certificates:
CA signed server certification
CA certificate file
Self signed certificates

www.mokosmart.com
3
3. Click the "Add Devices" button to select a gateway to connect, the connection password is
Moko4321. After the APP is successfully connected with the gateway's Bluetooth, the indicator
will turn to solid green.
4. Fill in the configuration for the device, and configure an available WIFI SSID and password. The
gateway will automatically connect the WIFI and the server, and the indicator will flash blue.
5. Waiting for a few seconds, if the gateway is successfully connected to the server, the indicator
will change to solid blue, and the APP will prompt "Connection successful", you can edit a local
name for the gateway here.

www.mokosmart.com
4
Type
Parameter
Description
Broker setting
Host
The IP address or domain name of your server.
Port
Server port number.
Client Id
MQTT client id, each device connected to the server
should have a unique client id.
Topics
Subscribe
The gateway uses it to subscribe messages from the APP.
You can use the default topic directly or modify it.
If the topic of “Settings for APP” page has been set, it
should be set the same as the APP published topic.
Publish
The gateway uses it to publish messages to the APP. You
can use the default topic directly or modify it.
If the topic of “Settings for APP” page has been set, it
should be set the same as the APP subscribed topic.
General
Clean Session
Default: Enable, range: Enable/Disable
Qos
Quality of service. Default: 1, range: 0-2
Keep Alive
Default : 60, range: 10-120
User Credentials
Username
If access to your server doesn’t require a username and
password, it can be blank.
Password
SSL/TSL
SSL/TLS
Enable means SSL mode
Disable means TCP mode
Certificates
It supports three type of certificates:
CA signed server certification;
CA certificate file;
Self signed certificates
Device Id
Device Id
Each added device should have a unique device id.
Time setting
NTP URL
NTP server IP or domain name, it can be blank, then
device will use the default NTP server.
Timezone
Default: UTC+0, range: UTC-12 - UTC+12
2.2.2 Configure APP and Device connect to AWS iot
When configuring the gateway to connect to AWS iot, please enable the SSL/TLS option, and select
the certificate files locally from the mobile phone.

www.mokosmart.com
5
Since the certificate format required by the iOS APP is different from that of the Android APP, this
page of Android and iOS are slightly different (the left picture is the "MQTT settings for APP" page
of Android APP, and the right picture is the "MQTT settings for APP" page of IOS APP).
2.3 Set the Gateway Scan BLE Device
When the gateway is successfully connected to the server, it will automatically start scanning, and
the scanned data will be displayed on the page. The scan switch and scan time of the gateway can
be configured.

www.mokosmart.com
6
Parameter
Description
Scan switch
Default: enable, range: Enable/Disabled
Scan time
Default: 65535, range: 10-65535 (unit: second)
65535 is a special value, which means the gateway will be always scanning.
Other value is a countdown time, when the time expires, the gateway will
automatically stop scanning.
2.4 Set the Filter Condition
Click the "Filter and Upload option" button to set filter conditions, which can help users easily
obtain target beacon data.

www.mokosmart.com
7
2.4.1 Beacon Type Filter
The gateway can filter data by beacon type, and there are total 9 beacon types.
With the default configuration, the gateway will scan and upload all types of beacon data. When
the option is disabled, the gateway will not report this type of beacon data to your server.

www.mokosmart.com
8
2.4.2 Beacon Data Filter
The gateway can also filter by beacon data, and it allows to set at most two filter conditions
(condition A and condition B). The content of the two filter conditions is the same. When both of
the filter conditions are ON, the relationship can be set to And or Or.
Both Condition A and Condition B include the following filter items, each filter item can be set to
whitelist filtering. If the whitelist box is unchecked, the gateway will report advertising data which
meets the filter rules. Otherwise the gateway will report advertising data which doesn’t meet the
filter rules.
Parameters
Description
Filter Condition A
RSSI
Default: -127 dBm, range: -127- 0 dBm
MAC address
Default is disabled, when enabling it, please enter a full MAC
address or keyword.
ADV Name
Default is disabled, when enabling it, please enter a full ADV name
or keyword.
iBeacon Proximity UUID
Default is disabled, when enabling it, please enter a full iBeacon
UUID or keyword.
iBeacon major
Default is disabled, when enabling it, please enter the range value
of iBeacon major, the second value must be greater than or equal
to the first value.
iBeacon minor
Default is disabled, when enabling it, please enter the range value
of iBeacon minor, the second value must be greater than or equal
to the first value.