
小米开源 BSWorld:无需硬件,AI 智能体可模拟测试蓝牙代码
来源标题:Show HN: BSWorld – AI agents can now test Bluetooth code without hardware
小米发布 BSWorld,通过确定性模拟在 Linux 上测试蓝牙 Host 与应用程序,使 AI 智能体无需真实硬件即可完成验证。开发者可在 pytest 中定义拓扑与预期行为,Host 经 H4 HCI 连接 BSController,并通过共享的 BabbleSim 射频通信。Docker 镜像已内置 BabbleSim、32 位 UML 内核和 Guest 根文件系统,运行结果包含 pytest.xml、HCI 抓包和射频轨迹。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
BSWorld 通过确定性仿真在 Linux 上测试蓝牙 Host 和应用程序。在 pytest 中定义拓扑结构和预期行为。Host 通过 H4 HCI 连接到 BSController,并通过共享的 BabbleSim 射频进行通信。
Docker 镜像内置了 BabbleSim、一个 32 位 UML 内核,以及带有 Host 可执行文件的 Guest 根文件系统。在装有 Docker Engine 的主机上,从仓库根目录运行集成测试。
sudo docker pull ghcr.io/xiaomi/bsworld-linux:latest mkdir -p .cache/docker-results
镜像以 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
.cache/docker-results 中的结果包括 pytest.xml、进程日志、HCI 抓包和射频跟踪。有关套件选择、镜像版本和本地构建的信息,请参阅 Docker 指南。
开发和测试需要 Python 3.12 或更高版本。在 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
克隆 BSWorld 并在虚拟环境中安装。
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]'
运行开发检查。
ruff check . ruff format --check . pytest tests/unit -q
构建与测试
获取 components/babblesim.xml 中锁定的 BabbleSim 版本。
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
设置构建路径并编译 BabbleSim。
export BSIM_OUT_PATH="$PWD/build" export BSIM_COMPONENTS_PATH="$PWD/components" export BSIM_BUILD_FAIL_ASAP=1 make -j"$(nproc)" everything
从仓库根目录运行 BabbleSim 集成测试。在新 shell 中激活 .venv,并在运行测试前恢复 BSWORLD_ROOT 和 BSIM_OUT_PATH。
cd "$BSWORLD_ROOT" pytest tests/integration/babblesim -n auto
要在本地运行 Host 集成套件,请按照 UML 测试环境指南准备一个 32 位 Guest。
每个套件在 UML Guest 中运行其 Host,并在同一仿真射频上针对 Bumble 进行测试。
每个 Host 通过 H4 HCI 连接到各自的 BSController。各 Controller、pytest 时钟以及任何配置的干扰源共享一个 BabbleSim PHY。
Bumble 运行在 pytest 事件循环中。每个 UML Guest 在独立进程中运行,并通过各自的时间旅行套接字从该事件循环接收仿真时间。一个拓扑可以同时运行多个 Guest。
要设置每个 Controller 的选项(如设备地址、缓冲区大小和蓝牙版本),请参阅 BSController 配置。
在 Wireshark 中打开 hciN.snoop 和 radioN.pcapng,以检查 Controller 的 HCI 流量和射频活动。共享的 babblesim/ellisys.bttrp 为 Ellisys 收集 BSController 传输数据。有关抓包范围和文件位置的信息,请参阅日志、跟踪和抓包。
时间基准 含义 仿真时间 当所有 PHY 参与方同步时推进。它管控协议定时器、数据包时序、射频事件、asyncio 等待和测试超时。 壁钟时间 衡量主机上的测试持续时间,随 CPU 负载和 Linux 调度而变化。
启动后,标准 asyncio 等待和超时使用仿真时间。示例请参阅异步等待与仿真时间。
可重复性假设二进制文件和输入相同,且随机源受控。外部网络、由壁钟驱动的服务以及其他未适配的 Host I/O 仍可能引入非确定性。
编写测试并配置射频场景 分配和配置 BSController 查找日志、跟踪和抓包 运行单元测试、lint 检查和覆盖率 构建或运行 Docker 测试镜像 社区 贡献 行为准则 安全策略 许可证
BSWorld 在 Apache License 2.0 下授权。有关第三方许可证的信息,请参阅第三方声明。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。