2. embOS开发环境搭建

搭建 embOS 开发环境的核心目标，是让“编辑—编译—下载—调试”这条链路在真实硬件上跑通。本节以 SEGGER 官方工具链为主线，从 Embedded Studio 安装、embOS 源码包结构、目标板与调试器连接，一直走到第一个 LED 闪烁任务，形成可复现的最小工程闭环。

一、安装 SEGGER Embedded Studio

SEGGER Embedded Studio（简称 SES）是 SEGGER 提供的跨平台 IDE，内置 GCC/Clang 编译器、J-Link 调试支持和 embOS 工程模板，是学习 embOS 最省事的入口。安装流程如下：

1. 访问 SEGGER 官网下载对应平台的 Embedded Studio 安装包（Windows/macOS/Linux）。
2. 安装时勾选 J-Link 驱动 与 ARM 工具链，避免后续手动补装。
3. 首次启动后，在 Tools → Package Manager 中确认已安装目标芯片对应的 Device Support Package（如 Nordic nRF52、ST STM32F4 等）。
4. 若使用非商业授权，选择 Non-Commercial License 即可，学习与评估场景完全够用。

安装完成后，建议先新建一个空的 Cortex-M 工程并编译一次，确认工具链本身可用，再引入 embOS，这样能把“环境问题”和“embOS 集成问题”分开排查。

二、embOS 源码包结构

embOS 以源码形式交付，解压后目录结构清晰，理解它有助于后续裁剪与移植。典型结构如下：

embOS/
├── Start/                 # 启动与初始化相关
│   ├── BSP.c / BSP.h      # 板级支持包，含 LED、时钟等
│   ├── RTOSInit.c         # 系统节拍、中断优先级初始化
│   └── Main.c             # 示例主程序入口
├── Gen/                   # 通用内核源码（与 CPU 无关）
│   ├── OS_Global.h
│   ├── OS_Task.c
│   ├── OS_Time.c
│   └── ...
├── CPU/                   # 与 CPU 架构相关
│   └── ARM/CM4/
│       ├── OS_CPU.h
│       ├── OS_CPU_A.S     # 上下文切换汇编
│       └── OS_CPU_C.c
├── Config/                # 配置头文件
│   └── OS_Config.h        # 任务数、优先级数、节拍频率等
└── Doc/                   # 手册与 API 说明

其中 Gen/ 与 CPU/ 是内核本体，Start/ 是移植层，Config/OS_Config.h 决定系统规模。例如 OS_TASK_MAX 控制最大任务数，OS_TIME_TICK_FREQ 决定系统节拍频率，默认常为 1000 Hz（即 1 ms 一个 tick）。

三、目标板选型与调试器连接

学习 embOS 建议选择资料丰富、J-Link 支持良好的 Cortex-M 开发板，例如 STM32F407 Discovery、STM32F103 最小系统板或 Nordic nRF52840 DK。选型时关注三点：

• 内核与主频：Cortex-M3/M4/M7 均可，主频 ≥ 72 MHz 便于观察节拍。
• 板载调试器：带 ST-Link 或 J-Link OB 的板子可省去外接调试器。
• 可观测外设：至少一个用户 LED 和一个串口，便于验证任务运行。

调试器连接方面，若使用独立 J-Link，接线为：VTref 接目标板 3.3V 参考、GND 共地、SWDIO 与 SWCLK 接对应引脚、RESET 可选。连接后在 SES 中打开 Target → Connect J-Link，若能在 Debug 窗口看到芯片 ID 与内核信息，说明链路正常。

四、第一个 LED 闪烁任务

embOS 的最小可运行程序由三部分组成：硬件初始化、内核启动、任务定义。下面给出一个基于 Cortex-M 的示例结构（参数为教学示例，实际以所用板卡为准）。

#include "RTOS.h"
#include "BSP.h"

static OS_STACKPTR int AppStack[128];   // 任务栈，单位：OS_STACKPTR
static OS_TASK     AppTCB;              // 任务控制块

static void AppTask(void) {
    while (1) {
        BSP_LED_Toggle(0);              // 翻转 LED0
        OS_TASK_Delay(500);             // 延时 500 个 tick
    }
}

int main(void) {
    OS_Init();                          // 内核初始化
    OS_InitHW();                        // 硬件/节拍初始化
    BSP_Init();                         // 板级初始化（LED、时钟）
    OS_TASK_CREATE(&AppTCB, "App", AppTask, 100, AppStack, sizeof(AppStack));
    OS_Start();                         // 启动调度器，不再返回
    return 0;
}

关键点说明：OS_TASK_CREATE 的优先级参数 100 需落在 OS_Config.h 允许的优先级范围内；OS_TASK_Delay(500) 在 1000 Hz 节拍下对应 500 ms，因此 LED 会以约 1 Hz 频率闪烁。若节拍频率改为 100 Hz，同样的 500 会变成 5 s，这是初学者最容易忽略的换算关系。

五、下载、运行与结果判断

在 SES 中依次执行 Build → Download → Debug。若一切正常，可观察到：

• LED 以约 1 Hz 稳定闪烁，说明调度器已启动且任务在运行。
• 在 Debug 窗口暂停 CPU，调用栈应停在 AppTask 或 OS_TASK_Delay 内部。
• 若 LED 不亮，先检查 BSP_Init 是否配置了正确引脚，再确认 OS_InitHW 是否使能了 SysTick。