encukou-ampy 1.0.7.1

encukou-ampy

这是adafruit-ampy的一个实验性分支，旨在修复Windows 10上的一个问题。

ampy

Adafruit MicroPython工具（ampy） - 通过串行连接与CircuitPython或MicroPython板交互的实用工具。

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

请注意，ampy的设计目的是简单，不支持像shell或终端这样的高级交互，用于向板发送输入。有关与板进行更多高级交互的其他MicroPython工具，请参阅rshell或mpfshell。

安装

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

pip3 install --user encukou-ampy

在Windows上，请执行以下操作

pip install encukou-ampy

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

sudo pip3 install encukou-ampy

如果您没有Python 3，则尝试使用Python 2与

pip install encukou-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 install（或开发模式）

python3 setup.py install

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

pip install mock

使用方法

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

ampy --port /dev/tty.SLAB_USBtoUART ls

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

还有其他命令可用，运行 ampy 并使用 --help 查看更多信息

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

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

要将这些变量自动设置为每次运行 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 文件放在您的当前工作目录中，其父目录之一，或者放在您的家目录中。