STM32物联网之TFTP文件传输


  • 感言:专注物联网应用开发,分享物联网技术经验。
  • 软件平台:IAR6.5
  • TCP/IP协议栈:LWIP1.4.1
  • 硬件平台:STM32F103C8T6有线通信板(点击这里可以购买)
  • STM32物联网之TFTP文件传输
    文章图片


1、TCP/IP协议栈LWIP 1.1、LWIP认识
LWIP是瑞典计算机科学院(SICS)的Adam Dunkels 开发的一个小型开源的TCP/IP协议栈,是Light Weight (轻型)IP协议,有无操作系统的支持都可以运行。LWIP提供三种API,分别是RAW API、LWIP API 、BSD API。其中RAW API把协议栈和应用程序放到一个进程里边,该接口基于函数回调技术来实现的,适合于无操作系统的场合运行,如单片机。本文使用的就是LWIP的RAW API来实现网络层的通信的。
1.2、TFTP在LWIP中的实现 关于LWIP的移植,就不在本文中多讲,读者可以在网上找到众多资料或在另外的专题中再详细讲解,在这里我们专注其应用。在LWIP中实现一个TFTP服务器非常简单,根据RAW API的编程方法,在初始化的时候创建一个UDP PCB(TFTP使用UDP协议通信),且绑定69端口(TFTP默认通信端口),最后指定该UDP PCB的数据接收回调函数即可。
以上的创建TFTP服务器的方法需要在LWIP初始化,并启动网卡后进行:

LwIP_Config(); printf("ipaddr:%d.%d.%d.%d\r\n", net_ip[0], net_ip[1], net_ip[2], net_ip[3]); tftpd_init();

在tftpd_init函数中创建TFTP服务器:

void tftpd_init(void) { err_t err; unsigned port = 69; /* create a new UDP PCB structure*/ UDPpcb = udp_new(); if (!UDPpcb) {/* Error creating PCB. Out of Memory*/ return; }/* Bind this PCB to port 69*/ err = udp_bind(UDPpcb, IP_ADDR_ANY, port); if (err != ERR_OK) {/* Unable to bind to port*/ return; }/* TFTP server start*/ udp_recv(UDPpcb, recv_callback_tftp, NULL); }

OK,到这里就完成了TFTP服务器在LWIP中建立起来了,接下来的主要事情就是根据TFTP协议进行协议解释、数据处理。


2、TFTP协议分析 2.1、TFTP通信基本流程(摘自网络) STM32物联网之TFTP文件传输
文章图片


2.2、TFTP报文格式(摘自网络) STM32物联网之TFTP文件传输
文章图片


2.3、TFTP协议理解 从以上两张图片,我们了解到什么有用信息呢?
  • 每一次文件传输,首先需要发起一个请求,根据请求帧的操作码判断是读文件还是写文件。
  • 每一帧都有一个操作码用来标识读写。
  • 数据包的长度有一个块编号用来表示数据包的顺序。
  • 数据包中的数据长度为512个字节(在后面的软件我们可以了解到这个长度是可以设定的)。
3、实现TFTP文件传输 3.1、文件传输协议实现 有了第2节的协议分析,我们基本了解了TFTP通信的协议,在这里,我们来实现TFTP的服务器端代码。
在监听的回调函数被触发调用时,首先从请求帧中获取操作码:

typedef enum { TFTP_RRQ = 1, TFTP_WRQ = 2, TFTP_DATA = https://www.it610.com/article/3, TFTP_ACK = 4, TFTP_ERROR = 5 } tftp_opcode; tftp_opcode tftp_decode_op(char *buf) { return (tftp_opcode)(buf[1]); }

根据操作码进行相应的处理:

tftp_opcode op = tftp_decode_op(pkt_buf->payload); switch (op) {case TFTP_RRQ:/* TFTP RRQ (read request) */ tftp_extract_filename(FileName, pkt_buf->payload); tftp_process_read(upcb, addr, port, FileName); break; case TFTP_WRQ:/* TFTP WRQ (write request) */ tftp_extract_filename(FileName, pkt_buf->payload); //在这个加入擦FALSH tftp_process_write(upcb, addr, port, FileName); break; default: /* sEndTransfera generic access violation message */ tftp_send_error_message(upcb, addr, port, TFTP_ERR_ACCESS_VIOLATION); /* TFTP unknown request op */ /* no need to use tftp_cleanup_wr because no "tftp_connection_args" struct has been malloc'd*/ udp_remove(upcb); break; }

这里当STM32接收到写操作请求时,通过tftp_extract_filename函数把文件名读出来。接下来通过tftp_process_write函数来完成文件数据的传输:

int tftp_process_write(struct udp_pcb *upcb, struct ip_addr *to, int to_port, char *FileName) { ... ... udp_recv(upcb, wrq_recv_callback, args); tftp_send_ack_packet(upcb, to, to_port, args->block); return 0; }

设定数据传输回调函数后,根据TFTP协议,回复一个ACK,之后TFTP客户端开始传输文件数据,从而触发调用wrq_recv_callback
void wrq_recv_callback(void *_args, struct udp_pcb *upcb, struct pbuf *pkt_buf, struct ip_addr *addr, u16_t port) { tftp_connection_args *args = (tftp_connection_args *)_args; int n = 0; if (pkt_buf->len != pkt_buf->tot_len) { return; }/* Does this packet have any valid data to write? */ if ((pkt_buf->len > TFTP_DATA_PKT_HDR_LEN) && (tftp_extract_block(pkt_buf->payload) == (args->block + 1))) { /* 在这里处理接收到的数据pkt_buf->payload *//* update our block number to match the block number just received */ args->block++; /* update total bytes*/ (args->tot_bytes) += (pkt_buf->len - TFTP_DATA_PKT_HDR_LEN); /* This is a valid pkt but it has no data.This would occur if the file being written is an exact multiple of 512 bytes.In this case, the args->block value must still be updated, but we can skip everything else.*/ } else if (tftp_extract_block(pkt_buf->payload) == (args->block + 1)) { /* update our block number to match the block number just received*/ args->block++; }/* SEndTransferthe appropriate ACK pkt (the block number sent in the ACK pkt echoes * the block number of the DATA pkt we just received - see RFC1350) * NOTE!: If the DATA pkt we received did not have the appropriate block * number, then the args->block (our block number) is never updated and * we simply sEndTransfera "duplicate ACK" which has the same block number as the * last ACK pkt we sent.This lets the host know that we are still waiting * on block number args->block+1. */ tftp_send_ack_packet(upcb, addr, port, args->block); /* If the last write returned less than the maximum TFTP data pkt length, * then we've received the whole file and so we can quit (this is how TFTP * signals the EndTransferof a transfer!) */ if (pkt_buf->len < TFTP_DATA_PKT_LEN_MAX) { tftp_cleanup_wr(upcb, args); pbuf_free(pkt_buf); } else { pbuf_free(pkt_buf); return; }}

OK!至此STM32就完成了整个TFTP协议文件的接收。
3.2、保存文件数据 接收到完整的文件数据之后,我们需要把数据写到STM32的FLASH中,保存起来。
由于STM32内存较小,不可能开辟一个大的内存空间把文件数据保存起来再写到FLASH,
所以需要边接收边写FLASH。
首先在接收到写操作请求后,把存储区域的FLASH擦除:

case TFTP_WRQ:/* TFTP WRQ (write request) */ 。... ... FlashDestination = HtmlDataAddress; /* Erase the needed pages where the user application will be loaded */ /* Define the number of page to be erased */ NbrOfPage = FLASH_PagesMask(HtmlTotalSize); //擦除HTML区域/* Erase the FLASH pages */ FLASH_Unlock(); for (EraseCounter = 0; (EraseCounter < NbrOfPage) && (FLASHStatus == FLASH_COMPLETE); EraseCounter++) { FLASHStatus = FLASH_ErasePage(HtmlSizeAddress + (PageSize * EraseCounter)); } FLASH_Lock();

在文件数据传输过程中,把<=512BYTE的数据写到FLASH:
filedata = https://www.it610.com/article/(uint32_t)pkt_buf->payload + TFTP_DATA_PKT_HDR_LEN; FLASH_Unlock(); for (n = 0; n < (pkt_buf->len - TFTP_DATA_PKT_HDR_LEN); n += 4) { /* Program the data received into STM32F10x Flash */ FLASH_ProgramWord(FlashDestination, *(uint32_t*)filedata); if (*(uint32_t*)FlashDestination != *(uint32_t*)filedata) { /* End session */ tftp_send_error_message(upcb, addr, port, FLASH_VERIFICATION_FAILED); /* close the connection */ tftp_cleanup_wr(upcb, args); /* close the connection */ } FlashDestination += 4; filedata += 4; } FLASH_Lock();

到这里,就实现了STM32接收TFTP客户端传输的文件数据,并保存到FLASH地址为FlashDestination的区域中。
3.3、演示操作 将通信板连接到与电脑在同一局域的路由器,并正确配置好IP信息。在电脑端打开软件Tftpd32.exe:
STM32物联网之TFTP文件传输
文章图片


点击“上传”按键,就会把文件html.bin文件发送到STM32通信板:
STM32物联网之TFTP文件传输
文章图片


可以在STM32通信板中把文件内容读出来使用,在下一篇博客物联网WEB开发中会使用TFTP传输HTML文件。

4、TFTP的应用 TFTP主要是实现文件传输,在固件升级、程序调试中极大提高效率,有重要的意义。
【STM32物联网之TFTP文件传输】在WEB的应用开发中会体会到其强大的作用。欢迎关注下一篇关于STM32的WEB开发的博客。

    推荐阅读