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. 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 https://docs.docker.com/engine/install/ubuntu/ . sudo docker pull ghcr.io/xiaomi/bsworld-linux:latest mkdir -p .cache/docker-results The image runs as UID/GID 1000. 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 https://github.com/XiaoMi/bsworld/blob/main/docker/README.md . 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 https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/README.md . Each suite runs its Host in a UML Guest and tests it against Bumble on the same simulated radio. | Guest Host | Coverage | |---|---| | BlueZ https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/bluez/README.md | Multi-Guest advertising, scanning, connection and disconnection | | Zephyr Bluetooth shell https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/zephyr/README.md | Advertising, scanning, GATT, pairing, privacy, link updates, periodic advertising and sync transfer | | NuttX BTSak and NimBLE https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/nuttx/README.md | Advertising, multi-device scanning, interference recovery, GATT reads, writes and notifications | | Apache NimBLE Linux https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/nimble/README.md | Discovery and connection | | TrouBLE https://github.com/XiaoMi/bsworld/blob/main/tests/integration/uml/trouble/README.md | 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 https://github.com/XiaoMi/bsworld/blob/main/docs/controllers.md . 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 https://github.com/XiaoMi/bsworld/blob/main/docs/artifacts.md . | 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 https://github.com/XiaoMi/bsworld/blob/main/docs/writing-tests.md 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 https://github.com/XiaoMi/bsworld/blob/main/LICENSE . For third-party licenses, see Third-Party Notices https://github.com/XiaoMi/bsworld/blob/main/THIRD PARTY NOTICES.md .