Hardware/LPC/IT87XX.cs
author moel.mich
Sun, 15 Jan 2012 22:06:59 +0000
changeset 335 9549c46bebb1
parent 320 df3493f75225
child 341 5172a92c5c20
permissions -rw-r--r--
Fixed Issue 313.
     1 /*
     2   
     3   Version: MPL 1.1/GPL 2.0/LGPL 2.1
     4 
     5   The contents of this file are subject to the Mozilla Public License Version
     6   1.1 (the "License"); you may not use this file except in compliance with
     7   the License. You may obtain a copy of the License at
     8  
     9   http://www.mozilla.org/MPL/
    10 
    11   Software distributed under the License is distributed on an "AS IS" basis,
    12   WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
    13   for the specific language governing rights and limitations under the License.
    14 
    15   The Original Code is the Open Hardware Monitor code.
    16 
    17   The Initial Developer of the Original Code is 
    18   Michael Möller <m.moeller@gmx.ch>.
    19   Portions created by the Initial Developer are Copyright (C) 2009-2011
    20   the Initial Developer. All Rights Reserved.
    21 
    22   Contributor(s):
    23 
    24   Alternatively, the contents of this file may be used under the terms of
    25   either the GNU General Public License Version 2 or later (the "GPL"), or
    26   the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
    27   in which case the provisions of the GPL or the LGPL are applicable instead
    28   of those above. If you wish to allow use of your version of this file only
    29   under the terms of either the GPL or the LGPL, and not to allow others to
    30   use your version of this file under the terms of the MPL, indicate your
    31   decision by deleting the provisions above and replace them with the notice
    32   and other provisions required by the GPL or the LGPL. If you do not delete
    33   the provisions above, a recipient may use your version of this file under
    34   the terms of any one of the MPL, the GPL or the LGPL.
    35  
    36 */
    37 
    38 using System.Globalization;
    39 using System.Text;
    40 
    41 namespace OpenHardwareMonitor.Hardware.LPC {
    42   internal class IT87XX : ISuperIO {
    43        
    44     private readonly ushort address;
    45     private readonly Chip chip;
    46     private readonly byte version;
    47 
    48     private readonly ushort gpioAddress;
    49     private readonly int gpioCount;
    50 
    51     private readonly ushort addressReg;
    52     private readonly ushort dataReg;
    53 
    54     private readonly float?[] voltages = new float?[0];
    55     private readonly float?[] temperatures = new float?[0];
    56     private readonly float?[] fans = new float?[0];
    57     private readonly float?[] controls = new float?[0];
    58 
    59     private readonly float voltageGain;
    60     private readonly bool has16bitFanCounter;
    61    
    62     // Consts
    63     private const byte ITE_VENDOR_ID = 0x90;
    64        
    65     // Environment Controller
    66     private const byte ADDRESS_REGISTER_OFFSET = 0x05;
    67     private const byte DATA_REGISTER_OFFSET = 0x06;
    68 
    69     // Environment Controller Registers    
    70     private const byte CONFIGURATION_REGISTER = 0x00;
    71     private const byte TEMPERATURE_BASE_REG = 0x29;
    72     private const byte VENDOR_ID_REGISTER = 0x58;
    73     private const byte FAN_TACHOMETER_DIVISOR_REGISTER = 0x0B;
    74     private readonly byte[] FAN_TACHOMETER_REG = 
    75       new byte[] { 0x0d, 0x0e, 0x0f, 0x80, 0x82 };
    76     private readonly byte[] FAN_TACHOMETER_EXT_REG =
    77       new byte[] { 0x18, 0x19, 0x1a, 0x81, 0x83 };
    78     private const byte VOLTAGE_BASE_REG = 0x20;
    79 
    80     private byte ReadByte(byte register, out bool valid) {
    81       Ring0.WriteIoPort(addressReg, register);
    82       byte value = Ring0.ReadIoPort(dataReg);
    83       valid = register == Ring0.ReadIoPort(addressReg);
    84       return value;
    85     }
    86 
    87     private bool WriteByte(byte register, byte value) {
    88       Ring0.WriteIoPort(addressReg, register);
    89       Ring0.WriteIoPort(dataReg, value);
    90       return register == Ring0.ReadIoPort(addressReg); 
    91     }
    92 
    93     public byte? ReadGPIO(int index) {
    94       if (index >= gpioCount)
    95         return null;
    96 
    97       return Ring0.ReadIoPort((ushort)(gpioAddress + index));
    98     }
    99 
   100     public void WriteGPIO(int index, byte value) {
   101       if (index >= gpioCount)
   102         return;
   103 
   104       Ring0.WriteIoPort((ushort)(gpioAddress + index), value);
   105     }
   106 
   107     public void SetControl(int index, byte? value) { }   
   108 
   109     public IT87XX(Chip chip, ushort address, ushort gpioAddress, byte version) {
   110 
   111       this.address = address;
   112       this.chip = chip;
   113       this.version = version;
   114       this.addressReg = (ushort)(address + ADDRESS_REGISTER_OFFSET);
   115       this.dataReg = (ushort)(address + DATA_REGISTER_OFFSET);
   116       this.gpioAddress = gpioAddress;
   117 
   118       // Check vendor id
   119       bool valid;
   120       byte vendorId = ReadByte(VENDOR_ID_REGISTER, out valid);       
   121       if (!valid || vendorId != ITE_VENDOR_ID)
   122         return;
   123 
   124       // Bit 0x10 of the configuration register should always be 1
   125       if ((ReadByte(CONFIGURATION_REGISTER, out valid) & 0x10) == 0)
   126         return;
   127       if (!valid)
   128         return;
   129 
   130       voltages = new float?[9];
   131       temperatures = new float?[3];
   132       fans = new float?[5];
   133 
   134       // IT8721F, IT8728F and IT8772E use a 12mV resultion ADC, all others 16mV
   135       if (chip == Chip.IT8721F || chip == Chip.IT8728F || chip == Chip.IT8772E) 
   136       {
   137         voltageGain = 0.012f;
   138       } else {
   139         voltageGain = 0.016f;        
   140       }
   141 
   142       // older IT8721F revision do not have 16-bit fan counters
   143       if (chip == Chip.IT8712F && version < 8) {
   144         has16bitFanCounter = false;
   145       } else {
   146         has16bitFanCounter = true;
   147       }
   148 
   149       // Set the number of GPIO sets
   150       switch (chip) {
   151         case Chip.IT8712F:
   152         case Chip.IT8716F:
   153         case Chip.IT8718F:
   154         case Chip.IT8726F:
   155           gpioCount = 5;
   156           break;
   157         case Chip.IT8720F:
   158         case Chip.IT8721F:
   159           gpioCount = 8;
   160           break;
   161         case Chip.IT8728F:
   162         case Chip.IT8772E:
   163           gpioCount = 0;
   164           break;
   165       }
   166     }
   167 
   168     public Chip Chip { get { return chip; } }
   169     public float?[] Voltages { get { return voltages; } }
   170     public float?[] Temperatures { get { return temperatures; } }
   171     public float?[] Fans { get { return fans; } }
   172     public float?[] Controls { get { return controls; } }
   173 
   174     public string GetReport() {
   175       StringBuilder r = new StringBuilder();
   176 
   177       r.AppendLine("LPC " + this.GetType().Name);
   178       r.AppendLine();
   179       r.Append("Chip ID: 0x"); r.AppendLine(chip.ToString("X"));
   180       r.Append("Chip Version: 0x"); r.AppendLine(
   181         version.ToString("X", CultureInfo.InvariantCulture));
   182       r.Append("Base Address: 0x"); r.AppendLine(
   183         address.ToString("X4", CultureInfo.InvariantCulture));
   184       r.Append("GPIO Address: 0x"); r.AppendLine(
   185         gpioAddress.ToString("X4", CultureInfo.InvariantCulture));
   186       r.AppendLine();
   187 
   188       if (!Ring0.WaitIsaBusMutex(100))
   189         return r.ToString();
   190 
   191       r.AppendLine("Environment Controller Registers");
   192       r.AppendLine();
   193       r.AppendLine("      00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F");
   194       r.AppendLine();
   195       for (int i = 0; i <= 0xA; i++) {
   196         r.Append(" "); 
   197         r.Append((i << 4).ToString("X2", CultureInfo.InvariantCulture)); 
   198         r.Append("  ");
   199         for (int j = 0; j <= 0xF; j++) {
   200           r.Append(" ");
   201           bool valid;
   202           byte value = ReadByte((byte)((i << 4) | j), out valid);
   203           r.Append(
   204             valid ? value.ToString("X2", CultureInfo.InvariantCulture) : "??");
   205         }
   206         r.AppendLine();
   207       }
   208       r.AppendLine();
   209 
   210       r.AppendLine("GPIO Registers");
   211       r.AppendLine();
   212       for (int i = 0; i < gpioCount; i++) {
   213         r.Append(" ");
   214         r.Append(ReadGPIO(i).Value.ToString("X2",
   215           CultureInfo.InvariantCulture));
   216       }
   217       r.AppendLine();
   218       r.AppendLine();
   219 
   220       Ring0.ReleaseIsaBusMutex();
   221 
   222       return r.ToString();
   223     }
   224 
   225     public void Update() {
   226       if (!Ring0.WaitIsaBusMutex(10))
   227         return;
   228 
   229       for (int i = 0; i < voltages.Length; i++) {
   230         bool valid;
   231         
   232         float value = 
   233           voltageGain * ReadByte((byte)(VOLTAGE_BASE_REG + i), out valid);   
   234 
   235         if (!valid)
   236           continue;
   237         if (value > 0)
   238           voltages[i] = value;  
   239         else
   240           voltages[i] = null;
   241       }
   242 
   243       for (int i = 0; i < temperatures.Length; i++) {
   244         bool valid;
   245         sbyte value = (sbyte)ReadByte(
   246           (byte)(TEMPERATURE_BASE_REG + i), out valid);
   247         if (!valid)
   248           continue;
   249 
   250         if (value < sbyte.MaxValue && value > 0)
   251           temperatures[i] = value;
   252         else
   253           temperatures[i] = null;       
   254       }
   255 
   256       if (has16bitFanCounter) {
   257         for (int i = 0; i < fans.Length; i++) {
   258           bool valid;
   259           int value = ReadByte(FAN_TACHOMETER_REG[i], out valid);
   260           if (!valid)
   261             continue;
   262           value |= ReadByte(FAN_TACHOMETER_EXT_REG[i], out valid) << 8;
   263           if (!valid)
   264             continue;
   265 
   266           if (value > 0x3f) {
   267             fans[i] = (value < 0xffff) ? 1.35e6f / (value * 2) : 0;
   268           } else {
   269             fans[i] = null;
   270           }
   271         }
   272       } else {
   273         for (int i = 0; i < fans.Length; i++) {
   274           bool valid;
   275           int value = ReadByte(FAN_TACHOMETER_REG[i], out valid);
   276           if (!valid)
   277             continue;
   278 
   279           int divisor = 2;
   280           if (i < 2) {
   281             int divisors = ReadByte(FAN_TACHOMETER_DIVISOR_REGISTER, out valid);
   282             if (!valid)
   283               continue;
   284             divisor = 1 << ((divisors >> (3 * i)) & 0x7);
   285           }
   286 
   287           if (value > 0) {
   288             fans[i] = (value < 0xff) ? 1.35e6f / (value * divisor) : 0;
   289           } else {
   290             fans[i] = null;
   291           }
   292         }
   293       }
   294 
   295       Ring0.ReleaseIsaBusMutex();
   296     }
   297   } 
   298 }