Pybricks开发者工具
项目描述
Pybricks工具和接口库
这是一个为Pybricks开发者提供的工具包。对于普通用户，我们推荐使用Pybricks Code Web IDE。
此包包含命令行工具和库，可以从Python脚本中调用等效操作。
安装
Python运行时
pybricksdev需要Python 3.10或更高版本。
- 对于Windows，请使用官方Python安装程序或Windows商店。
- 对于Mac，请使用官方Python安装程序或Homebrew（运行
brew install python@3.12）。 - 对于Linux，请使用发行版提供的
python3.12或如果不可用，则使用Python运行时版本管理器，如asdf或pyenv。
命令行工具
我们建议使用pipx来运行pybricksdev作为命令行工具。这确保您总是运行最新的pybricksdev版本。
我们还强烈建议按照官方pipx安装说明使用包管理器（如apt、brew等）安装pipx。
然后使用pipx运行pybricksdev
pipx run pybricksdev ...
如果您不喜欢总是输入pipx run ...，您可以安装
pipx install pybricksdev
然后您可以只输入
pybricksdev run ...
并使用以下命令检查更新
pipx upgrade pybricksdev
Windows用户
如果您正在使用Python Launcher for Windows（由官方Python安装程序默认安装），则您需要使用py -3而不是python3。
py -3 -m pip install --upgrade pip # ensure pip is up to date first
py -3 -m pip install pipx
py -3 -m pipx run pybricksdev ...
Linux USB
在Linux上，需要udev规则才能通过USB进行访问。pybricksdev命令行工具包含一个生成所需规则的函数。运行以下命令：
pipx run pybricksdev udev | sudo tee /etc/udev/rules.d/99-pybricksdev.rules
库
要作为库安装pybricksdev，我们强烈建议为您的项目使用虚拟环境。我们首选的工具是poetry。
poetry env use python3.12
poetry add pybricksdev
当然，您也可以始终使用pip。
pip install pybricksdev --pre
使用命令行工具
以下是一些如何使用pybricksdev命令行工具的示例。有关更多信息，请运行pybricksdev --help。
闪存Pybricks MicroPython固件
开启集线器，并运行
pipx run pybricksdev flash <firmware.zip>
将<firmware.zip>替换为固件存档的实际路径。
运行Pybricks MicroPython程序
这将编译MicroPython脚本并将其发送到带有Pybricks固件的集线器。
pipx run pybricksdev run --help
#
# ble connection examples:
#
# Run script on any Pybricks device
pipx run pybricksdev run ble demo/shortdemo.py
# Run script on the first device we find called Pybricks hub
pipx run pybricksdev run ble --name "Pybricks Hub" demo/shortdemo.py
# Run script on device with address 90:84:2B:4A:2B:75 (doesn't work on Mac)
pipx run pybricksdev run ble --name 90:84:2B:4A:2B:75 demo/shortdemo.py
#
# usb connection examples:
# NOTE: running programs via usb connection works for official LEGO firmwares only
# Run script on any Pybricks device
pipx run pybricksdev run usb demo/shortdemo.py
#
# Other connection examples:
#
# Run script on ev3dev at 192.168.0.102
pipx run pybricksdev run ssh --name 192.168.0.102 demo/shortdemo.py
编译Pybricks MicroPython程序而不运行
这可以用于编译程序。它不会像上面那样同时运行它们，而是仅在屏幕上打印输出。
pipx run pybricksdev compile demo/shortdemo.py
pipx run pybricksdev compile "print('Hello!'); print('world!');"
这主要面向希望快速检查.mpy文件内容的开发者。要获取实际文件，只需直接使用mpy-cross。我们过去曾使用此工具测试了没有内置编译器或任何形式的I/O的最基本的MicroPython端口。您可以直接将生成的const uint8_t script[]粘贴到您的C代码中。
其他文档
下载文件
下载适合您平台的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。
源代码分发
构建分发
pybricksdev-1.0.0a50.tar.gz 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 8e95290cd57bf573cedee1722f2497ece77b1127d10309966593191b31230333 |
|
| MD5 | bdc03fc7d0b4a141667094ec5bdcbec4 |
|
| BLAKE2b-256 | 5b7370cafc77acf05ae1b143b9a4572d3c6824499cc4164db2f516789c885ef6 |
pybricksdev-1.0.0a50-py3-none-any.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | fcd23e493da2ae1537d96e78a305e5cb1ff3d607a7b581b3f782cc379f7f7823 |
|
| MD5 | 94588ce5d8f849636fd2d472417f5c64 |
|
| BLAKE2b-256 | d5c1ff4ed8d4a6fc88220bb330c1a5389141310e2de20c1d9411d12981b21b1e |