ThreadX_note:创建线程

ThreadX 创建线程

ThreadX 是一款实时操作系统 (RTOS)，它提供了一套全面的 API，可以用于创建和管理线程。

创建线程

在 ThreadX 中，我们可以使用 tx_thread_create 函数来创建线程。

exam：

#include "tx_api.h"

/* 定义任务堆栈大小 */
#define TASK_STACK_SIZE 1024

/* 定义任务优先级 */
#define TASK_PRI 16

/* 定义两个任务的ID */
TX_THREAD thread_0;
TX_THREAD thread_1;

/* 定义任务堆栈 */
uint8_t thread_0_stack[TASK_STACK_SIZE];
uint8_t thread_1_stack[TASK_STACK_SIZE];

/* 任务入口函数 */
void thread_0_entry(ULONG thread_input) {
    /* 执行任务0的操作 */
}

void thread_1_entry(ULONG thread_input) {
    /* 执行任务1的操作 */
}

/* 程序入口函数 */
int main(void) {
    /* 初始化STM32硬件 */
    /* 初始化ThreadX内核 */
    tx_kernel_enter();

    /* 创建任务0 */
    tx_thread_create(&thread_0, "thread_0", thread_0_entry, 0, 
                     thread_0_stack, TASK_STACK_SIZE, 
                     TASK_PRI, TASK_PRI, TX_NO_TIME_SLICE, TX_AUTO_START);

    /* 创建任务1 */
    tx_thread_create(&thread_1, "thread_1", thread_1_entry, 0, 
                     thread_1_stack, TASK_STACK_SIZE, 
                     TASK_PRI, TASK_PRI, TX_NO_TIME_SLICE, TX_AUTO_START);

    /* 启动ThreadX内核 */
    tx_kernel_start();

    /* 永远不会运行到这里 */
    return 0;
}

tx_thread_create 函数解析

tx_thread_create 函数是 ThreadX 库中用于创建线程的函数。它的原型如下：

UINT tx_thread_create(TX_THREAD *thread_ptr, CHAR *name_ptr, 
                      VOID (*entry_function)(ULONG), ULONG entry_input, 
                      VOID *stack_start, ULONG stack_size, 
                      UINT priority, UINT preempt_threshold, 
                      ULONG time_slice, UINT auto_start);

下面对 tx_thread_create 函数的各个参数进行解析：

• thread_ptr：指向 TX_THREAD 类型的指针，用于保存新创建线程的控制块信息。
• name_ptr：线程的名称，以字符串形式提供。
• entry_function：线程的入口函数，即线程创建后要执行的函数。它必须是一个无返回值（void），接受 ULONG 类型参数的函数指针，因为 ThreadX 会将传递给线程的参数作为 entry_input 传递给入口函数。
• entry_input：线程入口函数的输入参数。可以是任何类型的数据，但将其转换为 ULONG 类型并在入口函数中进行相应的类型转换。
• stack_start：线程堆栈的起始地址。通常通过定义一个数组，并将数组的地址作为参数传递给此处，用于分配线程的堆栈空间。
• stack_size：线程堆栈的大小，以字节为单位。
• priority：线程的优先级。ThreadX 使用固定优先级调度算法来确定线程执行的顺序，优先级较高的线程将在优先级较低的线程之前执行。
• preempt_threshold：线程的抢占阈值。当一个线程的优先级高于或等于抢占阈值时，它可以抢占当前正在执行的线程。
• time_slice：线程的时间片大小。时间片是指线程在多任务系统中执行的时间段。如果设置为 0，则禁用时间片调度。
• auto_start：指示线程是否在创建后自动启动的标志。如果设置为 TX_AUTO_START，则线程在创建后立即运行。如果设置为其他非零值或 0，则线程需要手动启动。

tx_thread_create 函数返回一个无符号整数类型的值，表示函数执行的状态。常见的返回值包括 TX_SUCCESS（成功）和 TX_PTR_ERROR（参数错误）等。

通过使用 tx_thread_create 函数，可以在 ThreadX 环境中创建新的线程，并为其指定入口函数、堆栈、优先级等参数。这样就可以在 STM32 微控制器上同时运行多个线程，实现多任务处理和并发执行的应用程序。

在 ThreadX 中，线程入口函数只接受一个 ULONG 类型的参数。如果你需要传递多个参数给线程，你可以使用一个结构体来封装这些参数，然后将结构体的地址转换为 ULONG 类型并传递给线程。

exam：

#include "tx_api.h"

/* 定义任务堆栈大小 */
#define TASK_STACK_SIZE 1024

/* 定义任务优先级 */
#define TASK_PRI 16

/* 定义任务的ID */
TX_THREAD thread;

/* 定义任务堆栈 */
uint8_t thread_stack[TASK_STACK_SIZE];

/* 定义任务参数结构体 */
typedef struct {
    int param1;
    float param2;
    char* param3;
} thread_params_t;

/* 定义任务参数 */
thread_params_t thread_params = {123, 456.78, "Hello, ThreadX"};

/* 任务入口函数 */
void thread_entry(ULONG thread_input) {
    /* 将 thread_input 转换回原来的结构体指针 */
    thread_params_t* params = (thread_params_t*)thread_input;

    /* 现在你可以使用 params->param1, params->param2 和 params->param3 了 */
}

/* 程序入口函数 */
int main(void) {
    /* 初始化STM32硬件 */
    /* 初始化ThreadX内核 */
    tx_kernel_enter();

    /* 创建任务，将结构体的地址转换为 ULONG 类型并传递给线程 */
    tx_thread_create(&thread, "thread", thread_entry, (ULONG)&thread_params, 
                     thread_stack, TASK_STACK_SIZE, 
                     TASK_PRI, TASK_PRI, TX_NO_TIME_SLICE, TX_AUTO_START);

    /* 启动ThreadX内核 */
    tx_kernel_start();

    /* 永远不会运行到这里 */
    return 0;
}

以上代码演示了如何创建一个带有多个参数的任务并启动 ThreadX 内核。每个任务都有一个独立的堆栈和一个入口函数，可以在其中执行任务的操作。任务的参数通过 tx_thread_create 函数的 entry_input 参数传递给任务的入口函数。