* \author Stefano Fedrigo <aleph@develer.com>
*/
-/*
- * $Log$
- * Revision 1.13 2004/08/24 13:16:00 bernie
- * Add type-size definitions for preprocessor.
- *
- * Revision 1.12 2004/08/14 19:37:57 rasky
- * Merge da SC: macros.h, pool.h, BIT_CHANGE, nome dei processi, etc.
- *
- * Revision 1.11 2004/08/05 17:39:56 bernie
- * Fix a Doxygen tag.
- *
- * Revision 1.10 2004/08/02 20:20:29 aleph
- * Merge from project_ks
- *
- * Revision 1.9 2004/07/30 14:24:16 rasky
- * Task switching con salvataggio perfetto stato di interrupt (SR)
- * Kernel monitor per dump informazioni su stack dei processi
- *
- * Revision 1.8 2004/07/30 14:15:53 rasky
- * Nuovo supporto unificato per detect della CPU
- *
- * Revision 1.7 2004/07/20 23:26:48 bernie
- * Fix two errors introduced by previous commit.
- *
- * Revision 1.6 2004/07/20 23:12:16 bernie
- * Rationalize and document SCHEDULER_IDLE.
- *
- * Revision 1.5 2004/07/20 16:20:35 bernie
- * Move byte-order macros to mware/byteorder.h; Add missing author names.
- *
- * Revision 1.4 2004/07/20 16:06:04 bernie
- * Add macros to handle endianess issues.
- *
- * Revision 1.3 2004/07/18 21:49:51 bernie
- * Fixes for GCC 3.5.
- *
- * Revision 1.2 2004/06/03 11:27:09 bernie
- * Add dual-license information.
- *
- * Revision 1.1 2004/05/23 17:48:35 bernie
- * Add top-level files.
- *
- */
-#ifndef CPU_H
-#define CPU_H
-
-#include "compiler.h"
+/*#*
+ *#* $Log$
+ *#* Revision 1.17 2004/09/06 21:48:27 bernie
+ *#* ATOMIC(): New macro.
+ *#*
+ *#* Revision 1.16 2004/08/29 21:58:33 bernie
+ *#* Rename BITS_PER_XYZ macros; Add sanity checks.
+ *#*
+ *#* Revision 1.15 2004/08/25 14:12:08 rasky
+ *#* Aggiornato il comment block dei log RCS
+ *#*
+ *#* Revision 1.14 2004/08/24 13:29:28 bernie
+ *#* Trim CVS log; Rename header guards.
+ *#*
+ *#* Revision 1.12 2004/08/14 19:37:57 rasky
+ *#* Merge da SC: macros.h, pool.h, BIT_CHANGE, nome dei processi, etc.
+ *#*
+ *#* Revision 1.11 2004/08/05 17:39:56 bernie
+ *#* Fix a Doxygen tag.
+ *#*
+ *#* Revision 1.10 2004/08/02 20:20:29 aleph
+ *#* Merge from project_ks
+ *#*
+ *#* Revision 1.9 2004/07/30 14:24:16 rasky
+ *#* Task switching con salvataggio perfetto stato di interrupt (SR)
+ *#* Kernel monitor per dump informazioni su stack dei processi
+ *#*/
+#ifndef DEVLIB_CPU_H
+#define DEVLIB_CPU_H
+
+#include "compiler.h" /* for uintXX_t, PP_CAT3(), PP_STRINGIZE() */
// Macros for determining CPU endianness
#define CPU_BYTE_ORDER CPU_BIG_ENDIAN
/* Memory is word-addessed in the DSP56K */
- #define BITSP_PER_CHAR 16
- #define SIZEOF_SHORT 1
- #define SIZEOF_INT 1
- #define SIZEOF_LONG 2
- #define SIZEOF_PTR 1
+ #define CPU_BITS_PER_CHAR 16
+ #define SIZEOF_SHORT 1
+ #define SIZEOF_INT 1
+ #define SIZEOF_LONG 2
+ #define SIZEOF_PTR 1
#elif CPU_AVR
#endif
+/*!
+ * Execute \a CODE atomically with respect to interrupts.
+ *
+ * \see ENABLE_IRQSAVE DISABLE_IRQRESTORE
+ */
+#define ATOMIC(CODE) \
+ do { \
+ cpuflags_t __flags; \
+ DISABLE_IRQSAVE(__flags); \
+ CODE; \
+ ENABLE_IRQRESTORE(__flags); \
+ } while (0)
+
//! Default for macro not defined in the right arch section
#ifndef CPU_REG_INIT_VALUE
/*!
- * \def SIZEOF_CHAR SIZEOF_SHORT SIZEOF_INT SIZEOF_LONG SIZEOF_PTR
- * \def BITS_PER_CHAR BITS_PER_SHORT BITS_PER_INT BITS_PER_LONG BITS_PER_PTR
+ * \name Default type sizes
*
- * \brief Default type sizes
+ * \def SIZEOF_CHAR SIZEOF_SHORT SIZEOF_INT SIZEOF_LONG SIZEOF_PTR
+ * \def CPU_BITS_PER_CHAR CPU_BITS_PER_SHORT CPU_BITS_PER_INT
+ * \def CPU_BITS_PER_LONG CPU_BITS_PER_PTR
*
* These defaults are reasonable for most 16/32bit machines.
* Some of these macros may be overridden by CPU-specific code above.
*
- * ANSI C specifies that the following equations must be true:
+ * ANSI C requires that the following equations be true:
* \code
* sizeof(char) <= sizeof(short) <= sizeof(int) <= sizeof(long)
* sizeof(float) <= sizeof(double)
- * BITS_PER_CHAR >= 8
- * BITS_PER_SHORT >= 8
- * BITS_PER_INT >= 16
- * BITS_PER_LONG >= 32
+ * CPU_BITS_PER_CHAR >= 8
+ * CPU_BITS_PER_SHORT >= 8
+ * CPU_BITS_PER_INT >= 16
+ * CPU_BITS_PER_LONG >= 32
* \end code
* \{
*/
#define SIZEOF_PTR SIZEOF_INT
#endif
-#ifndef BITS_PER_CHAR
-#define BITS_PER_CHAR (SIZEOF_CHAR * 8)
+#ifndef CPU_BITS_PER_CHAR
+#define CPU_BITS_PER_CHAR (SIZEOF_CHAR * 8)
#endif
-#ifndef BITS_PER_SHORT
-#define BITS_PER_SHORT (SIZEOF_SHORT * BITS_PER_CHAR)
+#ifndef CPU_BITS_PER_SHORT
+#define CPU_BITS_PER_SHORT (SIZEOF_SHORT * CPU_BITS_PER_CHAR)
#endif
-#ifndef BITS_PER_INT
-#define BITS_PER_INT (SIZEOF_INT * BITS_PER_CHAR)
+#ifndef CPU_BITS_PER_INT
+#define CPU_BITS_PER_INT (SIZEOF_INT * CPU_BITS_PER_CHAR)
#endif
-#ifndef BITS_PER_LONG
-#define BITS_PER_LONG (SIZEOF_LONG * BITS_PER_CHAR)
+#ifndef CPU_BITS_PER_LONG
+#define CPU_BITS_PER_LONG (SIZEOF_LONG * CPU_BITS_PER_CHAR)
#endif
-#ifndef BITS_PER_PTR
-#define BITS_PER_PTR (SIZEOF_PTR * BITS_PER_CHAR)
+#ifndef CPU_BITS_PER_PTR
+#define CPU_BITS_PER_PTR (SIZEOF_PTR * CPU_BITS_PER_CHAR)
#endif
/*\}*/
+/* Sanity checks for the above definitions */
+STATIC_ASSERT(sizeof(char) == SIZEOF_CHAR);
+STATIC_ASSERT(sizeof(short) == SIZEOF_SHORT);
+STATIC_ASSERT(sizeof(long) == SIZEOF_LONG);
+STATIC_ASSERT(sizeof(int) == SIZEOF_INT);
+
/*!
* \def SCHEDULER_IDLE
#endif /* !ARCH_EMUL */
#endif /* !SCHEDULER_IDLE */
-#endif /* CPU_H */
+#endif /* DEVLIB_CPU_H */