无锡建设信息中心网站,古镇营销型网站建设,合肥政务新区建设局网站,页面模板怎么修改文章目录1.RT-Thread版本信息2.RT-Thrad基础数据类型定义3.RT-Thread基本数据类型的范围4.RT-Thread系统滴答时钟最大计数值5.RT-Thread IPC数据类型范围6.RT-Thread避免未使用变量警告7.编译器相关定义8.编译器相关定义9.RT-Thread错误码定义1.RT-Thread版本信息
/* RT-Threa…
文章目录1.RT-Thread版本信息2.RT-Thrad基础数据类型定义3.RT-Thread基本数据类型的范围4.RT-Thread系统滴答时钟最大计数值5.RT-Thread IPC数据类型范围6.RT-Thread避免未使用变量警告7.编译器相关定义8.编译器相关定义9.RT-Thread错误码定义1.RT-Thread版本信息
/* RT-Thread version information */
#define RT_VERSION 4 /** major version number */
#define RT_SUBVERSION 1 /** minor version number */
#define RT_REVISION 1 /** revise version number *//* RT-Thread version */
#define RTTHREAD_VERSION RT_VERSION_CHECK(RT_VERSION, RT_SUBVERSION, RT_REVISION)使用方法可用于bsp指定RT-Thread版本
例如
#if (RTTHREAD_VERSION RT_VERSION_CHECK(4, 1, 0) */
#define RT_VERSION_CHECK(major, minor, revise) ((major * 10000) \(minor * 100) revise)2.RT-Thrad基础数据类型定义
/* RT-Thread basic data type definitions */
#ifndef RT_USING_ARCH_DATA_TYPE /* 简单来说开启此宏定义后BSP就会在ARCH_CPU 级别定义基本数据类型 */
#ifdef RT_USING_LIBC /* 用于控制是否使用标准C库函数 */
typedef int8_t rt_int8_t; /** 8bit integer type */
typedef int16_t rt_int16_t; /** 16bit integer type */
typedef int32_t rt_int32_t; /** 32bit integer type */
typedef uint8_t rt_uint8_t; /** 8bit unsigned integer type */
typedef uint16_t rt_uint16_t; /** 16bit unsigned integer type */
typedef uint32_t rt_uint32_t; /** 32bit unsigned integer type */
typedef int64_t rt_int64_t; /** 64bit integer type */
typedef uint64_t rt_uint64_t; /** 64bit unsigned integer type */
typedef size_t rt_size_t; /** Type for size number */#else
typedef signed char rt_int8_t; /** 8bit integer type */
typedef signed short rt_int16_t; /** 16bit integer type */
typedef signed int rt_int32_t; /** 32bit integer type */
typedef unsigned char rt_uint8_t; /** 8bit unsigned integer type */
typedef unsigned short rt_uint16_t; /** 16bit unsigned integer type */
typedef unsigned int rt_uint32_t; /** 32bit unsigned integer type */#ifdef ARCH_CPU_64BIT /* 判断当前程序运行的CPU架构是否为64位 */
typedef signed long rt_int64_t; /** 64bit integer type */
typedef unsigned long rt_uint64_t; /** 64bit unsigned integer type */
typedef unsigned long rt_size_t; /** Type for size number */
#else
typedef signed long long rt_int64_t; /** 64bit integer type */
typedef unsigned long long rt_uint64_t; /** 64bit unsigned integer type */
typedef unsigned int rt_size_t; /** Type for size number */
#endif /* ARCH_CPU_64BIT */
#endif /* RT_USING_LIBC */
#endif /* RT_USING_ARCH_DATA_TYPE */typedef int rt_bool_t; /** boolean type */
typedef long rt_base_t; /** Nbit CPU related date type */
typedef unsigned long rt_ubase_t; /** Nbit unsigned CPU related data type */typedef rt_base_t rt_err_t; /** Type for error number */
typedef rt_uint32_t rt_time_t; /** Type for time stamp */
typedef rt_uint32_t rt_tick_t; /** Type for tick count */
typedef rt_base_t rt_flag_t; /** Type for flags */
typedef rt_ubase_t rt_dev_t; /** Type for device */
typedef rt_base_t rt_off_t; /** Type for offset *//* boolean type definitions */
#define RT_TRUE 1 /** boolean true */
#define RT_FALSE 0 /** boolean fails *//* null pointer definition */
#define RT_NULL 0rt_base_t为了使代码可以在不同的CPU上移植并保持向后兼容性。long类型的位数bit数可能因不同的CPU体系结构而有所不同但是使用rt_base_t代替long可以隐藏这种差异以实现代码的可移植性。rt_ubase_t原理相同 rt_err_t代表错误码的数据类型这里使用了之前定义的rt_base_t作为它的别名。 rt_time_t代表时间戳的数据类型这里使用了rt_uint32_t作为它的别名。rt_uint32_t是一个32位无符号整数类型可以用来表示1970年1月1日以来的秒数。 rt_tick_t代表系统时钟节拍计数的数据类型这里也使用了rt_uint32_t作为它的别名。在嵌入式系统中通常会使用硬件定时器来产生一个固定频率的中断信号并且在每次中断时对rt_tick_t进行递增操作从而实现对时间的计数。 rt_flag_t代表标志位的数据类型这里使用了之前定义的rt_base_t作为它的别名。 rt_dev_t代表设备号的数据类型这里使用了rt_ubase_t作为它的别名。在嵌入式系统中通常会有多个外设需要使用不同的设备号进行标识因此需要定义一个数据类型来保存设备号。 rt_off_t代表偏移量的数据类型这里也使用了之前定义的rt_base_t作为它的别名。在文件系统中通常需要记录某个文件中的偏移量即当前读写位置因此需要定义一个数据类型来保存偏移量。
3.RT-Thread基本数据类型的范围
/* maximum value of base type */
#ifdef RT_USING_LIBC
#define RT_UINT8_MAX UINT8_MAX /** Maximum number of UINT8 */
#define RT_UINT16_MAX UINT16_MAX /** Maximum number of UINT16 */
#define RT_UINT32_MAX UINT32_MAX /** Maximum number of UINT32 */
#else
#define RT_UINT8_MAX 0xff /** Maximum number of UINT8 */
#define RT_UINT16_MAX 0xffff /** Maximum number of UINT16 */
#define RT_UINT32_MAX 0xffffffff /** Maximum number of UINT32 */
#endif /* RT_USING_LIBC */附此处的UINT8_MAX、UINT16_MAX、UINT32_MAX为编译器预定的宏定义
4.RT-Thread系统滴答时钟最大计数值
#define RT_TICK_MAX RT_UINT32_MAX /** Maximum number of tick */5.RT-Thread IPC数据类型范围
/* maximum value of ipc type */
#define RT_SEM_VALUE_MAX RT_UINT16_MAX /** Maximum number of semaphore .value */
#define RT_MUTEX_VALUE_MAX RT_UINT16_MAX /** Maximum number of mutex .value */
#define RT_MUTEX_HOLD_MAX RT_UINT8_MAX /** Maximum number of mutex .hold */
#define RT_MB_ENTRY_MAX RT_UINT16_MAX /** Maximum number of mailbox .entry */
#define RT_MQ_ENTRY_MAX RT_UINT16_MAX /** Maximum number of message queue .entry */6.RT-Thread避免未使用变量警告
#define RT_UNUSED(x) ((void)x)**该宏定义表示将变量x强制转换为void类型从而告诉编译器该变量未被使用从而避免编译器发出“未使用变量”的警告。这种空操作常常用于函数参数或者结构体成员的声明中因为有时候我们为了某些原因不得不声明一个变量但在实际使用中却无需使用它这时候就可以使用这个宏来标记变量未被使用。 **
下面是一个例子假设在编写一个C语言程序时需要使用qsort()函数进行数组排序。
该函数的第一个参数是一个void类型的指针用于表示要排序的数组。
在实际使用中我们可能并不需要使用这个参数。但是由于该函数的参数列表中必须要有第一个参数而且其类型为void*因此我们不得不将一个无用的参数传递给函数否则就会编译错误。
这时候就可以使用RT_UNUSED宏来标记这个参数未被使用代码如下
#include stdlib.hint cmp(const void *a, const void *b)
{/* sort code */
}int main()
{int arr[10] {3, 1, 4, 1, 5, 9, 2, 6, 5, 3};qsort(arr, 10, sizeof(int), cmp); // 必须传递一个void*类型参数return 0;
}int cmp(const void *a, const void *b)
{RT_UNUSED(a); // 标记参数未使用RT_UNUSED(b); // 标记参数未使用return 0;
}这样就可以避免编译器报“未使用变量a/b”的警告了。
7.编译器相关定义
/* Compiler Related Definitions */
#if defined(__ARMCC_VERSION) /* ARM Compiler */
#define RT_SECTION(x) __attribute__((section(x)))
#define RT_USED __attribute__((used))
#define ALIGN(n) __attribute__((aligned(n)))
#define RT_WEAK __attribute__((weak))
#define rt_inline static __inlineRT_SECTION(x)表示将所修饰的数据/函数放置在指定的section中x为section名字通常是一个字符串。这个宏可以用于在程序中指定某些数据/函数位于特定的内存区域比如放在Flash中或者RAM中以满足不同的需求。该宏使用了GCC的语法扩展。RT_USED表示告诉编译器保留所修饰的数据/函数即使它没有被直接引用或调用。该宏通常用于防止删除不需要的代码和变量以及确保所需的函数和变量在链接时能够正确地生成和调用。该宏使用了GCC的语法扩展。ALIGN(n)表示将所修饰的数据/函数按照n字节对齐即从地址0开始每隔n个字节就对齐一次。该宏通常用于解决访问未对齐的数据导致的性能问题以及操作系统中数据结构对齐的需求。该宏同样使用了GCC的语法扩展。RT_WEAK表示将所修饰的数据/函数标记为弱引用即该数据/函数可以被重定义。当出现多个同名的弱引用时链接器会选择其中优先级最高的一个。该宏通常用于提供一些默认实现但允许用户在需要时重写它们。该宏同样使用了GCC的语法扩展。rt_inline表示将所修饰的函数定义为静态内联函数即在编译时将函数的代码直接嵌入到调用处以避免隐式调用带来的额外开销。该宏同样使用了GCC的语法扩展。
8.编译器相关定义
/* Compiler Related Definitions */
#if defined(__ARMCC_VERSION) /* ARM Compiler */
#define RT_SECTION(x) __attribute__((section(x)))
#define RT_USED __attribute__((used))
#define ALIGN(n) __attribute__((aligned(n)))
#define RT_WEAK __attribute__((weak))
#define rt_inline static __inline/* module compiling */
#ifdef RT_USING_MODULE
#define RTT_API __declspec(dllimport)
#else
#define RTT_API __declspec(dllexport)
#endif /* RT_USING_MODULE */#elif defined (__IAR_SYSTEMS_ICC__) /* for IAR Compiler */
#define RT_SECTION(x) x
#define RT_USED __root
#define PRAGMA(x) _Pragma(#x)
#define ALIGN(n) PRAGMA(data_alignmentn)
#define RT_WEAK __weak
#define rt_inline static inline
#define RTT_API
#elif defined (__GNUC__) /* GNU GCC Compiler */#ifndef RT_USING_LIBC
/* the version of GNU GCC must be greater than 4.x */
typedef __builtin_va_list __gnuc_va_list;
typedef __gnuc_va_list va_list;
#define va_start(v,l) __builtin_va_start(v,l)
#define va_end(v) __builtin_va_end(v)
#define va_arg(v,l) __builtin_va_arg(v,l)
#endif /* RT_USING_LIBC */#define RT_SECTION(x) __attribute__((section(x)))
#define RT_USED __attribute__((used))
#define ALIGN(n) __attribute__((aligned(n)))
#define RT_WEAK __attribute__((weak))
#define rt_inline static __inline
#define RTT_API#elif defined (__ADSPBLACKFIN__) /* for VisualDSP Compiler */
#define RT_SECTION(x) __attribute__((section(x)))
#define RT_USED __attribute__((used))
#define ALIGN(n) __attribute__((aligned(n)))
#define RT_WEAK __attribute__((weak))
#define rt_inline static inline
#define RTT_API#elif defined (_MSC_VER)
#define RT_SECTION(x)
#define RT_USED
#define ALIGN(n) __declspec(align(n))
#define RT_WEAK
#define rt_inline static __inline
#define RTT_API#elif defined (__TI_COMPILER_VERSION__)
/* The way that TI compiler set section is different from other(at least* GCC and MDK) compilers. See ARM Optimizing C/C Compiler 5.9.3 for more* details. */
#define RT_SECTION(x)
#define RT_USED
#define PRAGMA(x) _Pragma(#x)
#define ALIGN(n)
#define RT_WEAK
#define rt_inline static inline
#define RTT_API#elif defined (__TASKING__)
#define RT_SECTION(x) __attribute__((section(x)))
#define RT_USED __attribute__((used, protect))
#define PRAGMA(x) _Pragma(#x)
#define ALIGN(n) __attribute__((__align(n)))
#define RT_WEAK __attribute__((weak))
#define rt_inline static inline
#define RTT_API
#else#error not supported tool chain
#endif /* __ARMCC_VERSION */typedef __builtin_va_list __gnuc_va_list 定义了一个新类型__gnuc_va_list并使用 __builtin_va_list 进行初始化。__builtin_va_list 是GCC内建的类型用于表示可变参数列表中的参数并在实现中进行处理。由于可变参数的实现和操作系统和编译器等因素相关因此需要使用 __builtin_va_list 类型来实现可变参数列表。typedef __gnuc_va_list va_list 定义了一个名为va_list的新类型并将其重命名为__gnuc_va_list。#define va_start(v,l) __builtin_va_start(v,l) 将 va_start() 重命名为 __builtin_va_start()从而能够使用 GCC 内建的函数 __builtin_va_start() 实现可变参数的功能。该宏的作用是对变参列表进行初始化获取第一个参数的地址和类型并返回可变参数队列中下一个参数的地址。#define va_end(v) __builtin_va_end(v) 将 va_end() 重命名为 __builtin_va_end()从而能够使用 GCC 内建的函数 __builtin_va_end() 实现可变参数的功能。该宏的作用是清除可变参数列表并将其指针置为 NULL。#define va_arg(v,l) __builtin_va_arg(v,l) 将 va_arg() 重命名为 __builtin_va_arg()并使用 GCC 内建的函数 __builtin_va_arg() 实现可变参数的功能。该宏的作用是获取可变参数队列中的下一个参数并将指针指向该参数的位置。#define PRAGMA(x) _Pragma(#x)将参数x转化为字符串并使用_Pragma()将其作为编译指令执行。_Pragma是C99标准引入的一个新特性它允许程序员在说明文件中进行诸如#pragma等命令式编译指令的嵌入式编程。而#pragma则是一种编译指令用于控制编译器的一些行为比如告诉编译器去链接某个库、指定编译器选项等。
9.RT-Thread错误码定义
/* RT-Thread error code definitions */
#define RT_EOK 0 /** There is no error */
#define RT_ERROR 1 /** A generic error happens */
#define RT_ETIMEOUT 2 /** Timed out */
#define RT_EFULL 3 /** The resource is full */
#define RT_EEMPTY 4 /** The resource is empty */
#define RT_ENOMEM 5 /** No memory */
#define RT_ENOSYS 6 /** No system */
#define RT_EBUSY 7 /** Busy */
#define RT_EIO 8 /** IO error */
#define RT_EINTR 9 /** Interrupted system call */
#define RT_EINVAL 10 /** Invalid argument */RT_EOK表示没有错误。RT_ERROR表示发生了一般性的错误。RT_ETIMEOUT表示超时错误。RT_EFULL表示资源已满。RT_EEMPTY表示资源为空。RT_ENOMEM表示内存不足。RT_ENOSYS表示没有该系统。RT_EBUSY表示忙碌。RT_EIO表示输入/输出错误。RT_EINTR表示中断的系统调用。RT_EINVAL表示无效的参数。
