mirror of
https://github.com/RT-Thread/rt-thread.git
synced 2025-01-16 05:19:23 +08:00
f51bce3fed
We currently only support building with CCS and SCons is not using.
bsp/rm48x50/HALCoGen/HALCoGen.{hcg,dil} is the HALCoGen project file.
You may need to regenerate the source file as you like, providing that:
1, IRQ is in Dispatch Mode and the table entry is IRQ_Handler. The
channel 5 in enabled and connected to IRQ.
2, RTI driver is enabled and compare3 source is selected to counter1
and the compare3 will generate tick in the period of 10ms. This
value is coresponding with RT_TICK_PER_SECOND in rtconfig.h.
In CCS, you need to create a new CCS project and create link folders
pointing at bsp/rm48x50, libcpu/arm/rm48x50 and src/, include/. Remember
to add the include path to the Build Properties.
914 lines
32 KiB
C
914 lines
32 KiB
C
/*
|
|
* File : rtdef.h
|
|
* This file is part of RT-Thread RTOS
|
|
* COPYRIGHT (C) 2006 - 2012, RT-Thread Development Team
|
|
*
|
|
* The license and distribution terms for this file may be
|
|
* found in the file LICENSE in this distribution or at
|
|
* http://www.rt-thread.org/license/LICENSE
|
|
*
|
|
* Change Logs:
|
|
* Date Author Notes
|
|
* 2007-01-10 Bernard the first version
|
|
* 2008-07-12 Bernard remove all rt_int8, rt_uint32_t etc typedef
|
|
* 2010-10-26 yi.qiu add module support
|
|
* 2010-11-10 Bernard add cleanup callback function in thread exit.
|
|
* 2011-05-09 Bernard use builtin va_arg in GCC 4.x
|
|
* 2012-11-16 Bernard change RT_NULL from ((void*)0) to 0.
|
|
* 2012-12-29 Bernard change the RT_USING_MEMPOOL location and add
|
|
* RT_USING_MEMHEAP condition.
|
|
* 2012-12-30 Bernard add more control command for graphic.
|
|
* 2013-01-09 Bernard change version number.
|
|
*/
|
|
|
|
#ifndef __RT_DEF_H__
|
|
#define __RT_DEF_H__
|
|
|
|
#include <rtconfig.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @addtogroup BasicDef
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/* RT-Thread version information */
|
|
#define RT_VERSION 1L /**< major version number */
|
|
#define RT_SUBVERSION 2L /**< minor version number */
|
|
#define RT_REVISION 0L /**< revise version number */
|
|
|
|
/* RT-Thread version */
|
|
#define RTTHREAD_VERSION ((RT_VERSION * 10000) + \
|
|
(RT_SUBVERSION * 100) + RT_REVISION)
|
|
|
|
/* RT-Thread basic data type definitions */
|
|
typedef signed char rt_int8_t; /**< 8bit integer type */
|
|
typedef signed short rt_int16_t; /**< 16bit integer type */
|
|
typedef signed long 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 long rt_uint32_t; /**< 32bit unsigned integer type */
|
|
typedef int rt_bool_t; /**< boolean type */
|
|
|
|
/* 32bit CPU */
|
|
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_size_t; /**< Type for size number */
|
|
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 */
|
|
|
|
/*@}*/
|
|
|
|
/* maximum value of base type */
|
|
#define RT_UINT8_MAX 0xff /**< Maxium number of UINT8 */
|
|
#define RT_UINT16_MAX 0xffff /**< Maxium number of UINT16 */
|
|
#define RT_UINT32_MAX 0xffffffff /**< Maxium number of UINT32 */
|
|
#define RT_TICK_MAX RT_UINT32_MAX /**< Maxium number of tick */
|
|
|
|
/* Compiler Related Definitions */
|
|
#ifdef __CC_ARM /* ARM Compiler */
|
|
#include <stdarg.h>
|
|
#define SECTION(x) __attribute__((section(x)))
|
|
#define UNUSED __attribute__((unused))
|
|
#define ALIGN(n) __attribute__((aligned(n)))
|
|
#define rt_inline static __inline
|
|
/* module compiling */
|
|
#ifdef RT_USING_MODULE
|
|
#define RTT_API __declspec(dllimport)
|
|
#else
|
|
#define RTT_API __declspec(dllexport)
|
|
#endif
|
|
|
|
#elif defined (__IAR_SYSTEMS_ICC__) /* for IAR Compiler */
|
|
#include <stdarg.h>
|
|
#define SECTION(x) @ x
|
|
#define UNUSED
|
|
#define PRAGMA(x) _Pragma(#x)
|
|
#define ALIGN(n) PRAGMA(data_alignment=n)
|
|
#define rt_inline static inline
|
|
#define RTT_API
|
|
|
|
#elif defined (__GNUC__) /* GNU GCC Compiler */
|
|
#ifdef RT_USING_NEWLIB
|
|
#include <stdarg.h>
|
|
#else
|
|
#if __GNUC__ < 4
|
|
typedef void *__sys_va_list;
|
|
typedef __sys_va_list va_list;
|
|
#define __va_rounded_size(type) \
|
|
(((sizeof(type) + sizeof(int) - 1) / sizeof(int)) * sizeof(int))
|
|
#define va_start(ap, lastarg) \
|
|
(ap = ((char *) &(lastarg) + __va_rounded_size(lastarg)))
|
|
#define va_end(ap) ((void)0)
|
|
/* little endian */
|
|
#define va_arg(ap, type) \
|
|
(ap = (__sys_va_list) ((char *)(ap) + __va_rounded_size(type)), \
|
|
*((type *) (void *) ((char *)(ap) - __va_rounded_size(type))))
|
|
#else
|
|
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
|
|
#endif
|
|
|
|
#define SECTION(x) __attribute__((section(x)))
|
|
#define UNUSED __attribute__((unused))
|
|
#define ALIGN(n) __attribute__((aligned(n)))
|
|
#define rt_inline static __inline
|
|
#define RTT_API
|
|
#elif defined (__ADSPBLACKFIN__) /* for VisualDSP++ Compiler */
|
|
#include <stdarg.h>
|
|
#define SECTION(x) __attribute__((section(x)))
|
|
#define UNUSED __attribute__((unused))
|
|
#define ALIGN(n) __attribute__((aligned(n)))
|
|
#define rt_inline static inline
|
|
#define RTT_API
|
|
#elif defined (_MSC_VER)
|
|
#include <stdarg.h>
|
|
#define SECTION(x)
|
|
#define UNUSED
|
|
#define ALIGN(n) __declspec(align(n))
|
|
#define rt_inline static __inline
|
|
#define RTT_API
|
|
#elif defined (__TI_EABI_SUPPORT__)
|
|
#define SECTION(x)
|
|
#define UNUSED
|
|
#define ALIGN(n)
|
|
#define rt_inline static inline
|
|
#define RTT_API
|
|
#else
|
|
#error not supported tool chain
|
|
#endif
|
|
|
|
/* event length */
|
|
#define RT_EVENT_LENGTH 32
|
|
|
|
/* memory management option */
|
|
#define RT_MM_PAGE_SIZE 4096
|
|
#define RT_MM_PAGE_MASK (RT_MM_PAGE_SIZE - 1)
|
|
#define RT_MM_PAGE_BITS 12
|
|
|
|
/* kernel malloc definitions */
|
|
#ifndef RT_KERNEL_MALLOC
|
|
#define RT_KERNEL_MALLOC(sz) rt_malloc(sz)
|
|
#endif
|
|
|
|
#ifndef RT_KERNEL_FREE
|
|
#define RT_KERNEL_FREE(ptr) rt_free(ptr)
|
|
#endif
|
|
|
|
/**
|
|
* @addtogroup Error
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/* 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 */
|
|
|
|
/*@}*/
|
|
|
|
/**
|
|
* @ingroup BasicDef
|
|
*
|
|
* @def RT_ALIGN(size, align)
|
|
* Return the most contiguous size aligned at specified width. RT_ALIGN(13, 4)
|
|
* would return 16.
|
|
*/
|
|
#define RT_ALIGN(size, align) (((size) + (align) - 1) & ~((align) - 1))
|
|
|
|
/**
|
|
* @ingroup BasicDef
|
|
*
|
|
* @def RT_ALIGN_DOWN(size, align)
|
|
* Return the down number of aligned at specified width. RT_ALIGN_DOWN(13, 4)
|
|
* would return 12.
|
|
*/
|
|
#define RT_ALIGN_DOWN(size, align) ((size) & ~((align) - 1))
|
|
|
|
/**
|
|
* @ingroup BasicDef
|
|
*
|
|
* @def RT_NULL
|
|
* Similar as the \c NULL in C library.
|
|
*/
|
|
#define RT_NULL (0)
|
|
|
|
struct rt_list_node
|
|
{
|
|
struct rt_list_node *next; /**< point to next node. */
|
|
struct rt_list_node *prev; /**< point to prev node. */
|
|
};
|
|
typedef struct rt_list_node rt_list_t; /**< Type for lists. */
|
|
|
|
/**
|
|
* @addtogroup KernelObject
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/*
|
|
* kernel object macros
|
|
*/
|
|
#define RT_OBJECT_FLAG_MODULE 0x80 /**< is module object. */
|
|
|
|
/**
|
|
* Base structure of Kernel object
|
|
*/
|
|
struct rt_object
|
|
{
|
|
char name[RT_NAME_MAX]; /**< name of kernel object */
|
|
rt_uint8_t type; /**< type of kernel object */
|
|
rt_uint8_t flag; /**< flag of kernel object */
|
|
|
|
#ifdef RT_USING_MODULE
|
|
void *module_id; /**< id of application module */
|
|
#endif
|
|
rt_list_t list; /**< list node of kernel object */
|
|
};
|
|
typedef struct rt_object *rt_object_t; /**< Type for kernel objects. */
|
|
|
|
/**
|
|
* The object type can be one of the follows with specific
|
|
* macros enabled:
|
|
* - Thread
|
|
* - Semaphore
|
|
* - Mutex
|
|
* - Event
|
|
* - MailBox
|
|
* - MessageQueue
|
|
* - MemHeap
|
|
* - MemPool
|
|
* - Device
|
|
* - Timer
|
|
* - Module
|
|
* - Unknown
|
|
* - Static
|
|
*/
|
|
enum rt_object_class_type
|
|
{
|
|
RT_Object_Class_Thread = 0, /**< The object is a thread. */
|
|
#ifdef RT_USING_SEMAPHORE
|
|
RT_Object_Class_Semaphore, /**< The object is a semaphore. */
|
|
#endif
|
|
#ifdef RT_USING_MUTEX
|
|
RT_Object_Class_Mutex, /**< The object is a mutex. */
|
|
#endif
|
|
#ifdef RT_USING_EVENT
|
|
RT_Object_Class_Event, /**< The object is a event. */
|
|
#endif
|
|
#ifdef RT_USING_MAILBOX
|
|
RT_Object_Class_MailBox, /**< The object is a mail box. */
|
|
#endif
|
|
#ifdef RT_USING_MESSAGEQUEUE
|
|
RT_Object_Class_MessageQueue, /**< The object is a message queue. */
|
|
#endif
|
|
#ifdef RT_USING_MEMHEAP
|
|
RT_Object_Class_MemHeap, /**< The object is a memory heap */
|
|
#endif
|
|
#ifdef RT_USING_MEMPOOL
|
|
RT_Object_Class_MemPool, /**< The object is a memory pool. */
|
|
#endif
|
|
#ifdef RT_USING_DEVICE
|
|
RT_Object_Class_Device, /**< The object is a device */
|
|
#endif
|
|
RT_Object_Class_Timer, /**< The object is a timer. */
|
|
#ifdef RT_USING_MODULE
|
|
RT_Object_Class_Module, /**< The object is a module. */
|
|
#endif
|
|
RT_Object_Class_Unknown, /**< The object is unknown. */
|
|
RT_Object_Class_Static = 0x80 /**< The object is a static object. */
|
|
};
|
|
|
|
/**
|
|
* The information of the kernel object
|
|
*/
|
|
struct rt_object_information
|
|
{
|
|
enum rt_object_class_type type; /**< object class type */
|
|
rt_list_t object_list; /**< object list */
|
|
rt_size_t object_size; /**< object size */
|
|
};
|
|
|
|
/**
|
|
* The hook function call macro
|
|
*/
|
|
#ifdef RT_USING_HOOK
|
|
#define RT_OBJECT_HOOK_CALL(func, argv) \
|
|
do { if ((func) != RT_NULL) func argv; } while (0)
|
|
#else
|
|
#define RT_OBJECT_HOOK_CALL(func, argv)
|
|
#endif
|
|
|
|
/*@}*/
|
|
|
|
/**
|
|
* @addtogroup Clock
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/**
|
|
* clock & timer macros
|
|
*/
|
|
#define RT_TIMER_FLAG_DEACTIVATED 0x0 /**< timer is deactive */
|
|
#define RT_TIMER_FLAG_ACTIVATED 0x1 /**< timer is active */
|
|
#define RT_TIMER_FLAG_ONE_SHOT 0x0 /**< one shot timer */
|
|
#define RT_TIMER_FLAG_PERIODIC 0x2 /**< periodic timer */
|
|
|
|
#define RT_TIMER_FLAG_HARD_TIMER 0x0 /**< hard timer,the timer's callback function will be called in tick isr. */
|
|
#define RT_TIMER_FLAG_SOFT_TIMER 0x4 /**< soft timer,the timer's callback function will be called in timer thread. */
|
|
|
|
#define RT_TIMER_CTRL_SET_TIME 0x0 /**< set timer control command */
|
|
#define RT_TIMER_CTRL_GET_TIME 0x1 /**< get timer control command */
|
|
#define RT_TIMER_CTRL_SET_ONESHOT 0x2 /**< change timer to one shot */
|
|
#define RT_TIMER_CTRL_SET_PERIODIC 0x3 /**< change timer to periodic */
|
|
|
|
/**
|
|
* timer structure
|
|
*/
|
|
struct rt_timer
|
|
{
|
|
struct rt_object parent; /**< inherit from rt_object */
|
|
|
|
rt_list_t list; /**< the node of timer list */
|
|
|
|
void (*timeout_func)(void *parameter); /**< timeout function */
|
|
void *parameter; /**< timeout function's parameter */
|
|
|
|
rt_tick_t init_tick; /**< timer timeout tick */
|
|
rt_tick_t timeout_tick; /**< timeout tick */
|
|
};
|
|
typedef struct rt_timer *rt_timer_t;
|
|
|
|
/*@}*/
|
|
|
|
/**
|
|
* @addtogroup Thread
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/*
|
|
* Thread
|
|
*/
|
|
|
|
/*
|
|
* thread state definitions
|
|
*/
|
|
#define RT_THREAD_INIT 0x00 /**< Initialized status */
|
|
#define RT_THREAD_READY 0x01 /**< Ready status */
|
|
#define RT_THREAD_SUSPEND 0x02 /**< Suspend status */
|
|
#define RT_THREAD_RUNNING 0x03 /**< Running status */
|
|
#define RT_THREAD_BLOCK RT_THREAD_SUSPEND /**< Blocked status */
|
|
#define RT_THREAD_CLOSE 0x04 /**< Closed status */
|
|
|
|
/**
|
|
* thread control command definitions
|
|
*/
|
|
#define RT_THREAD_CTRL_STARTUP 0x00 /**< Startup thread. */
|
|
#define RT_THREAD_CTRL_CLOSE 0x01 /**< Close thread. */
|
|
#define RT_THREAD_CTRL_CHANGE_PRIORITY 0x02 /**< Change thread priority. */
|
|
#define RT_THREAD_CTRL_INFO 0x03 /**< Get thread information. */
|
|
|
|
/**
|
|
* Thread structure
|
|
*/
|
|
struct rt_thread
|
|
{
|
|
/* rt object */
|
|
char name[RT_NAME_MAX]; /**< the name of thread */
|
|
rt_uint8_t type; /**< type of object */
|
|
rt_uint8_t flags; /**< thread's flags */
|
|
|
|
#ifdef RT_USING_MODULE
|
|
void *module_id; /**< id of application module */
|
|
#endif
|
|
|
|
rt_list_t list; /**< the object list */
|
|
rt_list_t tlist; /**< the thread list */
|
|
|
|
/* stack point and entry */
|
|
void *sp; /**< stack point */
|
|
void *entry; /**< entry */
|
|
void *parameter; /**< parameter */
|
|
void *stack_addr; /**< stack address */
|
|
rt_uint16_t stack_size; /**< stack size */
|
|
|
|
/* error code */
|
|
rt_err_t error; /**< error code */
|
|
|
|
rt_uint8_t stat; /**< thread stat */
|
|
|
|
/* priority */
|
|
rt_uint8_t current_priority; /**< current priority */
|
|
rt_uint8_t init_priority; /**< initialized priority */
|
|
#if RT_THREAD_PRIORITY_MAX > 32
|
|
rt_uint8_t number;
|
|
rt_uint8_t high_mask;
|
|
#endif
|
|
rt_uint32_t number_mask;
|
|
|
|
#if defined(RT_USING_EVENT)
|
|
/* thread event */
|
|
rt_uint32_t event_set;
|
|
rt_uint8_t event_info;
|
|
#endif
|
|
|
|
rt_ubase_t init_tick; /**< thread's initialized tick */
|
|
rt_ubase_t remaining_tick; /**< remaining tick */
|
|
|
|
struct rt_timer thread_timer; /**< built-in thread timer */
|
|
|
|
void (*cleanup)(struct rt_thread *tid); /**< cleanup function when thread exit */
|
|
|
|
rt_uint32_t user_data; /**< private user data beyond this thread */
|
|
};
|
|
typedef struct rt_thread *rt_thread_t;
|
|
|
|
/*@}*/
|
|
|
|
/**
|
|
* @addtogroup IPC
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/**
|
|
* IPC flags and control command definitions
|
|
*/
|
|
#define RT_IPC_FLAG_FIFO 0x00 /**< FIFOed IPC. @ref IPC. */
|
|
#define RT_IPC_FLAG_PRIO 0x01 /**< PRIOed IPC. @ref IPC. */
|
|
|
|
#define RT_IPC_CMD_UNKNOWN 0x00 /**< unknown IPC command */
|
|
#define RT_IPC_CMD_RESET 0x01 /**< reset IPC object */
|
|
|
|
#define RT_WAITING_FOREVER -1 /**< Block forever until get resource. */
|
|
#define RT_WAITING_NO 0 /**< Non-block. */
|
|
|
|
/**
|
|
* Base structure of IPC object
|
|
*/
|
|
struct rt_ipc_object
|
|
{
|
|
struct rt_object parent; /**< inherit from rt_object */
|
|
|
|
rt_list_t suspend_thread; /**< threads pended on this resource */
|
|
};
|
|
|
|
#ifdef RT_USING_SEMAPHORE
|
|
/**
|
|
* Semaphore structure
|
|
*/
|
|
struct rt_semaphore
|
|
{
|
|
struct rt_ipc_object parent; /**< inherit from ipc_object */
|
|
|
|
rt_uint16_t value; /**< value of semaphore. */
|
|
};
|
|
typedef struct rt_semaphore *rt_sem_t;
|
|
#endif
|
|
|
|
#ifdef RT_USING_MUTEX
|
|
/**
|
|
* Mutual exclusion (mutex) structure
|
|
*/
|
|
struct rt_mutex
|
|
{
|
|
struct rt_ipc_object parent; /**< inherit from ipc_object */
|
|
|
|
rt_uint16_t value; /**< value of mutex */
|
|
|
|
rt_uint8_t original_priority; /**< priority of last thread hold the mutex */
|
|
rt_uint8_t hold; /**< numbers of thread hold the mutex */
|
|
|
|
struct rt_thread *owner; /**< current owner of mutex */
|
|
};
|
|
typedef struct rt_mutex *rt_mutex_t;
|
|
#endif
|
|
|
|
#ifdef RT_USING_EVENT
|
|
/**
|
|
* flag defintions in event
|
|
*/
|
|
#define RT_EVENT_FLAG_AND 0x01 /**< logic and */
|
|
#define RT_EVENT_FLAG_OR 0x02 /**< logic or */
|
|
#define RT_EVENT_FLAG_CLEAR 0x04 /**< clear flag */
|
|
|
|
/*
|
|
* event structure
|
|
*/
|
|
struct rt_event
|
|
{
|
|
struct rt_ipc_object parent; /**< inherit from ipc_object */
|
|
|
|
rt_uint32_t set; /**< event set */
|
|
};
|
|
typedef struct rt_event *rt_event_t;
|
|
#endif
|
|
|
|
#ifdef RT_USING_MAILBOX
|
|
/**
|
|
* mailbox structure
|
|
*/
|
|
struct rt_mailbox
|
|
{
|
|
struct rt_ipc_object parent; /**< inherit from ipc_object */
|
|
|
|
rt_uint32_t *msg_pool; /**< start address of message buffer */
|
|
|
|
rt_uint16_t size; /**< size of message pool */
|
|
|
|
rt_uint16_t entry; /**< index of messages in msg_pool */
|
|
rt_uint16_t in_offset; /**< input offset of the message buffer */
|
|
rt_uint16_t out_offset; /**< output offset of the message buffer */
|
|
|
|
rt_list_t suspend_sender_thread; /**< sender thread suspended on this mailbox */
|
|
};
|
|
typedef struct rt_mailbox *rt_mailbox_t;
|
|
#endif
|
|
|
|
#ifdef RT_USING_MESSAGEQUEUE
|
|
/**
|
|
* message queue structure
|
|
*/
|
|
struct rt_messagequeue
|
|
{
|
|
struct rt_ipc_object parent; /**< inherit from ipc_object */
|
|
|
|
void *msg_pool; /**< start address of message queue */
|
|
|
|
rt_uint16_t msg_size; /**< message size of each message */
|
|
rt_uint16_t max_msgs; /**< max number of messages */
|
|
|
|
rt_uint16_t entry; /**< index of messages in the queue */
|
|
|
|
void *msg_queue_head; /**< list head */
|
|
void *msg_queue_tail; /**< list tail */
|
|
void *msg_queue_free; /**< pointer indicated the free node of queue */
|
|
};
|
|
typedef struct rt_messagequeue *rt_mq_t;
|
|
#endif
|
|
|
|
/*@}*/
|
|
|
|
/**
|
|
* @addtogroup MM
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/*
|
|
* memory management
|
|
* heap & partition
|
|
*/
|
|
|
|
#ifdef RT_USING_MEMHEAP
|
|
/**
|
|
* memory item on the heap
|
|
*/
|
|
struct rt_memheap_item
|
|
{
|
|
rt_uint32_t magic; /**< magic number for memheap */
|
|
struct rt_memheap_item *next; /**< next memheap item */
|
|
struct rt_memheap_item *prev; /**< prev memheap item */
|
|
|
|
struct rt_memheap *pool_ptr; /**< point of pool */
|
|
|
|
struct rt_memheap_item *next_free; /**< next free memheap item */
|
|
struct rt_memheap_item *prev_free; /**< prev free memheap item */
|
|
};
|
|
|
|
/**
|
|
* Base structure of memory heap object
|
|
*/
|
|
struct rt_memheap
|
|
{
|
|
struct rt_object parent; /**< inherit from rt_object */
|
|
|
|
void *start_addr; /**< pool start address and size */
|
|
|
|
rt_uint32_t pool_size; /**< pool size */
|
|
rt_uint32_t available_size; /**< available size */
|
|
rt_uint32_t max_used_size; /**< maximum allocated size */
|
|
|
|
struct rt_memheap_item *block_list; /**< used block list */
|
|
|
|
struct rt_memheap_item *free_list; /**< free block list */
|
|
struct rt_memheap_item free_header; /**< free block list header */
|
|
|
|
struct rt_semaphore lock; /**< semaphore lock */
|
|
};
|
|
#endif
|
|
|
|
#ifdef RT_USING_MEMPOOL
|
|
/**
|
|
* Base structure of Memory pool object
|
|
*/
|
|
struct rt_mempool
|
|
{
|
|
struct rt_object parent; /**< inherit from rt_object */
|
|
|
|
void *start_address; /**< memory pool start */
|
|
rt_size_t size; /**< size of memory pool */
|
|
|
|
rt_size_t block_size; /**< size of memory blocks */
|
|
rt_uint8_t *block_list; /**< memory blocks list */
|
|
|
|
rt_size_t block_total_count; /**< numbers of memory block */
|
|
rt_size_t block_free_count; /**< numbers of free memory block */
|
|
|
|
rt_list_t suspend_thread; /**< threads pended on this resource */
|
|
rt_size_t suspend_thread_count; /**< numbers of thread pended on this resource */
|
|
};
|
|
typedef struct rt_mempool *rt_mp_t;
|
|
#endif
|
|
|
|
/*@}*/
|
|
|
|
#ifdef RT_USING_DEVICE
|
|
/**
|
|
* @addtogroup Device
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/**
|
|
* device (I/O) class type
|
|
*/
|
|
enum rt_device_class_type
|
|
{
|
|
RT_Device_Class_Char = 0, /**< character device */
|
|
RT_Device_Class_Block, /**< block device */
|
|
RT_Device_Class_NetIf, /**< net interface */
|
|
RT_Device_Class_MTD, /**< memory device */
|
|
RT_Device_Class_CAN, /**< CAN device */
|
|
RT_Device_Class_RTC, /**< RTC device */
|
|
RT_Device_Class_Sound, /**< Sound device */
|
|
RT_Device_Class_Graphic, /**< Graphic device */
|
|
RT_Device_Class_I2CBUS, /**< I2C bus device */
|
|
RT_Device_Class_USBDevice, /**< USB slave device */
|
|
RT_Device_Class_USBHost, /**< USB host bus */
|
|
RT_Device_Class_SPIBUS, /**< SPI bus device */
|
|
RT_Device_Class_SPIDevice, /**< SPI device */
|
|
RT_Device_Class_SDIO, /**< SDIO bus device */
|
|
RT_Device_Class_PM, /**< PM pseudo device */
|
|
RT_Device_Class_Unknown /**< unknown device */
|
|
};
|
|
|
|
/**
|
|
* device flags defitions
|
|
*/
|
|
#define RT_DEVICE_FLAG_DEACTIVATE 0x000 /**< device is not not initialized */
|
|
|
|
#define RT_DEVICE_FLAG_RDONLY 0x001 /**< read only */
|
|
#define RT_DEVICE_FLAG_WRONLY 0x002 /**< write only */
|
|
#define RT_DEVICE_FLAG_RDWR 0x003 /**< read and write */
|
|
|
|
#define RT_DEVICE_FLAG_REMOVABLE 0x004 /**< removable device */
|
|
#define RT_DEVICE_FLAG_STANDALONE 0x008 /**< standalone device */
|
|
#define RT_DEVICE_FLAG_ACTIVATED 0x010 /**< device is activated */
|
|
#define RT_DEVICE_FLAG_SUSPENDED 0x020 /**< device is suspended */
|
|
#define RT_DEVICE_FLAG_STREAM 0x040 /**< stream mode */
|
|
|
|
#define RT_DEVICE_FLAG_INT_RX 0x100 /**< INT mode on Rx */
|
|
#define RT_DEVICE_FLAG_DMA_RX 0x200 /**< DMA mode on Rx */
|
|
#define RT_DEVICE_FLAG_INT_TX 0x400 /**< INT mode on Tx */
|
|
#define RT_DEVICE_FLAG_DMA_TX 0x800 /**< DMA mode on Tx */
|
|
|
|
#define RT_DEVICE_OFLAG_CLOSE 0x000 /**< device is closed */
|
|
#define RT_DEVICE_OFLAG_RDONLY 0x001 /**< read only access */
|
|
#define RT_DEVICE_OFLAG_WRONLY 0x002 /**< write only access */
|
|
#define RT_DEVICE_OFLAG_RDWR 0x003 /**< read and write */
|
|
#define RT_DEVICE_OFLAG_OPEN 0x008 /**< device is opened */
|
|
|
|
/**
|
|
* general device commands
|
|
*/
|
|
#define RT_DEVICE_CTRL_RESUME 0x01 /**< resume device */
|
|
#define RT_DEVICE_CTRL_SUSPEND 0x02 /**< suspend device */
|
|
|
|
/**
|
|
* special device commands
|
|
*/
|
|
#define RT_DEVICE_CTRL_CHAR_STREAM 0x10 /**< stream mode on char device */
|
|
#define RT_DEVICE_CTRL_BLK_GETGEOME 0x10 /**< get geometry information */
|
|
#define RT_DEVICE_CTRL_BLK_SYNC 0x11 /**< flush data to block device */
|
|
#define RT_DEVICE_CTRL_BLK_ERASE 0x12 /**< erase block on block device */
|
|
#define RT_DEVICE_CTRL_NETIF_GETMAC 0x10 /**< get mac address */
|
|
#define RT_DEVICE_CTRL_MTD_FORMAT 0x10 /**< format a MTD device */
|
|
#define RT_DEVICE_CTRL_RTC_GET_TIME 0x10 /**< get time */
|
|
#define RT_DEVICE_CTRL_RTC_SET_TIME 0x11 /**< set time */
|
|
#define RT_DEVICE_CTRL_RTC_GET_ALARM 0x12 /**< get alarm */
|
|
#define RT_DEVICE_CTRL_RTC_SET_ALARM 0x13 /**< set alarm */
|
|
|
|
typedef struct rt_device *rt_device_t;
|
|
/**
|
|
* Device structure
|
|
*/
|
|
struct rt_device
|
|
{
|
|
struct rt_object parent; /**< inherit from rt_object */
|
|
|
|
enum rt_device_class_type type; /**< device type */
|
|
rt_uint16_t flag; /**< device flag */
|
|
rt_uint16_t open_flag; /**< device open flag */
|
|
|
|
rt_uint8_t device_id; /**< 0 - 255 */
|
|
|
|
/* device call back */
|
|
rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size);
|
|
rt_err_t (*tx_complete)(rt_device_t dev, void *buffer);
|
|
|
|
/* common device interface */
|
|
rt_err_t (*init) (rt_device_t dev);
|
|
rt_err_t (*open) (rt_device_t dev, rt_uint16_t oflag);
|
|
rt_err_t (*close) (rt_device_t dev);
|
|
rt_size_t (*read) (rt_device_t dev, rt_off_t pos, void *buffer, rt_size_t size);
|
|
rt_size_t (*write) (rt_device_t dev, rt_off_t pos, const void *buffer, rt_size_t size);
|
|
rt_err_t (*control)(rt_device_t dev, rt_uint8_t cmd, void *args);
|
|
|
|
#ifdef RT_USING_DEVICE_SUSPEND
|
|
rt_err_t (*suspend) (rt_device_t dev);
|
|
rt_err_t (*resumed) (rt_device_t dev);
|
|
#endif
|
|
|
|
void *user_data; /**< device private data */
|
|
};
|
|
|
|
/**
|
|
* block device geometry structure
|
|
*/
|
|
struct rt_device_blk_geometry
|
|
{
|
|
rt_uint32_t sector_count; /**< count of sectors */
|
|
rt_uint32_t bytes_per_sector; /**< number of bytes per sector */
|
|
rt_uint32_t block_size; /**< size to erase one block */
|
|
};
|
|
|
|
/**
|
|
* sector arrange struct on block device
|
|
*/
|
|
struct rt_device_blk_sectors
|
|
{
|
|
rt_uint32_t sector_begin; /**< begin sector */
|
|
rt_uint32_t sector_end; /**< end sector */
|
|
};
|
|
|
|
/**
|
|
* cursor control command
|
|
*/
|
|
#define RT_DEVICE_CTRL_CURSOR_SET_POSITION 0x10
|
|
#define RT_DEVICE_CTRL_CURSOR_SET_TYPE 0x11
|
|
|
|
/**
|
|
* graphic device control command
|
|
*/
|
|
#define RTGRAPHIC_CTRL_RECT_UPDATE 0
|
|
#define RTGRAPHIC_CTRL_POWERON 1
|
|
#define RTGRAPHIC_CTRL_POWEROFF 2
|
|
#define RTGRAPHIC_CTRL_GET_INFO 3
|
|
#define RTGRAPHIC_CTRL_SET_MODE 4
|
|
#define RTGRAPHIC_CTRL_GET_EXT 5
|
|
|
|
/* graphic deice */
|
|
enum
|
|
{
|
|
RTGRAPHIC_PIXEL_FORMAT_MONO = 0,
|
|
RTGRAPHIC_PIXEL_FORMAT_GRAY4,
|
|
RTGRAPHIC_PIXEL_FORMAT_GRAY16,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB332,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB444,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB565,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB565P,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB666,
|
|
RTGRAPHIC_PIXEL_FORMAT_RGB888,
|
|
RTGRAPHIC_PIXEL_FORMAT_ARGB888
|
|
};
|
|
|
|
/**
|
|
* build a pixel position according to (x, y) coordinates.
|
|
*/
|
|
#define RTGRAPHIC_PIXEL_POSITION(x, y) ((x << 16) | y)
|
|
|
|
/**
|
|
* graphic device information structure
|
|
*/
|
|
struct rt_device_graphic_info
|
|
{
|
|
rt_uint8_t pixel_format; /**< graphic format */
|
|
rt_uint8_t bits_per_pixel; /**< bits per pixel */
|
|
rt_uint16_t reserved; /**< reserved field */
|
|
|
|
rt_uint16_t width; /**< width of graphic device */
|
|
rt_uint16_t height; /**< height of graphic device */
|
|
|
|
rt_uint8_t *framebuffer; /**< frame buffer */
|
|
};
|
|
|
|
/**
|
|
* rectangle information structure
|
|
*/
|
|
struct rt_device_rect_info
|
|
{
|
|
rt_uint16_t x; /**< x coordinate */
|
|
rt_uint16_t y; /**< y coordinate */
|
|
rt_uint16_t width; /**< width */
|
|
rt_uint16_t height; /**< height */
|
|
};
|
|
|
|
/**
|
|
* graphic operations
|
|
*/
|
|
struct rt_device_graphic_ops
|
|
{
|
|
void (*set_pixel) (const char *pixel, int x, int y);
|
|
void (*get_pixel) (char *pixel, int x, int y);
|
|
|
|
void (*draw_hline)(const char *pixel, int x1, int x2, int y);
|
|
void (*draw_vline)(const char *pixel, int x, int y1, int y2);
|
|
|
|
void (*blit_line) (const char *pixel, int x, int y, rt_size_t size);
|
|
};
|
|
#define rt_graphix_ops(device) ((struct rt_device_graphic_ops *)(device->user_data))
|
|
|
|
/*@}*/
|
|
#endif
|
|
|
|
#ifdef RT_USING_MODULE
|
|
/**
|
|
* @addtogroup Module
|
|
*/
|
|
|
|
/*@{*/
|
|
|
|
/*
|
|
* module system
|
|
*/
|
|
|
|
#define RT_MODULE_FLAG_WITHENTRY 0x00 /**< with entry point */
|
|
#define RT_MODULE_FLAG_WITHOUTENTRY 0x01 /**< without entry point */
|
|
|
|
/**
|
|
* Application Module structure
|
|
*/
|
|
struct rt_module
|
|
{
|
|
struct rt_object parent; /**< inherit from object */
|
|
|
|
rt_uint8_t *module_space; /**< module memory space */
|
|
|
|
void *module_entry; /**< entry address of module's thread */
|
|
rt_thread_t module_thread; /**< stack size of module's thread */
|
|
rt_uint32_t stack_size; /**< priority of module's thread */
|
|
rt_uint32_t thread_priority;
|
|
|
|
#ifdef RT_USING_SLAB
|
|
/* module memory allocator */
|
|
void *mem_list; /**< module's free memory list */
|
|
void *page_array; /**< module's using pages */
|
|
rt_uint32_t page_cnt; /**< module's using pages count */
|
|
#endif
|
|
|
|
rt_uint32_t nsym; /**< number of symbol in the module */
|
|
struct rt_module_symtab *symtab; /**< module symbol table */
|
|
|
|
rt_uint32_t nref; /**< reference count */
|
|
|
|
/* object in this module, module object is the last basic object type */
|
|
struct rt_object_information module_object[RT_Object_Class_Unknown];
|
|
};
|
|
typedef struct rt_module *rt_module_t;
|
|
|
|
/*@}*/
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|