c语言的串口ymodem程序,ymodem源码（基于C语言实现）

短命女 2022-10-14 05:25 777阅读 0赞

![bedab9118ad8538115f45a48a1acafcf.png][]

基于类串口通信的文件传输协议，ymodem应用非常广泛，比如在MCU IAP中，常用的就是这种协议。ymodem是xmodem的改进版协议，具有传输快速稳定的优点。它可以一次传输1024字节的信息块，同时还支持传输多个文件。

本文ymodem源码基于C语言，采用回调机制，设计为独立的C库，包含了发送端和接收端的实现。

YMODEM协议简介

YMODEM源码简介

/\*

\* ymodem.h

\*

\* COPYRIGHT (C) 2019. All rights reserved.

\*

\* Created on: 2019-06-05

\* Author: gyr

\*

\* \\briefYMODEM协议库实现

\*

\* YMODEM文件传输过程:

\*

\* 发送端 接收端

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< C

\* SOH 00 FF \[filename 00\] \[filesize 00\] \[NUL..\] CRCH CRCL >>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< C

\* SOH 00 FF \[filename 00\] \[filesize 00\] \[NUL..\] CRCH CRCL >>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< C

\* STX 01 FE data\[1024\] CRC CRC>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* STX 02 FD data\[1024\] CRC CRC>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* STX 03 FC data\[1024\] CRC CRC>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* STX 04 FB data\[1024\] CRC CRC>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* SOH 05 FA data\[100\] 1A\[28\] CRC CRC>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* EOT >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< NAK

\* EOT>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< C

\* SOH 00 FF NUL\[128\] CRC CRC >>>>>>>>>>>>>>>

\* <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ACK

\*

\* 上述中：

\* filename：字符串

\* filesize：文件大小，字符串格式

\* NUL：填充为0x00

\* CRC：先传CRC高字节，再传低字节

\*/

\#ifndef YMODEM\_H\_

\#define YMODEM\_H\_

/\*\*

\* Make sure we can call this stuff from C++.

\*/

\#ifdef \_\_cplusplus

extern "C" \{

\#endif

/\*\*

\* Provide the ability to override linkage features of the interface.

\*/

\#ifndef YMODEM\_EXTERN

\# define YMODEM\_EXTERN extern

\#endif

\#ifndef YMODEM\_API

\# define YMODEM\_API

\#endif

/\*\*

\* Ensure these symbols were not defined by some previous header file.

\*/

\#ifdef YMODEM\_VERSION

\# undef YMODEM\_VERSION

\#endif

\#ifdef YMODEM\_VERSION\_NUMBER

\# undef YMODEM\_VERSION\_NUMBER

\#endif

/\*\*

\* YMODEM库版本号

\*

\* \[YMODEM\_VERSION\]

\*

\* 字符串格式版本号，格式为：X.Y.Z，其中，X为主版本号；Y为次版本号；Z为发布版本号

\*

\* \[YMODEM\_VERSION\_NUMBER\]

\*

\* 整数版本号：(X\*1000000 + Y\*1000 + Z)

\* 对于任何一个版本，该宏的值总是比前一个版本的值大。当Y操持不变时，Z递增；当Y递增时，Z归位为0

\*/

\#define YMODEM\_VERSION"1.0.0"

\#define YMODEM\_VERSION\_NUMBER 1000000

/\*\*

\* These interfaces provide the same information as the \[YMODEM\_VERSION\],

\* \[YMODEM\_VERSION\_NUMBER\]

\*/

YMODEM\_API YMODEM\_EXTERN const char ymodem\_version\[\];

YMODEM\_API const char \*ymodem\_libversion();

YMODEM\_API int ymodem\_libversion\_number();

/\*\*

\* Result Codes: result code definitions

\*

\* Many YMODEM functions return an integer result code from the set shown

\* here in order to indicate success or failure.

\*

\* New error codes may be added in future versions of YMODEM.

\*/

typedef int ymodem\_rt\_t;

\#define YMODEM\_RT\_OK0/\* Successful result \*/

/\* beginning-of-error-codes \*/

\#define YMODEM\_RT\_ERR1/\* Generic error \*/

/\* end-of-error-codes \*/

/\* 定义日志级别 \*/

\#define YM\_LOG\_LVL\_DBG 0// 调试级别

\#define YM\_LOG\_LVL\_INFO 1// 辅助级别

\#define YM\_LOG\_LVL\_WARN 2// 警告级别

\#define YM\_LOG\_LVL\_ERROR 3// 错误级别

// -----------------------------------------------------------------------------

typedef struct ymodem\_mgr ymodem\_mgr\_t;

typedef struct ymodem\_callbackymodem\_callback\_t;

struct ymodem\_callback

\{

/\*\*

\* \\brief接收数据回调接口

\*

\* @param buff接收缓存

\* @param len接收缓存字节长度

\* @param timeout接收超时时间，单位：ms

\*/

int (\*recv\_data)(char\* buff, int len, int timeout);

/\*\*

\* \\brief发送数据回调接口

\*

\* @param buff发送缓存

\* @param len发送缓存字节长度

\*/

int (\*send\_data)(const char\* buff, int len);

/\*\*

\* \\brief日志输出接口，如果未定义，则不打印输出任何日志信息，即使错误信息

\*/

void (\*write\_log)(int logLevel, const char \*file, int line,

const char \*fmt, ...);// const \_\_attribute\_\_((format(printf,5,6)));

\};

typedef struct ymodem\_cfg ymodem\_cfg\_t;

struct ymodem\_cfg

\{

/\*\*

\* \\brief传输数据时，指定接收超时时间，单位：ms

\*/

inttimeout;

/\*\*

\* \\briefYMODEM数据块大小

\* 标准YMODEM协议采用128/1024字节大小数据块传输文件

\*

\* @param blk\_size

\* 0：采用标准YMODEM数据块大小

\* \[20-1024\]：自定义字节大小的YMODEM数据库(非标准)

\* 自定义的YMODEM数据块大小必须满足 >= 文件名+字符串格式文件字节大小，否则会出错

\* > 1024：N/A

\*/

charblk\_size;

\};

/\*\*

\* \\brief开始接收回调函数

\*

\* @param filename准备接收的文件名

\* @param filesize准备接收的文件大小，单位：byte

\*/

typedef ymodem\_rt\_t cb\_on\_receive\_begin(const char \*filename, unsigned int filesize);

/\*\*

\* \\brief接收文件数据回调函数

\*/

typedef ymodem\_rt\_t cb\_on\_receive\_packet(const unsigned char \*filedata, unsigned int length);

/\*\*

\* \\brief获取要传输的文件数据的回调函数

\*

\* @param filedata存储文件数据的缓存

\* @param length filedata的字节长度

\* @param transmited\_size当前已传输字节数，可用作文件偏移

\*/

typedef ymodem\_rt\_t cb\_on\_transmit\_packet(unsigned char \*filedata, unsigned int length, const unsigned int transmited\_size);

/\*\*

\* \\brief文件传输完成回调函数

\*/

typedef ymodem\_rt\_t cb\_on\_end(unsigned int transmited\_size);

// -----------------------------------------------------------------------------

/\*\*

\* \\brief打开、关闭 ymodem对象，涉及内存分配，必须成对使用

\*/

YMODEM\_API ymodem\_rt\_t ymodem\_open(ymodem\_mgr\_t \*\*ym, ymodem\_callback\_t \*callback, ymodem\_cfg\_t \*cfg);

YMODEM\_API ymodem\_rt\_t ymodem\_close(ymodem\_mgr\_t \*ym);

/\*\*

\* \\brief使用YMODEM协议接收文件

\*

\* @param ymymodem对象指针

\* @param on\_begin开始接收回调函数

\* @param on\_packet接收文件数据回调函数

\* @param on\_end文件接收完成回调函数

\* @param handshake\_timeout等待超时时间，单位：秒

\*/

YMODEM\_API ymodem\_rt\_t ymodem\_receive(ymodem\_mgr\_t \*ym,

cb\_on\_receive\_begin \*on\_begin,

cb\_on\_receive\_packet \*on\_packet,

cb\_on\_end \*on\_end,

const int handshake\_timeout);

/\*\*

\* \\brief使用YMODEM协议传输文件

\*

\* \\input

\* @ymymodem对象指针

\* @param filename要传输的文件名称

\* @param filesize要传输的文件字节大小

\* @param on\_packet获取要传输的文件数据

\* @param on\_end文件传输完成回调函数

\* @param handshake\_timeout等待接收端CCC超时时间，单位：秒

\*/

YMODEM\_API ymodem\_rt\_t ymodem\_transmit(ymodem\_mgr\_t \*ym,

const char \*filename, unsigned int filesize,

cb\_on\_transmit\_packet \*on\_packet,

cb\_on\_end \*on\_end,

const int handshake\_timeout);

/\*

\*\* END OF REGISTRATION API

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

\#ifdef \_\_cplusplus

\} /\* end of the 'extern "C"' block \*/

\#endif

\#endif /\* YMODEM\_H\_ \*/

// -----------------------------------------------------------------------------

// End of ymodem.h

YMODE源码

请等待本人上传github。

» 文章出处：

reille博客—http://velep.com

, 如果没有特别声明，文章均为reille博客原创作品

» 郑重声明：

原创作品未经允许不得转载，如需转载请联系reille\#qq.com(\#换成@)

分享到：

[bedab9118ad8538115f45a48a1acafcf.png]: /images/20221014/8a9a97ae18864c249c5425a909ebba19.png

发表评论取消回复

表情：

评论列表（有 0 条评论，777人围观）

还没有评论，来说两句吧...

相关阅读

相关 c语言串口源码,单片机通过串口与电脑连接通信C语言源代码

该楼层疑似违规已被系统折叠隐藏此楼查看此楼 \include \define uchar unsigned char uchar time,b\_break,b\_b

红太狼/ 2023年01月22日 14:54/ 0 赞/ 186 阅读

相关 c语言串口源码,C语言串口测试程序代码

http://www.open-open.com/code/view/14319342653962015.05\include unsigned int UART0\_ADD

╰+哭是因爲堅強的太久メ/ 2023年01月22日 14:49/ 0 赞/ 244 阅读

相关 YModem协议解析-基于STM32的IAP实现

-------------------- 这是以前就想写的一个小专题关于IAP，以及IAP在STM32编程的应用，专题分三小节，主要介绍常见的单片机烧录方式，IAP的实际

た入场券/ 2023年01月21日 11:25/ 0 赞/ 31 阅读

相关 vb6源码 ymodem_VB爱好者乐园(VBGood)

《仿 Microsoft 屏幕键盘》软件及作者简介公开源代码，与跟我一样初涉VB的人一起共勉！设计初衷：Windows ME 以上版本的操作系统中，都带有一款辅助工具

朴灿烈づ我的快乐病毒、/ 2023年01月09日 12:57/ 0 赞/ 180 阅读

相关 ymodem协议c实现

/Copyright ©\\\\\\\\\\ \\ Henan Star Hi-Tech CO.,LTD \\ All rights reserved. \\

Love The Way You Lie/ 2022年11月30日 12:50/ 0 赞/ 264 阅读

相关 C语言网站木马源码,C语言木马源码.pdf

C 语言木马源码很值得研究 \include \pragma comment( lib , "ws2\_32.lib" ) \include \include \

淡淡的烟草味﹌/ 2022年10月14日 15:57/ 0 赞/ 186 阅读

相关 c语言的串口ymodem程序,ymodem源码（基于C语言实现）

![bedab9118ad8538115f45a48a1acafcf.png][] 基于类串口通信的文件传输协议，ymodem应用非常广泛，比如在MCU IAP中，常用

短命女/ 2022年10月14日 05:25/ 0 赞/ 778 阅读

相关 YModem协议理解

YModem协议理解 Modem协议是使用更大数据块，以追求更高效率的调制解调器所使用的一种纠错协议。它类似于Modem协议。YModem协议使用循环

淩亂°似流年/ 2022年08月21日 04:45/ 0 赞/ 672 阅读

相关栈的C语言源码

1.导言（为什么要用栈？）通常来说，决定采用何种方式来存储数据是非常重要的，这样便于对数据检索时，数据会自动按照某种规定的顺序给出。栈和队列是检索数据的一种常用的数据

末蓝、/ 2022年08月04日 09:21/ 0 赞/ 178 阅读

相关串口传输文件（YModem协议）

需求：通过串口线实现应用程序固件烧录到单片机的flash中开发语言：C\ 串口设置：串口号，波特率：115200；文件传输函数如下： //烧

深碍√TFBOYSˉ_/ 2022年05月28日 00:10/ 0 赞/ 422 阅读