FreeRTOS_On_AI8051U_5022:基于 FreeRTOS v10.5.1 的 STC32G/AI8051U 251 内核单片机移植项目

在AI8051U上运行FreeRTOS,当前视频FreeRTOS的内核版本V10.5.1

Branch5Tags0

<<<<<<< HEAD

TestRepo

第一个Repo的测试项目

作者

姓名:毛钧杰 学号:2024540115

FreeRTOS_AI8051U_USB_BaseLine

基于 FreeRTOS v10.5.1 的移植工程,适配 STC32G/AI8051U 251 内核单片机,支持 USB 通信,演示多任务调度与外设控制。


项目简介

本项目将 FreeRTOS v10.5.1 移植到 STC32G/AI8051U 251 系列单片机,利用硬件中断模拟 PendSV 行为,实现多任务调度。集成了 USB 通信、LED 闪烁、串口打印等基础功能,适合二次开发和学习。

主要特性

  • FreeRTOS v10.5.1 内核,支持任务调度、队列、信号量等常用功能
  • 适配 STC32G/AI8051U 251 内核,支持 Keil C251 编译环境
  • USB 通信支持,内置 USB 设备描述符与数据收发接口
  • 任务演示:LED 闪烁、串口/USB 打印
  • 代码结构清晰,便于扩展

目录结构

├── FreeRTOS/           # FreeRTOS 内核源码及移植层
│   ├── include/        # FreeRTOS 头文件
│   ├── portable/       # 移植相关代码
│   └── ...
├── library/            # STC32G 外设驱动库
├── main.c              # 主函数,任务创建与调度入口
├── StarTask.c/h        # 任务示例:LED 跑马灯、打印
├── TaskBlinkP21.c/h    # 任务示例:P2.1 闪烁
├── UART.C/H            # 串口驱动
├── ai_usb.h            # USB 驱动与接口
├── FreeRTOS@AI8051.uvproj # Keil 工程文件
├── 使用说明.txt        # 简要中文说明
└── README.md           # 项目说明文档

编译方法

  1. 使用 Keil uVision(建议 v5 及以上)打开 FreeRTOS@AI8051.uvproj 工程文件。
  2. 选择 MCS-251 Toolset,目标芯片为 AI8051U-32Bit Series。
  3. 勾选项目选项中的 Generate reentrant functions(全局重入函数)。
  4. 编译工程,生成 HEX 文件。
  5. 使用 STC ISP 工具或其他烧录工具下载至目标单片机。

注意:

  • 定时器0 用作系统滴答。
  • PendSV 由硬件中断模拟,占用一个中断源。
  • 详细配置请参考 library/config.h 和 使用说明.txt。

使用说明

  • 上电后,USB 自动枚举为自定义设备。
  • 主任务创建后,LED 跑马灯与 P2.1 闪烁任务自动运行。
  • 可通过串口或 USB 观察任务运行日志。
  • 任务与外设可按需扩展。

贡献方式

欢迎提交 issue 或 PR 进行改进。建议遵循如下流程:

  1. Fork 本仓库
  2. 新建分支进行开发
  3. 提交 PR 并描述修改内容

许可证

本项目基于 MIT 许可证,FreeRTOS 内核遵循其官方许可证。


移植作者:tzz1983
日期:2024/4/5# FreeRTOS for STC AI8051U

基于 STC AI8051U 微控制器的 FreeRTOS V10.5.1 移植版本,支持 USB CDC 通信。

目录

简介

本项目是 FreeRTOS 在 STC AI8051U(251内核)芯片上的移植版本。采用硬件中断模拟 PendSV 行为实现任务切换,弥补了传统8051内核无法直接使用 PendSV 的问题。

作者: 杨老师
移植日期: 2026年4月24日
FreeRTOS版本: V10.5.1

特性

  • 完整的 FreeRTOS 内核功能
  • USB CDC 虚拟串口通信
  • 多串口支持(UART1-4),支持 DMA 模式
  • 抢占式任务调度
  • 时间片轮转调度
  • 任务通知、信号量、队列等同步机制
  • 可配置的任务堆栈大小

硬件要求

  • MCU: STC AI8051U-32Bit Series
  • 时钟频率: 可配置(默认 11.0592MHz)
  • 存储:
    • IRAM: 0x0000 - 0x07FF (2KB)
    • XRAM: 0x10000 - 0x17FFF (32KB)
    • Flash: 0xFF0000 - 0xFFFFFF (64KB)

软件要求

  • IDE: Keil MDK (支持 MCS-251)
  • 编译器: C251 编译器
  • 烧录工具: STC ISP 或 STC-Link

快速开始

1. 编译项目

  1. 使用 Keil MDK 打开 FreeRTOS@AI8051.uvprojx 文件
  2. 确保编译选项中勾选 Generate reentrant functions(全局重入函数)
  3. 点击 Build 进行编译

2. 烧录程序

  1. 使用 STC ISP 或 STC-Link 工具
  2. 选择对应的芯片型号(AI8051U-32Bit Series)
  3. 选择编译生成的 HEX 文件
  4. 点击下载

3. 运行验证

程序运行后:

  • P2.1 引脚会以 0.5Hz 频率闪烁(每秒切换一次)
  • P2 口会循环点亮 LED
  • USB 虚拟串口会输出任务运行日志

项目结构

FreeRTOS_AI8051U_USB_BaseLine_V1.0/
├── FreeRTOS/                    # FreeRTOS 内核源码
│   ├── include/                 # 内核头文件
│   ├── portable/                # 移植层
│   │   └── AI8051U/             # AI8051U 特定移植文件
│   │       ├── port.c          # 移植实现
│   │       ├── portmacro.h     # 移植宏定义
│   │       ├── FreeRTOSConfig.h # FreeRTOS 配置
│   │       └── os_pendsv_config.h # PendSV 配置
│   ├── croutine.c              # 协程实现
│   ├── tasks.c                 # 任务管理
│   ├── queue.c                 # 队列实现
│   ├── timers.c                # 软件定时器
│   └── event_groups.c          # 事件组
├── library/                     # 外设库
│   └── config.h                # 系统配置
├── StarTask.c                   # 启动任务
├── TaskBlinkP21.c               # LED 闪烁任务
├── UART.H/C                     # UART 驱动
├── ai_usb.h                     # USB API
├── main.c                       # 主程序
└── START251.A51                 # 启动文件

配置说明

系统时钟配置

在 library/config.h 中修改:

#define MAIN_Fosc    11059200L    // 定义主时钟

PendSV 配置

在 FreeRTOS/portable/AI8051U/os_pendsv_config.h 中配置。

FreeRTOS 配置

在 FreeRTOS/portable/AI8051U/FreeRTOSConfig.h 中配置关键参数:

配置项 默认值 说明
configTICK_RATE_HZ 1000 系统节拍频率
configMAX_PRIORITIES 16 最大优先级数
configTOTAL_HEAP_SIZE 1024 堆大小(字节)
configUSE_PREEMPTION 1 启用抢占式调度

UART 配置

在 UART.H 中配置:

#define UART1_EN    1           // 启用 UART1
#define UART2_EN    0           // 禁用 UART2
#define UART1_BRT_Timer1        // 波特率发生器选择

API 参考

USB API

// 初始化 USB
void usb_init(void);

// 发送数据
void USB_SendData(BYTE *dat, int size);

// 设置接收回调
void set_usb_OUT_callback(void (*pfn)(void));

// USB printf 输出
int printf_usb(const char *fmt, ...);

FreeRTOS 任务 API

// 创建任务
BaseType_t xTaskCreate(
    TaskFunction_t pvTaskCode,    // 任务函数
    const char *pcName,           // 任务名称
    uint16_t usStackDepth,        // 堆栈深度
    void *pvParameters,           // 参数
    UBaseType_t uxPriority,       // 优先级
    TaskHandle_t *pvCreatedTask   // 任务句柄
);

// 任务延时
void vTaskDelay(TickType_t xTicksToDelay);

// 启动调度器
void vTaskStartScheduler(void);

示例任务

BlinkP21 - LED 闪烁任务

void TaskBlinkP21(void *pvParameters)
{
    for(;;)
    {
        P21 = !P21;           // 翻转 P2.1
        vTaskDelay(1000);    // 延时 1000ms
        printf_usb("BlinkP1在运行\r\n");
    }
}

StartTask - 启动任务

创建系统启动后需要的其他任务。

注意事项

  1. 编译选项: 必须勾选 Generate reentrant functions
  2. 局部变量: 不要强制指定存储类型
  3. 定时器: 定时器0用作系统滴答,优先级最低
  4. 主堆栈: 任务启动后,主堆栈可作为通用内存使用
  5. 风险提示: 当前版本只对少量 OS 功能做了测试,请自行评估风险

License

本项目基于 FreeRTOS,遵循 FreeRTOS License。

56a309f42083b03fb10458ad5fa28db762758ee1

Introduction

在AI8051U上运行FreeRTOS,当前视频FreeRTOS的内核版本V10.5.1

Customize your domain