emptool 0.9.0

Easy MicroPython toolchain

emptool 是一个由 1Z实验室 开发的 MicroPython 的命令行工具。

基本功能

• 更灵活的文件及文件夹的传输，支持 PC <==> MicroPython 间的双向传输

• 获取 MicroPython 文件系统目录

• 直接查看 MicroPython 文件系统中的某个文件内容

• MicroPython 文件系统的递归删除

• PC 端 pip 辅助安装 Pypi 上的扩展

安装

pip install emptool

快速开始

向 MicroPython 设备传输文件

sudo emptool put --target=example.py --device=/dev/ttyUSB0

以上指令将文件exmaple.py传输到MicroPython的根目录下

sudo emptool put --target=example.py --path=/lib --device=/dev/ttyUSB0
# 或者可简写为：
sudo emptool put example.py /lib --device=/dev/ttyUSB0

以上指令将文件example.py传输到MicroPython的/lib目录下

从 MicroPython 设备下载指定文件到PC的指定目录下

sudo emptool get --target=boot.py --path=~/Test/boot.py --device=/dev/ttyUSB0
# 或者可简写为：
sudo emptool get boot.py ~/Test/boot.py --device=/dev/ttyUSB0

以上指令将MicroPython文件系统中根目录下的boot.py下载到PC上的～/Test目录下。

PC 到 MicroPython 设备端的指定工程目录的同步传输

sudo emptool sync --target=./lib --path=/lib --device=/dev/ttyUSB0
# 或者可简写为：
sudo emptool sync ./lib /lib --device=/dev/ttyUSB0

以上指令可将PC当前目录下lib文件夹中的所有内容，全部同步传输到MicroPython的/lib目录下

MicroPython 设备到 PC 端的指定工程目录的下载

sudo emptool download --target=/ --path=~/Test --device=/dev/ttyUSB0
# 或者可简写为：
sudo emptool download / ~/Test --device=/dev/ttyUSB0

以上指令可以将MicroPython根目录下的所有内容，同步下载到PC的～/Test目录下

PC 端 pip 辅助安装 Pypi 上的扩展

由于8266之类的内存太少，导致无法使用upip进行正常的下载,或者说那些根本不带Wifi模块的MicriPython设备而言,可以在与PC串口连接的情况下让PC辅助进行安装。

sudo emptool pip_install --pkg=emp-ext --path=/lib --device=/dev/ttyUSB0
# 或者可简写为：
sudo emptool pip_install emp-ext /lib --device=/dev/ttyUSB0
# 安装的目录默认为/lib，如果不特定指定为其他目录，因此path参数也可以省略：
sudo emptool pip_install emp-ext --device=/dev/ttyUSB0

以上的指令将会从Pypi上寻找 名为emp-ext的包，并下载解压后，按照指定的路径同步传输到MicroPython的文件系统中。

设置文件传输速率

在以上关于文件传输的指令中，默认的缓冲区大小为1024，这个参数我们可以人为的进行设定，以便来根据不同的设备最大化传输效率,这对于那些较大的脚本而言，极为有效。

# 以从PC端获取MicroPython下的boot.py为例
sudo emptool get boot.py ~/Test/boot.py --device=/dev/ttyUSB0 --buffer=2048

显示指定目录下的文件列表

# 不指明路径参数时，默认会列出MicroPython文件系统根目录下所有的内容
sudo emptool ls --device=/dev/ttyUSB0
# 罗列/lib目录下的内容
sudo emptool ls --dir=/lib --device=/dev/ttyUSB0
# 或简写为：
sudo emptool ls /lib --device=/dev/ttyUSB0

在终端中直接打印出某个文件中的内容

# 例如查看boot.py
sudo emptool showcode --target=/boot.py --device=/dev/ttyUSB0 --buffer=2048
# 或者简写为
sudo emptool showcode boot.py --device=/dev/ttyUSB0

删除指定目录内的所有内容

该功能只在方便的对MicroPython设备文件系统中指定目录内的所有内容进行递归删除。如果指定为根目录，将忽略boot.py

sudo emptool clear --path=/ --device=/dev/ttyUSB0
# 或者可简写为
sudo emptool clear / --device=/dev/ttyUSB0

以上的指令将删除除了boot.py的所有内容，慎用。