硬件

三个基站，一个标签，一台打印机。

所有部件均可在 Makerfabs 直接购买。外壳是参数化的 OpenSCAD：模块变了，外壳随之调整。

部件	作用	数量	来源
MaUWB ESP32S3（DW3000 + PA）	基站（固定在舞台周围）	最少 3 个，推荐 6 个，最多 8 个	Makerfabs
MaUWB Direct	标签（演员佩戴），或额外基站	每位演员 1 个	Makerfabs
USB-C 线	需支持数据传输，不能是仅充电线	每个基站 1 根	—
USB 电源，5 V 1 A 以上	基站供电	视布线而定	—
PLA 或 PETG 耗材	外壳	每个外壳几十克	—
激光测距仪	场地校准，毫米精度	1	您应该已经有了

最小套件 — 三个基站呈三角形布置（切勿排成一线），安装高度 2–3 m，一个标签 — 足以在剧场舞台上做 2D 定位。建议按六个基站规划：这是 Douze Dix-Huit 的配置。冗余可抵消人体或布景的遮挡，不同高度可开启 3D，而自动校准 — 基站以一个标签十字为基准自行测量，无需激光 — 的约束也更充分。详见指南：所需硬件。

可打印外壳

两件式：底座 + 卡扣盖，FDM 打印，无需支撑。为 MaUWB ESP32-S3 模块设计（PCB 73 × 33 × 12 mm）。OpenSCAD 源文件和 STL 在代码仓库中，采用 CERN-OHL-P v2 许可。

基站

基站外壳

正面开有 USB-C 和 OLED 窗口，UWB 天线区域留空。壁厚 2 mm，底面与盖板 1.6 mm。

模块

MaUWB ESP32-S3

材料

PLA 或 PETG

支撑

无

STL + SCAD重新生成

标签

标签外壳

演员佩戴。设计中。

模块

MaUWB Direct

状态

即将推出

照片

打印成品

首批组装完成的基站照片已在图库中；经验证的打印参数将随后发布于此。

正面 — 上盖开口中的 OLED 屏幕：标识符、最近一次测距、基站 IP 及其推送数据的 Topos 服务器。

基站固件

ESP32-S3 的 Arduino 固件：UWB 测距、配网页面连接 WiFi（换场馆无需重新烧录）、UDP 推流到 Topos、OLED 显示基站编号和 IP。每个基站烧录前只需改一个参数：它的编号。

更换场馆 — 在 10 秒内按两次 RST，即可清除已保存的 WiFi 并重新打开配网页面。另一个按钮 FLASH 仅用于烧录。详见第 2.4 节。

基站页面 — 每个基站都自带网页：已保存的网络、IP、测量数据目标地址，可更换 Topos 服务器或清除 WiFi——在控制室的任何浏览器中打开即可。

固件指南

Topos 不要求您做的事

不需要制作电路板，不需要焊接元件。模块到手即可烧录；标签通过 Topos 仪表盘配置，无需 Arduino IDE。有一台 3D 打印机打印外壳，就够了。