Compiler abstraction layer and code utilities

Compiler abstraction layer and code utilities for 32-bit AVR.

This module provides various abstraction layers and utilities to make code compatible between different compilers.

Modules
	Preprocessor - Stringize
	Preprocessor - Token Paste
	Status Codes
	Preprocessor - Macro Repeat

Macros
#define	barrier()   asm volatile("" ::: "memory")
	Memory barrier. More...
#define	COMPILER_ALIGNED(a)   __attribute__((__aligned__(a)))
	Set aligned boundary. More...
#define	COMPILER_PACK_RESET()   COMPILER_PRAGMA(pack())
	Set default alignment for subsequent struct and union definitions. More...
#define	COMPILER_PACK_SET(alignment)   COMPILER_PRAGMA(pack(alignment))
	Set maximum alignment for subsequent struct and union definitions to alignment. More...
#define	COMPILER_PRAGMA(arg)   _Pragma(#arg)
	Emit the compiler pragma arg. More...
#define	COMPILER_WORD_ALIGNED   __attribute__((__aligned__(4)))
	Set word-aligned boundary. More...
#define	Get_system_register(reg)   sysreg_read(reg)
#define	Set_system_register(reg, val)   sysreg_write(reg, val)
#define	sysreg_write(reg, val)   __builtin_mtsr(reg, val)
	Set value of system register. More...
#define	UNUSED(v)   (void)(v)
	Marking v as a unused parameter or value. More...
#define	unused(v)   do { (void)(v); } while(0)
	Marking v as a unused parameter or value. More...

System Register Access
#define	sysreg_read(reg)   __builtin_mfsr(reg)
	Get value of system register. More...

Tag functions as deprecated
Tagging a function as deprecated will produce a warning when and only when the function is called. Usage is to add the DEPRECATED symbol before the function definition. E.g.: DEPRECATED uint8_t some_deprecated_function (void) { ... } Note Only supported by GCC 3.1 and above, no IAR support
#define	__DEPRECATED__   __attribute__((__deprecated__))

#define __DEPRECATED__   __attribute__((__deprecated__))

#define barrier

(

)

asm volatile("" ::: "memory")

Memory barrier.

Referenced by cpu_irq_restore(), fifo_pull_uint16(), fifo_pull_uint16_nocheck(), fifo_pull_uint32(), fifo_pull_uint32_nocheck(), fifo_pull_uint8(), fifo_pull_uint8_nocheck(), fifo_push_uint16(), fifo_push_uint16_nocheck(), fifo_push_uint32(), fifo_push_uint32_nocheck(), fifo_push_uint8(), and fifo_push_uint8_nocheck().

#define COMPILER_ALIGNED

(

a

)

__attribute__((__aligned__(a)))

Set aligned boundary.

Referenced by stream_mem_to_mem().

#define COMPILER_PACK_RESET

(

)

COMPILER_PRAGMA(pack())

Set default alignment for subsequent struct and union definitions.

#define COMPILER_PACK_SET

(

alignment

)

COMPILER_PRAGMA(pack(alignment))

Set maximum alignment for subsequent struct and union definitions to alignment.

#define COMPILER_PRAGMA

(

arg

)

_Pragma(#arg)

Emit the compiler pragma arg.

Parameters

arg	The pragma directive as it would appear after #pragma (i.e. not stringified).

#define COMPILER_WORD_ALIGNED   __attribute__((__aligned__(4)))

Set word-aligned boundary.

#define Get_system_register

(

reg

)

sysreg_read(reg)

Referenced by configure_memory_area(), cpu_is_timeout(), cpu_set_timeout(), gpio_local_init(), sdramc_ck_delay(), sensor_timestamp(), set_access_permissions(), time_tick_get(), and toggle_led().

#define Set_system_register	(		reg,
			val
	)		sysreg_write(reg, val)

Referenced by _init_startup(), disable_mpu(), disable_mpu_entry(), enable_mpu(), gpio_local_init(), init_exceptions(), INTC_init_evba(), select_subregion(), set_access_permissions(), and set_mpu_entry().

#define sysreg_read

(

reg

)

__builtin_mfsr(reg)

Get value of system register.

Parameters

reg	Address of the system register of which to get the value.

Returns

Value of system register reg.

Referenced by cpu_irq_save(), twi_master_init(), and twi_slave_init().

#define sysreg_write	(		reg,
			val
	)		__builtin_mtsr(reg, val)

Set value of system register.

Parameters

reg	Address of the system register of which to set the value.
val	Value to set the system register reg to.

#define UNUSED

(

v

)

(void)(v)

Marking v as a unused parameter or value.

#define unused

(

v

)

do { (void)(v); } while(0)

Marking v as a unused parameter or value.