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
应用案例和最佳实践
应用案例
- 智能家居控制:使用 Ampy 将控制脚本上传到 MicroPython 开发板,实现对家中设备的远程控制。
- 物联网数据采集:通过 Ampy 将数据采集脚本部署到开发板上,实时收集传感器数据并上传到云端。
最佳实践
- 定期备份:定期使用
ampy get
命令备份开发板上的重要文件,以防数据丢失。 - 模块化开发:将复杂的项目拆分为多个模块,使用 Ampy 分别上传和管理,提高代码的可维护性。
典型生态项目
相关工具
- rshell:一个更高级的串行连接工具,支持类似 shell 的交互方式。
- mpfshell:另一个用于与 MicroPython 开发板进行文件管理的工具,支持 WebREPL。
集成开发环境
- Thonny:一个支持 MicroPython 的集成开发环境,提供图形化界面和调试功能。
- Mu Editor:专为初学者设计的编辑器,支持 MicroPython 和 CircuitPython。
通过这些工具和环境的结合使用,可以大大提高开发效率和项目管理的便捷性。