返回列表 发新帖我要提问本帖赏金: 120.00元(功能说明)

[MM32生态] MM32F3270通讯板之通过RS232接口实现Xmodem协议传输

[复制链接]
2646|16
 楼主| xld0932 发表于 2022-4-29 11:14 | 显示全部楼层 |阅读模式
本帖最后由 xld0932 于 2022-4-29 11:17 编辑

#申请原创#   @21小跑堂


简介
串行通讯的文件传输协议主要有Xmodem、Ymodem、Zmodem、KERMIT等等。其中Xmodem协议是Ward Chritensen于1978年创建的用于调制解调纠错的协议,它是一种被广泛使用的异步文件传输协议。

Xmodem传输以数据包为单位,一个数据包由一个字节的开始字符、一个字节的包序号、一个字节的包序号补码、数据包内容以及数据校验这几部分组成。其中数据包序号下标是从0x01开始向上递增的,累加到0xFF后将循环反复。

根据开始字符的区分,可以将Xmodem协议分为标准Xmodem和Xmodem-1k两个版本。标准Xmodem版本协议数据包内容长度固定为128字节,Xmodem-1k版本协议的数据包内容长度固定为1024字节。规定传输多少字节的数据包内容是由发送方决定的,当发送方发送的开始字符为SOH(0x01),则表示后面数据包内容长度固定为128字节,若发送方发送的开始字符为STX(0x02),则表示后面数据包内容长度固定为1024字节;在实际数据发送中,每个传输数据包的长度都是固定的,如果数据包内容长度不足128/1024字节,则会使用CTRLZ(0x1A)来补全数据包内容。

标准Xmodem协议(每个数据包含有128字节数据)帧格式
SOH + 数据包序号 + 数据包序号补码 + 数据包内容(128字节) + 数据校验

Xmodem-1k协议(每个数据包含有1024字节数据)帧格式
STX + 数据包序号 + 数据包序号补码 + 数据包内容(1024字节) + 数据校验

Xmodem协议的数据检验方式也有2种,一种是累加和校验方式,对传输的数据进行累加和运算,然后对256取余数即可,这种校验方式的校验数据长度为1个字节;另外一种是CRC校验方式,对传输的数据进行CRC运算(CRC多项式公式为X16+X12+X5+1),然后取低16位数据,这种校验方式的检验数据长度为2个字节。判断使用哪种检验方式,是由接收方决定的;接收方在准备接收数据时,会每间隔3秒向发送方发送一个代表可以开始传输的标志字符;如果接收方发送的是大写字母C,则表示接收方要求发送方以CRC的校验方式对数据进行打包发送;如果接收方发送的是NAK(0x15),则表示接收方要求发送方以累加和的校验方式对数据进行打包发送;接收方在收到发送方数据后,同样也要使用与之相一致的校验方式进行计算校验。

Xmodem如何启动传输?
1、传输由接收方来启动,方法是接收方向发送方发送字符C或者NAK信号。
2、当接收方发送的是NAK信号启动传输时,表示接收方使用的是累加和方式进行校验的;当接收方发送的是字符C启动传输时,表示接收方使用的是CRC方式进行校验的;累加和检验占1个字节, CRC校验占2个字节。

Xmodem传输过程描述:
1、当接收方发送的第一个字符C或者NAK信号到达发送方后,发送方认为可以发送第一个数据包,传输已经启动。发送方接着应该将数据以每次128/1024字节的数据加上开始字符,数据包序列号,数据包序列号补码,末尾加上校验和,打包成帧格式进行传送。
2、发送方发送了第一帧数据后,就在等待接收方回复ACK确认字节,发送方收到接收方的ACK确认后,就认为数据包被接收方正确接收了,并且接收方要求发送方继续发送下一个帧数据。
3、如果发送方收到的是接收方传过来的NAK字节,则表示接收方请求重新发送刚才的数据帧;如果发送方收到的是接收方传过来的CAN字节,则表示接收方请求无条件停止传输。

Xmodem处理注意事项
1、接收方首先应该确认数据包信号的完整性,通过对数据包序号取补码,然后和数据包序号的补码异或运算,结果为0表示正确,结果不为0,则发送NAK请求重传。
2、如果接收到的数据包的包序号和前一个包相同,那么接收方会忽略这个重复的包,向发送方发出ACK,并准备接收下一个数据包。
3、接收方确认了信息包序号的完整性和是否期望包序号后,只对128/1024字节的数据段进行累加和校验或者CRC校验,结果与帧中最后的数据校验比较,相同则发送ACK,不同则发送NAK。

实现功能
使用MobaXterm工具结合SHELL命令来实现选择Xmodem进行发送或是接收的测试;使用SecureCRT工具进行Xmodem数据的发送和接收;并通讯USB转串口打印出传输过程,查看传输结果。


实现代码
由于字数限制,下面的代码仅是核心实现部分,完整的代码可参考附件中的源代码工程,包含详尽的中文注释,易于阅读和理解。

Xmodem校验计算:
  1. uint16_t Xmodem_CalcCheckCRC(uint8_t *Buffer, uint16_t Length)
  2. {
  3.     uint32_t Result = 0;

  4.     Length += 2;

  5.     while(Length--)
  6.     {
  7.         uint8_t Value = (Length < 2) ? 0 : *Buffer++;

  8.         for(uint8_t j = 0; j < 8; j++)
  9.         {
  10.             Result <<= 1;

  11.             if(Value  & 0x00080) Result += 0x0001;

  12.             Value  <<= 1;

  13.             if(Result & 0x10000) Result ^= 0x1021;
  14.         }
  15.     }

  16.     Result &= 0xFFFF;

  17.     printf("\r\n\r\nCheck CRC:0x%04x\r\n\r\n", Result);

  18.     return Result;
  19. }

  20. uint8_t Xmodem_CalcCheckSum(uint8_t *Buffer, uint16_t Length)
  21. {
  22.     uint16_t Result = 0;

  23.     while(Length--)
  24.     {
  25.         Result += *Buffer++;
  26.     }

  27.     Result &= 0xFF;

  28.     printf("\r\n\r\nCheck Sum:0x%02x\r\n\r\n", Result);

  29.     return Result;
  30. }

Xmodem接收处理:
  1. void Xmodem_RxHandler(void)
  2. {
  3.     uint32_t StartTryTimtout = 0x0;

  4.     QUEUE_INIT(QUEUE_RS232_RX_IDX);

  5.     Xmodem_State = XMODEM_RX_STATE_SOH;

  6.     while(1)
  7.     {
  8.         if(QUEUE_EMPTY(QUEUE_RS232_RX_IDX) == 0)
  9.         {
  10.             uint8_t data = QUEUE_READ(QUEUE_RS232_RX_IDX);

  11.             printf("0x%02x ", data);

  12.             switch(Xmodem_State)
  13.             {
  14.                 case XMODEM_RX_STATE_SOH:
  15.                     if((data == XMODEM_SOH) || (data == XMODEM_STX))
  16.                     {
  17.                         Xmodem_Length  = (data == XMODEM_STX) ? 1024 : 128;
  18.                         Xmodem_Index   = 0;
  19.                         Xmodem_State   = XMODEM_RX_STATE_NUM;
  20.                     }
  21.                     else if(data == XMODEM_EOT)
  22.                     {
  23.                         RS232_SendData(XMODEM_ACK);
  24.                         printf("\r\nXmodem Finish"); return;
  25.                     }
  26.                     else if(data == XMODEM_CAN)
  27.                     {
  28.                         printf("\r\nXmodem Cancle"); return;
  29.                     }
  30.                     else
  31.                     {
  32.                     }
  33.                     break;

  34.                 case XMODEM_RX_STATE_NUM:
  35.                     Xmodem_Number[Xmodem_Index++] = data;

  36.                     if(Xmodem_Index == 2)
  37.                     {
  38.                         Xmodem_Index = 0;
  39.                         Xmodem_State = XMODEM_RX_STATE_DAT;
  40.                     }
  41.                     break;

  42.                 case XMODEM_RX_STATE_DAT:
  43.                     Xmodem_Buffer[Xmodem_Index++] = data;

  44.                     if(Xmodem_Index == Xmodem_Length)
  45.                     {
  46.                         Xmodem_Index = 0;
  47.                         Xmodem_State = XMODEM_RX_STATE_CHK;
  48.                     }
  49.                     break;

  50.                 case XMODEM_RX_STATE_CHK:
  51.                     Xmodem_CheckData[Xmodem_Index++] = data;

  52.                     if((Xmodem_CheckType == 1) && (Xmodem_Index == 1))
  53.                     {
  54.                         Xmodem_Index = 0;

  55.                         if(Xmodem_Number[0] == ((Xmodem_Number[1] ^ 0xFF) & 0xFF))
  56.                         {
  57.                             if(Xmodem_CheckData[0] == Xmodem_CalcCheckSum(Xmodem_Buffer, Xmodem_Length))
  58.                             {
  59.                                 RS232_SendData(XMODEM_ACK);
  60.                             }
  61.                             else
  62.                             {
  63.                                 RS232_SendData(XMODEM_NAK);
  64.                             }
  65.                         }
  66.                         else
  67.                         {
  68.                             RS232_SendData(XMODEM_NAK);
  69.                         }

  70.                         Xmodem_State = XMODEM_RX_STATE_SOH;
  71.                     }
  72.                     else if((Xmodem_CheckType == 0) && (Xmodem_Index == 2))
  73.                     {
  74.                         Xmodem_Index = 0;

  75.                         if(Xmodem_Number[0] == ((Xmodem_Number[1] ^ 0xFF) & 0xFF))
  76.                         {
  77.                             uint16_t Result = 0;

  78.                             Result   = Xmodem_CheckData[0];
  79.                             Result <<= 8;
  80.                             Result  |= Xmodem_CheckData[1];

  81.                             if(Result == Xmodem_CalcCheckCRC(Xmodem_Buffer, Xmodem_Length))
  82.                             {
  83.                                 RS232_SendData(XMODEM_ACK);
  84.                             }
  85.                             else
  86.                             {
  87.                                 RS232_SendData(XMODEM_NAK);
  88.                             }
  89.                         }
  90.                         else
  91.                         {
  92.                             RS232_SendData(XMODEM_NAK);
  93.                         }

  94.                         Xmodem_State = XMODEM_RX_STATE_SOH;
  95.                     }
  96.                     else
  97.                     {
  98.                     }
  99.                     break;

  100.                 default:
  101.                     break;
  102.             }
  103.         }
  104.         else
  105.         {
  106.             if(StartTryTimtout == 0)
  107.             {
  108.                 if(Xmodem_CheckType)
  109.                 {
  110.                     RS232_SendData(XMODEM_NAK);
  111.                 }
  112.                 else
  113.                 {
  114.                     RS232_SendData('C');
  115.                 }
  116.             }

  117.             StartTryTimtout = (StartTryTimtout + 1) % XMODEM_TRY_TIMEOUT;
  118.         }
  119.     }
  120. }

Xmodem发送处理:
  1. void Xmodem_TxHandler(void)
  2. {
  3.     for(uint16_t i = 0; i < sizeof(Xmodem_FileBuffer); i++)
  4.     {
  5.         Xmodem_FileBuffer[i] = 0x30 + (i % 10);
  6.     }

  7.     QUEUE_INIT(QUEUE_RS232_RX_IDX);

  8.     Xmodem_State      = XMODEM_TX_STATE_WAIT_SOH;
  9.     Xmodem_SentLength = 0;
  10.     Xmodem_Length     = 128;

  11.     while(1)
  12.     {
  13.         switch(Xmodem_State)
  14.         {
  15.             case XMODEM_TX_STATE_WAIT_SOH:
  16.                 if(QUEUE_EMPTY(QUEUE_RS232_RX_IDX) == 0)
  17.                 {
  18.                     uint8_t data = QUEUE_READ(QUEUE_RS232_RX_IDX);

  19.                     printf("\r\nSOH: 0x%02x", data);

  20.                     if((data == 'C') || (data == XMODEM_NAK))
  21.                     {
  22.                         Xmodem_CheckType = (data == 'C') ? 0 : 1;
  23.                         Xmodem_Number[0] = 0x00;
  24.                         Xmodem_Number[1] = (Xmodem_Number[0] ^ 0xFF) & 0xFF;
  25.                         Xmodem_State     = XMODEM_TX_STATE_SEND_DAT;
  26.                     }
  27.                     else if(data == XMODEM_CAN)
  28.                     {
  29.                         return;
  30.                     }
  31.                     else
  32.                     {
  33.                     }
  34.                 }
  35.                 break;

  36.             case XMODEM_TX_STATE_SEND_DAT:
  37.                 memset(Xmodem_Buffer, 0, sizeof(Xmodem_Buffer));

  38.                 QUEUE_INIT(QUEUE_RS232_RX_IDX);

  39.                 Xmodem_Index = 0;
  40.                 Xmodem_Number[0]++;
  41.                 Xmodem_Number[1] = (Xmodem_Number[0] ^ 0xFF) & 0xFF;

  42.                 while(Xmodem_SentLength < Xmodem_FileLength)
  43.                 {
  44.                     if(Xmodem_Index < Xmodem_Length)
  45.                     {
  46.                         Xmodem_Buffer[Xmodem_Index++] = Xmodem_FileBuffer[Xmodem_SentLength++];
  47.                     }
  48.                     else
  49.                     {
  50.                         break;
  51.                     }
  52.                 }

  53.                 while(Xmodem_Index < Xmodem_Length)
  54.                 {
  55.                     Xmodem_Buffer[Xmodem_Index++] = XMODEM_CTRLZ;
  56.                 }

  57.                 if(Xmodem_Length == 128)
  58.                 {
  59.                     RS232_SendData(XMODEM_SOH);
  60.                 }
  61.                 else
  62.                 {
  63.                     RS232_SendData(XMODEM_STX);
  64.                 }

  65.                 RS232_SendData(Xmodem_Number[0]);
  66.                 RS232_SendData(Xmodem_Number[1]);

  67.                 for(uint16_t i = 0; i < Xmodem_Length; i++)
  68.                 {
  69.                     RS232_SendData(Xmodem_Buffer[i]);
  70.                 }

  71.                 if(Xmodem_CheckType)
  72.                 {
  73.                     RS232_SendData(Xmodem_CalcCheckSum(Xmodem_Buffer, Xmodem_Length));
  74.                 }
  75.                 else
  76.                 {
  77.                     uint16_t Result = Xmodem_CalcCheckCRC(Xmodem_Buffer, Xmodem_Length);

  78.                     RS232_SendData((Result >> 0x08) & 0xFF);
  79.                     RS232_SendData((Result >> 0x00) & 0xFF);
  80.                 }

  81.                 Xmodem_State = XMODEM_TX_STATE_WAIT_ACK;
  82.                 break;

  83.             case XMODEM_TX_STATE_WAIT_ACK:
  84.                 if(QUEUE_EMPTY(QUEUE_RS232_RX_IDX) == 0)
  85.                 {
  86.                     uint8_t data = QUEUE_READ(QUEUE_RS232_RX_IDX);

  87.                     printf("\r\nACK: 0x%02x", data);

  88.                     if(data == XMODEM_ACK)
  89.                     {
  90.                         if(Xmodem_SentLength == Xmodem_FileLength)
  91.                         {
  92.                             QUEUE_INIT(QUEUE_RS232_RX_IDX);

  93.                             RS232_SendData(XMODEM_EOT);

  94.                             Xmodem_State = XMODEM_TX_STATE_WAIT_EOT;
  95.                         }
  96.                         else
  97.                         {
  98.                             Xmodem_State = XMODEM_TX_STATE_SEND_DAT;
  99.                         }
  100.                     }
  101.                     else if(data == XMODEM_NAK)
  102.                     {
  103.                         Xmodem_Number[0]  -= 1;
  104.                         Xmodem_SentLength -= Xmodem_Length;
  105.                         Xmodem_State       = XMODEM_TX_STATE_SEND_DAT;
  106.                     }
  107.                 }
  108.                 break;

  109.             case XMODEM_TX_STATE_WAIT_EOT:
  110.                 if(QUEUE_EMPTY(QUEUE_RS232_RX_IDX) == 0)
  111.                 {
  112.                     uint8_t data = QUEUE_READ(QUEUE_RS232_RX_IDX);

  113.                     printf("\r\nEOT: 0x%02x", data);

  114.                     if(data == XMODEM_ACK)
  115.                     {
  116.                         printf("\r\nXmodem Finish"); return;
  117.                     }
  118.                     else if(data == XMODEM_NAK)
  119.                     {
  120.                         RS232_SendData(XMODEM_EOT);
  121.                     }
  122.                 }
  123.                 break;

  124.             default:
  125.                 break;
  126.         }
  127.     }
  128. }


运行测试
1.jpg

程序启动后,我们可以通过MobaXterm终端看到打印信息,当输入1命令的时候,MCU作为接收方接收来自电脑通过SecureCRT传输过来的数据内容,当输入2命令的时候,MCU作为发送方将数据内容发送给电脑上的SecureCRT,SecureCRT会将接收到的数据存储在路径下的文件中。
R0.png

我们将分别测试标准Xmodem和Xmodem-1k在不同校验方式下的接收数据和发送数据,在SecureCRT软件中Options->Session Options->X/Y/Zmodem中来选择发送数据包的长度,是标准的128字节还是1024字节。
R01.png

1、使用CRC的校验方式进行测试:在MobaXterm终端输入XMODEM 1命令进入接收Xmodem数据状态,此时SecureCRT软件窗口会每间隔一段时间会显示一个大写字母C;通过点击Transfer->Send Xmodem...在弹出的窗口中,选择需要发送的文件1.TXT,点击Send后即刻发送数据。
R10.png R101.png R102.png

1.1、标准Xmodem协议
R110.png R111.png

1.2、Xmodem-1k协议
R112.png R113.png

2、使用累加和的校验方式进行测试:在MobaXterm终端输入XMODEM 1命令进入接收Xmodem数据状态,此时SecureCRT软件窗口不会显示任何提示信息,因为此时接收方发送的是NAK,这是一个不可见的字符;通过点击Transfer->Send Xmodem...在弹出的窗口中,选择需要发送的文件1.TXT,点击Send后即刻发送数据。

2.1、标准Xmodem协议
R114.png R115.png

2.2、Xmodem-1k协议
R116.png R117.png
我们可以看到在当SecureCRT软件中将数据包设置成1024之后,在实际的发送过程中最后一个数据包的大小是根据文件剩余数据量大小来定的,当小于128字节时,使用的是标准的Xmodem数据包大小。

3、使用标准Xmodem协议接收来自MCU的文件数据:在MobaXterm终端输入XMODEM 2命令进入准备Xmodem数据状态,等待SecureCRT软件发送可以开始传输的起始字符;通过程序打印消息得知,SecureCRT软件在接收Xmodem时,使用的是CRC的校验方式。在SecureCRT软件中通过点击Transfer->Receive Xmodem...在弹出的窗口中,选择需要保存的文件路径和文件名2.TXT,点击Receive后即刻接收数据。
R30.png R31.png R32.png R33.png


附件
软件工程源代码: Xmodem.zip (2.74 MB, 下载次数: 36)
参考资料: XMODEM-YMODEM-Protocol-Refrence.pdf (323.26 KB, 下载次数: 29) 用-UART-做文件传输(采用-Xmodem协议).pdf (448.42 KB, 下载次数: 30)
测试文件: 1.zip (207 Bytes, 下载次数: 15) 2.zip (180 Bytes, 下载次数: 14)

打赏榜单

21小跑堂 打赏了 120.00 元 2022-04-29
理由:恭喜通过原创奖文章审核!请多多加油哦!

www5911839 发表于 2022-4-29 13:44 | 显示全部楼层
好文,水平太高了,强烈建议在 b 站做这系列的视频教程啊!
 楼主| xld0932 发表于 2022-4-29 14:36 | 显示全部楼层
通过MM32F3270通讯板的RS232实现了Xmodem协议的数据发送和接收,软件代码实现了标准Xmodem和Xmodem-1k两个版本协议相兼容,实现了CRC校验和累加和校验相兼容;对Xmodem协议的启动过程、传输过程以及处理注意事项做了说明。并附带了详细的测试过程。
 楼主| xld0932 发表于 2022-4-29 14:40 | 显示全部楼层
www5911839 发表于 2022-4-29 13:44
好文,水平太高了,强烈建议在 b 站做这系列的视频教程啊!

先积累一些再出视频吧……技术比较内向,还需要时间来心理建设
tpgf 发表于 2022-5-4 16:18 | 显示全部楼层
最大数据传输速度是多少啊
wiba 发表于 2022-5-4 16:29 | 显示全部楼层
做成视频教程很好
nawu 发表于 2022-5-4 16:45 | 显示全部楼层
发送间隔最短是多少呢
zljiu 发表于 2022-5-4 16:55 | 显示全部楼层
工程内容是全的
tfqi 发表于 2022-5-4 17:22 | 显示全部楼层
可否详解协议内容啊
drer 发表于 2022-5-4 18:00 | 显示全部楼层
使用的非常广泛的通讯种类
 楼主| xld0932 发表于 2022-5-4 21:35 | 显示全部楼层
tpgf 发表于 2022-5-4 16:18
最大数据传输速度是多少啊

这个根据你的UART速率和软件处理过程相关,你可以下载工程,再优化后测试看看
 楼主| xld0932 发表于 2022-5-4 21:36 | 显示全部楼层
nawu 发表于 2022-5-4 16:45
发送间隔最短是多少呢

协议是ARQ方式的,所以间隔时间取决你应用的处理速度啦
 楼主| xld0932 发表于 2022-5-4 21:39 | 显示全部楼层
zljiu 发表于 2022-5-4 16:55
工程内容是全的

我分享的所有帖子中,所有附件内容都是完整的工程、或者是资源文件、或者是生产文件;方便需要的小伙伴上手熟悉一下,可以直接应用
 楼主| xld0932 发表于 2022-5-4 21:39 | 显示全部楼层
tfqi 发表于 2022-5-4 17:22
可否详解协议内容啊

协议内容在附件中有文档,就是英文版本的,需要点耐心去研读呢
 楼主| xld0932 发表于 2022-5-4 21:41 | 显示全部楼层
drer 发表于 2022-5-4 18:00
使用的非常广泛的通讯种类

是的,串行文件传输、一些ISP升级功能在通讯上也是用的Xmodem、Ymodem、Kermit等等这些常用的协议

caigang13 发表于 2022-5-5 08:05 来自手机 | 显示全部楼层
谢谢楼主的分享,非常nice。
 楼主| xld0932 发表于 2022-5-5 08:46 | 显示全部楼层
caigang13 发表于 2022-5-5 08:05
谢谢楼主的分享,非常nice。

您需要登录后才可以回帖 登录 | 注册

本版积分规则

个人签名:King.Xu

77

主题

3023

帖子

38

粉丝
快速回复 在线客服 返回列表 返回顶部