b76bf99d7c
Added VAL2FIELD_M / SET_FIELD_M for rare cases when there might actually be some need for it.
54 lines
2 KiB
C
54 lines
2 KiB
C
/* Some common compiler macros
|
|
*
|
|
* Not esp8266-specific.
|
|
*
|
|
* Part of esp-open-rtos
|
|
* Copyright (C) 2015 Superhouse Automation Pty Ltd
|
|
* BSD Licensed as described in the file LICENSE
|
|
*/
|
|
|
|
#ifndef _COMMON_MACROS_H
|
|
#define _COMMON_MACROS_H
|
|
|
|
#define UNUSED __attributed((unused))
|
|
|
|
#ifndef BIT
|
|
#define BIT(X) (1<<(X))
|
|
#endif
|
|
|
|
/* These macros convert values to/from bitfields specified by *_M and *_S (mask
|
|
* and shift) constants. Used primarily with ESP8266 register access.
|
|
*/
|
|
|
|
#define VAL2FIELD(fieldname, value) ((value) << fieldname##_S)
|
|
#define FIELD2VAL(fieldname, regbits) (((regbits) >> fieldname##_S) & fieldname##_M)
|
|
|
|
#define FIELD_MASK(fieldname) (fieldname##_M << fieldname##_S)
|
|
#define SET_FIELD(regbits, fieldname, value) (((regbits) & ~FIELD_MASK(fieldname)) | VAL2FIELD(fieldname, value))
|
|
|
|
/* VAL2FIELD/SET_FIELD do not normally check to make sure that the passed value
|
|
* will fit in the specified field (without clobbering other bits). This makes
|
|
* them faster and is usually fine. If you do need to make sure that the value
|
|
* will not overflow the field, use VAL2FIELD_M or SET_FIELD_M (which will
|
|
* first mask the supplied value to only the allowed number of bits) instead.
|
|
*/
|
|
#define VAL2FIELD_M(fieldname, value) (((value) & fieldname##_M) << fieldname##_S)
|
|
#define SET_FIELD_M(regbits, fieldname, value) (((regbits) & ~FIELD_MASK(fieldname)) | VAL2FIELD_M(fieldname, value))
|
|
|
|
/* Use this macro to store constant values in IROM flash instead
|
|
of having them loaded into rodata (which resides in DRAM)
|
|
|
|
Unlike the ESP8266 SDK you don't need an attribute like this for
|
|
standard functions. They're stored in flash by default. But
|
|
variables need them.
|
|
|
|
Important to note: IROM flash can only be accessed via 32-bit word
|
|
aligned reads. It's up to the user of this attribute to ensure this.
|
|
*/
|
|
#define IROM __attribute__((section(".irom0.literal"))) const
|
|
|
|
#define INLINED inline static __attribute__((always_inline)) __attribute__((unused))
|
|
|
|
#define IRAM __attribute__((section(".iram1.text")))
|
|
|
|
#endif
|