MOKO MK105 Bluetooth Gateway Plug User Manual

: June 6, 2024
: MOKO

Table of Contents

About This Manual
Product Introduction
APP Operation
Revision History
Read User Manual Online (PDF format)
Download This Manual (PDF format)

MK105 User Manual

MOKO Bluetooth Gateway Plug （MK105）

About This Manual

This document will briefly introduce the MK105 gateway plug and guide users on how to operate the gateway using a mobile APP.

Product Introduction

2.1 Overview

MK105 is an IOT Bluetooth gateway plug that integrates WIFI and Bluetooth wireless technology. It is based on the 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 the 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 are not connected to the network, the short pressing button can set Bluetooth to 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 will trigger the device to reset. when LED flashes GREEN and BLUE alternately once, that means the device resets successfully.

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.

http://app.appurl.me/79816229277

3.2 Configure Server Information

MK105 gateway supports multiple kinds of MQTT servers such as MQTT, AWS IoT, and Ali cloud IoT. This section will describe the EMQTT connection and AWS connection using an Android mobile phone.

3.2.1 EMQTT Server Configuration

Insert the gateway plug into any power socket and shortly press the button, the LED will flash green(Device is advertising data).
Run your Mokoscanner APP, tap the upper-left icon to the “MQTT settings for APP” page, enter the configuration information and save it.
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 the “MQTT settings for Device” page. please enter the configuration information here and save it.

Host and Port: The same as APP side.
Username & Password: User authentication for connection
Client Id: Unique client identity of device connecting the server
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 it, just available for test.

3.2.2 AWS Server Configuration

Compared with the EMQTT connection, the port uses 8883, not 1883, and the 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.
MQTT settings for devices also need to choose a 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 the device will connect to the specified network and server.
When a device connects to the network successfully, LED will turn solid blue. And you can rename your device, then you can set the gateway through APP.

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, which 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.

3.4.2 Set Filter Parameters
Click the “Edit Filter” to enter the edition page. Default, 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 an RSSI value.
Name Filter: Set the switch on, and enter a device name that needs to be filtered.
MAC Filter: Set the switch on, and enter a MAC address that needs 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, the device will execute each filter rule as an “And” operation.

3.4.3 About OTA
The Host, Port, and Catalogue is the file path where the upgrade packet is located, then click “Start Update”, the device will update the firmware over the air, and the LED will flash green. When update successfully, the LED will become solid green, and the 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
On this page, you can set the LED disabled/enabled in the following four states independently. Default, LED state should be all enabled.

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

3.4.6 Factory Reset
You can reset your gateway through the “Reset” button, then the LED will flash blue and green alternately once, which 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
The “Remove Device” button is used to remove a device from your APP. You can also operate it on the device list page.