Skip to content
chdhelpnlPublic

About

Windows tray utility: real-time CPU package power/temperature, per-core frequency panel, and TDP presets via Intel MSR 0x610 (PL1/PL2).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CpuTuner

任务栏常驻的 CPU 控制台:实时显示 功耗 / 温度,右键托盘一键切换 TDP 功耗档位。 由 CPUTempBar(显示)与 PowerLimiter(限功耗)合并而来,合二为一后只保留一个进程、一份 WinRing0 驱动会话。

功能

  • 任务栏右缘(时钟上方)浮窗显示 24.6W 65°C:实时封装功耗 + Package 温度(每 3 秒刷新)
  • 浮窗背景透明、点击穿透(WS_EX_TRANSPARENT),不干扰任务栏与托盘操作
  • 右键托盘 → 功耗档位 子菜单,当前档位打勾:
    • 24W / 25W(静音):PL1 24W、PL2 25W、时间窗取最大
    • 45W / 115W(性能):PL1 45W、PL2 115W(满睿频)、时间窗取最大
  • 自定义档位:子菜单「自定义…」填 10-115 之间的 PL1,沿用旧映射(PL2 = PL1 + 1W、固定时间窗)
  • 切换在后台线程执行,界面不卡;成功/失败弹气泡提示,失败自动回滚菜单勾选
  • 单击托盘图标呼出/隐藏「每核频率」面板(仅左键)
  • 右键托盘:开机自启动开关 / 退出(退出有二次确认)
  • 启动时自动应用第一个预设;退出时清除限制——写回启动前读到的 MSR 原值,而不是钉死某个瓦数
  • 自动提权(UAC)、单实例、开机自启计划任务 CpuTunerAutostart

运行原理

传感器与 MSR 写入走同一个内核驱动:

用途 方式
读温度/功耗/频率 LibreHardwareMonitorLib 0.9.4,Computer.Open() 会加载 WinRing0(\\.\WinRing0_1_2_0)
改功耗限制 反射调用同库内部的 LibreHardwareMonitor.Hardware.Ring0.WriteMsr(0x610, eax, edx)

因此不再需要 KX.exe 和 WinRing0x64.dll:写 MSR 复用已加载的驱动连接,少了外部进程和第二个驱动客户端。

档位值怎么算出来的

自定义档位仍走这条公式,只有两个字段随瓦数变化,其余是固定模板位(使能/硬钳制/时间窗):

EAX = 0x00DD8000 + W*8     // [14:0] PL1 = W(1/8 W 单位)
EDX = 0x00438008 + W*8     // [14:0] PL2 = W+1(短时睿频只高 1W)

0x610 每一半的结构(EAX 存 PL1,EDX 存 PL2):

[14:0]  功耗上限,单位 1/8 W
[15]    使能(1)
[16]    硬钳制 clamp(1)
[21:17] 时间窗尾数 M(0-31)
[23:22] 时间窗指数 E(0-3)     窗口 = (1 + M/4) × 2^E 个时间单位

两个预设(时间窗都取最大 M=31, E=3 = 70 个单位):

预设 PL1 PL2 EAX EDX
24W / 25W 24W (0xC0) 25W (0xC8) 0x00FF80C0 0x00FF80C8
45W / 115W 45W (0x168) 115W (0x398) 0x00FF8168 0x00FF8398

自定义档位仍沿用旧 PowerLimiter 的映射(PL1 = W、PL2 = W+1、PL1 窗口 36 单位、PL2 窗口 2.5 单位):

档位 EDX EAX
25W 0x004380d0 0x00dd80c8
28W 0x004380e8 0x00dd80e0
45W 0x00438170 0x00dd8168
65W 0x00438210 0x00dd8208

也就是 EAX = 0x00DD8000 + W*8、EDX = 0x00438008 + W*8。

退出时怎么“清除限制”

  • 启动时先用 Ring0.ReadMsr(0x610) 存一份固件原值,再写第一个预设
  • 退出时把这份原值写回去,所以恢复的是你机器本来的功耗策略(BIOS/EC 给的),不是一个写死的 65W
  • 如果启动时读不到(驱动被拦),退而清除 PL1/PL2 的使能位(EAX[15] / EDX[15],即 ~0x8000),等于撤掉 RAPL 约束、交回固件策略

自定义范围是 10-115W,上限取 i7-13700H 的 Maximum Turbo Power(115W)。这只是 UI 边界:真正生效的天花板是固件在 MSR 0x614[46:32] 里写的 max,写超了 IOCTL 照样成功但 CPU 会自己钳回去;0x610 的 bit63 若为 1(lock),写入会被整个忽略。判断依据永远是浮窗里的实测功耗。

Ring0 在 0.9.4 里是 internal,只能反射调用,所以 csproj 里把 LibreHardwareMonitorLib 锁死在 0.9.4。升级前务必确认 WriteMsr 的签名与可见性。

构建

dotnet build -c Release
dotnet publish -c Release -r win-x64 --self-contained false -o publish

要求 .NET SDK 8。构建前请先退出正在运行的实例,否则 exe 被占用会报 MSB3021/MSB3027。

使用

  1. 运行 publish\CpuTuner.exe(首次会弹 UAC,点“是”;需与同目录 DLL 一起,勿单独拷贝 exe)
  2. 右键托盘图标选档位;左键托盘图标看每核频率
  3. 退出时自动清除功耗限制(恢复启动前的 MSR 值)

目录

文件 说明
Program.cs 入口、提权、单实例、异常兜底、--list 诊断
AppCore.cs 刷新循环、定位、托盘菜单、档位状态、退出恢复
PowerController.cs 反射调用 LHM Ring0 写 MSR 0x610,档位表、串行化与合并请求
HardwareReader.cs 温度/功耗/每核频率读取(持有驱动会话)
TaskbarWidget.cs 透明点击穿透小窗(逐像素 alpha 绘制)
HoverPopup.cs 每核频率面板
CustomPowerDialog.cs 自定义档位输入框(10-115W)
TaskbarLocator.cs 任务栏矩形探测(句柄缓存)
ScheduledTask.cs 计划任务自启管理(含清理旧任务)
power.ico 托盘/应用图标(沿用 PowerLimiter)

免责声明

本工具通过反射调用内核驱动直接写 Intel MSR(0x610)修改 CPU 功耗限制,属于非官方、不受 Intel 或整机厂商支持的操作:

  • 仅在你自己拥有的设备上使用,风险自负。
  • 取值不当可能导致过热、降频、死机,极端情况下损伤硬件。
  • 不同机型的功率单位、固件上限(0x614)和 lock 位(0x610[63])都不相同,写入成功不代表生效,以浮窗实测功耗为准。
  • 作者不对任何直接或间接损失负责。

说明与已知行为

  • 不写日志文件;启动/运行异常会直接弹窗提示。
  • 传感器连续约 60 秒读不到时,会自动重建驱动连接并弹一次托盘提示。
  • 驱动被安全软件拦截时,读数和写 MSR 会一起失效,气泡会提示“写 MSR 失败(驱动未就绪)”。
  • 进程被强杀、崩溃或蓝屏时 MSR 不会自动恢复(这是 PowerLimiter 原有的限制,非合并引入;正常退出才会写回原值)。
  • 第一次在新程序里勾选「开机自启动」时,会自动删除旧的 CPUTempBarAutostart 计划任务,避免开机同时拉起两个驱动客户端。

About

Windows tray utility: real-time CPU package power/temperature, per-core frequency panel, and TDP presets via Intel MSR 0x610 (PL1/PL2).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages