Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758421Ab0GVQWe (ORCPT ); Thu, 22 Jul 2010 12:22:34 -0400 Received: from mga11.intel.com ([192.55.52.93]:25657 "EHLO mga11.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1758288Ab0GVQWY (ORCPT ); Thu, 22 Jul 2010 12:22:24 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.55,243,1278313200"; d="scan'208";a="588696160" Date: Thu, 22 Jul 2010 09:22:23 -0700 From: Fenghua Yu To: Ingo Molnar , Thomas Gleixner , "H. Peter Anvin" , "Brown, Len" , Chen Gong , Jean Delvare , Guenter Roeck , Huaxu Wan Cc: lkml , lm-sensors@lm-sensors.org Subject: [PATCH 5/5] Package Level Thermal Control and Power Limit Notification: pkgtemp doc Message-ID: <20100722162222.GA22450@linux-os.sc.intel.com> References: <94E56C79ECC49A4B87113985F1FEBA8D03F8AE2A4B@bgsmsx502.gar.corp.intel.com> <4C485DF1.5050407@linux.intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4C485DF1.5050407@linux.intel.com> User-Agent: Mutt/1.4.1i Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2168 Lines: 57 Document for package level thermal hwmon driver. Signed-off-by: Fenghua Yu Reviewed-by: Len Brown --- pkgtemp | 36 ++++++++++++++++++++++++++++++++++++ 1 files changed, 36 insertions(+) diff --git a/Documentation/hwmon/pkgtemp b/Documentation/hwmon/pkgtemp new file mode 100644 index 0000000..a60d286 --- /dev/null +++ b/Documentation/hwmon/pkgtemp @@ -0,0 +1,36 @@ +Kernel driver pkgtemp +====================== + +Supported chips: + * Intel family + Prefix: 'pkgtemp' + CPUID: + Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual + Volume 3A: System Programming Guide + +Author: Fenghua Yu + +Description +----------- + +This driver permits reading package level temperature sensor embedded inside +Intel CPU package. The sensors can be in core, uncore, memroy controller, or +other componenets in a package. The feature is first implemented in Intel Sandy +Bridge platform. + +Temperature is measured in degrees Celsius and measurement resolution is +1 degree C. Valid temperatures are from 0 to TjMax degrees C, because the actual +value of temperature register is in fact a delta from TjMax. + +Temperature known as TjMax is the maximum junction temperature of package. +Intel defines this temperature as 125C. At this temperature, protection +mechanism will perform actions to forcibly cool down the processor. Alarm +may be raised, if the temperature grows enough (more than TjMax) to trigger +the Out-Of-Spec bit. Following table summarizes the exported sysfs files: + +temp1_input - Package temperature (in millidegrees Celsius). +temp1_crit - Maximum junction temperature (in millidegrees Celsius). +temp1_crit_alarm - Set when Out-of-spec bit is set, never clears. + Correct CPU operation is no longer guaranteed. +temp1_label - Contains string "Pysical package id X", where X is physical + package id. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/