adafruit-ampy 1.1.0

安培

MicroPython Tool (ampy) - 通过串行连接与 CircuitPython 或 MicroPython 板交互的实用程序。

Ampy 旨在成为一个简单的命令行工具，用于通过串行连接在 CircuitPython 或 MicroPython 板上操作文件和运行代码。使用 ampy，您可以将文件从您的计算机发送到开发板的文件系统，将文件从开发板下载到您的计算机，甚至可以将 Python 脚本发送到要执行的开发板。

请注意，ampy 的设计意味着简单，不支持高级交互，如外壳或终端将输入发送到板。查看其他 MicroPython 工具，如rshell 或mpfshell，以获得与板的更高级交互。

安装

您可以将 ampy 与 Python 2.7.x 或 3.x 一起使用，并且可以从 Python 的包索引轻松安装它。在 MacOS 或 Linux 上，在终端中运行以下命令（假设 Python 3）：

pip3 install --user adafruit-ampy

在 Windows 上，执行：

pip install adafruit-ampy

请注意，在某些 Linux 和 Mac OSX 系统上，您可能需要使用 sudo 以 root 身份运行：

sudo pip3 install adafruit-ampy

如果您没有 Python 3，请尝试使用 Python 2：

pip install adafruit-ampy

安装后验证您可以运行 ampy 程序并获得帮助输出：

ampy --help

您应该会看到如下所示的使用信息：

Usage: ampy [OPTIONS] COMMAND [ARGS]...

  ampy - Adafruit MicroPython Tool

  Ampy is a tool to control MicroPython boards over a serial connection.
  Using ampy you can manipulate files on the board's internal filesystem and
  even run scripts.

Options:
  -p, --port PORT  Name of serial port for connected board.  [required]
  -b, --baud BAUD  Baud rate for the serial connection. (default 115200)
  -d, --delay DELAY Delay in seconds before entering RAW MODE (default 0)
  --help           Show this message and exit.

Commands:
  get  Retrieve a file from the board.
  ls   List contents of a directory on the board.
  put  Put a file on the board.
  rm   Remove a file from the board.
  run  Run a script and print its output.

如果您想从 Github 源安装，请使用标准 Python setup.py 安装（或开发模式）：

python3 setup.py install

注意要在 Python 2 上运行单元测试，您必须安装模拟库：

pip install mock

用法

Ampy 通过其串行连接与 CircuitPython MicroPython 板通信。您将需要连接您的电路板并安装任何驱动程序来访问它的串行端口。然后例如列出板上的文件运行如下命令：

ampy --port /dev/tty.SLAB_USBtoUART ls

您应该会看到打印到终端的板根目录中的文件列表。请注意，您需要将端口参数更改为 MicroPython 板连接到的串行端口的名称或路径。

其他命令可用，使用 --help 运行 ampy 以查看更多信息：

ampy --help

每个子命令都有自己的帮助，例如查看 ls 命令运行的帮助（请注意，不幸的是，您必须连接板并指定串行端口）：

ampy --port /dev/tty.SLAB_USBtoUART ls --help

配置

为方便起见，您可以设置一个AMPY_PORT环境变量，如果未指定端口参数，将使用该变量。例如在 Linux 或 OSX 上：

export AMPY_PORT=/dev/tty.SLAB_USBtoUART
ampy ls

或者在 Windows（未经测试）上尝试 SET 命令：

set AMPY_PORT=COM4
ampy ls

同样，您可以在进入 RAW MODE 之前设置AMPY_BAUD和AMPY_DELAY控制波特率和延迟。

要在每次运行时自动设置这些变量ampy，请将它们复制到一个名为.ampy：

# Example .ampy file
# Please fill in your own port, baud rate, and delay
AMPY_PORT=/dev/cu.wchusbserial1410
AMPY_BAUD=115200
# Fix for macOS users' "Could not enter raw repl"; try 2.0 and lower from there:
AMPY_DELAY=0.5

您可以将.ampy文件放在您的工作目录、其父目录之一或您的主目录中。