Metadata-Version: 2.1
Name: ectool
Version: 1.1.4
Summary: A tools for EC modules, like EC618/EC616/EC718
Home-page: https://github.com/openLuat/ectool2py
Author: Wendal Chen
Project-URL: Bug Reports, https://github.com/openLuat/ectool2py/issues
Project-URL: Source, https://github.com/openLuat/ectool2py/
Keywords: ec618,development
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.7, <4
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cstruct
Requires-Dist: pyserial
Requires-Dist: py7zr
Provides-Extra: dev
Requires-Dist: check-manifest ; extra == 'dev'
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'

# 移芯工具箱

支持移芯方案的刷机, 解包, windows/linux/macos 可用

当前支持EC618系列, 例如Air780E/Air700E等模块

## 用法

先安装ectool, 在命令行或控制台执行

```bash
# 清华镜像
pip3 install -U -i https://pypi.tuna.tsinghua.edu.cn/simple ectool
# 无镜像,或者系统默认镜像
pip3 install -U ectool
```

刷机(当前仅USB刷机), 支持binpkg和soc文件, 但暂不支持LuatOS的脚本刷机

```bash
ectool burn -f example.binpkg
# 启动后, 按住BOOT键, 复位模块, 或模块开机
```

更多参数执行 `ectool -h` 获取说明

## TODO List

* [x] EC618使用USB刷机
* [x] binpkg解包
* [x] 测试Linux下的兼容性
* [ ] EC618使用物理UART刷机
* [ ] 测试Mac下的兼容性
* [ ] 支持刷LuatOS的script.bin
* [ ] 支持只刷AP
* [ ] 完整的注释
* [ ] SoC日志解析

## Linux刷机过程展示

[![asciicast](https://asciinema.org/a/595464.svg)](https://asciinema.org/a/595464)

## 参考链接

* 流程参考 https://citeseerx.ist.psu.edu/document?repid=rep1&type=pdf&doi=483a9555e446577cefc31b5629e843cc814b83cb
* beanio做的逆向版本 https://github.com/beanjs/beanio-ec618-downloader

## 开源协议

MIT
