ampy完全指南：如何通过串口轻松控制MicroPython开发板

ampy完全指南：如何通过串口轻松控制MicroPython开发板

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

ampy（Adafruit MicroPython Tool）是一款功能强大的实用工具，专为通过串口连接与MicroPython开发板交互而设计。无论是 CircuitPython 还是 MicroPython 开发板，ampy 都能让你轻松管理板上文件系统、执行代码，极大简化开发流程。

🚀 快速安装ampy：3种简单方法

ampy支持Python 2.7.x和3.x环境，安装过程非常简单，根据你的系统选择以下任一命令：

使用pip3安装（推荐Python 3）

pip3 install --user adafruit-ampy

使用pip安装（Python 2或3）

pip install adafruit-ampy

系统级安装（需要管理员权限）

sudo pip3 install adafruit-ampy

安装完成后，通过以下命令验证安装是否成功：

ampy --help

如果一切正常，你将看到ampy的使用信息和命令列表。

📝 核心功能与基础命令

ampy虽然设计简洁，但提供了丰富的功能来满足MicroPython开发需求。通过ampy --help可以查看所有可用命令，以下是最常用的核心功能：

1️⃣ 列出开发板文件系统

使用ls命令查看板上文件和目录：

ampy ls

2️⃣ 从开发板获取文件

使用get命令将文件从开发板下载到本地：

ampy get remote_filename.py local_filename.py

3️⃣ 向开发板上传文件

使用put命令将本地文件发送到开发板：

ampy put local_script.py

4️⃣ 在开发板上运行代码

使用run命令直接在开发板上执行本地Python文件：

ampy run test_script.py

⚙️ 高级配置与使用技巧

创建配置文件简化操作

为避免每次使用都输入串口参数，可以创建.ampy配置文件，保存常用设置：

[ampy] port = /dev/ttyUSB0 baud = 115200

源码安装与开发模式

如果你需要使用最新开发版本，可以从源码安装：

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

对于开发者，建议使用开发模式安装，以便修改代码后立即生效：

python3 setup.py develop

🧪 测试与故障排除

ampy提供了完整的测试套件，位于tests/目录下。运行测试前，请确保已安装必要的依赖：

pip install mock

常见问题解决：

• 串口访问权限：在Linux系统上，可能需要将用户添加到dialout组以获取串口访问权限
• 连接不稳定：尝试降低波特率或检查USB线缆连接
• 文件传输失败：确保开发板上有足够的存储空间

📌 总结

ampy作为一款轻量级但功能强大的MicroPython工具，为开发者提供了便捷的开发板交互方式。通过简单的命令，你可以轻松管理文件、执行代码，专注于创意实现而非繁琐的设备交互。无论是MicroPython新手还是经验丰富的开发者，ampy都能显著提升你的开发效率。

要了解更多高级功能和最新更新，请查看项目源码中的PLAN.md文件，其中包含了ampy的发展规划和功能路线图。

开始使用ampy，让你的MicroPython开发之旅更加顺畅！

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