cd /news/developer-tools/show-hn-bsworld-ai-agents-can-now-te… · home › topics › developer-tools › article
[ARTICLE · art-173093] src=github.com ↗ pub= topic=developer-tools verified=true sentiment=↑ positive

Show HN: BSWorld – AI agents can now test Bluetooth code without hardware

Xiaomi has released BSWorld, an open-source tool that tests Bluetooth Host stacks and applications on Linux through deterministic simulation, letting developers run BlueZ, Zephyr, NuttX, Apache NimBLE and TrouBLE suites without hardware or source-code changes. BSWorld connects Hosts to a BSController over H4 HCI and communicates over a shared BabbleSim radio, supporting path attenuation, injected interference and WLAN activity, and replay of recorded radio signals, with parallel scenarios via pytest-xdist. The Docker image ghcr.io/xiaomi/bsworld-linux:latest ships BabbleSim, a 32-bit UML kernel and a Guest root filesystem, and development requires Python 3.12 or newer on Ubuntu 24.04.

key takeaway

BSWorld runs Bluetooth Host stacks such as BlueZ, Zephyr and NimBLE against Bumble on a shared BabbleSim radio inside a 32-bit UML Guest, so integration tests need no physical hardware and no source changes.

read3 min views4 publishedNov 20, 2026
Show HN: BSWorld – AI agents can now test Bluetooth code without hardware
Image: Michielbdejong (auto-discovered)

BSWorld tests Bluetooth Hosts and applications on Linux through deterministic simulation. Define the topology and expected behavior in pytest. Hosts connect to BSController over H4 HCI and communicate over a shared BabbleSim radio.

  • Test open-source Host stacks without hardware or changes to their source code.
  • Run multiple devices on one simulation clock. Run independent scenarios in parallel with pytest-xdist.
  • Set path attenuation, inject interference and WLAN activity, or replay recorded radio signals.
  • Inspect application logs, HCI BTSnoop captures, per-Controller radio captures, and shared Ellisys traces.

BSWorld runs on Linux/x86_64.

The Docker image ships with BabbleSim, a 32-bit UML kernel, and a Guest root filesystem with the Host executables. Run the integration tests from the repository root on a host with Docker Engine.

sudo docker pull ghcr.io/xiaomi/bsworld-linux:latest
mkdir -p .cache/docker-results
sudo chown 1000:1000 .cache/docker-results
sudo docker run --rm \
  --security-opt seccomp=docker/uml-seccomp.json \
  --mount "type=bind,src=$PWD/.cache/docker-results,dst=/output" \
  ghcr.io/xiaomi/bsworld-linux:latest

The results in .cache/docker-results include pytest.xml, process logs, HCI captures, and RF traces. For suite selection, image versions, and local builds, see the Docker guide.

Development and tests require Python 3.12 or newer. Install these tools on Ubuntu 24.04.

sudo apt-get update
sudo apt-get install -y \
  bash ca-certificates curl git repo file make binutils build-essential \
  python3.12 python3.12-dev python3.12-venv python3-pip \
  gcc-multilib g++-multilib coreutils findutils grep sed

Clone BSWorld and install it in a virtual environment.

git clone https://github.com/XiaoMi/bsworld.git
cd bsworld
export BSWORLD_ROOT="$PWD"
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -e components/bscontroller -e '.[test]'

Run the development checks.

ruff check .
ruff format --check .
pytest tests/unit -q

Fetch the BabbleSim revisions pinned in components/babblesim.xml.

mkdir -p "$BSWORLD_ROOT/.cache/babblesim"
cd "$BSWORLD_ROOT/.cache/babblesim"
repo init --standalone-manifest --depth=1 -u "file://$BSWORLD_ROOT/components/babblesim.xml"
repo sync -c --no-tags

Set the build paths and compile BabbleSim.

export BSIM_OUT_PATH="$PWD/build"
export BSIM_COMPONENTS_PATH="$PWD/components"
export BSIM_BUILD_FAIL_ASAP=1
make -j"$(nproc)" everything

Run the BabbleSim integration tests from the repository root. In a new shell, activate .venv and restore BSWORLD_ROOT and BSIM_OUT_PATH before running the tests.

cd "$BSWORLD_ROOT"
pytest tests/integration/babblesim -n auto

To run the Host integration suites locally, prepare a 32-bit Guest as described in the UML test environment guide.

Each suite runs its Host in a UML Guest and tests it against Bumble on the same simulated radio.

Guest Host Coverage
BlueZ Multi-Guest advertising, scanning, connection and disconnection
Zephyr Bluetooth shell Advertising, scanning, GATT, pairing, privacy, link updates, periodic advertising and sync transfer
NuttX BTSak and NimBLE Advertising, multi-device scanning, interference recovery, GATT reads, writes and notifications
Apache NimBLE Linux Discovery and connection
TrouBLE Battery Service discovery, reads, and notifications in both roles

Each Host connects to its own BSController over H4 HCI. The Controllers, the pytest clock, and any configured interference sources share a BabbleSim PHY.

Bumble runs in the pytest event loop. Each UML Guest runs in a separate process and receives simulation time from that loop through its own time-travel socket. A topology can run several Guests together.

To set per-Controller options such as device address, buffer sizes, and Bluetooth version, see BSController configuration.

Open hciN.snoop and radioN.pcapng in Wireshark to inspect a Controller's HCI traffic and radio activity. The shared babblesim/ellisys.bttrp collects BSController transmissions for Ellisys. For capture scope and file locations, see Logs, traces, and captures.

Time base Meaning
Simulation time Advances when all PHY participants synchronize. It governs protocol timers, packet timing, RF events, asyncio waits, and test timeouts.
Wall-clock time Measures test duration on the host and varies with CPU load and Linux scheduling.

After startup, standard asyncio waits and timeouts use simulation time. See Async waiting and simulation time for examples.

Repeatability assumes identical binaries and inputs and controlled random sources. External networks, wall-clock-driven services, and other unadapted Host I/O can still introduce nondeterminism.

BSWorld is licensed under the Apache License 2.0. For third-party licenses, see Third-Party Notices.

── more in #developer-tools 4 stories · sorted by recency
── more on @xiaomi 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/show-hn-bsworld-ai-a…] indexed:0 read:3min 2026-11-20 · —