该使用说明主要描述如何使用Ymodem协议通过串口向模组传输文件，需要模组的接收端处于接收模式才可以传输，该协议传输规范符合标准Ymodem 1K的传输规范，整体代码由python实现，接收端为QuecPython模块，模块端代码由QuecPython代码编写
适用系统
- Windows
- Linux
协议传输参考Ymodem协议实现，代码实现参考 Pypi的xmodem模块，在xmodem协议的基础上实现了ymodem协议传输，新增特性支持单次连接传输多个文件，并且基于QuecPython做了众多适配，不再适用于传统的xmodem模式
python代码依赖库（python版本>3.0)
- os
- time
- serial
调用方法，在代码中调用如下函数
# port为要传输的串口,filepath为文件本地路径,remote_filepath为传输到模组中的路径(绝对路径)
send_file(port, [filepath, remote_filepath]...)
# 当需要传多个文件时，参数累加文件列表即可如果想调整Ymodem传输模式，参照以下方法修改（推荐使用默认参数，QuecPython环境下只可使用rzsz、rbsb、pram）
KMD/IMP 详见官方文档
YMODEM传输模式，默认使用program为rzsz，文件头长度为128字节，文件体长度为1024字节，即 mode为 ymodem1k
| Program | Length | Date | Mode | S/N | 1k-Blk | YMODEM-g |
|---|---|---|---|---|---|---|
| Unix rz/sz | yes | yes | yes | no | yes | sb only |
| VMS rb/sb | yes | no | no | no | yes | no |
| Pro-YAM | yes | yes | no | yes | yes | yes |
| CP/M YAM | no | no | no | no | yes | no |
| KMD/IMP | ？ | no | no | no | yes | no |
若要修改默认program，需要在send_file函数代码中增加初始化参数
sender = Modem(sender_read, sender_write，"rzsz") # 可选参数: rzsz|rbsb|pyam|cyam|kimp回调参数：
| 参数（按顺序） | 描述 |
|---|---|
| total packets | 待发送的文件总大小 |
| success packets | 发送成功的包总大小 |
exe可执行文件，使用方法
至少需要两个参数，参数一为要传输的模块交互口串口号，格式COMXX；参数二为要传的文件信息，格式要求：
[run_std_1.log, /usr/run_std_1.log]
逗号前的参数为需要传入的文件的本地路径，建议使用绝对路径，逗号后的为传入到模块内的文件路径，必须使用绝对路径（模块内没有的路径会新建），参数前后使用中括号括起来，如果有多个文件按照这个格式在命令行中追加即可
后续多文件的传输将以 -F 文件名的形式来传入参数，在文件中按指定格式编辑即可
ymodem.exe "COM63" "[run_std_1.log, /usr/run_std_1.log]" ...注意:使用前需要模组端先传入接收协议代码,当前为demo测试版本需要自行传入，后续集成至固件之后不需要进行此步操作
- 输出 QuecPython File Download Success 表示成功
- 输出 QuecPython File Download Failure 表示失败
将文件包中ymodem.py代码传入模块中即可
模组端使用只需进入传输模式即可
enter_ymodem(callback=None)
传输模式会等待10s，10s后没有数据传入就退出传输模式
回调参数：
| 参数（按顺序） | 描述 |
|---|---|
| filename | 传输完成的文件名 |
| filesize | 传输文件的大小 |