tftp.h

针对德州仪器DM270开发板的bootloader,其实现了内核的下载以及文件系统的下载

/*
 * File: tftp.h
 *
 * This is an interface to a utility which supplies the caller with the byte
 * stream of a file being pulled through the ether port via TFTP.
 *
 * See Also
 *   tftp.c -- An implementation exposing a tftp.h interface.
 *
 * Copyright (C) 2002 RidgeRun, Inc.
 * Author: RidgeRun, Inc  <[e-mail]>
 *
 *  This program is free software; you can redistribute  it and/or modify it
 *  under  the terms of  the GNU General  Public License as published by the
 *  Free Software Foundation;  either version 2 of the  License, or (at your
 *  option) any later version.
 *
 *  THIS  SOFTWARE  IS  PROVIDED  ``AS  IS''  AND   ANY  EXPRESS  OR IMPLIED
 *  WARRANTIES,   INCLUDING, BUT NOT  LIMITED  TO, THE IMPLIED WARRANTIES OF
 *  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
 *  NO  EVENT  SHALL   THE AUTHOR  BE    LIABLE FOR ANY   DIRECT,  INDIRECT,
 *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 *  NOT LIMITED   TO, PROCUREMENT OF  SUBSTITUTE GOODS  OR SERVICES; LOSS OF
 *  USE, DATA,  OR PROFITS; OR  BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 *  ANY THEORY OF LIABILITY, WHETHER IN  CONTRACT, STRICT LIABILITY, OR TORT
 *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 *  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *  You should have received a copy of the  GNU General Public License along
 *  with this program; if not, write  to the Free Software Foundation, Inc.,
 *  675 Mass Ave, Cambridge, MA 02139, USA.
 *
 * Please report all bugs/problems to the author or <[e-mail]>
 *
 * key: RRGPLCR (do not remove)
 *
 */

#ifndef TFTP_H
#define TFTP_H

extern void connect_tftp(char *device_IP,
                         char *host_IP,
                         char *device_MAC, // MACs may be NULL only if 
                         char *host_MAC,   // our network stack has ARP.
                         char *fname);

  // --connect_tftp--
  // This call should be made for each file that you intend
  // on reading into the ether port. After this call is made
  // the client may use successive getchar_tftp() calls to
  // retrieve the file's contents.

extern void disconnect_tftp(void);

  // --disconnect_tftp--
  // This call should be made after the client has
  // retrieved the files's final byte from getchar_tftp().

extern unsigned char getchar_tftp(void);

  // --getchar_tftp--
  // Retrieves another byte of the file which is
  // being transfered into our ether port via TFTP.
  // Bytes are retrieved in the order they appear
  // within the host-file specified in the most recent
  // connect_tftp() call. The getchar_tftp call blocks
  // until the next byte becomes available.

extern void tftp_init(void);

  // Should be called once to initialize the underlying
  // implementation prior to using any of the supplied routines.

#endif