MOKO MK105 User manual

Datasheet
MK105 User Manual
MOKO Bluetooth Gateway Plug
MOKO TECHNOLOGY LTD.
Version 1.0 www.mokosmart.com
User Manual
（MK105）

www.mokosmart.com
1. About This Manual.................................................................................... 1
2. Product Introduction................................................................................. 1
2.1 Overview..................................................................................................................................1
2.2 Application...............................................................................................................................1
2.3 Button Operation.....................................................................................................................1
3. APP Operation........................................................................................... 2
3.1 APP Download......................................................................................................................... 2
3.2 Configure Server Information..................................................................................................2
3.2.1 EMQTT Server Configuration...............................................................................................................2
3.2.2 AWS Server Configuration................................................................................................................... 4
3.3 Connect to Router................................................................................................................... 4
3.4 Set the Gateway via APP......................................................................................................... 5
3.4.1 Scan BLE Devices..................................................................................................................................5
3.4.2 Set Filter Parameters........................................................................................................................... 6
3.4.3 About OTA............................................................................................................................................7
3.4.4 LED Settings......................................................................................................................................... 7
3.4.5 Data Reporting Setting........................................................................................................................ 8
3.4.6 Factory Reset....................................................................................................................................... 9
3.4.7 Remove Device.................................................................................................................................... 9
4. Revision History.......................................................................................10
Content

MK105 User Manual
www.mokosmart.com
1
1. About This Manual
This document will briefly introduce the MK105 gateway plug and guide users how to operate the
gateway using mobile APP.
2. Product Introduction
2.1 Overview
MK105 is an IOT Bluetooth gateway plug that integrates WIFI and Bluetooth wireless technology. It
is based on ESP32 solution and is cost-effective.
The plug works as a BLE scanner to gather Bluetooth broadcast data of BLE device nearby, and
upload these data frames to MQTT server through 2.4Ghz WIFI. It is mainly used for position
tracking and BLE sensor monitoring.
2.2 Applications
Location tracking in room
Health/fitness monitoring in hospital
Environmental monitoring
Temperature sensor monitoring
Beacon & BLE Sensor & BLE device raw data collection
2.3 Button Operation
Short pressing button: to set the Bluetooth status. For devices that not connected to network,
short pressing button can set Bluetooth advertise/OFF, LED will flash GREEN/OFF .
Holding the button for 10s: to restore factory settings. In any situation, after the device is
powered up, long pressing the button for 10s, that will trigger device to reset. When LED
flashes GREEN and BLUE alternately once, that means device resets successfully.

MK105 User Manual
www.mokosmart.com
2
3. APP Operation
3.1 APP Download
Scan the following QR code to download Mokoscanner APP, you can also search “Mokoscanner” in
Google play or APP Store for download.
3.2 Configure Server Information
MK105 gateway supports multiple kinds of MQTT servers such as EMQTT, AWS IOT and Ali cloud
IOT. This section will describe EMQTT connection and AWS connection using Android mobile
phone.
3.2.1 EMQTT Server Configuration
1. Insert the gateway plug into any power socket and shortly press the button, the LED will flash
green(Device is advertising data).
2. Run your Mokoscanner APP, tap the upper left icon to the "MQTT settings for APP" page, enter
the configuration information and save it.

MK105 User Manual
www.mokosmart.com
3
Host: Your server IP address or domain name
Port: 1883
Username & Password: User authentication for connection
Client Id: Unique client identity of APP connecting the server
Connect mode: TCP
Subscribed Topic and Publish Topic here can be empty
3. Tap "Add Devices" and select a device, then go into "MQTT settings for Device" page. please
enter the configuration information here and save.
Host and Port: The same as APP side.
Username & Password: User authentication for connection
Client Id: Unique client identity of device connecting the server

MK105 User Manual
www.mokosmart.com
4
Device Id: Use a random device id
Connect Mode: TCP
Subscribed Topic and Published Topic: Use the default topics directly, or set them as random
characters.
Note: The DEMO host 47.104.81.55 can be used directly if you need, just available for test.
3.2.2 AWS Server Configuration
1. Compared with EMQTT connection, the port uses 8883 not 1883, and AWS connection needs
AWS certificates, including CA root certificate, client CA certificate and client private key. Please
choose “Two-way SSL” as the Connect Mode.
2. MQTT settings for device also need choose Two-way SSL mode and attach AWS certificates.
3.3 Connect to Router
After server information is configured, you can set an available router SSID and password for the
device, then device will connect the specified network and server.
When device connects to network successfully, LED will turn solid blue. And you can rename your
device, then you can set the gateway through APP.

MK105 User Manual
www.mokosmart.com
5
3.4 Set the Gateway via APP
3.4.1 Scan BLE Devices
Click the switch button to set the gateway start/stop scanning. The default scanning time is 65535s,
that means the device will scan all the time. And the scanning time is settable, it can be set from
10 to 65535. When the scanning time expires, the gateway will automatically stop scanning.

MK105 User Manual
www.mokosmart.com
6
3.4.2 Set Filter Parameters
Click the “Edit Filter” to enter the edition page. Defaultly, the name filter, MAC filter and raw data
filter are all disabled, you can enable these options according to the actual needs.
RSSI Filter: Slide the icon to set a RSSI value.
Name Filter: Set the switch on, and enter a device name that need to be filtered.
MAC Filter: Set the switch on, and enter a MAC address that need to be filtered.
Raw Data Filter: Set the switch on, tap the ” +” icon to add a textbox(it allows to add up to 5
rules), enter the data type, data range(0~0 /1~29 is available), and raw data field(1~29bytes)
that need to be filtered, then “Done”.
Note: If all filters have been set, device will execute each filter rule as “And” operation.

MK105 User Manual
www.mokosmart.com
7
3.4.3 About OTA
The Host, Port, and Catalogue is the file path where the upgrade packet is located, then click “Start
Update”, device will update the firmware over the air, and the LED will flash green. When update
successfully, the LED will become solid green, and device will reboot once.
Note: The OTA server(Host: 47.104.172.169, port: 8080) in the above picture is just available for
your test. If you need, MOKO can provide the lasted firmware upgrade packet, then you can paste
the file to your server to operate OTA.
3.4.4 LED Settings
In this page, you can set the LED disabled/enabled in the following four states independently.
Defaultly, LED state should be all enabled.

MK105 User Manual
www.mokosmart.com
8
3.4.5 Data Reporting Setting
This parameter defines the time interval of device reporting data to server, you can set the value
from 0 to 60(interval range should be 0-3 seconds), and default value is 20.

MK105 User Manual
www.mokosmart.com
9
3.4.6 Factory Reset
You can reset your gateway through the “Reset” button, then LED will flash blue and green
alternately once, that means the gateway restores factory settings successfully. And you can also
hold the button on the casing for 10 seconds to reset the plug.
3.4.7 Remove Device
“Remove Device” button is used to remove a device from your APP. You can also operate it in the
device list page.

MK105 User Manual
www.mokosmart.com
10
4. Revision History
Revision
Description
Editor
Date
V1.0
Initial Release
Weiguifen
2020.12.15
MOKO TECHNOLOGY LTD.
4F, Building2, Guanghui Technology Park,
MinQing Rd, Longhua, Shenzhen, Guangdong, China
Tel: [phone]-829
[e-mail]
https://www.mokosmart.com