W6300作为FTP客户端

本篇总结

W6300 实现 FTP 客户端功能，可访问 FTP 服务器进行文件上传、下载和目录管理。

硬件平台：本例程基于 W6300-EVB-M4 开发板运行。

采购推荐：点击前往 WIZnet 官方淘宝店铺 选购 W6300-EVB-M4 开发板

W6300 的优势

W6300 SDK 内置了完整的 FTP 客户端库（ftpc.c/h），命令组包/解包、状态机管理、文件操作全部由库函数处理。你只需要：调用 ftpc_init() 初始化客户端 → 在主循环中调用 ftpc_run() 驱动双状态机。

客户端                                服务器
  |                                     |
  |====== TCP 连接到 21 端口 ==========>|  建立控制连接
  |<----- 220 Welcome to FTP Server ----|
  |------ USER wiznet ----------------->|
  |<----- 331 Password required --------|
  |------ PASS wiznet ----------------->|
  |<----- 230 User logged in -----------|
  |------ PORT 192,168,1,5,20,100 ----->|  主动模式, 端口 = 20*256+100 = 5260
  |<----- 200 PORT command successful --|
  |------ LIST ------------------------>|  获取当前目录文件信息
  |<----- 150 Opening data connection --|
  |<====== 目录数据 (数据连接传输) ====|
  |------ QUIT ------------------------>|  退出 FTP 会话
  |<----- 221 Goodbye ------------------|

void ftpc_init(uint8_t *src_ip, uint8_t sn_ctrl, uint8_t sn_data)
{
    if (src_ip != NULL)
    {
        memcpy(s_ftpc_server_ip, src_ip, sizeof(s_ftpc_server_ip));
    }
    s_ftpc_control_socket = sn_ctrl;
    s_ftpc_data_socket = sn_data;
    s_ftpc_data_local_port = FTPC_DATA_LOCAL_PORT_START;
    s_ftpc_type = FTPC_ASCII_TYPE;
    s_ftpc_data_mode = FTPC_ACTIVE_MODE;
    s_ftpc_pending = 1U;
}

uint8_t ftp_ip[4] = {192, 168, 1, 20};

ftpc_init(ftp_ip, SOCKET_CTRL, SOCKET_DATA);

while (1)
{
    ftpc_run(ethernet_buf);
}

static void ftpc_menu(void)
{
    while (getSn_SR(s_ftpc_control_socket) == SOCK_ESTABLISHED)
    {
        uint8_t key;
        int result = 0;

        printf("\r\n----------------------------------------\r\n");
        printf("Press menu key\r\n");
        printf("----------------------------------------\r\n");
        printf("1> View FTP Server Directory\r\n");
        printf("2> View My Directory\r\n");
        printf("3> Sets the type of file to be transferred. Current state : %s\r\n",
               (s_ftpc_type == FTPC_ASCII_TYPE) ? "Ascii" : "Binary");
        printf("4> Sets Data Connection. Current state : %s\r\n",
               (s_ftpc_data_mode == FTPC_ACTIVE_MODE) ? "Active" : "Passive");
        printf("5> Put File to Server\r\n");
        printf("6> Get File from Server\r\n");
        printf("----------------------------------------\r\n");

        key = ftpc_get_char();
        printf("%c\r\n", (int)key);

        if (key == '1')
        {
            result = ftpc_do_list();
        }
        else if (key == '2')
        {
            printf("\r\ndrwxr-xr-x 1 ftp ftp 0 Dec 31 2014 $Recycle.Bin\r\n");
            printf("-rwxr-xr-x 1 ftp ftp 512 Dec 31 2014 test.txt\r\n");
        }
        else if (key == '3')
        {
            /* 切换 ASCII / BINARY 传输类型 */
        }
        else if (key == '4')
        {
            /* 切换 ACTIVE / PASSIVE 数据连接模式 */
        }
        else if (key == '5')
        {
            result = ftpc_do_put();
        }
        else if (key == '6')
        {
            result = ftpc_do_get();
        }
        else
        {
            printf("Retry...\r\n");
        }

        if (result < 0)
        {
            printf("FTP operation failed.\r\n");
        }
    }
}

static int ftpc_wait_active_established(void)
{
    uint32_t start_tick = wiz_platform_get_tick();

    if (s_ftpc_data_mode != FTPC_ACTIVE_MODE)
    {
        return 0;
    }

    while ((uint32_t)(wiz_platform_get_tick() - start_tick) < FTPC_CONNECT_TIMEOUT_MS)
    {
        uint8_t status = getSn_SR(s_ftpc_data_socket);

        if (status == SOCK_ESTABLISHED)
        {
            return 0;
        }

        if (status == SOCK_CLOSE_WAIT)
        {
            /*
             * 服务器可能在客户端进入此函数之前就已经把数据发完并发 FIN，
             * 此时 Socket 已进入 SOCK_CLOSE_WAIT。如果 RX 缓冲区里还有数据，
             * 必须返回成功，让 ftpc_receive_data() 把数据读出来。
             */
            if (getSn_RX_RSR(s_ftpc_data_socket) > 0U)
            {
                return 0;
            }

            return -1;
        }

        if (status == SOCK_CLOSED)
        {
            return -1;
        }

        wiz_platform_delay_ms(1U);
    }

    return -1;
}

测试前提

测试实例需要 PC 端和 W6300 处于同一网段。使用 FileZilla Server 作为 FTP 服务器端，操作步骤如下：第一步建立服务器并设置账户（用户名：wiznet，密码：123456）；第二步添加共享文件夹，并确保要下载的文件放在共享目录下；第三步在串口助手根据提示输入用户名和密码；第四步选择 6 从服务器获取文件；第五步输入文件名，成功获取文件内容。