# ext2-py-uwb-api

**Repository Path**: mind-plus/ext2-py-uwb-api

## Basic Information

- **Project Name**: ext2-py-uwb-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课程工具箱 - UWB（aicoursetoolsuwb）

`aicoursetoolsuwb` 是一个适用于 Mind+ V2 Python 积木模式的扩展，由爱方思（AiFangSi）同名 Mind+ V1.8 用户库 `ai_course_tools_uwb`（AI课程工具箱_UWB，V2.0.1）转换而来，配合 AIToolkit2 与 AI 课程使用。

该扩展提供 UWB（超宽带）标签定位积木：初始化 UWB 标签（指定 COM 串口号与基座距离）、按基座编号获取距离、获取与所有基座的距离列表、计算标签坐标。

本扩展无硬件 SKU，运行依赖本机 AIToolkit2 Python 环境中的 `aitoolkit.uwb` 模块与 UWB 硬件（扩展不声明 pip 依赖，与 V1 行为一致）。

## 积木

扩展共 5 个积木（UWB 分组）：

- 指定 Python 解释器（基础）
- 初始化 UWB 标签（串口编号 1-20，基座距离）
- 获取标签与基座距离（基座编码 1-4）
- 获取标签与所有基座距离
- 获取标签坐标

## 示例程序

V1 源库未包含示例工程文件，本仓库暂未提供可运行示例；典型用法：先「指定Python解释器」指向 AIToolkit2 的 primary 目录，初始化 UWB 标签后读取距离或坐标。

## 支持列表

本扩展为 Python 积木模式（`mode: "python-block"`），不绑定主板，在 Mind+ Python 模式下于 Windows 平台配合 AIToolkit2 与 UWB 硬件使用（V1 config 声明 `platform: ["win"]`）。

## 更新日志

### V2.0.1

- 由 Mind+ V1 用户库 `ai_course_tools_uwb` 2.0.1 完整转换为 Mind+ V2 扩展；积木名称、参数、默认值与生成代码行为保持一致（`compatibilityId: 爱方思-ai_course_tools_uwb-thirdex`）

## 开发指南

- 源码位于 `extension/`（index.js 积木定义、func.js 生成代码、public/ 配置与本地库、icon/ 图标、locales/ 翻译）。
- 本地 Python 库 `public/libraries/env.py`、`a.py` 负责按 `#env_path` 注释切换到 AIToolkit2 解释器运行生成的脚本。
- 初始化与编译：`npm install` 后 `npm run build`，产物在 `build/`。
- 更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)