【亲测免费】 Ampy 项目使用教程

1. 项目介绍

Ampy 是一个用于与 MicroPython 开发板进行交互的命令行工具。通过 Ampy，用户可以在计算机与 MicroPython 开发板之间传输文件、运行脚本以及管理开发板的文件系统。Ampy 的设计初衷是提供一个简单易用的工具，帮助开发者更高效地与 MicroPython 开发板进行交互。

2. 项目快速启动

安装 Ampy

首先，确保你已经安装了 Python 3。然后，使用 pip 安装 Ampy：

pip3 install --user adafruit-ampy

如果你使用的是 Windows 系统，可以使用以下命令：

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.

基本使用

假设你已经将 MicroPython 开发板连接到计算机，并且知道它的串口名称（例如 /dev/ttyUSB0），你可以使用以下命令列出开发板上的文件：

ampy --port /dev/ttyUSB0 ls

你还可以将本地文件上传到开发板：

ampy --port /dev/ttyUSB0 put example.py

3. 应用案例和最佳实践

应用案例

Ampy 可以用于多种场景，例如：

• 文件传输：将 Python 脚本上传到 MicroPython 开发板，以便在板上运行。
• 固件更新：通过 Ampy 将新的固件文件上传到开发板，实现固件更新。
• 数据采集：将传感器数据从开发板下载到计算机进行分析。

最佳实践

• 环境变量配置：为了方便使用，可以将 AMPY_PORT 环境变量设置为开发板的串口名称，这样每次使用 Ampy 时就不需要指定 --port 参数。

  export AMPY_PORT=/dev/ttyUSB0
  

• 批量操作：使用脚本自动化文件上传和下载操作，提高工作效率。

4. 典型生态项目

Ampy 是 MicroPython 生态系统中的一个重要工具，与之相关的典型生态项目包括：

• rshell：一个功能更强大的 MicroPython 交互工具，支持类似 shell 的交互方式。
• mpfshell：另一个用于与 MicroPython 开发板进行文件管理的工具，支持 FTP 和串口连接。
• uPyCraft：一个图形化的 MicroPython 开发环境，集成了文件管理、代码编辑和调试功能。

这些工具可以与 Ampy 结合使用，提供更全面的开发体验。