2. 开发环境搭建：使用Azure RTOS ThreadX源码包，基于STM32CubeMX或IAR/Keil的工程配置

说实话，很多初学者在ThreadX上栽跟头，不是因为RTOS本身难，而是环境没搭对。我见过有人花了一周时间，最后发现是源码路径里多了个空格。嗯，咱们今天就把这事彻底理清楚。

2.1 你需要准备什么

先列个清单，省得到时候手忙脚乱。我个人习惯把工具版本固定下来，避免「昨天还能编译，今天就不行了」的尴尬。

2.2 源码包结构速览

你下载的ThreadX源码包，打开后大概长这样。别被一堆文件夹吓到，核心就几个。

azure-rtos-threadx/
├── common/           # 核心源码，所有平台共用
│   ├── inc/          # 头文件
│   └── src/          # C源文件
├── ports/            # 移植层，按架构分
│   ├── cortex_m3/    # M3/M4/M7通用
│   ├── cortex_m4/    # 带FPU的M4
│   └── cortex_m7/    # M7专用优化
├── samples/          # 示例工程
└── docs/             # 文档，但说实话我很少看

你真正需要关心的只有两个：common/src 和 ports/cortex_m4。前者是所有RTOS的核心逻辑，后者是跟MCU硬件绑定的汇编和配置。

2.3 方式一：用STM32CubeMX生成基础工程

这是我最推荐的方式，尤其适合新手。CubeMX帮你把时钟、GPIO、调试接口都配好了，你只需要把ThreadX塞进去。

步骤拆解：

1. 新建工程，选好你的MCU型号。比如我常用STM32F407VGT6。
2. 配置时钟：HSE + PLL，主频拉到168MHz。ThreadX的时钟节拍依赖SysTick，所以SysTick别乱动。
3. 配置调试接口：SWD保留，串口1留作printf输出。我习惯把串口波特率设成115200。
4. 生成代码：Toolchain选MDK-ARM或EWARM，看你用哪个。

生成完工程后，在CubeMX里把 SYS->Timebase Source 改成 TIM6。这样SysTick就空出来给ThreadX了。

2.4 方式二：手动搭建IAR/Keil工程

如果你像我一样，喜欢对工程有完全控制权，那就手动搭。说白了就是新建一个空工程，然后把ThreadX源码加进去。

IAR下的操作：

• 新建工程，选 ARM Cortex-M4 内核。
• 添加源码组：common/src 下的所有 .c 文件。
• 添加移植组：ports/cortex_m4/iar 下的 .s 汇编文件。
• 添加头文件路径：common/inc 和 ports/cortex_m4/inc。
• 预定义宏：TX_INCLUDE_USER_DEFINE_FILE，这样ThreadX会加载你的 tx_user.h。

Keil下的操作：

• 基本一样，只是汇编文件在 ports/cortex_m4/keil 目录下。
• Keil的AC6编译器对ThreadX支持很好，但记得把优化等级设为 -O1 或 -O2，别用 -O0，否则任务切换会有奇怪的问题。

2.5 配置ThreadX：tx_user.h

这是ThreadX的配置总开关。你需要在工程里新建一个 tx_user.h，然后定义你需要的宏。下面是我常用的配置模板：

#ifndef TX_USER_H
#define TX_USER_H

// 系统时钟节拍，单位是Hz。我一般设1000，即1ms一个tick
#define TX_TIMER_TICKS_PER_SECOND     1000

// 线程栈对齐，Cortex-M4要求8字节对齐
#define TX_THREAD_STACK_ALIGNMENT     8

// 最大线程数，根据实际需求设。F4的话32个够用了
#define TX_MAX_THREADS                32

// 启用性能分析功能，调试时很有用
#define TX_ENABLE_EXECUTION_CHANGE_NOTIFY
#define TX_ENABLE_STACK_CHECKING

// 禁用不必要的功能，节省ROM
// #define TX_DISABLE_NOTIFY_CALLBACKS
// #define TX_DISABLE_PREEMPTION_THRESHOLD

#endif

配置完这个文件，ThreadX就知道怎么跑了。说白了，你告诉它「我的MCU主频多快、要支持多少个线程、要不要栈检查」，它就按这个来裁剪代码。

2.6 编写启动代码：main.c

环境搭好了，配置写好了，总得跑起来看看。下面是最简的启动代码：

#include "tx_api.h"

// 定义线程栈和控制块
TX_THREAD my_thread;
uint8_t my_thread_stack[1024];

// 线程入口函数
void my_thread_entry(ULONG thread_input)
{
    while(1)
    {
        // 你的应用代码放这里
        tx_thread_sleep(100);  // 休眠100个tick，即100ms
    }
}

int main(void)
{
    // 硬件初始化（CubeMX生成的代码）
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();

    // 初始化ThreadX
    tx_kernel_enter();
    return 0;  // 永远不会执行到这里
}

// ThreadX初始化完成后会调用这个函数
void tx_application_define(void *first_unused_memory)
{
    // 创建线程
    tx_thread_create(&my_thread, "My Thread",
                     my_thread_entry, 0,
                     my_thread_stack, sizeof(my_thread_stack),
                     16, 16,  // 优先级16，不使能抢占阈值
                     TX_NO_TIME_SLICE,
                     TX_AUTO_START);
}

注意 tx_kernel_enter() 这个函数。它不会返回。ThreadX接管后，所有代码都在任务上下文中执行。你的 main() 函数，说白了就是个启动引导。

2.7 验证环境：点灯测试

环境搭没搭对，跑个点灯任务就知道了。我在项目中每次移植完新板子，第一件事就是写一个LED闪烁的任务。如果LED能按预期闪烁，说明：

• 时钟配置正确
• SysTick中断正常
• 任务调度器在工作
• 栈空间分配没问题

2.8 知识结构总览

下面这张图，把整个搭建流程串起来了。你跟着箭头走一遍，环境就能跑起来。

2.9 常见问题速查

最后，我把移植过程中最常遇到的几个问题列出来。你如果遇到类似情况，直接对照排查。