终极ampy安装教程：3分钟上手MicroPython工具

终极ampy安装教程：3分钟上手MicroPython工具

【免费下载链接】ampyMicroPython Tool - Utility to interact with a MicroPython board over a serial connection.项目地址: https://gitcode.com/gh_mirrors/am/ampy

ampy（Adafruit MicroPython工具）是一款通过串口连接与CircuitPython或MicroPython开发板交互的命令行工具。它能轻松实现文件传输、代码执行等功能，是MicroPython开发者的必备工具。本教程将带你快速完成ampy的安装与基础配置，让你在3分钟内即可开始使用这个强大的工具。

准备工作：安装环境要求

在开始安装ampy前，请确保你的系统已满足以下要求：

• Python环境：支持Python 2.7.x或3.x版本（推荐Python 3以获得最佳体验）
• 依赖库：ampy需要以下Python库支持
  • click：命令行界面框架
  • pyserial：串口通信库
  • python-dotenv：环境变量管理工具

这些依赖会在安装ampy时自动安装，无需手动操作。

快速安装：3种方法任选

方法1：使用pip安装（推荐）

这是最简单快捷的安装方式，适用于大多数用户：

在MacOS或Linux系统，打开终端执行：

pip3 install --user adafruit-ampy

在Windows系统，打开命令提示符执行：

pip install adafruit-ampy

如果遇到权限问题（Linux/MacOS），可以尝试使用sudo：

sudo pip3 install adafruit-ampy

方法2：从源码安装

如果你需要最新开发版本，可以从Git仓库克隆源码安装：

git clone https://gitcode.com/gh_mirrors/am/ampy cd ampy python3 setup.py install

方法3：开发模式安装

如果你是开发者，想要修改ampy源码并实时测试，可以使用开发模式安装：

git clone https://gitcode.com/gh_mirrors/am/ampy cd ampy python3 setup.py develop

验证安装：确认ampy已正确安装

安装完成后，我们需要验证ampy是否可以正常运行。在终端或命令提示符中执行：

ampy --help

如果安装成功，你将看到ampy的帮助信息，包含版本号（当前最新为1.2.0）和可用命令列表：

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. mkdir Create a directory on the board. mv Rename/move a file or directory on the board. put Put a file or folder and its contents on the board. rm Remove a file from the board. rmdir Forcefully remove a folder and all its children from the board. run Run a script and print its output. reset Perform soft reset/reboot of the board.

基础配置：设置环境变量

为了避免每次使用ampy时都需要指定端口等参数，我们可以通过环境变量或配置文件进行设置。

临时环境变量设置

在Linux/MacOS系统，终端中执行：

export AMPY_PORT=/dev/tty.SLAB_USBtoUART # 替换为你的串口 export AMPY_BAUD=115200 # 波特率，默认115200 export AMPY_DELAY=0.5 # 延迟时间，部分系统需要设置

在Windows系统，命令提示符中执行：

set AMPY_PORT=COM4 # 替换为你的串口 set AMPY_BAUD=115200 set AMPY_DELAY=0.5

永久配置：使用.ampy文件

创建一个名为.ampy的文件，保存以下内容（根据你的实际情况修改）：

# 示例.ampy配置文件 # 请填写你的端口、波特率和延迟时间 AMPY_PORT=/dev/cu.wchusbserial1410 # Linux/MacOS示例 # AMPY_PORT=COM4 # Windows示例 AMPY_BAUD=115200 # macOS用户解决"Could not enter raw repl"问题，尝试0.5或更低值 AMPY_DELAY=0.5

将此文件保存到以下任一位置：

• 当前工作目录
• 工作目录的任意父目录
• 你的用户主目录

常见问题解决

权限问题

如果遇到"Permission denied"错误，可能是因为没有串口访问权限。在Linux系统中，可以将用户添加到dialout组：

sudo usermod -a -G dialout $USER

修改后需要注销并重新登录才能生效。

依赖冲突

如果安装过程中出现依赖冲突，可以尝试使用虚拟环境：

python3 -m venv ampy-env source ampy-env/bin/activate # Linux/MacOS # ampy-env\Scripts\activate # Windows pip install adafruit-ampy

端口识别

不知道开发板的串口名称？可以尝试以下方法：

Linux系统：

ls /dev/tty* | grep -i usb

MacOS系统：

ls /dev/cu.* | grep -i usb

Windows系统： 在设备管理器的"端口(COM和LPT)"中查看

开始使用ampy：常用命令示例

安装并配置完成后，你可以开始使用ampy与MicroPython开发板交互了。以下是一些常用命令：

• 列出开发板文件：

  ampy ls

• 上传文件到开发板：

  ampy put main.py

• 从开发板下载文件：

  ampy get boot.py

• 在开发板上创建目录：

  ampy mkdir lib

• 运行开发板上的脚本：

  ampy run test.py

• 重置开发板：

  ampy reset

总结

通过本教程，你已经掌握了ampy的安装方法、配置技巧和基本使用命令。ampy作为一款轻量级但功能强大的MicroPython工具，能够极大简化你的开发流程。无论是文件传输还是远程执行代码，ampy都能帮你轻松完成。

如果你想了解更多高级用法，可以查看项目中的README.md文件或探索ampy的命令帮助信息。祝你在MicroPython开发之路上取得成功！

【免费下载链接】ampyMicroPython Tool - Utility to interact with a MicroPython board over a serial connection.项目地址: https://gitcode.com/gh_mirrors/am/ampy