Ampy 使用教程

项目介绍

Ampy 是一个用于通过串行连接与 MicroPython 或 CircuitPython 开发板进行交互的工具。它允许用户在开发板上上传、下载和管理文件，以及执行 Python 脚本。Ampy 的设计目标是提供一个简单易用的命令行工具，以便用户能够轻松地与 MicroPython 开发板进行交互。

项目快速启动

安装 Ampy

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

pip3 install adafruit-ampy

配置环境变量

为了方便使用，可以设置一些环境变量，例如端口、波特率和延迟。

在 Linux 或 macOS 上：

export AMPY_PORT=/dev/tty.SLAB_USBtoUART
export AMPY_BAUD=115200
export AMPY_DELAY=0.5

在 Windows 上：

set AMPY_PORT=COM4
set AMPY_BAUD=115200
set AMPY_DELAY=0.5

基本命令

以下是一些基本的 Ampy 命令示例：

• 列出开发板上的文件：

ampy ls

• 上传文件到开发板：

ampy put example.py

• 从开发板下载文件：

ampy get example.py

• 在开发板上运行脚本：

ampy run example.py

应用案例和最佳实践

应用案例

1. 智能家居控制：使用 Ampy 将控制脚本上传到 MicroPython 开发板，实现对家中设备的远程控制。
2. 物联网数据采集：通过 Ampy 将数据采集脚本部署到开发板上，实时收集传感器数据并上传到云端。

最佳实践

1. 定期备份：定期使用 ampy get 命令备份开发板上的重要文件，以防数据丢失。
2. 模块化开发：将复杂的项目拆分为多个模块，使用 Ampy 分别上传和管理，提高代码的可维护性。

典型生态项目

相关工具

1. rshell：一个更高级的串行连接工具，支持类似 shell 的交互方式。
2. mpfshell：另一个用于与 MicroPython 开发板进行文件管理的工具，支持 WebREPL。

集成开发环境

1. Thonny：一个支持 MicroPython 的集成开发环境，提供图形化界面和调试功能。
2. Mu Editor：专为初学者设计的编辑器，支持 MicroPython 和 CircuitPython。

通过这些工具和环境的结合使用，可以大大提高开发效率和项目管理的便捷性。