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@4:895c0ae49294, 2018-03-20 (annotated)

Committer:
hudakz
Date:
Tue Mar 20 17:32:28 2018 +0000
Revision:
4:895c0ae49294
Parent:
3:77497b352c3f
Child:
5:063211afa95c
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 * Copyright (c) 2011 Jaap Vermaas
hudakz 4:895c0ae49294 5 * Modified by Zoltan Hudak 2018 for MBED-OS5
tuxic 0:5c9e0971532d 6 *
hudakz 3:77497b352c3f 7 * For more detaisl see https://os.mbed.com/users/hudakz/code/TFTPServerTest/
hudakz 3:77497b352c3f 8 *
hudakz 3:77497b352c3f 9 * The TFTPServer is part of the LaOS project (see: http://wiki.laoslaser.org)
tuxic 0:5c9e0971532d 10 *
tuxic 0:5c9e0971532d 11 * LaOS is free software: you can redistribute it and/or modify
tuxic 0:5c9e0971532d 12 * it under the terms of the GNU General Public License as published by
tuxic 0:5c9e0971532d 13 * the Free Software Foundation, either version 3 of the License, or
tuxic 0:5c9e0971532d 14 * (at your option) any later version.
tuxic 0:5c9e0971532d 15 *
tuxic 0:5c9e0971532d 16 * LaOS is distributed in the hope that it will be useful,
tuxic 0:5c9e0971532d 17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
tuxic 0:5c9e0971532d 18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
tuxic 0:5c9e0971532d 19 * GNU General Public License for more details.
tuxic 0:5c9e0971532d 20 *
tuxic 0:5c9e0971532d 21 * You should have received a copy of the GNU General Public License
tuxic 0:5c9e0971532d 22 * along with LaOS. If not, see <http://www.gnu.org/licenses/>.
hudakz 1:698437bcd48d 23 *
tuxic 0:5c9e0971532d 24 */
tuxic 0:5c9e0971532d 25 #include "mbed.h"
hudakz 1:698437bcd48d 26 #include "SDBlockDevice.h"
hudakz 1:698437bcd48d 27 #include "FATFileSystem.h"
hudakz 1:698437bcd48d 28 #include "EthernetInterface.h"
tuxic 0:5c9e0971532d 29 #include "TFTPServer.h"
hudakz 1:698437bcd48d 30 #include "errno.h"
hudakz 1:698437bcd48d 31
hudakz 1:698437bcd48d 32 Serial pc(USBTX, USBRX);
hudakz 1:698437bcd48d 33 SDBlockDevice bd(p5, p6, p7, p8); // SD card SPI driver pins: mosi, miso, sclk, cs
hudakz 1:698437bcd48d 34 FATFileSystem fs("fs"); // FAT file sytem
hudakz 1:698437bcd48d 35 EthernetInterface net; // Ethernet interface
hudakz 1:698437bcd48d 36 TFTPServer* server; // Pointer to a TFTPServer
hudakz 1:698437bcd48d 37 int myPort = 69; // TFPTServer port
hudakz 1:698437bcd48d 38 Timer timer; // For sending debug messages to the remote client every two seconds
hudakz 1:698437bcd48d 39
hudakz 1:698437bcd48d 40 #define USE_DHCP
tuxic 0:5c9e0971532d 41
hudakz 1:698437bcd48d 42 /**
hudakz 1:698437bcd48d 43 * @brief
hudakz 1:698437bcd48d 44 * @note
hudakz 1:698437bcd48d 45 * @param
hudakz 1:698437bcd48d 46 * @retval
hudakz 1:698437bcd48d 47 */
hudakz 1:698437bcd48d 48 int main()
hudakz 1:698437bcd48d 49 {
hudakz 1:698437bcd48d 50 // Try to mount the filesystem. This should work without the Ethernet.
hudakz 4:895c0ae49294 51 pc.printf("Mounting the filesystem... ");
hudakz 1:698437bcd48d 52
hudakz 1:698437bcd48d 53 int err = fs.mount(&bd);
hudakz 1:698437bcd48d 54 pc.printf("%s\r\n", (err ? "Failed :(\r\n" : "OK\r\n"));
hudakz 1:698437bcd48d 55 if (err)
hudakz 4:895c0ae49294 56 return err;
hudakz 1:698437bcd48d 57
hudakz 1:698437bcd48d 58 // Open a file. This should work without the Ethernet, too.
hudakz 4:895c0ae49294 59 pc.printf("Opening file '/fs/test.txt'... ");
hudakz 1:698437bcd48d 60
hudakz 4:895c0ae49294 61 FILE* fp = fopen("/fs/test.txt", "w+");
hudakz 1:698437bcd48d 62 pc.printf("%s\r\n", (!fp ? "Failed :(\r\n" : "OK\r\n"));
hudakz 1:698437bcd48d 63
hudakz 1:698437bcd48d 64 if (!fp)
hudakz 1:698437bcd48d 65 {
hudakz 4:895c0ae49294 66 // Create the test file if it doesn't exist
hudakz 1:698437bcd48d 67 pc.printf("No file found, creating a new file ...\r\n");
hudakz 3:77497b352c3f 68 fp = fopen("/fs/test.txt", "w+");
hudakz 3:77497b352c3f 69 pc.printf("%s\r\n", (!fp ? "Failed :(" : "OK"));
hudakz 1:698437bcd48d 70 if (!fp)
hudakz 4:895c0ae49294 71 {
hudakz 1:698437bcd48d 72 error("error: %s (%d)\r\n", strerror(errno), -errno);
hudakz 4:895c0ae49294 73 return errno;
hudakz 4:895c0ae49294 74 }
hudakz 4:895c0ae49294 75 }
hudakz 4:895c0ae49294 76
hudakz 4:895c0ae49294 77 for (int i = 0; i < 10; i++)
hudakz 4:895c0ae49294 78 {
hudakz 4:895c0ae49294 79 pc.printf("Writing numbers (%d/%d)... ", i, 10);
hudakz 4:895c0ae49294 80 err = fprintf(fp, " %d\r\n", i);
hudakz 4:895c0ae49294 81 if (err < 0)
hudakz 1:698437bcd48d 82 {
hudakz 4:895c0ae49294 83 pc.printf("Fail :(\r\n");
hudakz 4:895c0ae49294 84 error("error: %s (%d)\r\n", strerror(errno), -errno);
hudakz 1:698437bcd48d 85 }
hudakz 4:895c0ae49294 86 else
hudakz 4:895c0ae49294 87 pc.printf("OK\r\n");
hudakz 4:895c0ae49294 88 }
hudakz 1:698437bcd48d 89
hudakz 4:895c0ae49294 90 pc.printf("Writing numbers (%d/%d)... OK\r\n\r\n", 10, 10);
hudakz 4:895c0ae49294 91
hudakz 4:895c0ae49294 92 err = fclose(fp);
hudakz 4:895c0ae49294 93 pc.printf("Closing file '/fs/test.txt'... ");
hudakz 4:895c0ae49294 94 pc.printf("%s\r\n", (err ? "Failed :(\r\n" : "OK\r\n"));
hudakz 4:895c0ae49294 95 if (err)
hudakz 4:895c0ae49294 96 return err;
tuxic 0:5c9e0971532d 97
hudakz 1:698437bcd48d 98 // Connect to the Ethernet
hudakz 1:698437bcd48d 99 pc.printf("Connecting to the Ethernet using ");
hudakz 1:698437bcd48d 100 #ifdef USE_DHCP
hudakz 4:895c0ae49294 101 pc.printf("DHCP server... ");
hudakz 1:698437bcd48d 102 #else
hudakz 1:698437bcd48d 103 pc.printf("fixed IP ...\r\n");
hudakz 1:698437bcd48d 104 net.set_network("192.168.1.185", "255.255.255.0", "192.168.1.1");
hudakz 1:698437bcd48d 105 #endif
hudakz 4:895c0ae49294 106 err = net.connect();
hudakz 4:895c0ae49294 107 pc.printf("%s\r\n", (err ? "Failed :(\r\n" : "OK\r\n"));
hudakz 4:895c0ae49294 108 if (err)
hudakz 4:895c0ae49294 109 return err;
hudakz 4:895c0ae49294 110
hudakz 4:895c0ae49294 111 pc.printf("IP: %s\r\n", net.get_ip_address());
hudakz 1:698437bcd48d 112 pc.printf("NetMask: %s\r\n\r\n", net.get_netmask());
hudakz 1:698437bcd48d 113
hudakz 1:698437bcd48d 114 // Create a TFTP server.
hudakz 4:895c0ae49294 115 pc.printf("Creating a TFTP server... ");
hudakz 1:698437bcd48d 116 server = new TFTPServer(&net, myPort);
hudakz 4:895c0ae49294 117 pc.printf("%s\r\n", (server ? "OK" : "Failed :("));
hudakz 4:895c0ae49294 118 if (!server)
hudakz 4:895c0ae49294 119 return 1;
hudakz 4:895c0ae49294 120
hudakz 4:895c0ae49294 121 if (server->getState() == TFTPServer::LISTENING)
hudakz 4:895c0ae49294 122 pc.printf("\r\nThe TFTP server is listening at port %d.\r\n", myPort);
hudakz 4:895c0ae49294 123 else
hudakz 4:895c0ae49294 124 {
hudakz 4:895c0ae49294 125 pc.printf("\r\nSomething went wrong.\r\nThe TFTP server is not listening.\r\n");
hudakz 4:895c0ae49294 126 return 1;
hudakz 4:895c0ae49294 127 }
hudakz 4:895c0ae49294 128
tuxic 0:5c9e0971532d 129
hudakz 1:698437bcd48d 130 int fileCount = 0; // incoming files
hudakz 1:698437bcd48d 131 char fileName[256]; // to display filenames
hudakz 1:698437bcd48d 132
hudakz 1:698437bcd48d 133 timer.start();
hudakz 1:698437bcd48d 134
hudakz 1:698437bcd48d 135 while (1)
hudakz 1:698437bcd48d 136 {
hudakz 1:698437bcd48d 137 server->poll();
hudakz 1:698437bcd48d 138
hudakz 1:698437bcd48d 139 if (server->fileCount() > fileCount)
hudakz 1:698437bcd48d 140 {
hudakz 1:698437bcd48d 141 fileCount = server->fileCount();
hudakz 1:698437bcd48d 142 server->getFileName(fileName);
hudakz 1:698437bcd48d 143 pc.printf("new file: %s\r\n", fileName);
tuxic 0:5c9e0971532d 144 }
tuxic 0:5c9e0971532d 145 }
tuxic 0:5c9e0971532d 146 }