术语表
super_agent_bot edited this page 2026-11-02 03:35:24 +08:00

术语表

按字母/中文混排, 便于在文档与代码之间对照。更完整的产品术语见 docs/产品需求/产品需求设计文档.md §1.2。

系统与平台

术语 含义
DTU Data Transfer Unit, 数据传输单元; 本产品的设备角色
MCU 微控制器; 本项目为 STM32F407ZGTx(Cortex-M4F, LQFP144)
HAL 硬件抽象层; ST 的 STM32F4xx HAL Driver
CMSIS Cortex 微控制器软件接口标准; 本项目用 CMSIS-RTOS2 封装 FreeRTOS
BSP Board Support Package, 板级支持包; 本项目指 Drivers/BSP/ 下手写驱动与服务
RTOS 实时操作系统; 本项目为 FreeRTOS V10.3.1
CCM Core Coupled Memory; STM32F4 的 64 KB 内核耦合内存, 本项目用于 FreeRTOS 堆(任务栈)
HSE / PLL 外部高速晶振 / 锁相环; 8 MHz → 168 MHz
IWDG Independent Watchdog, 独立看门狗; LSI 时钟源, 约 2.5 s 复位
Fault Cortex-M4 异常: HardFault / MemManage / BusFault / UsageFault
SWD Serial Wire Debug; PA13 SWDIO / PA14 SWCLK

存储

术语 含义
NAND 闪存类型; 本项目为 GD5F2GQ5UE SPI NAND, 256 MB
FTL Flash Translation Layer, 闪存转换层; 本项目用 dhara 实现逻辑块映射、磨损均衡、GC
BBT Bad Block Table, 坏块表; 持久化在 NAND 顶部 4 个保留块
GC Garbage Collection, 垃圾回收; FTL 的一部分
FatFs 通用 FAT 文件系统模块; 本项目为 FAT32, FF_USE_LFN=0
LFN Long File Name; 本项目关闭, 只支持 8.3 短名
8.3 短名 文件名 8 字符 + 扩展名 3 字符; 不得以点开头
原子写 临时文件 + rename, 保证读者只看到旧完整文件或新完整文件
BBT 扫描 启动时扫描 NAND 坏块并建立坏块表, 启动段最耗时步骤之一

网络

术语 含义
CH395F 10/100M 以太网控制器(MAC+PHY), SPI2 接口
PHY 物理层收发器; 本项目强制 100M 全双工
MAC 媒体访问控制地址; 全零表示使用 CH395F 芯片内置 MAC
BSD Socket API 本项目在 CH395F 之上封装的 net_socket 接口(socket/bind/listen/accept/recv/send/close)
select/poll I/O 多路复用; 本项目由 net_select 提供
单连接模型 CH395F 的 TCP Server 同一时刻只支持一个连接; Socket 0 复用监听与数据通道
netTask 唯一串行执行 CH395F 操作的任务; 其他任务经 netMsgQueue 请求
FTP File Transfer Protocol; 本项目 lftpd, 端口 21, 单客户端
RemoDispBus 远程显示总线协议; 160x160 1bpp 帧 + 远端按键, TCP 7003
IEC 60870-5-104 电力系统远动规约; 本项目为被控站, TCP 2404
总召 104 的 General Interrogation, 主站请求全量数据
COV Change of Value, 变化上送
SOE Sequence of Events, 事件顺序记录
t1/t2/t3、k/w 104 链路超时与窗口参数

采集与算法

术语 含义
TPAFE5160 高精度多通道 ADC, 并行 16 位接口; 本项目 8 路电气量
ADC1 STM32 片内 12 位 ADC; 本项目 9 路扫描 + DMA
DMA Direct Memory Access; ADC1 用 DMA2 Stream4 搬运
TRGO Timer Trigger Output; TIM3 更新事件经 TRGO 触发 ADC1
CONVST Convert Start; TPAFE5160 的转换启动脉冲
1 kHz / 20 点周波 采样率 1000 Hz; 50 Hz 下每周期 20 点
采集处理层 语义通道映射、有效性、健康检查
相量层 采样环 + 全周傅氏 + 相量计算
测频 自适应窗频率测量
保护判据层 定值与保护元件判据
全周傅氏 / DFT 全周波离散傅氏变换; 利用正交性做梳状带通, 计算幅值/相位
相量 用幅值和相位表示的正弦量; 相量层输出
RMS 有效值; 傅氏系数表折算
protectTask 20 ms 保护判据任务
定值 保护动作门槛与参数; 存 /prot_set.bin
YK11 104 遥控命令码之一; 本项目用于保护复归请求

UI

术语 含义
LVGL 轻量级嵌入式图形库; MCU 与 PC 模拟器共用
1bpp 每像素 1 位, 单色; 160x160 = 3200 B/帧
MSB 优先 位图字节的最高位对应该字节第一个像素
级联框 菜单显示模型: 每级一个框, 子框在父框右侧级联
内容页 独立全屏页面, 由框架一次性自绘, 零 LVGL 子对象
待机屏 空闲超时(默认 60 s)自动切入的屏幕
字体子集 只包含 UI 实际使用汉字的字库; 当前 122 字 / 217 字形
黄金参考 UI 回归的基准像素/文本快照; 更新需人工确认

工程与测试

术语 含义
@build 仓库约定的编译命令(keil-build skill)
@test 仓库约定的上电自检命令(串口采集 → 烧录 → 日志校验)
pre-commit Git 提交前自动执行的检查框架; 本项目约 52 个钩子
cppcheck C/C++ 静态分析工具; 本项目对项目代码执行
gitlint Git 提交信息格式检查
测试分类 静态检查 / 主机侧单元测试 / 板端套件 / 模拟器回归 / 真机台架
双端 MCU(Keil/ARMCC)与 PC 模拟器(CMake/MSVC)共用同一份源码
内核前模式 osKernelStart 之前只能使用纯寄存器/HAL/无锁静态缓冲的阶段
就绪屏障 用 Event Flags 表达子系统就绪、控制任务启动顺序的机制
单写者 某类资源只允许一个任务写: 配置、syslog、控制台均由 defaultTask 写