Zoltan Hudak / Mbed OS TFTPServerTest

This is an example code for using the TFTPServer library.

Dependencies:   TFTPServer

Fork of TFTPServerTest by Jaap Vermaas

A simple TFTP server built with the TFTPServer library

In this example a FAT formatted SD card is connected to the MBED board to provide a storage place for a TFTP server. This will allow us to upload files to or download files from the TFTP server (SD card) over an Ethernet connection as well as to use the files uploaded to the TFTP server in a program running on the MBED board.

Schematic

/media/uploads/hudakz/tftpserver01.png

We can use for example the SD Formatter utility to format an SD card for the FAT file system .

NOTE: In the commands below substitute 192.168.1.185 with the actual IP address of your TFTP server. It's printed to the serial terminal of the connected PC during the server start up.

To upload or download files from a MS Windows PC we can use the TFTP client utility as follows:

  • To upload for example the test.txt file to the TFTP server:
    • Open a command prompt in the folder the file is located in.
    • Type tftp 192.168.1.185 put test.txt /fs/test.txt and hit ENTER
  • To download for example the test.txt file from the TFTP server:
    • Open a command prompt in the destination folder.
    • Type tftp 192.168.1.185 get /fs/test.txt test.txt and hit ENTER

A similar built-in TFTP client is available also on MAC and Linux operating systems.

References:

main.cpp@2:228ce0f5c9c8, 2018-03-16 (annotated)

Committer:
hudakz
Date:
Fri Mar 16 19:34:42 2018 +0000
Revision:
2:228ce0f5c9c8
Parent:
1:698437bcd48d
Child:
3:77497b352c3f
Updated.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
tuxic 0:5c9e0971532d 1 /*
hudakz 1:698437bcd48d 2 * example program for the TFTPServer library
tuxic 0:5c9e0971532d 3 *
tuxic 0:5c9e0971532d 4 * How to use:
hudakz 1:698437bcd48d 5 * -> use DHCP or change the IP to something that works for you
tuxic 0:5c9e0971532d 6 * -> connect to the mbed with a TFTP client in binary(octet) mode
tuxic 0:5c9e0971532d 7 * -> use (s)uspend and (r)esume keys to turn TFTP server on/off
hudakz 1:698437bcd48d 8 * -> upload any file
tuxic 0:5c9e0971532d 9 *
tuxic 0:5c9e0971532d 10 * Copyright (c) 2011 Jaap Vermaas
hudakz 1:698437bcd48d 11 * Modified for MBED-OS5 by Zoltan Hudak 2018
tuxic 0:5c9e0971532d 12 *
hudakz 1:698437bcd48d 13 * This file is part of the LaOS project (see: http://wiki.laoslaser.org)
tuxic 0:5c9e0971532d 14 *
tuxic 0:5c9e0971532d 15 * LaOS is free software: you can redistribute it and/or modify
tuxic 0:5c9e0971532d 16 * it under the terms of the GNU General Public License as published by
tuxic 0:5c9e0971532d 17 * the Free Software Foundation, either version 3 of the License, or
tuxic 0:5c9e0971532d 18 * (at your option) any later version.
tuxic 0:5c9e0971532d 19 *
tuxic 0:5c9e0971532d 20 * LaOS is distributed in the hope that it will be useful,
tuxic 0:5c9e0971532d 21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
tuxic 0:5c9e0971532d 22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
tuxic 0:5c9e0971532d 23 * GNU General Public License for more details.
tuxic 0:5c9e0971532d 24 *
tuxic 0:5c9e0971532d 25 * You should have received a copy of the GNU General Public License
tuxic 0:5c9e0971532d 26 * along with LaOS. If not, see <http://www.gnu.org/licenses/>.
hudakz 1:698437bcd48d 27 *
hudakz 1:698437bcd48d 28 *
tuxic 0:5c9e0971532d 29 */
tuxic 0:5c9e0971532d 30 #include "mbed.h"
hudakz 1:698437bcd48d 31 #include "SDBlockDevice.h"
hudakz 1:698437bcd48d 32 #include "FATFileSystem.h"
hudakz 1:698437bcd48d 33 #include "EthernetInterface.h"
tuxic 0:5c9e0971532d 34 #include "TFTPServer.h"
hudakz 1:698437bcd48d 35 #include "errno.h"
hudakz 1:698437bcd48d 36
hudakz 1:698437bcd48d 37 Serial pc(USBTX, USBRX);
hudakz 1:698437bcd48d 38 SDBlockDevice bd(p5, p6, p7, p8); // SD card SPI driver pins: mosi, miso, sclk, cs
hudakz 1:698437bcd48d 39 FATFileSystem fs("fs"); // FAT file sytem
hudakz 1:698437bcd48d 40 EthernetInterface net; // Ethernet interface
hudakz 1:698437bcd48d 41 TFTPServer* server; // Pointer to a TFTPServer
hudakz 1:698437bcd48d 42 int myPort = 69; // TFPTServer port
hudakz 1:698437bcd48d 43 Timer timer; // For sending debug messages to the remote client every two seconds
hudakz 1:698437bcd48d 44
hudakz 1:698437bcd48d 45 #define USE_DHCP
tuxic 0:5c9e0971532d 46
hudakz 1:698437bcd48d 47 /**
hudakz 1:698437bcd48d 48 * @brief
hudakz 1:698437bcd48d 49 * @note
hudakz 1:698437bcd48d 50 * @param
hudakz 1:698437bcd48d 51 * @retval
hudakz 1:698437bcd48d 52 */
hudakz 1:698437bcd48d 53 int main()
hudakz 1:698437bcd48d 54 {
hudakz 1:698437bcd48d 55 // Try to mount the filesystem. This should work without the Ethernet.
hudakz 1:698437bcd48d 56 pc.printf("Mounting the filesystem... \r\n");
hudakz 1:698437bcd48d 57
hudakz 1:698437bcd48d 58 int err = fs.mount(&bd);
hudakz 1:698437bcd48d 59 pc.printf("%s\r\n", (err ? "Failed :(\r\n" : "OK\r\n"));
tuxic 0:5c9e0971532d 60
hudakz 1:698437bcd48d 61 if (err)
hudakz 1:698437bcd48d 62 return 1;
hudakz 1:698437bcd48d 63
hudakz 1:698437bcd48d 64 // Open a file. This should work without the Ethernet, too.
hudakz 1:698437bcd48d 65 pc.printf("Opening \"/fs/test.txt\"... \r\n");
hudakz 1:698437bcd48d 66
hudakz 1:698437bcd48d 67 FILE* fp = fopen("/fs/test.txt", "r+");
hudakz 1:698437bcd48d 68 pc.printf("%s\r\n", (!fp ? "Failed :(\r\n" : "OK\r\n"));
hudakz 1:698437bcd48d 69
hudakz 1:698437bcd48d 70 if (!fp)
hudakz 1:698437bcd48d 71 {
hudakz 1:698437bcd48d 72 // Create the test file if it doesn't exist
hudakz 1:698437bcd48d 73 pc.printf("No file found, creating a new file ...\r\n");
hudakz 2:228ce0f5c9c8 74 fp = fopen("/fs/test.txt", "w+");
hudakz 1:698437bcd48d 75 pc.printf("%s\r\n", (!fp ? "Fail :(" : "OK"));
hudakz 1:698437bcd48d 76 if (!fp)
hudakz 1:698437bcd48d 77 error("error: %s (%d)\r\n", strerror(errno), -errno);
tuxic 0:5c9e0971532d 78
hudakz 1:698437bcd48d 79 for (int i = 0; i < 10; i++)
hudakz 1:698437bcd48d 80 {
hudakz 1:698437bcd48d 81 pc.printf("\rWriting numbers (%d/%d)... ", i, 10);
hudakz 1:698437bcd48d 82 err = fprintf(fp, " %d\n", i);
hudakz 1:698437bcd48d 83 if (err < 0)
hudakz 1:698437bcd48d 84 {
hudakz 1:698437bcd48d 85 pc.printf("Fail :(\r\n");
hudakz 1:698437bcd48d 86 error("error: %s (%d)\n", strerror(errno), -errno);
hudakz 1:698437bcd48d 87 }
hudakz 1:698437bcd48d 88 }
hudakz 1:698437bcd48d 89
hudakz 1:698437bcd48d 90 pc.printf("\rWriting numbers (%d/%d)... OK\r\n", 10, 10);
hudakz 1:698437bcd48d 91
hudakz 1:698437bcd48d 92 pc.printf("Seeking file ...\r\n");
hudakz 1:698437bcd48d 93 err = fseek(fp, 0, SEEK_SET);
hudakz 1:698437bcd48d 94 pc.printf("%s\r\n", (err < 0 ? "Fail :(" : "OK"));
hudakz 1:698437bcd48d 95 if (err < 0)
hudakz 1:698437bcd48d 96 {
hudakz 1:698437bcd48d 97 error("error: %s (%d)\r\n", strerror(errno), -errno);
hudakz 1:698437bcd48d 98 }
tuxic 0:5c9e0971532d 99 }
tuxic 0:5c9e0971532d 100
hudakz 1:698437bcd48d 101 // Connect to the Ethernet
hudakz 1:698437bcd48d 102 pc.printf("Connecting to the Ethernet using ");
hudakz 1:698437bcd48d 103 #ifdef USE_DHCP
hudakz 1:698437bcd48d 104 pc.printf("DHCP server ...\r\n");
hudakz 1:698437bcd48d 105 #else
hudakz 1:698437bcd48d 106 pc.printf("fixed IP ...\r\n");
hudakz 1:698437bcd48d 107 net.set_network("192.168.1.185", "255.255.255.0", "192.168.1.1");
hudakz 1:698437bcd48d 108 #endif
hudakz 1:698437bcd48d 109 net.connect();
hudakz 1:698437bcd48d 110 pc.printf("IP: %s\r\n", net.get_ip_address());
hudakz 1:698437bcd48d 111 pc.printf("NetMask: %s\r\n\r\n", net.get_netmask());
hudakz 1:698437bcd48d 112
hudakz 1:698437bcd48d 113 // Create a TFTP server.
hudakz 1:698437bcd48d 114 pc.printf("Creating a TFTP server ...\r\n\r\n");
hudakz 1:698437bcd48d 115 server = new TFTPServer(&net, myPort);
tuxic 0:5c9e0971532d 116
hudakz 1:698437bcd48d 117 int fileCount = 0; // incoming files
hudakz 1:698437bcd48d 118 char fileName[256]; // to display filenames
hudakz 1:698437bcd48d 119
hudakz 1:698437bcd48d 120 timer.start();
hudakz 1:698437bcd48d 121
hudakz 1:698437bcd48d 122 while (1)
hudakz 1:698437bcd48d 123 {
hudakz 1:698437bcd48d 124 server->poll();
hudakz 1:698437bcd48d 125
hudakz 1:698437bcd48d 126 if (pc.readable())
hudakz 1:698437bcd48d 127 {
hudakz 1:698437bcd48d 128 int c = pc.getc();
tuxic 0:5c9e0971532d 129 switch (c) {
hudakz 1:698437bcd48d 130 case 's':
hudakz 1:698437bcd48d 131 server->suspend();
tuxic 0:5c9e0971532d 132 break;
hudakz 1:698437bcd48d 133
tuxic 0:5c9e0971532d 134 case 'r':
hudakz 1:698437bcd48d 135 server->resume();
tuxic 0:5c9e0971532d 136 break;
tuxic 0:5c9e0971532d 137 }
tuxic 0:5c9e0971532d 138 }
hudakz 1:698437bcd48d 139
hudakz 1:698437bcd48d 140 if (server->fileCount() > fileCount)
hudakz 1:698437bcd48d 141 {
hudakz 1:698437bcd48d 142 fileCount = server->fileCount();
hudakz 1:698437bcd48d 143 server->getFileName(fileName);
hudakz 1:698437bcd48d 144 pc.printf("new file: %s\r\n", fileName);
tuxic 0:5c9e0971532d 145 }
hudakz 1:698437bcd48d 146
hudakz 1:698437bcd48d 147 if (timer.read() > 2)
hudakz 1:698437bcd48d 148 {
hudakz 1:698437bcd48d 149 timer.reset();
hudakz 1:698437bcd48d 150
hudakz 1:698437bcd48d 151 switch (server->getState()) {
hudakz 1:698437bcd48d 152 case TFTPServer::LISTENING:
hudakz 1:698437bcd48d 153 pc.printf("main: TFTP server is listening\r\n");
tuxic 0:5c9e0971532d 154 break;
hudakz 1:698437bcd48d 155
hudakz 1:698437bcd48d 156 case TFTPServer::READING:
hudakz 1:698437bcd48d 157 server->getFileName(fileName);
hudakz 1:698437bcd48d 158 pc.printf("main: TFTP server is reading file: %s\r\n", fileName);
tuxic 0:5c9e0971532d 159 break;
hudakz 1:698437bcd48d 160
hudakz 1:698437bcd48d 161 case TFTPServer::WRITING:
hudakz 1:698437bcd48d 162 server->getFileName(fileName);
hudakz 1:698437bcd48d 163 pc.printf("main: TFTP server is writing file: %s\r\n", fileName);
tuxic 0:5c9e0971532d 164 break;
hudakz 1:698437bcd48d 165
hudakz 1:698437bcd48d 166 case TFTPServer::ERROR:
hudakz 1:698437bcd48d 167 pc.printf("main: TFTP error\r\n");
tuxic 0:5c9e0971532d 168 break;
hudakz 1:698437bcd48d 169
hudakz 1:698437bcd48d 170 case TFTPServer::SUSPENDED:
hudakz 1:698437bcd48d 171 pc.printf("main: TFTP suspended\r\n");
tuxic 0:5c9e0971532d 172 break;
hudakz 1:698437bcd48d 173
tuxic 0:5c9e0971532d 174 default:
hudakz 1:698437bcd48d 175 pc.printf("main: Unknown TFTP status\r\n");
tuxic 0:5c9e0971532d 176 break;
tuxic 0:5c9e0971532d 177 }
tuxic 0:5c9e0971532d 178 }
tuxic 0:5c9e0971532d 179 }
tuxic 0:5c9e0971532d 180 }