thinkfan 温度到转速的决策原理StepwiseMapping 迟滞切换算法与 TemperatureState 偏置计算实战解读【免费下载链接】thinkfanThe minimalist fan control program项目地址: https://gitcode.com/gh_mirrors/th/thinkfanthinkfan 是一款极简的 Linux 风扇控制程序它按温度阈值自动调节转速。本文将带你读懂它的两个核心决策机制StepwiseMapping的迟滞切换算法如何决定升档/降档以及TemperatureState的温度偏置bias计算如何平滑或放大瞬时温变。理解这两点你就能为自己的笔记本或迷你主机写出安静又安全的温控配置。为什么风扇控制需要迟滞️ 先想象一个朴素做法温度高于 50°C 就开高速低于 50°C 就开低速。问题在于当温度长期在 50°C 附近波动传感器精度、采样误差、负载起伏都可能导致 ±1°C 的抖动时风扇会每几秒在高低速之间来回切换——既吵又伤风扇这就是振荡。thinkfan 的解法是给每一档都配置两个不同的阈值阈值含义判定方向upper_limit上限温度≥ 上限才升档升档条件lower_limit下限温度 下限才降档降档条件升档阈值高、降档阈值低中间形成一个缓冲区。温度必须在缓冲区外才能触发切换从而天然消除抖动。这就是迟滞hysteresis的核心思想。StepwiseMapping转速档位是如何切换的档位与阈值的关系由src/config.h中的StepwiseMapping类承载它的运行逻辑在 StepwiseMapping::set_fanspeed()即src/config.cpp第 67–86 行附近中实现规则可以归纳为三步尝试升档当前档的up()返回真任一传感器偏置温度 ≥ 该档 upper_limit就连续向上找直到某档的up()为假然后写入新转速尝试降档当前档的down()返回真所有传感器偏置温度 该档 lower_limit就连续向下找然后写入新转速保持不变两者都不满足时不重新写转速只发送一次看门狗心跳ping_watchdog_and_depulse防止某些硬件风扇控制器因超时而回落到自动模式。启动时的初始档位逻辑在init_fanspeed()从最高档开始只要down()为真就一路降档找到当前温度所属的第一档保证开机即进入合理状态而不是从 0 档慢慢爬。两种配置风格对应两种判定实现src/config.h第 94–114 行简单模式SimpleLevel所有传感器共用一对阈值只比较全局最高温度tmax。适合各部件温度相近的小系统详细模式ComplexLevel每个传感器各配一个阈值up()只要任一传感器越上限即升档down()要求所有传感器都低于下限才降档。多传感器场景如 CPU GPU推荐用这种。⚠️ 配置合法性在add_level()src/config.cpp第 111–132 行中被强制校验档位必须升序排列且上一档上限不能低于下一档下限——阈值区间不允许重叠否则直接报配置错误。以 YAML 配置为例参考 examples/thinkfan.yamllevels: - [0, 0, 50] # 0–50°C停转 - [100, 45, 65] # 50°C 升档65°C 以下才允许降档 - [255, 60] # 65°C 升档注意第 2 档升档线 50、降档线 45——温度降到 49°C 时风扇不会回落必须低于 45°C 才降档迟滞缓冲区就是这 5°C。TemperatureState温度偏置bias计算的实战细节阈值再好也比不过读到的温度不可信。thinkfan 用TemperatureStatesrc/temperature_state.h/src/temperature_state.cpp维护三组并行数据原始温度temps_、偏置量biases_、偏置后温度biased_temps_——所有档位判定使用的都是偏置后温度。偏置由命令行参数-b BIAS取值 -10 ~ 30默认 0控制src/thinkfan.cpp第 55 行的bias_level BIAS / 10。计算逻辑集中在TemperatureState::Ref::add_temp()src/temperature_state.cpp第 60–96 行① 快速温变触发偏置若本次温度比上次升高超过 2°C一个采样周期内立刻计算offset 温升差 × BIAS / 10 biased_t 当前温度 offset② 偏置缓慢衰减之后每次采样只要温升 ≤ 2°C偏置就按1 |bias|/5的步长朝 0 回归直到不足 0.5 时清零。也就是说偏置是临时加分不是永久篡改。③ 快速轮询触发偏置的同时采样间隔会被临时压到 2 秒tmp_sleeptime之后每轮 1 秒逐渐恢复到默认 5 秒-s可改。温变剧烈时盯得紧平稳后放松兼顾响应速度与系统开销。两种符号方向对应两类典型硬件问题场景参数效果集成温度传感器爱抽风瞬间冲高 10°C 后回落-b -10偏置 -10把毛刺削平防止风扇误升档传感器贴在大散热片上响应迟钝、真实温度已高却读数滞后-b 15温升 10°C 时偏置 15提前升档补偿滞后man 页src/thinkfan.1.cmake第 126–155 行明确建议负值用于抹平 on-die 传感器的尖峰正值用于补偿响应缓慢的传感器。负值写法注意-b-10中间不能有空格。组合起来看一次完整决策的时间线把两个机制串起来thinkfan 主循环src/thinkfan.cpp中run()约第 165–198 行每轮做的事是按tmp_sleeptime休眠默认 5 秒温变剧烈时缩短到 2 秒读取全部传感器TemperatureState计算偏置刷新tmaxStepwiseMapping::set_fanspeed()用偏置后温度做up()/down()迟滞判定发生档位变化才真正写入 PWM并输出一条日志。 实战建议先用默认-b 0跑几天观察日志里temp - fan level的变化频率如果看到同一对档位反复横跳优先拉大降档线与升档线的差距如 50/45 改成 50/42如果传感器有毛刺尖峰加-b -10如果降档总是慢半拍导致过热试-b 15提前升档多传感器机器CPU GPU尽量用详细模式给每个传感器独立阈值比全局tmax更精准。关键文件速查模块路径职责档位切换src/config.cpp/src/config.hStepwiseMapping、SimpleLevel、ComplexLevel温度偏置src/temperature_state.cpp偏置触发、衰减、tmax 跟踪主循环与参数src/thinkfan.cpp-b/-s/-p选项、轮询节奏配置示例examples/thinkfan.yamlYAML 传感器与档位写法参考选项手册src/thinkfan.1.cmakeman 页中 bias 公式的权威出处总结thinkfan 的决策链路可以用一句话概括TemperatureState 先把原始温度修正成可信的偏置温度StepwiseMapping 再用上/下限不对称的迟滞阈值决定升档、降档或保持。前者解决读数不可信后者解决切换会抖动。两者都不涉及复杂的 PID 计算代码量极小却完整体现了嵌入式温控中最实用的一套工程智慧——阈值区间 事件补偿。读懂这两个文件你也就掌握了 Linux 风扇控制程序的通用设计范式。【免费下载链接】thinkfanThe minimalist fan control program项目地址: https://gitcode.com/gh_mirrors/th/thinkfan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 thinkfan 温度到转速的决策原理：StepwiseMapping 迟滞切换算法与 TemperatureState 偏置计算实战解读
thinkfan 温度到转速的决策原理StepwiseMapping 迟滞切换算法与 TemperatureState 偏置计算实战解读【免费下载链接】thinkfanThe minimalist fan control program项目地址: https://gitcode.com/gh_mirrors/th/thinkfanthinkfan 是一款极简的 Linux 风扇控制程序它按温度阈值自动调节转速。本文将带你读懂它的两个核心决策机制StepwiseMapping的迟滞切换算法如何决定升档/降档以及TemperatureState的温度偏置bias计算如何平滑或放大瞬时温变。理解这两点你就能为自己的笔记本或迷你主机写出安静又安全的温控配置。为什么风扇控制需要迟滞️ 先想象一个朴素做法温度高于 50°C 就开高速低于 50°C 就开低速。问题在于当温度长期在 50°C 附近波动传感器精度、采样误差、负载起伏都可能导致 ±1°C 的抖动时风扇会每几秒在高低速之间来回切换——既吵又伤风扇这就是振荡。thinkfan 的解法是给每一档都配置两个不同的阈值阈值含义判定方向upper_limit上限温度≥ 上限才升档升档条件lower_limit下限温度 下限才降档降档条件升档阈值高、降档阈值低中间形成一个缓冲区。温度必须在缓冲区外才能触发切换从而天然消除抖动。这就是迟滞hysteresis的核心思想。StepwiseMapping转速档位是如何切换的档位与阈值的关系由src/config.h中的StepwiseMapping类承载它的运行逻辑在 StepwiseMapping::set_fanspeed()即src/config.cpp第 67–86 行附近中实现规则可以归纳为三步尝试升档当前档的up()返回真任一传感器偏置温度 ≥ 该档 upper_limit就连续向上找直到某档的up()为假然后写入新转速尝试降档当前档的down()返回真所有传感器偏置温度 该档 lower_limit就连续向下找然后写入新转速保持不变两者都不满足时不重新写转速只发送一次看门狗心跳ping_watchdog_and_depulse防止某些硬件风扇控制器因超时而回落到自动模式。启动时的初始档位逻辑在init_fanspeed()从最高档开始只要down()为真就一路降档找到当前温度所属的第一档保证开机即进入合理状态而不是从 0 档慢慢爬。两种配置风格对应两种判定实现src/config.h第 94–114 行简单模式SimpleLevel所有传感器共用一对阈值只比较全局最高温度tmax。适合各部件温度相近的小系统详细模式ComplexLevel每个传感器各配一个阈值up()只要任一传感器越上限即升档down()要求所有传感器都低于下限才降档。多传感器场景如 CPU GPU推荐用这种。⚠️ 配置合法性在add_level()src/config.cpp第 111–132 行中被强制校验档位必须升序排列且上一档上限不能低于下一档下限——阈值区间不允许重叠否则直接报配置错误。以 YAML 配置为例参考 examples/thinkfan.yamllevels: - [0, 0, 50] # 0–50°C停转 - [100, 45, 65] # 50°C 升档65°C 以下才允许降档 - [255, 60] # 65°C 升档注意第 2 档升档线 50、降档线 45——温度降到 49°C 时风扇不会回落必须低于 45°C 才降档迟滞缓冲区就是这 5°C。TemperatureState温度偏置bias计算的实战细节阈值再好也比不过读到的温度不可信。thinkfan 用TemperatureStatesrc/temperature_state.h/src/temperature_state.cpp维护三组并行数据原始温度temps_、偏置量biases_、偏置后温度biased_temps_——所有档位判定使用的都是偏置后温度。偏置由命令行参数-b BIAS取值 -10 ~ 30默认 0控制src/thinkfan.cpp第 55 行的bias_level BIAS / 10。计算逻辑集中在TemperatureState::Ref::add_temp()src/temperature_state.cpp第 60–96 行① 快速温变触发偏置若本次温度比上次升高超过 2°C一个采样周期内立刻计算offset 温升差 × BIAS / 10 biased_t 当前温度 offset② 偏置缓慢衰减之后每次采样只要温升 ≤ 2°C偏置就按1 |bias|/5的步长朝 0 回归直到不足 0.5 时清零。也就是说偏置是临时加分不是永久篡改。③ 快速轮询触发偏置的同时采样间隔会被临时压到 2 秒tmp_sleeptime之后每轮 1 秒逐渐恢复到默认 5 秒-s可改。温变剧烈时盯得紧平稳后放松兼顾响应速度与系统开销。两种符号方向对应两类典型硬件问题场景参数效果集成温度传感器爱抽风瞬间冲高 10°C 后回落-b -10偏置 -10把毛刺削平防止风扇误升档传感器贴在大散热片上响应迟钝、真实温度已高却读数滞后-b 15温升 10°C 时偏置 15提前升档补偿滞后man 页src/thinkfan.1.cmake第 126–155 行明确建议负值用于抹平 on-die 传感器的尖峰正值用于补偿响应缓慢的传感器。负值写法注意-b-10中间不能有空格。组合起来看一次完整决策的时间线把两个机制串起来thinkfan 主循环src/thinkfan.cpp中run()约第 165–198 行每轮做的事是按tmp_sleeptime休眠默认 5 秒温变剧烈时缩短到 2 秒读取全部传感器TemperatureState计算偏置刷新tmaxStepwiseMapping::set_fanspeed()用偏置后温度做up()/down()迟滞判定发生档位变化才真正写入 PWM并输出一条日志。 实战建议先用默认-b 0跑几天观察日志里temp - fan level的变化频率如果看到同一对档位反复横跳优先拉大降档线与升档线的差距如 50/45 改成 50/42如果传感器有毛刺尖峰加-b -10如果降档总是慢半拍导致过热试-b 15提前升档多传感器机器CPU GPU尽量用详细模式给每个传感器独立阈值比全局tmax更精准。关键文件速查模块路径职责档位切换src/config.cpp/src/config.hStepwiseMapping、SimpleLevel、ComplexLevel温度偏置src/temperature_state.cpp偏置触发、衰减、tmax 跟踪主循环与参数src/thinkfan.cpp-b/-s/-p选项、轮询节奏配置示例examples/thinkfan.yamlYAML 传感器与档位写法参考选项手册src/thinkfan.1.cmakeman 页中 bias 公式的权威出处总结thinkfan 的决策链路可以用一句话概括TemperatureState 先把原始温度修正成可信的偏置温度StepwiseMapping 再用上/下限不对称的迟滞阈值决定升档、降档或保持。前者解决读数不可信后者解决切换会抖动。两者都不涉及复杂的 PID 计算代码量极小却完整体现了嵌入式温控中最实用的一套工程智慧——阈值区间 事件补偿。读懂这两个文件你也就掌握了 Linux 风扇控制程序的通用设计范式。【免费下载链接】thinkfanThe minimalist fan control program项目地址: https://gitcode.com/gh_mirrors/th/thinkfan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考