/* * File: rawbin.h * * An interface definition of an BINARY parser. As an example, the `mkimage` * utility can be run to convert a standard binary executable (such as ELF) * into the special RR_BINARY format suitable for download to a bootloader * incorporating this module. * * See Also *   rawbin.c -- An implementation exposing a rawbin.h interface. * * Copyright (C) 2002 RidgeRun, Inc. * Author: RidgeRun, Inc  <skranz@ridgerun.com> * *  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 <support@dsplinux.net> * * key: RRGPLCR (do not remove) * */#ifndef RAWBIN_H#define RAWBIN_H#include "types.h"#include "flash.h"extern void rawbin_RegisterGetByte(GetByteCallBack_t CBack);  // --rawbin_RegisterGetByte--  // Allows the caller to register the getchar  // callback routine that will be used during  // the processing of a rawbin_parse().extern void rawbin_RegisterPut(PutValAtAddrCallBack_t CBack);  // --rawbin_RegisterPut--  // Allows the caller to register the "put"  // callback routine that will be used during  // the processing of a rawbin_parse().extern ParseStatus_t rawbin_parse(unsigned int *load_addr,  // out                                  unsigned int *entry_addr, // out                                  unsigned int *num_bytes,				  unsigned int *use_header); // out  // --rawbin_parse--  // Use rawbin_parse to process the binary stream  // and produce a set of Put() calls forming   // the address/val pairs necessary to load the  // incoming image into memory. Uses the caller's  // supplied GetByte() and PutByte() routines  // during the processing.  //  // Parameters:  //   These output values are set by the parse operation  //   and summarize the resulting load to memory.  //   use_header will be true if the 20 byte header should  //   be stored in flash.  JFFS type file systems don't work  //   with the rrload flash header.#endif