Contents 1. About this document ....................1 2. LED status .......................1 3. Install the Gateway ....................1 4. Configure gateway with APP ...................2 4.1 Configure mobile APP ..................2 4.2 Configure gateway ..................4 4.3 Scan BLE devices .................... 9 4.4 Manage BLE devices ..................9 4.5 Filter and upload ..................10 4.6 Power metering ...................
Beacon data collecting, intelligent control and power monitoring together by the one device. This User Guide was designed to help users to know the MOKO MK110 Plus 03 gateway and set up the gateway with MOKO APP.
4. Configure gateway with APP MOKO provides a demo APP with users to configure the gateway, please search “MKScannerPro” in APP Store or Google Play to download the APP. When install it, please allow the location and storage permissions. In the configuration, we will firstly configure the app connecting to MQTT broker and then configure gateway connecting to MQTT broker.
Page 5
There are three buttons in the very bottom of this page to help users quickly complete the configuration: Clear all configurations: Delete all the current settings, so that users can input new settings. Export config file: Export the current settings from the APP, it will create a excel file and can be sent by email.
When the gateway LED flashes Blue, click “Add Devices” . We can see some advertisers named “MK110 Plus 03-XXXX”, select the correct device and enter password Moko4321. After APP connects with the gateway Bluetooth, the LED will turn to solid Blue.
Page 7
4.2.2 MQTT settings To configure MQTT parameters for the gateway. The gateway has default MQTT settings, if use default settings for testing purpose, just click . It also allows to change the settings. If connect the gateway to AWS IoT, please see Appendix B Connect to AWS IoT to get more details.
Page 8
If connecting with customer server, please follow the below descriptions to finish the configuration: Type Parameter Description Host Server IP address or domain name Server port Port Broker setting MQTT client id, each device connected to the server should have a different client id. The default id is device Client id MAC address.
Page 9
4.2.4 Scanner filters To configure the scanner filter for the gateway. It supports filter by RSSI, MAC and advertising name. 4.2.5 Advertise iBeacon To set the gateway advertise iBeacon and setup advertising parameters. By default, iBeacon advertisement is turned off. if it is turned to on, the gateway will advertise iBeacon frame after it connects to server.
Page 10
Metering switch: if it is on, the gateway will periodically report power and energy data after it connects to cloud. If it if off, the data reporting will be off. Load detection notification: if it is on, when the gateway detects the electrical load is removed or inserted, it will report a notification to cloud.
4.3 Scan BLE devices When the gateway is successfully configured, it will automatically start scanning. At the same time, the gateway will measure the network status and show it in the app. Icon Network status RSSI OFFLINE POOR WiFi <-65 dBm MEDIUM WiFi -65~-50 dBm GOOD WiFi...
4.5 Filter and upload To set the scanning filter and uploading data content for the gateway. www.mokosmart.com...
Page 13
4.5.1 Filter By RSSI The gateway filters beacon data according to the RSSI, it will upload the beacon advertising data with RSSI no less than the setting value. Parameter Description RSSI Default: -127 dBm, range: -127~0 dBm. 4.5.2 Filter By PHY The gateway filters beacon data according to the PHY type.
Page 14
The gateway filters beacon data according to advertising data type. The first 10 types are supported by MOKO beacon, the gateway will decode all MOKO beacon data. Other beacon data apart from the 10 types will be called “Other”, gateway will not decode the data, directly upload raw data to cloud.
Page 15
4.5.5.1 iBeacon To determine iBeacon frame is uploaded or not. If the iBeacon switch is on, the iBeacon UUID, major and minor are empty, the gateway will upload all detected iBeacon data. If the iBeacon UUID, major and minor are filled with some value, the gateway will upload only the iBeacon data which conforms the value.
Page 16
4.5.5.2 Eddystone - UID To determine Eddystone-UID frame is uploaded or not. If the Eddystone-UID switch is on, the Namespace ID and Instance ID are empty, the gateway will upload all detected Eddystone - UID data. If the Namespace ID and Instance ID are filled with some value, the gateway will upload only the Eddystone - UID data which conforms the value.
Page 17
Null: All versions will be uploaded; TLM version Version 0: Unencrypted TLM; Version 1: Encrypted TLM 4.5.5.5 BXP- Device info To determine MOKO BXP-Device info frame is uploaded or not. Parameter Description To determine upload BXP-device info data or not. Switch On: upload, off: not upload 4.4.5.6 BXP- ACC...
Page 18
4.4.5.9 BXP- Tag To determine MOKO BXP-Tag frame is uploaded or not. It supports filter the specified data by Tag ID, allows to set up to 10 sets of Tag id at the same time.
Page 19
“or”, and case insensitive. Click the “-” icon, it will delete the tag id input box. 4.4.5.10 PIR Presence To determine MOKO PIR Presence frame is uploaded or not. It supports filter the specified data by sensor status and major, minor. Parameter...
Page 20
Options: All/low/medium/high Sensor sensitivity All: All sensor sensitivity advertising data will be uploaded Options: All/no motion detected/motion detected Detection status All: All detection status advertising data will be uploaded Major From 0 to 65535, the Max value must be no less than the Min value. Minor From 0 to 65535, the Max value must be no less than the Min value.
Page 21
Condition C The same as condition A Filter relationship The “AND/OR” logic setting for the conditions. 4.5.5 Filter Relationship After the MAC filter, ADV name filter or raw data filter are set, it also needs to set the filter relationship, the relationship determines the processing logic. If you set one or more filters, but relationship is set as “Null”, the filters will not take effect.
4.5.7 Upload Data Option To determine the payload content uploaded to server. The Bluetooth data packet uploaded to the server includes timestamp, MAC, RSSI, advertising raw data and response raw data. The timestamp and raw data are optional. 4.6 Power metering To enter the page where we can get set the metering parameters and get the power and energy consumption data.
4.7 Gateway parameter settings The gateway allows users to change its parameters. All parameters in the settings page can be modified. 4.7.1 Indicator settings The LED indicator function in different device status can be configured. Parameter Description Bluetooth advertising indicator Default is enabled, when it is disabled, the LED will be OFF Bluetooth connected indicator Default is enabled, when it is disabled, the LED will be OFF...
Page 24
Server connecting indicator Default is enabled, when it is disabled, the LED will be OFF Server connected indicator Default is enabled, when it is disabled, the LED will be OFF 4.7.2 Network Status Report Period The gateway reports its network status to the server to notify the server that it is online. The report interval can be configured.
Page 25
4.7.6 Advertise iBeacon To set the gateway advertise iBeacon data. Parameter Description On/off Advertise iBeacon 0-65535 Major 0-65535 Minor 16 bytes UUID Range: 1-100, unit: 100ms ADV interval Tx power -24dBm~21dBm, step by 3 dBm. 4.7.7 Reset device by button To determine the reset device mode triggered by the physical button.
Off: Short click button will not change the output switch 4.8 OTA The gateway has an ability to update firmware over the air. When MOKO releases a new firmware, you can easily upgrade your gateway firmware by loading an upgrade Bin file with MOKO APP.
4.9 Modify Network settings Change the WiFi, MQTT and network settings for the gateway, it allows users to change the settings independently. After the WIFI, MQTT or network settings are changed, click the “Connect” button, the gateway will reboot once and reconnect using the new settings. 4.9.1 Modify WiFi settings To change the WIFI settings for the gateway.
4.11 Reboot The “Reboot” button is used to send a reboot command to the device. After that, the gateway will reboot once. 4.12 Reset Device The “Reset Device” button is used to send a reset command to the device. After that, the device will restore to factory settings, and the indicator will flash blue and green once.
Appendix A: WPA2 Enterprise Security Go to WIFI settings, select Enterprise for security, then select EAP type and enter the correct settings. PEAP-MSHCHAPV2: The user should enter the WIFI SSID, EAP username, EAP password. If verify server is enabled, it requires to upload the CA certificate from your phone. ...
Page 31
If using IOS phone, users need convert AWS certificates to required format, and import the certificates into your iOS phones through iTunes, then users can upload certificates from their phones. Please note that only the APP settings require the converted certificate, while the device settings still use the CA root certificate, private key and client certificate original files.
Revision History Revision Description Editor Date V1.0 Initial version Weiguifen 2023.9.12 MOKO TECHNOLOGY LTD. 4F, Building2, Guanghui Technology Park, MinQing Rd, Longhua, Shenzhen, Guangdong, China Tel: 86-755-23573370-829 sales@mokosmart.com https://www.mokosmart.com www.mokosmart.com...
Page 33
FCC Warning 15.19 Labeling requirements. This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
Page 34
IC Warning This device complies with Industry Canada’s licence-exempt RSSs. Operation is subject to the following two conditions: (1)This device may not cause interference; (2)This device must accept any interference, including interference that may cause undesired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence.
Need help?
Do you have a question about the MK110 Plus 03 and is the answer not in the manual?
Questions and answers