// 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. // Partial Copyright (C) Michael Möller and Contributors. // All Rights Reserved. using System; using System.Globalization; using System.Linq; using System.Text; using System.Threading; // ReSharper disable once InconsistentNaming namespace LibreHardwareMonitor.Hardware.Motherboard.Lpc; internal class IT87XX : ISuperIO { private const int MaxFanHeaders = 6; private readonly ushort _address; private readonly ushort _addressReg; private readonly int _bankCount; private readonly ushort _dataReg; private readonly bool[] _fansDisabled = Array.Empty(); private readonly ushort _gpioAddress; private readonly int _gpioCount; private readonly bool _has16BitFanCounter; private readonly bool _hasExtReg; private readonly bool[] _initialFanOutputModeEnabled = new bool[3]; // Initial Fan Controller Main Control Register value. private readonly byte[] _initialFanPwmControl = new byte[MaxFanHeaders]; // This will also store the 2nd control register value. private readonly byte[] _initialFanPwmControlExt = new byte[MaxFanHeaders]; private readonly bool[] _restoreDefaultFanPwmControlRequired = new bool[MaxFanHeaders]; private readonly byte _version; private readonly float _voltageGain; private IGigabyteController _gigabyteController; private readonly bool _requiresBankSelect; // Fix #780 Set to true for those chips that need a SelectBank(0) to fix dodgy temps and fan speeds private bool SupportsMultipleBanks => _bankCount > 1; public IT87XX(Chip chip, ushort address, ushort gpioAddress, byte version, Motherboard motherboard, IGigabyteController gigabyteController) { _address = address; _version = version; _addressReg = (ushort)(address + ADDRESS_REGISTER_OFFSET); _dataReg = (ushort)(address + DATA_REGISTER_OFFSET); _gpioAddress = gpioAddress; _gigabyteController = gigabyteController; _requiresBankSelect = false; Chip = chip; // Check vendor id byte vendorId = ReadByte(VENDOR_ID_REGISTER, out bool valid); if (!valid) return; bool hasMatchingVendorId = false; foreach (byte iteVendorId in ITE_VENDOR_IDS) { if (iteVendorId == vendorId) { hasMatchingVendorId = true; break; } } if (!hasMatchingVendorId) return; // Bit 0x10 of the configuration register should always be 1 byte configuration = ReadByte(CONFIGURATION_REGISTER, out valid); if (!valid || ((configuration & 0x10) == 0 && chip != Chip.IT8655E && chip != Chip.IT8665E)) return; FAN_PWM_CTRL_REG = chip switch { Chip.IT8665E or Chip.IT8625E => new byte[] { 0x15, 0x16, 0x17, 0x1e, 0x1f, 0x92 }, Chip.IT8792E => new byte[] { 0x15, 0x16, 0x17 }, _ => new byte[] { 0x15, 0x16, 0x17, 0x7f, 0xa7, 0xaf } }; _bankCount = chip switch { Chip.IT8689E => 4, _ => 1 }; _hasExtReg = chip is Chip.IT8721F or Chip.IT8728F or Chip.IT8665E or Chip.IT8686E or Chip.IT8688E or Chip.IT8689E or Chip.IT87952E or Chip.IT8628E or Chip.IT8625E or Chip.IT8620E or Chip.IT8613E or Chip.IT8792E or Chip.IT8655E or Chip.IT8631E or Chip.IT8696E; switch (chip) { case Chip.IT8613E: Voltages = new float?[10]; Temperatures = new float?[4]; Fans = new float?[5]; Controls = new float?[4]; break; case Chip.IT8625E: Voltages = new float?[7]; Temperatures = new float?[3]; Fans = new float?[6]; Controls = new float?[6]; break; case Chip.IT8628E: Voltages = new float?[10]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[6]; break; case Chip.IT8631E: Voltages = new float?[9]; Temperatures = new float?[2]; Fans = new float?[2]; Controls = new float?[2]; break; case Chip.IT8665E: Voltages = new float?[9]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[6]; _requiresBankSelect = true; break; case Chip.IT8686E: Voltages = new float?[10]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[5]; break; case Chip.IT8688E: Voltages = new float?[11]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[5]; break; case Chip.IT8689E: Voltages = new float?[10]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[6]; break; case Chip.IT8696E: Voltages = new float?[10]; Temperatures = new float?[6]; Fans = new float?[6]; Controls = new float?[6]; break; case Chip.IT87952E: Voltages = new float?[10]; Temperatures = new float?[3]; Fans = new float?[3]; Controls = new float?[3]; break; case Chip.IT8655E: Voltages = new float?[9]; Temperatures = new float?[6]; Fans = new float?[3]; Controls = new float?[3]; _requiresBankSelect = true; break; case Chip.IT8792E: Voltages = new float?[9]; Temperatures = new float?[3]; Fans = new float?[3]; Controls = new float?[3]; break; case Chip.IT8705F: Voltages = new float?[9]; Temperatures = new float?[3]; Fans = new float?[3]; Controls = new float?[3]; break; case Chip.IT8620E: Voltages = new float?[9]; Temperatures = new float?[3]; Fans = new float?[5]; Controls = new float?[5]; break; default: Voltages = new float?[9]; Temperatures = new float?[3]; Fans = new float?[5]; Controls = new float?[3]; break; } _fansDisabled = new bool[Fans.Length]; // Voltage gain varies by model. // Conflicting reports on IT8792E: either 0.0109 in linux drivers or 0.011 comparing with Gigabyte board & SIV SW. _voltageGain = chip switch { Chip.IT8613E or Chip.IT8620E or Chip.IT8628E or Chip.IT8631E or Chip.IT8721F or Chip.IT8728F or Chip.IT8771E or Chip.IT8772E or Chip.IT8686E or Chip.IT8688E or Chip.IT8689E or Chip.IT8696E => 0.012f, Chip.IT8625E or Chip.IT8792E or Chip.IT87952E => 0.011f, Chip.IT8655E or Chip.IT8665E => 0.0109f, _ => 0.016f }; // Older IT8705F and IT8721F revisions do not have 16-bit fan counters. _has16BitFanCounter = (chip != Chip.IT8705F || version >= 3) && (chip != Chip.IT8712F || version >= 8); // Disable any fans that aren't set with 16-bit fan counters if (_has16BitFanCounter) { int modes = ReadByte(FAN_TACHOMETER_16BIT_REGISTER, out valid); if (!valid) return; if (Fans.Length >= 5) { _fansDisabled[3] = (modes & (1 << 4)) == 0; _fansDisabled[4] = (modes & (1 << 5)) == 0; } if (Fans.Length >= 6) _fansDisabled[5] = (modes & (1 << 2)) == 0; } // Set the number of GPIO sets _gpioCount = chip switch { Chip.IT8712F or Chip.IT8716F or Chip.IT8718F or Chip.IT8726F => 5, Chip.IT8720F or Chip.IT8721F => 8, _ => 0 }; } public Chip Chip { get; } public float?[] Controls { get; } = Array.Empty(); public float?[] Fans { get; } = Array.Empty(); public float?[] Temperatures { get; } = Array.Empty(); public float?[] Voltages { get; } = Array.Empty(); public byte? ReadGpio(int index) { if (index >= _gpioCount) return null; return Ring0.ReadIoPort((ushort)(_gpioAddress + index)); } public void WriteGpio(int index, byte value) { if (index >= _gpioCount) return; Ring0.WriteIoPort((ushort)(_gpioAddress + index), value); } public void SetControl(int index, byte? value) { if (index < 0 || index >= Controls.Length) throw new ArgumentOutOfRangeException(nameof(index)); if (!Mutexes.WaitIsaBus(10)) return; if (value.HasValue) { SaveDefaultFanPwmControl(index); // Disable the controller when setting values to prevent it from overriding them if (_gigabyteController != null) _gigabyteController.Enable(false); if (index < 3 && !_initialFanOutputModeEnabled[index]) WriteByte(FAN_MAIN_CTRL_REG, (byte)(ReadByte(FAN_MAIN_CTRL_REG, out _) | (1 << index))); if (_hasExtReg) { if (Chip == Chip.IT8689E) { WriteByte(FAN_PWM_CTRL_REG[index], 0x7F); } else { WriteByte(FAN_PWM_CTRL_REG[index], (byte)(_initialFanPwmControl[index] & 0x7F)); } WriteByte(FAN_PWM_CTRL_EXT_REG[index], value.Value); } else { WriteByte(FAN_PWM_CTRL_REG[index], (byte)(value.Value >> 1)); } } else { RestoreDefaultFanPwmControl(index); } Mutexes.ReleaseIsaBus(); } public string GetReport() { StringBuilder r = new(); r.AppendLine("LPC " + GetType().Name); r.AppendLine(); r.Append("Chip ID: 0x"); r.AppendLine(Chip.ToString("X")); r.Append("Chip Version: 0x"); r.AppendLine(_version.ToString("X", CultureInfo.InvariantCulture)); r.Append("Base Address: 0x"); r.AppendLine(_address.ToString("X4", CultureInfo.InvariantCulture)); r.Append("GPIO Address: 0x"); r.AppendLine(_gpioAddress.ToString("X4", CultureInfo.InvariantCulture)); r.AppendLine(); if (!Mutexes.WaitIsaBus(100)) return r.ToString(); if (_requiresBankSelect) SelectBank(0); // dump memory of all banks if supported by chip for (byte b = 0; b < _bankCount; b++) { if (SupportsMultipleBanks && b > 0) { SelectBank(b); } r.AppendLine($"Environment Controller Registers Bank {b}"); r.AppendLine(); r.AppendLine(" 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F"); r.AppendLine(); for (int i = 0; i <= 0xA; i++) { r.Append(" "); r.Append((i << 4).ToString("X2", CultureInfo.InvariantCulture)); r.Append(" "); for (int j = 0; j <= 0xF; j++) { r.Append(" "); byte value = ReadByte((byte)((i << 4) | j), out bool valid); r.Append(valid ? value.ToString("X2", CultureInfo.InvariantCulture) : "??"); } r.AppendLine(); } r.AppendLine(); } if (SupportsMultipleBanks) { SelectBank(0); } r.AppendLine(); r.AppendLine("GPIO Registers"); r.AppendLine(); for (int i = 0; i < _gpioCount; i++) { r.Append(" "); r.Append(ReadGpio(i)?.ToString("X2", CultureInfo.InvariantCulture)); } r.AppendLine(); r.AppendLine(); Mutexes.ReleaseIsaBus(); return r.ToString(); } /// /// Selects another bank. Memory from 0x10-0xAF swaps to data from new bank. /// Beware to select the default bank 0 after changing. /// Bank selection is reset after power cycle. /// /// New bank index. Can be a value of 0-3. private void SelectBank(byte bankIndex) { if (bankIndex >= _bankCount) return; // current chip does not support that many banks // hard cap SelectBank to 2 bit values. If we ever have chips with more bank bits rewrite this method. bankIndex &= 0x3; byte value = ReadByte(BANK_REGISTER, out bool valid); if (valid) { value &= 0x9F; value |= (byte)(bankIndex << 5); WriteByte(BANK_REGISTER, value); } } public void Update() { if (!Mutexes.WaitIsaBus(10)) return; // Is this needed on every update? Yes, until a way to detect resume from sleep/hibernation is added, as that invalidates the bank select. if (_requiresBankSelect) SelectBank(0); for (int i = 0; i < Voltages.Length; i++) { float value = _voltageGain * ReadByte((byte)(VOLTAGE_BASE_REG + i), out bool valid); if (!valid) continue; if (value > 0) Voltages[i] = value; else Voltages[i] = null; } for (int i = 0; i < Temperatures.Length; i++) { sbyte value = (sbyte)ReadByte((byte)(TEMPERATURE_BASE_REG + i), out bool valid); if (!valid) continue; if (value is < sbyte.MaxValue and > 0) Temperatures[i] = value; else Temperatures[i] = null; } if (_has16BitFanCounter) { for (int i = 0; i < Fans.Length; i++) { if (_fansDisabled[i]) continue; int value = ReadByte(FAN_TACHOMETER_REG[i], out bool valid); if (!valid) continue; value |= ReadByte(FAN_TACHOMETER_EXT_REG[i], out valid) << 8; if (!valid) continue; if (value > 0x3f) Fans[i] = value < 0xffff ? 1.35e6f / (value * 2) : 0; else Fans[i] = null; } } else { for (int i = 0; i < Fans.Length; i++) { int value = ReadByte(FAN_TACHOMETER_REG[i], out bool valid); if (!valid) continue; int divisor = 2; if (i < 2) { int divisors = ReadByte(FAN_TACHOMETER_DIVISOR_REGISTER, out valid); if (!valid) continue; divisor = 1 << ((divisors >> (3 * i)) & 0x7); } if (value > 0) Fans[i] = value < 0xff ? 1.35e6f / (value * divisor) : 0; else Fans[i] = null; } } for (int i = 0; i < Controls.Length; i++) { byte value = ReadByte(FAN_PWM_CTRL_REG[i], out bool valid); if (!valid) continue; if ((value & 0x80) > 0) { // Automatic operation (value can't be read). Controls[i] = null; } else { // Software operation. if (_hasExtReg) { value = ReadByte(FAN_PWM_CTRL_EXT_REG[i], out valid); if (valid) Controls[i] = (float)Math.Round(value * 100.0f / 0xFF); } else { Controls[i] = (float)Math.Round((value & 0x7F) * 100.0f / 0x7F); } } } Mutexes.ReleaseIsaBus(); } private byte ReadByte(byte register, out bool valid) { Ring0.WriteIoPort(_addressReg, register); byte value = Ring0.ReadIoPort(_dataReg); valid = register == Ring0.ReadIoPort(_addressReg) || Chip == Chip.IT8688E; // IT8688E doesn't return the value we wrote to // addressReg when we read it back. return value; } private void WriteByte(byte register, byte value) { Ring0.WriteIoPort(_addressReg, register); Ring0.WriteIoPort(_dataReg, value); Ring0.ReadIoPort(_addressReg); } private void SaveDefaultFanPwmControl(int index) { if (!_restoreDefaultFanPwmControlRequired[index]) { _initialFanPwmControl[index] = ReadByte(FAN_PWM_CTRL_REG[index], out bool _); if (index < 3) _initialFanOutputModeEnabled[index] = ReadByte(FAN_MAIN_CTRL_REG, out bool _) != 0; // Save default control reg value. if (_hasExtReg) _initialFanPwmControlExt[index] = ReadByte(FAN_PWM_CTRL_EXT_REG[index], out _); } _restoreDefaultFanPwmControlRequired[index] = true; } private void RestoreDefaultFanPwmControl(int index) { if (_restoreDefaultFanPwmControlRequired[index]) { WriteByte(FAN_PWM_CTRL_REG[index], _initialFanPwmControl[index]); if (index < 3) { byte value = ReadByte(FAN_MAIN_CTRL_REG, out _); bool isEnabled = (value & (1 << index)) != 0; if (isEnabled != _initialFanOutputModeEnabled[index]) WriteByte(FAN_MAIN_CTRL_REG, (byte)(value ^ (1 << index))); } if (_hasExtReg) WriteByte(FAN_PWM_CTRL_EXT_REG[index], _initialFanPwmControlExt[index]); _restoreDefaultFanPwmControlRequired[index] = false; // restore the GB controller when all fans become restored if (_gigabyteController != null && _restoreDefaultFanPwmControlRequired.All(e => e == false)) _gigabyteController.Restore(); } } // ReSharper disable InconsistentNaming #pragma warning disable IDE1006 // Naming Styles private const byte ADDRESS_REGISTER_OFFSET = 0x05; private const byte CONFIGURATION_REGISTER = 0x00; private const byte DATA_REGISTER_OFFSET = 0x06; private const byte BANK_REGISTER = 0x06; // bit 5-6 define selected bank private const byte FAN_TACHOMETER_16BIT_REGISTER = 0x0C; private const byte FAN_TACHOMETER_DIVISOR_REGISTER = 0x0B; private readonly byte[] ITE_VENDOR_IDS = { 0x90, 0x7F }; private const byte TEMPERATURE_BASE_REG = 0x29; private const byte VENDOR_ID_REGISTER = 0x58; private const byte VOLTAGE_BASE_REG = 0x20; private readonly byte[] FAN_PWM_CTRL_REG; private readonly byte[] FAN_PWM_CTRL_EXT_REG = { 0x63, 0x6b, 0x73, 0x7b, 0xa3, 0xab }; private readonly byte[] FAN_TACHOMETER_EXT_REG = { 0x18, 0x19, 0x1a, 0x81, 0x83, 0x4d }; private readonly byte[] FAN_TACHOMETER_REG = { 0x0d, 0x0e, 0x0f, 0x80, 0x82, 0x4c }; // Address of the Fan Controller Main Control Register. // No need for the 2nd control register (bit 7 of 0x15 0x16 0x17), // as PWM value will set it to manual mode when new value is set. private const byte FAN_MAIN_CTRL_REG = 0x13; #pragma warning restore IDE1006 // Naming Styles // ReSharper restore InconsistentNaming }