# TFF_26

**Repository Path**: caraba/26

## Basic Information

- **Project Name**: TFF_26
- **Description**: 基于STC8H单片机的26版TFF(分层流式框架)项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TFF（层流框架）

**TierFlow Embedded Development Framework（TF-EDMF）** —— 面向 AI 工具链的分层流式嵌入式开发框架。

通过分层架构和任务流式调度，为嵌入式应用提供清晰、可扩展的基础平台，并便于 AI 辅助开发工具理解、生成和修改代码。

> **注**：本仓库以智能风扇为例展示框架用法，完整文档见 `readme/00_项目文档索引.md`。

---

## 核心特点

- **分层架构**：bsp（板级支持）、csp（芯片支持）、user（应用层）、util（工具）职责清晰，便于维护和扩展
- **任务流式调度**：基于时间片的非阻塞任务调度，支持多任务按周期运行，适合资源受限的嵌入式场景
- **面向 AI 工具链**：结构规范、命名统一、模块边界明确，便于 AI 代码助手理解、生成和重构
- **轻量可编排**：模块化设计，可按需选用和组合，降低资源占用和上手成本

---

## 分层结构

```
user/    业务层：main、任务表、业务逻辑
bsp/     板级支持包：板载外设驱动（LED、按键、传感器等）
csp/     芯片支持包：片内外设驱动（定时器、UART、PWM、ADC 等）
util/    通用工具：延时、类型定义等
```

**依赖关系**：user → bsp → csp；csp 仅依赖芯片头文件。

---

## CSP（芯片支持包）

提供 STC8H 片内外设的底层驱动，纯寄存器配置：

| 模块 | 说明 |
|------|------|
| **cs_stc8h_timer** | T0～T4 定时器，1ms 节拍与回调注册 |
| **cs_stc8h_uart** | 多路 UART |
| **cs_stc8h_pwm** | PWM 输出 |
| **cs_stc8h_adc** | ADC 采集 |
| **cs_stc8h_eeprom** | EEPROM 读写 |
| **cs_stc8h_i2c_soft** | 软件 I2C |

---

## BSP（板级支持包）

针对 **sc8h25a** 开发板的板载外设驱动（可替换为其他板卡）：

| 模块 | 说明 |
|------|------|
| **bs_sc8h25a_led** | 三色 LED（蓝/红/绿，P0） |
| **bs_sc8h25a_key** | 按键扫描（定时扫描/外部中断） |
| **bs_sc8h25a_temp_ds18b20** | DS18B20 温度传感器 |
| **bs_sc8h25a_seg_tm1650** | TM1650 数码管 |

---

## 任务调度

- **1ms 节拍**：CSP 定时器（T0～T4 可选）每 1ms 溢出，在中断中调用 `Task_Tick_Cb` 对任务表倒计时
- **主循环执行**：`Task_Run_Pending()` 遍历任务表，执行 `pending==1` 的回调，无阻塞
- **任务表**：`s_task_table[]` 定义各任务周期与回调；扩展时增删表项并在 `Task_Init()` 中调用业务 Init

```
定时器 1ms 溢出 → Task_Tick_Cb(countdown_ms--) → pending=1
主循环 loop()   → Task_Run_Pending() → 执行 task_cb()
```

---

## 构建

- **工具链**：Keil C51
- **工程**：`.eide/eide.yml`（EIDE）
- **编译输出**：`build/tf/`

---

## 文档

- **文档索引**：`readme/00_项目文档索引.md`
- **框架简介**：`readme/02_TF框架简介.md`
- **示例说明**：`readme/04_智能风扇使用说明.md`（以智能风扇为例）
- **协议**：MIT License，详见 `readme/01_版权与开源协议.md`

---

## License

本项目采用 **MIT License**。协议全文见 [LICENSE](LICENSE)，版权声明与附加条款见 `readme/01_版权与开源协议.md`。