git.gag.com Git - fw/openocd/blob - src/helper/types.h

   1 /***************************************************************************
   2  *   Copyright (C) 2004, 2005 by Dominic Rath                              *
   3  *   Dominic.Rath@gmx.de                                                   *
   4  *                                                                         *
   5  *   Copyright (C) 2007,2008 Øyvind Harboe                                 *
   6  *   oyvind.harboe@zylin.com                                               *
   7  *                                                                         *
   8  *   This program is free software; you can redistribute it and/or modify  *
   9  *   it under the terms of the GNU General Public License as published by  *
  10  *   the Free Software Foundation; either version 2 of the License, or     *
  11  *   (at your option) any later version.                                   *
  12  *                                                                         *
  13  *   This program is distributed in the hope that it will be useful,       *
  14  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  15  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  16  *   GNU General Public License for more details.                          *
  17  *                                                                         *
  18  *   You should have received a copy of the GNU General Public License     *
  19  *   along with this program; if not, write to the                         *
  20  *   Free Software Foundation, Inc.,                                       *
  21  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  22  ***************************************************************************/
  23 #ifndef TYPES_H
  24 #define TYPES_H
  25
  26 #include <stddef.h>
  27 #ifdef HAVE_SYS_TYPES_H
  28 #include <sys/types.h>
  29 #endif
  30 #ifdef HAVE_STDINT_H
  31 #include <stdint.h>
  32 #endif
  33 #ifdef HAVE_INTTYPES_H
  34 #include <inttypes.h>
  35 #endif
  36
  37 #ifdef HAVE_STDBOOL_H
  38 #include <stdbool.h>
  39 #else   /* HAVE_STDBOOL_H */
  40 #define __bool_true_false_are_defined 1
  41
  42 #ifndef HAVE__BOOL
  43 #ifndef __cplusplus
  44
  45 #define false   0
  46 #define true            1
  47
  48 typedef int _Bool;
  49 #else
  50 typedef bool _Bool;
  51 #endif  /* __cplusplus */
  52 #endif  /* HAVE__BOOL */
  53
  54 #define bool _Bool
  55
  56 #endif  /* HAVE_STDBOOL_H */
  57
  58 /// turns a macro argument into a string constant
  59 #define stringify(s) __stringify(s)
  60 #define __stringify(s) #s
  61
  62
  63 /**
  64  * Cast a member of a structure out to the containing structure.
  65  * @param ptr The pointer to the member.
  66  * @param type The type of the container struct this is embedded in.
  67  * @param member The name of the member within the struct.
  68  *
  69  * This is a mechanism which is used throughout the Linux kernel.
  70  */
  71 #define container_of(ptr, type, member) ({                      \
  72         const typeof( ((type *)0)->member ) *__mptr = (ptr);    \
  73         (type *)( (char *)__mptr - offsetof(type,member) );})
  74
  75
  76 /**
  77  * Rounds @c m up to the nearest multiple of @c n using division.
  78  * @params m The value to round up to @c n.
  79  * @params n Round @c m up to a multiple of this number.
  80  * @returns The rounded integer value.
  81  */
  82 #define DIV_ROUND_UP(m, n)      (((m) + (n) - 1) / (n))
  83
  84
  85 /* DANGER!!!! here be dragons!
  86  *
  87  * Leave these fn's as byte accesses because it is safe
  88  * across architectures. Clever usage of 32 bit access
  89  * will create problems on some hosts.
  90  *
  91  * Note that the "buf" pointer in memory is probably unaligned.
  92  *
  93  * Were these functions to be re-written to take a 32 bit wide or 16 bit wide
  94  * memory access shortcut, then on some CPU's, i.e. ARM7, the 2 lsbytes of the address are
  95  * ignored for 32 bit access, whereas on other CPU's a 32 bit wide unaligned memory access
  96  * will cause an exception, and lastly on x86, an unaligned "greater than bytewide"
  97  * memory access works as if aligned.  So what follows below will work for all
  98  * platforms and gives the compiler leeway to do its own platform specific optimizations.
  99  *
 100  * Again, note that the "buf" pointer in memory is probably unaligned.
 101  */
 102
 103
 104 static inline uint32_t le_to_h_u32(const uint8_t* buf)
 105 {
 106         return (uint32_t)(buf[0] | buf[1] << 8 | buf[2] << 16 | buf[3] << 24);
 107 }
 108
 109 static inline uint16_t le_to_h_u16(const uint8_t* buf)
 110 {
 111         return (uint16_t)(buf[0] | buf[1] << 8);
 112 }
 113
 114 static inline uint32_t be_to_h_u32(const uint8_t* buf)
 115 {
 116         return (uint32_t)(buf[3] | buf[2] << 8 | buf[1] << 16 | buf[0] << 24);
 117 }
 118
 119 static inline uint16_t be_to_h_u16(const uint8_t* buf)
 120 {
 121         return (uint16_t)(buf[1] | buf[0] << 8);
 122 }
 123
 124 static inline void h_u32_to_le(uint8_t* buf, int val)
 125 {
 126         buf[3] = (uint8_t) (val >> 24);
 127         buf[2] = (uint8_t) (val >> 16);
 128         buf[1] = (uint8_t) (val >> 8);
 129         buf[0] = (uint8_t) (val >> 0);
 130 }
 131
 132 static inline void h_u32_to_be(uint8_t* buf, int val)
 133 {
 134         buf[0] = (uint8_t) (val >> 24);
 135         buf[1] = (uint8_t) (val >> 16);
 136         buf[2] = (uint8_t) (val >> 8);
 137         buf[3] = (uint8_t) (val >> 0);
 138 }
 139
 140 static inline void h_u16_to_le(uint8_t* buf, int val)
 141 {
 142         buf[1] = (uint8_t) (val >> 8);
 143         buf[0] = (uint8_t) (val >> 0);
 144 }
 145
 146 static inline void h_u16_to_be(uint8_t* buf, int val)
 147 {
 148         buf[0] = (uint8_t) (val >> 8);
 149         buf[1] = (uint8_t) (val >> 0);
 150 }
 151
 152 #if defined(__ECOS)
 153
 154 /* eCos plain lacks these definition... A series of upstream patches
 155  * could probably repair it, but it seems like too much work to be
 156  * worth it.
 157  */
 158
 159 #if !defined(_STDINT_H)
 160 #define PRIx32 "x"
 161 #define PRId32 "d"
 162 #define SCNx32 "x"
 163 #define PRIi32 "i"
 164 #define PRIu32 "u"
 165
 166 typedef CYG_ADDRWORD intptr_t;
 167 typedef int64_t intmax_t;
 168 typedef uint64_t uintmax_t;
 169 #define INT8_MAX 0x7f
 170 #define INT8_MIN (-INT8_MAX - 1)
 171 # define UINT8_MAX              (255)
 172 #define INT16_MAX 0x7fff
 173 #define INT16_MIN (-INT16_MAX - 1)
 174 # define UINT16_MAX             (65535)
 175 #define INT32_MAX 0x7fffffffL
 176 #define INT32_MIN (-INT32_MAX - 1L)
 177 # define UINT32_MAX             (4294967295U)
 178 #define INT64_MAX 0x7fffffffffffffffLL
 179 #define INT64_MIN (-INT64_MAX - 1LL)
 180 #define UINT64_MAX (__CONCAT(INT64_MAX, U) * 2ULL + 1ULL)
 181 #endif
 182
 183     #ifndef LLONG_MAX
 184         #define ULLONG_MAX      UINT64_C(0xFFFFFFFFFFFFFFFF)
 185         #define LLONG_MAX       INT64_C(0x7FFFFFFFFFFFFFFF)
 186         #define LLONG_MIN       ULLONG_MAX
 187     #endif
 188
 189
 190 #define ULLONG_MAX 18446744073709551615
 191
 192 /* C99, eCos is C90 compliant (with bits of C99) */
 193 #define isblank(c) ((c) == ' ' || (c) == '\t')
 194
 195
 196 #endif
 197
 198 #endif /* TYPES_H */