RT-Thread常见函数.pdfVIP

2 2 22 线程调度与管理 RT-Thread 4 线程状态 中的线程有 种状态：初始态、就绪态、运行态、挂起态。 这几种状态间的转换关系如下图所示： 2.6 2.6 22..66 调度器相关接口 2.6.1 2.6.1 22..66..11 调度器初始化 voidrt_system_scheduler_init(void); 2.6.2 2.6.2 22..66..22 启动调度器 voidrt_system_scheduler_start(void); 2.6.3 2.6.3 22..66..33 执行调度 voidrt_schedule(void); 2.6.4 2.6.4 22..66..44 设置调度器钩子 voidrt_scheduler_sethook(void (*hook)(structrt_thread* from,struct rt_thread* to)); hook 表示用户定义的钩子函数指针； 这个hook函数的声明如下： voidhook(struct rt_thread* from,structrt_thread* to); 函数参数 from 表示系统所要切入的线程的控制块指针； to 表示系统所要切出的线程的控制块指针。 2.7 线程相关接口 2.7.1 2.7.1 22..77..11 线程创建 rt_thread_t rt_thread_create(const char* name, void(*entry)(void* parameter), void*para rt_uint32_t stack_size, rt_uint8_t priority,rt_uint32_t tick); 函数参数 name 线程的名称；线程名称的最大长度由 rtconfig.h 中定义的 RT_NAME_MAX宏指定，多余部分会被自动截掉。 entry 线程入口函数 parameter 线程入口函数参数； stack_size 线程栈大小，单位是字节。在大多数系统中需要做栈空间地址对齐（例 ARM 4 如 体系结构中需要向 字节地址对齐）。 priority 线程的优先级。优先级范围根据系统配置情况（rtconfig.h 中的 RT_THREAD_PRIORITY_MAX 宏定义），如果支持的是256 级优先级，那么范 0 255 0 RT-Thread1.2.0 围是从 ～ ，数值越小优先级越高， 代表最高优先级。 tick tick 线程的时间片大小。时间片（ ）的单位是操作系统的时钟节拍。 当系统中存在相同优先级线程时，这个参数指定线程一次调度能够运行的最大时 间长度。这个时间片运行结束时，调度器自动选择下一个就绪态的同优先级线程 进行运行。 函数返回 创建成功返回线程句柄；否则返回RT_NULL。 2.7.2 2.7.2 22..77..22 线程删除 rt_thread_init函数用来初始化静态线程对象。 rt_err_trt_thread_delete(rt_thread_t thread); 函数参数 thread 要删除的线程句柄； 函数返回 返回RT_EOK 2.7.3 线程初始化 rt_err_trt_thread_init(struct rt_thread*thread, constchar* name, void(*entry)(void* parameter), void*parameter, void*stack_start, rt_uint32_t stack_size, rt_uint8_t priority,rt_uint32_t tick); 函数参数 hread 线程句柄。线程句柄由