Q群：
电话：
邮箱：
地址：
OneOS简介
硬件支持
编译构造工具
API参考文档
技术架构及目录结构
内核
驱动
高级语言
设备模型
ADC设备
DAC设备
Pulse Encoder设备
PWM设备
Serial设备
LPM设备
I2C设备
SPI设备
USB设备
Sensor设备
RTC设备
Watchdog设备
Clocksource设备
Clockevent设备
Crypto设备
CAN设备
Touch设备
Audio设备
WLAN设备
组件
MicroPython
用户编程手册
应用笔记
FAQ
标准宏定义
编译器指令相关宏定义
#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)
#define __CLANG_ARM
#endif
/* Compiler related definitions */
#if defined(__CC_ARM) || defined(__CLANG_ARM) /* For ARM compiler */
#define OS_SECTION(x) __attribute__((section(x)))
#define OS_ALIGN(n) __attribute__((aligned(n)))
#define OS_UNUSED __attribute__((unused))
#define OS_USED __attribute__((used))
#define OS_WEAK __attribute__((weak))
#define OS_INLINE static __inline
#elif defined (__IAR_SYSTEMS_ICC__) /* For IAR compiler */
#define OS_SECTION(x) @ x
#define OS_PRAGMA(x) _Pragma(#x)
#define OS_ALIGN(n) OS_PRAGMA(data_alignment=n)
#define OS_UNUSED
#define OS_USED __root
#define OS_WEAK __weak
#define OS_INLINE static inline
#elif defined (__GNUC__) /* For GNU GCC compiler */
#define OS_SECTION(x) __attribute__((section(x)))
#define OS_ALIGN(n) __attribute__((aligned(n)))
#define OS_UNUSED __attribute__((unused))
#define OS_USED __attribute__((used))
#define OS_WEAK __attribute__((weak))
#define OS_INLINE static __inline
#elif defined (__ADSPBLACKFIN__) /* For VisualDSP++ compiler */
#define OS_SECTION(x) __attribute__((section(x)))
#define OS_ALIGN(n) __attribute__((aligned(n)))
#define OS_UNUSED __attribute__((unused))
#define OS_USED __attribute__((used))
#define OS_WEAK __attribute__((weak))
#define OS_INLINE static inline
#else
#error Not supported tool chain
#endif
| 定义 | 说明 |
|---|---|
| OS_SECTION(x) | 段定义，将变量或函数放到指定的段中 |
| OS_ALIGN(n) | 字节对齐，作用是在给某对象分配地址空间时，指定n字节对齐，n一般为2的幂次方 |
| OS_UNUSED | 表示函数或者变量可能不使用，避免编译器产生告警 |
| OS_USED | 告诉编译器静态函数即使没有被调用也要链接 |
| OS_WEAK | 编译器链接时优先链接没有该关键字的函数，如果找不到才链接由该关键字修饰的函数 |
| OS_INLINE | 内联函数 |
自动初始化相关宏定义
该功能用于在系统初始化过程中，自动执行被OS_INIT_EXPORT修饰的函数，其中的数字越小，优先级越高，越先被执行。定义如下：
/* Auto initialization function type */
typedef os_err_t (*os_init_fn_t)(void);
#define OS_INIT_EXPORT(fn, level) \
OS_USED const os_init_fn_t __os_call_##fn OS_SECTION(".init_call."level) = fn
#define OS_BOARD_INIT(fn) OS_INIT_EXPORT(fn, "1") /* board init */
#define OS_PREV_INIT(fn) OS_INIT_EXPORT(fn, "2") /* pre-initialization except board(pure software initilization) */
#define OS_DEVICE_INIT(fn) OS_INIT_EXPORT(fn, "3") /* device initialization */
#define OS_CMPOENT_INIT(fn) OS_INIT_EXPORT(fn, "4") /* components initialization (dfs, lwip, ...) */
#define OS_ENV_INIT(fn) OS_INIT_EXPORT(fn, "5") /* environment initialization (mount disk, ...) */
#define OS_APP_INIT(fn) OS_INIT_EXPORT(fn, "6") /* appliation initialization */
| 定义 | 说明 |
|---|---|
| OS_BOARD_INIT(fn) | 板级自动初始化，优先级最高 |
| OS_PREV_INIT(fn) | 前置自动初始化，主要用于纯软件且没有太多依赖的初始化 |
| OS_DEVICE_INIT(fn) | 设备驱动级自动初始化 |
| OS_CMPOENT_INIT(fn) | 组件级自动初始化 |
| OS_ENV_INIT(fn) | 环境级自动初始化 |
| OS_APP_INIT(fn) | 应用程序级自动初始化 |
其它宏定义
#ifdef __cplusplus
#define OS_NULL 0
#else
#define OS_NULL ((void *)0)
#endif
#define OS_FALSE 0
#define OS_TRUE 1
#define OS_ALIGN_UP(size, align) (((size) + (align) - 1) & ~((align) - 1))
#define OS_ALIGN_DOWN(size, align) ((size) & ~((align) - 1))
#define OS_ARRAY_SIZE(x) (sizeof(x) / sizeof(x[0]))
#define os_container_of(ptr, type, member) \
((type *)((char *)(ptr) - (unsigned long)(&((type *)0)->member)))
#define os_offsetof(type, member) ((os_size_t) &((type *)0)->member)
| 定义 | 说明 |
|---|---|
| OS_ALIGN_UP(size, align) | 数字大小向上对齐，如OS_ALIGN_UP(5,4)，返回8 |
| OS_ALIGN_DOWN(size, align) | 数字大小向下对齐，如OS_ALIGN_DOWN(5,4)，返回4 |
| OS_ARRAY_SIZE | 求数组尺寸 |
| os_container_of(ptr, type, member) | 已知结构体type的成员member的地址ptr，求结构体type的起始地址 |
| os_offsetof(type, member) | 求成员member在结构体type内的偏移 |
