EMP-TOOL
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的所有内容,慎用。
Metadata
Release files for emptool 0.9.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| emptool-0.9.7-py3-none-any.whl | Python 3 | none | any | Details for emptool-0.9.7-py3-none-any.whl |
Release files / emptool-0.9.7-py3-none-any.whl
| Download URL | emptool-0.9.7-py3-none-any.whl |
|---|---|
| Size | 9.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb6b29746b17bd846a75b029053f492c18c7c35337390ff3dccf5fcbd9339da9
|
|
BLAKE2b-256 checksum How to use checksums |
bccdb11b4f5949cc8f95fc13da8cf2f5b8745c4ce7038c2c4ba55c1c8851cb84
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Python-urllib/3.7
|
Security for emptool 0.9.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.