This is intended as a starting point rather than a complete positioning or ranging system. If you already work with RSSI, the dashboard gives you a practical base for collecting observations, testing an environment, and extending the analysis for your own use case.<\/p>\n\n\n\n
What the analyzer provides<\/h2>\n\n\n\n
The dashboard is organized around one selected BLE device. Its current RSSI, smoothed RSSI, recent trend, and signal stability appear directly above a live time-series chart. The raw readings remain visible, so the processed line never hides what the dongle actually received.<\/p>\n\n\n\n
Below the main analysis, the Discovered Now<\/strong> section compares the latest RSSI values from nearby devices. An RSSI distribution chart shows how the selected device\u2019s readings are spread across the recent observation window.<\/p>\n\n\n\n This combination is useful when you want to answer practical questions such as whether a signal is consistently weak, whether it is changing direction, or whether an apparently stable device is producing occasional large variations.<\/p>\n\n\n\n You will need:<\/p>\n\n\n\n The application uses pySerial<\/a> to communicate with BleuIO and Plotly Dash<\/a> for the local dashboard. BleuIO handles the BLE radio operation, so the Python application only needs to work with its serial AT-command interface.<\/p>\n\n\n\n Clone the repository and move into the project directory:<\/p>\n\n\n\n On macOS or Linux, create a virtual environment and install the dependencies:<\/p>\n\n\n\n On Windows PowerShell, use:<\/p>\n\n\n\n Connect the BleuIO dongle before starting the application. BleuIO briefly exposes its bootloader after power-up, so allow approximately 15 seconds for the normal application serial port to appear.<\/p>\n\n\n\n Start the analyzer:<\/p>\n\n\n\n Then open http:\/\/127.0.0.1:8050<\/a> in a browser.<\/p>\n\n\n\n The serial-port menu only shows ports identified as BleuIO devices. On macOS, this normally looks like Select the dongle and click Start scan<\/strong>. The application places BleuIO in central role and repeatedly performs a short timed scan using As advertisements are received, nearby addresses appear in the BLE device menu. Select the device you want to examine, and the analysis area updates immediately.<\/p>\n\n\n\n The Current RSSI<\/strong> card displays the most recent reading. This value is useful for immediate feedback, but normal radio variation can make it jump even when neither device has deliberately moved.<\/p>\n\n\n\n <\/p>\n\n\n\n The Smoothed RSSI<\/strong> view makes the overall movement easier to follow. The project first applies a short median filter to reduce isolated spikes, followed by an exponentially weighted moving average that gives more importance to recent observations. The original samples remain visible as dots, while the smoothed result appears as the blue line.<\/p>\n\n\n\n <\/p>\n\n\n\n This processing is deliberately lightweight. It is enough to make the live chart readable, but it is also easy to replace if your experiment needs a Kalman filter, a different smoothing window, or no filtering at all.<\/p>\n\n\n\n The Recent Trend<\/strong> card compares the latest smoothed value with the recent signal history. A change of at least 4 dB is described as Getting stronger<\/strong> or Getting weaker<\/strong>. Smaller changes are shown as Stable<\/strong>. The card also displays the measured change, making the label easy to interpret rather than presenting it as an unexplained classification.<\/p>\n\n\n\n <\/p>\n\n\n The Signal Stability<\/strong> card looks at the variation among the latest raw readings. A tightly grouped signal is labeled Steady<\/strong>. Greater variation is reported as Variable<\/strong> or Unstable<\/strong>. Strength and stability are treated separately: a weak signal can still be steady, and a strong signal can fluctuate considerably. <\/p>\n\n\n\n <\/p>\n\n\n\n These thresholds are sensible defaults for exploring a signal, not universal BLE rules. They are kept in a small analysis module so they can be adjusted for the advertising interval, environment, antenna, and behavior of the device being studied.<\/p>\n\n\n\n The Discovered Now<\/strong> chart provides context for the focused analysis. It shows the latest RSSI from every address found during the scan, ordered from stronger to weaker signals. This is useful when choosing a target or checking how crowded the local BLE environment is.<\/p>\n\n\n\n The distribution beside it belongs only to the selected device. It counts how often recent readings occurred within each RSSI range. A narrow group of bars usually accompanies a steadier signal, while a wider spread reveals more variation. The chart can be especially useful when comparing two locations or antenna orientations that have a similar average RSSI but different consistency.<\/p>\n\n\n\n Choose a BLE advertiser that sends packets regularly and leave it in a fixed position. Let the analyzer collect readings for a short period, then change one condition at a time: rotate the device, move it farther away, place an obstacle between it and BleuIO, or walk through the signal path.<\/p>\n\n\n\n The raw samples show the immediate radio response. The smoothed line makes the larger movement easier to see, while the trend and stability cards provide a compact summary. The distribution shows whether the new condition changed only the average signal or also made it more variable.<\/p>\n\n\n\n The goal is not to turn RSSI into an exact ruler. Bluetooth radio measurements are affected by the environment, reflections, antenna orientation, and the human body. The Bluetooth SIG notes that newer Bluetooth Channel Sounding is more reliable for accurate ranging than approaches that use RSSI as a distance proxy. The Bluetooth Low Energy primer<\/a> provides useful background on that distinction.<\/p>\n\n\n\n For this project, RSSI is used for what it does well: observing relative signal behavior, detecting meaningful changes, and building an experiment around real measurements.<\/p>\n\n\n\n The source is intentionally compact so it can be adapted. A next version could save readings to CSV, compare multiple selected devices, add experiment markers, calculate packet reception rates, or load a calibration profile for a known environment. The analysis functions can also be replaced without changing the BleuIO serial scanner or the dashboard structure.<\/p>\n\n\n\nHardware and software<\/h2>\n\n\n\n
\n
Download and install the project<\/h2>\n\n\n\n
\ngit clone https:\/\/github.com\/smart-sensor-devices-ab\/bleuio-rssi-analyzer.git\n\ncd bleuio-rssi-analyzer\n\n<\/code><\/pre>\n\n\n\n\npython3 -m venv .venv\n\nsource .venv\/bin\/activate\n\npython -m pip install -r requirements.txt\n\n<\/code><\/pre>\n\n\n\n\npy -m venv .venv\n\n.venv\\Scripts\\Activate.ps1\n\npython -m pip install -r requirements.txt\n\n<\/code><\/pre>\n\n\n\n\npython app.py\n\n<\/code><\/pre>\n\n\n\nStart scanning<\/h2>\n\n\n\n
\/dev\/cu.usbmodem...<\/code>. On Windows, the dongle may appear as a generic USB Serial Device (COMx)<\/code>, so the application also recognizes BleuIO by its USB vendor and product identifiers.<\/p>\n\n\n\nAT+GAPSCAN=1<\/code>. Repeating the timed scan gives the dashboard a continuing series of fresh RSSI observations instead of a single discovery result. The command behavior is documented in the BleuIO AT command reference<\/a>.<\/p>\n\n\n\nFollow a selected signal<\/h2>\n\n\n
![\"\"](\"https:\/\/www.bleuio.com\/blog\/wp-content\/uploads\/2026\/11\/image.png\")
<\/figure>\n<\/div>\n\n\n![\"\"](\"https:\/\/www.bleuio.com\/blog\/wp-content\/uploads\/2026\/11\/image-1.png\")
<\/figure>\n<\/div>\n\n\nRead the trend and stability indicators<\/h2>\n\n\n
![\"\"](\"https:\/\/www.bleuio.com\/blog\/wp-content\/uploads\/2026\/11\/image-2.png\")
<\/figure>\n<\/div>\n\n\n![\"\"](\"https:\/\/www.bleuio.com\/blog\/wp-content\/uploads\/2026\/11\/image-3.png\")
<\/figure>\n<\/div>\n\n\nCompare nearby devices<\/h2>\n\n\n\n
![\"\"](\"https:\/\/www.bleuio.com\/blog\/wp-content\/uploads\/2026\/11\/image-4-1024x598.png\")
<\/figure>\n\n\n\nTry a simple observation<\/h2>\n\n\n\n
Take the project further<\/h2>\n\n\n\n