Skip to content
ToolOpen-source agent

BSWorld

Deterministic simulation testing for Bluetooth hosts and apps on Linux, driven from pytest

Pricing
Open source
Platforms
Linux, CLI, Self-hosted
Listing updated
today

About BSWorld

BSWorld is an open-source AI tool for developer tools. It is available on Linux, CLI and Self-hosted.

The README says BSWorld runs Bluetooth Host stacks and applications inside a deterministic radio simulation on Linux, so their behaviour can be tested without physical hardware. Test topology and expected behaviour are written in pytest, and each Host connects to its own BSController over an H4 HCI socket while all devices share a BabbleSim radio.

Multiple devices run on one simulation clock, and independent scenarios can be run in parallel with pytest-xdist. Path attenuation, interference, WLAN activity and replayed radio recordings can be configured per scenario. Application logs, HCI BTSnoop captures, per-Controller radio captures and shared Ellisys traces are written out for inspection in Wireshark.

The project targets embedded and stack developers who want repeatable Bluetooth integration tests for open-source Host implementations such as BlueZ, Zephyr, NuttX, NimBLE and TrouBLE. It requires Linux on x86_64 and is distributed under the Apache License 2.0.

What it does

Hardware-free Host testing
Runs open-source Host stacks against simulated controllers without requiring changes to their source code.
Deterministic simulation clock
Multiple devices share one simulation clock so protocol timers and packet timing follow simulation time.
Configurable RF scenarios
Sets path attenuation, injects interference and WLAN activity, or replays recorded radio signals.
Parallel pytest runs
Runs independent test scenarios concurrently through pytest-xdist.
Protocol capture artifacts
Produces HCI BTSnoop files, per-Controller radio captures and Ellisys traces for analysis.

Good for

  • Regression testing a Bluetooth Host stack against simulated peers
  • Reproducing interference or weak-signal conditions in a repeatable way
  • Checking advertising, scanning and GATT behaviour across several devices
  • Analysing HCI and radio traffic from Bluetooth test runs in Wireshark

Pricing

Open source

Open source under the Apache License 2.0.

BSWorld FAQ

Does BSWorld need Bluetooth hardware?

No. The README says it tests Host stacks through deterministic simulation, without hardware or changes to their source code.

Which operating systems are supported?

The README states BSWorld runs on Linux/x86_64.

Which Host stacks have integration suites?

The README lists suites for BlueZ, Zephyr Bluetooth shell, NuttX BTSak and NimBLE, Apache NimBLE Linux and TrouBLE.

How can I run the tests?

The README describes a Docker image that runs the integration tests, and a local Linux setup using Python 3.12, BabbleSim and pytest.

Is BSWorld free?

Yes. BSWorld is open source, so you can use and self-host it for free.

Where this comes from

  • Description: written from the project's README.