← Wireless iBeacon Receiver Main Page


WiFi-Sniffer is a device that searches for nearby ibeacon information and uploads data to the MQTT server over a wireless network. It can search for all ibeacon information in the vicinity of the radius of 30M, but uploads only 20 ibeacon data to the server at a time. The data read from the server can be analysed and applied to your development. This article is to help you to configure and set up WiFi-Sniffer (Wireless iBeacon Receiver).

Software and hardware preparation

Let's go

Install Wi-Fi Starter software

Install Wi-Fi Starter softwareopen in new window,  it shows as below after installation

Figure1 WiFi Starter App logo showed as above on your cell phone

Power on the device

When you first connect power supply and USB connector to Wi-Fi-Sniffer, you should see red and yellow led blink. Otherwise please check power connection, or change a USB connector. When the yellow led is on, the device prepare for connecting Wi-Fi AP. Configure the Wi-Fi SSID and password by app Wi-Fi Starter. The status is as follows

Figure 2 The green led won’t blink, only red and yellow led blink when it is first powered on.

Use the Wi-Fi Starter software to connect WiFi and detect the devices

  • Open app Wi-Fi Starter, type in SSID and password and tap Start.

* Choose the smart config interface* Input your WiFi SSID(click the eye logo can show the input content)* Input your WiFi password* Tap start button to configure

Figure 3

  • Wait a moment, the app will receive a notification for device discovering, now Wi-Fi config ok. (Note: Only work with 2.4G Wi-Fi AP)

Figure 4

  • The green LED start blink after configure is done. The device upload data to MQTT broker per 10 seconds (default setting)

Figure 5

  • Tap the Devices option at the bottom of the Device Configuration interface, you will see the devices which has just been configured. The device name contains its MAC address. Choose the name same as the Mac address sticker on the back of Wi-Fi sniffer, tap it to enter configuration interface.

Eg. Click on the F4B85E03F1EE @ mysimplelink to enter the device configuration interface

Figure 6 The IP address will be showed on the top of the interface.(which is used for configuration by computer)

  • Tap F4B85E03F1EE@mysimplelink device name to enter the configure page for the device

Figure 7

Right now, The Wi-Fi sniffer has connected to WiFi successfully.You can see the overview info of this Wifi Sniffer as showed in Figure 6. We can add more WiFi connection and set up for updating beacons info on next step.

Let’s explain how to configure Wifi sniffer by IP address on computer

Configure WiFi-Sniffer on your computer

  • Open the browser in the address bar to enter IP address obtained, you will enter the Overview page the same as Figure 6.

Figure 8

Fiemware VersionFirmware version for WiFi iBeacon Receiver
System Up TimeDevice start time
Device Modeworking mode
MAC AddressMAC address
Access Point IPAccess Point IP
  • Go to the Profiles page to add a new WiFi connection

Figure 9

SSIDThe name of the WiFi
Security TpyeSecurity Type Open\WEP\WPA1\WPA2
Security KeyWiFi Passord
Profile PriorityPriority 0 - 7 0 is the highest priority

After typing all parameters, click Add to submit. You can see all WiFi connections in the following Profiles list. The settings take effect after sniffer restart. The WiFi-Sniffer can work in the wireless environment in the list and upload the beacon information to the MQTT server.You can also remove the wifi setting as you need.

Figure 10

You can also remove the wifi setting as you need.

  • Go to the Setup page for beacons data updating

Figure 11

* In System section you can set beacon data update interval, filter beacon name and other parameters.* Auto Update  --- Automatic update firmware 

Figure 12

* Work Mode  ---- upload beacon information format Full Mode / Simple Mode / RAW Mode

Figure 13

*  Request Interval  ---- Scan interval is default 10s, it can be modified according to your needs 1-10s

Figure 14

* Min RSSI Filter --- Filter the beacon by RSSI value. the default is Default

Figure 15

* iBeacon UUID Filter --- Searches for beacon information for specified UUID and upload.

Figure 16

After the above parameters are modified, click the submit button

2、In the MQTT option you can set your own server

Figure 17

MQTT BrokerServer name or IP for MQTT broker
MQTT Uernameusername
MQTT Passwordpassword

Click the submit button when the modification is complete.

Read the uploaded beacon information from the MQTT server

Install mosquittoopen in new window software.

  • Open command line mode by cmd
  • Change directory to the installation directory of mosquitto
  • Enter command to view beacon data

mosquitto_sub.exe -h mqtt.bconimg.com -t "/beacons"

Figure 18

The beacon information format is as follows:


This is a set of json data

idMac address for WiFi iBeacon Receiver F4B85E03F1EE
vFirmware version 0.10
midThe number of times to upload
raw_beacons_dataBeacon data information

Parsing beacon data

Byte(hexadecimal digit)descriptionExample
1 - 12Mac address for Beacon123B6A1A6E33
13 - 44Beacon UUIDB5B182C7EAB14988AA99B5C1517008D9
45 - 48major0001
49 - 52minor336E
53, 54measured powerC5
55, 56Battery level in percent, FF when battery power is unknownFF
57, 58RSSIBD

Frequently Asked Questions and Solutionsopen in new window

Last Updated:
Contributors: yanc