// This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. // If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/. // Copyright (C) LibreHardwareMonitor and Contributors. // All Rights Reserved. using System; using System.Collections.Generic; using System.Globalization; using System.Linq; using System.Text; namespace LibreHardwareMonitor.Hardware.Motherboard.Lpc.EC { public abstract class EmbeddedController : Hardware { private enum ECSensor { /// Chipset temperature [℃] TempChipset, /// CPU temperature [℃] TempCPU, /// motherboard temperature [℃] TempMB, /// "T_Sensor" temperature sensor reading [℃] TempTSensor, /// VRM temperature [℃] TempVrm, /// CPU_Opt fan [RPM] FanCPUOpt, /// VRM heat sink fan [RPM] FanVrmHS, /// Chipset fan [RPM] FanChipset, /// Water flow sensor reading [RPM] FanWaterFlow, /// CPU current [A] CurrCPU, /// "Water_In" temperature sensor reading [℃] TempWaterIn, /// "Water_Out" temperature sensor reading [℃] TempWaterOut, Max }; private static readonly Dictionary _knownSensors = new() { { ECSensor.TempChipset, new EmbeddedControllerSource("Chipset", SensorType.Temperature, 0x003a) }, { ECSensor.TempCPU, new EmbeddedControllerSource("CPU", SensorType.Temperature, 0x003b) }, { ECSensor.TempMB, new EmbeddedControllerSource("Motherboard", SensorType.Temperature, 0x003c) }, { ECSensor.TempTSensor, new EmbeddedControllerSource("T Sensor", SensorType.Temperature, 0x003d, blank: -40) }, { ECSensor.TempVrm, new EmbeddedControllerSource("VRM", SensorType.Temperature, 0x003e) }, { ECSensor.FanCPUOpt, new EmbeddedControllerSource("CPU Optional Fan", SensorType.Fan, 0x00b0, 2) }, { ECSensor.FanVrmHS, new EmbeddedControllerSource("VRM Heat Sink Fan", SensorType.Fan, 0x00b2, 2) }, { ECSensor.FanChipset, new EmbeddedControllerSource("Chipset Fan", SensorType.Fan, 0x00b4, 2) }, // TODO: "why 42?" is a silly question, I know, but still, why? On the serious side, it might be 41.6(6) { ECSensor.FanWaterFlow, new EmbeddedControllerSource("Water flow", SensorType.Flow, 0x00bc, 2, factor: 1.0f / 42f * 60f) }, { ECSensor.CurrCPU, new EmbeddedControllerSource("CPU", SensorType.Current, 0x00f4) }, { ECSensor.TempWaterIn, new EmbeddedControllerSource("Water In", SensorType.Temperature, 0x0100, blank: -40) }, { ECSensor.TempWaterOut, new EmbeddedControllerSource("Water Out", SensorType.Temperature, 0x0101, blank: -40) }, }; private static readonly Dictionary _boardSensors = new() { { Model.PRIME_X570_PRO, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempVrm, ECSensor.TempTSensor, ECSensor.FanChipset } }, { Model.PRO_WS_X570_ACE, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB , ECSensor.TempVrm, ECSensor.FanChipset, ECSensor.CurrCPU} }, { Model.ROG_CROSSHAIR_VIII_HERO, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.TempWaterIn, ECSensor.TempWaterOut, ECSensor.FanCPUOpt, ECSensor.FanChipset, ECSensor.FanWaterFlow, ECSensor.CurrCPU} }, { Model.ROG_CROSSHAIR_VIII_HERO_WIFI, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.TempWaterIn, ECSensor.TempWaterOut, ECSensor.FanCPUOpt, ECSensor.FanChipset, ECSensor.FanWaterFlow, ECSensor.CurrCPU} }, { Model.ROG_CROSSHAIR_VIII_DARK_HERO, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.TempWaterIn, ECSensor.TempWaterOut, ECSensor.FanCPUOpt, ECSensor.FanWaterFlow, ECSensor.CurrCPU } }, { Model.CROSSHAIR_III_FORMULA, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.FanCPUOpt, ECSensor.FanChipset, ECSensor.CurrCPU } }, { Model.ROG_CROSSHAIR_VIII_IMPACT, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.FanChipset, ECSensor.CurrCPU } }, { Model.ROG_STRIX_B550_E_GAMING, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.FanCPUOpt } }, { Model.ROG_STRIX_B550_I_GAMING, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.FanVrmHS, ECSensor.CurrCPU } }, { Model.ROG_STRIX_X570_E_GAMING, new ECSensor[] { ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.TempVrm, ECSensor.FanChipset, ECSensor.CurrCPU } }, { Model.ROG_STRIX_X570_F_GAMING, new ECSensor[]{ECSensor.TempChipset, ECSensor.TempCPU, ECSensor.TempMB, ECSensor.TempTSensor, ECSensor.FanChipset} }, { Model.ROG_STRIX_X570_I_GAMING, new ECSensor[] { ECSensor.TempTSensor, ECSensor.FanVrmHS, ECSensor.FanChipset, ECSensor.CurrCPU } } }; static EmbeddedController() { System.Diagnostics.Debug.Assert(_knownSensors.Count == ((int)ECSensor.Max)); } private readonly IReadOnlyList _sources; private readonly List _sensors; private readonly ushort[] _registers; private readonly byte[] _data; protected EmbeddedController(IEnumerable sources, ISettings settings) : base("Embedded Controller", new Identifier("lpc", "ec"), settings) { // sorting by address, which implies sorting by bank, for optimized EC access var sourcesList = sources.ToList(); sourcesList.Sort((left, right) => { return left.Register.CompareTo(right.Register); }); _sources = sourcesList; var indices = new Dictionary(); foreach (SensorType t in Enum.GetValues(typeof(SensorType))) { indices.Add(t, 0); } _sensors = new List(); List registers = new(); foreach (EmbeddedControllerSource s in _sources) { int index = indices[s.Type]; indices[s.Type] = index + 1; _sensors.Add(new Sensor(s.Name, index, s.Type, this, settings)); for (int i = 0; i < s.Size; ++i) { registers.Add((ushort)(s.Register + i)); } ActivateSensor(_sensors[_sensors.Count - 1]); } _registers = registers.ToArray(); _data = new byte[_registers.Length]; } public override HardwareType HardwareType => HardwareType.EmbeddedController; internal static EmbeddedController Create(Model model, ISettings settings) { if (_boardSensors.TryGetValue(model, out ECSensor[] sensors)) { var sources = sensors.Select(ecs => _knownSensors[ecs]); return Environment.OSVersion.Platform switch { PlatformID.Win32NT => new WindowsEmbeddedController(sources, settings), _ => null }; } return null; } public override void Update() { if (!TryUpdateData()) { // just skip this update cycle? return; } int readRegister = 0; for (int si = 0; si < _sensors.Count; ++si) { int val = _sources[si].Size switch { 1 => unchecked((sbyte)_data[readRegister]), 2 => unchecked((short)((_data[readRegister] << 8) + _data[readRegister + 1])), _ => 0, }; readRegister += _sources[si].Size; _sensors[si].Value = val != _sources[si].Blank ? val * _sources[si].Factor : null; } } public override string GetReport() { StringBuilder r = new(); r.AppendLine("EC " + GetType().Name); r.AppendLine("Embedded Controller Registers"); r.AppendLine(); r.AppendLine(" 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F"); r.AppendLine(); try { using IEmbeddedControllerIO embeddedControllerIO = AcquireIOInterface(); ushort[] src = new ushort[0x100]; byte[] data = new byte[0x100]; for (ushort i = 0; i < src.Length; ++i) { src[i] = i; } embeddedControllerIO.Read(src, data); for (int i = 0; i <= 0xF; ++i) { r.Append(" "); r.Append((i << 4).ToString("X2", CultureInfo.InvariantCulture)); r.Append(" "); for (int j = 0; j <= 0xF; ++j) { byte address = (byte)(i << 4 | j); r.Append(" "); r.Append(data[address].ToString("X2", CultureInfo.InvariantCulture)); } r.AppendLine(); } } catch (IOException e) { r.AppendLine(e.Message); } return r.ToString(); } protected abstract IEmbeddedControllerIO AcquireIOInterface(); private bool TryUpdateData() { try { using IEmbeddedControllerIO embeddedControllerIO = AcquireIOInterface(); embeddedControllerIO.Read(_registers, _data); return true; } catch (IOException) { return false; } } public class IOException: System.IO.IOException { public IOException(string message): base($"ACPI embedded controller I/O error: {message}") { } } } }