packages/cygmon/v2_0/misc/bsp/hex-utils.h

   1 #ifndef __BSP_HEX_UTILS_H__
   2 #define __BSP_HEX_UTILS_H__
   3 //==========================================================================
   4 //
   5 //      hex-utils.h
   6 //
   7 //      Utilities for decoding hexadecimal encoded integers.
   8 //
   9 //==========================================================================
  10 //####ECOSGPLCOPYRIGHTBEGIN####
  11 // -------------------------------------------
  12 // This file is part of eCos, the Embedded Configurable Operating System.
  13 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  14 //
  15 // eCos is free software; you can redistribute it and/or modify it under
  16 // the terms of the GNU General Public License as published by the Free
  17 // Software Foundation; either version 2 or (at your option) any later version.
  18 //
  19 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  20 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
  21 // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  22 // for more details.
  23 //
  24 // You should have received a copy of the GNU General Public License along
  25 // with eCos; if not, write to the Free Software Foundation, Inc.,
  26 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  27 //
  28 // As a special exception, if other files instantiate templates or use macros
  29 // or inline functions from this file, or you compile this file and link it
  30 // with other works to produce a work based on this file, this file does not
  31 // by itself cause the resulting work to be covered by the GNU General Public
  32 // License. However the source code for this file must still be made available
  33 // in accordance with section (3) of the GNU General Public License.
  34 //
  35 // This exception does not invalidate any other reasons why a work based on
  36 // this file might be covered by the GNU General Public License.
  37 //
  38 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  39 // at http://sources.redhat.com/ecos/ecos-license/
  40 // -------------------------------------------
  41 //####ECOSGPLCOPYRIGHTEND####
  42 //==========================================================================
  43 //#####DESCRIPTIONBEGIN####
  44 //
  45 // Author(s):
  46 // Contributors: gthomas
  47 // Date:         1999-10-20
  48 // Purpose:      Utilities for decoding hexadecimal encoded integers.
  49 // Description:
  50 //
  51 //
  52 //####DESCRIPTIONEND####
  53 //
  54 //=========================================================================
  55
  56
  57 #ifndef __ASSEMBLER__
  58
  59 /*
  60  * Convert a single hex character to its binary value.
  61  * Returns -1 if given character is not a value hex character.
  62  */
  63 extern int __hex(char ch);
  64
  65 /*
  66  * Convert the hex data in 'buf' into 'count' bytes to be placed in 'mem'.
  67  * Returns a pointer to the character in mem AFTER the last byte written.
  68  */
  69 extern char *__unpack_bytes_to_mem(char *buf, char *mem, int count);
  70
  71 /*
  72  * While finding valid hex chars, build an unsigned long int.
  73  * Return number of hex chars processed.
  74  */
  75 extern int __unpack_ulong(char **ptr, unsigned long *val);
  76
  77 /*
  78  * Unpack 'count' hex characters, forming them into a binary value.
  79  * Return that value as an int. Adjust the source pointer accordingly.
  80  */
  81 extern int __unpack_nibbles(char **ptr, int count);
  82
  83 #endif
  84
  85 #endif // __BSP_HEX_UTILS_H__