{{{#!html
          <div id="wikipage" class="trac-content"><p>
</p><div class="wiki-toc">
<ol>
  <li>
    <a href="#VentanaThermalInformation">Ventana Thermal Information</a>
    <ol>
      <li>
        <a href="#GateworksSystemControllerGSC">Gateworks System Controller (GSC)</a>
      </li>
      <li>
        <a href="#IMX6SoC">IMX6 SoC</a>
        <ol>
          <li>
            <a href="#LinuxKernelSupport">Linux Kernel Support</a>
          </li>
          <li>
            <a href="#U-BootSupport">U-Boot Support</a>
          </li>
        </ol>
      </li>
      <li>
        <a href="#VivanteGPUthermalmanagement">Vivante GPU thermal management</a>
      </li>
    </ol>
  </li>
</ol>
</div><p>
</p>
<h1 id="VentanaThermalInformation">Ventana Thermal Information</h1>
<p>
See also:
</p>
<ul><li><a class="wiki" href="/wiki/ventana/thermal_management">Very Resourceful Thermal Management Page</a>
</li><li><a class="wiki" href="/wiki/DVFS">Dynamic Voltage and Frequency Scaling of the Processor</a>
</li><li><a class="wiki" href="/wiki/ventana/power">Ventana Power Consumption</a>
</li><li><a class="wiki" href="/wiki/faq#WhyarecertainareasontheboardwarmwithregardstotemperatureWhyismyboardhot">FAQ - Why is my board running hot?</a>
</li></ul><p>
<span class="wikianchor" id="gsc-thermal"></span>
</p>
<h2 id="GateworksSystemControllerGSC">Gateworks System Controller (GSC)</h2>
<p>
The Gateworks System Controller has a temperature sensor that measures board temperature as well as a fan controller on some models.
</p>
<p>
For more information:
</p>
<ul><li><a class="wiki" href="/wiki/gsc#hwmon">GSC Thermal sensor</a>
</li><li><a class="wiki" href="/wiki/gsc#fan">GSC Fan Controller</a> - Only available on GW54xx
</li></ul><p>
<span class="wikianchor" id="imx-thermal"></span>
</p>
<h2 id="IMX6SoC">IMX6 SoC</h2>
<p>
The IMX6 System On Chip has an internal die temperature sensor.
</p>
<p>
There are several temperature grades of IMX6 SoC's that are used across various Gateworks products:
</p>
<ul><li>IMX6Q Automotive: -40C to 125C
</li><li>IMX6DL Industrial: -40C to 105C
</li><li>IMX6S Industrial: -40C to 105C
</li></ul><h3 id="LinuxKernelSupport">Linux Kernel Support</h3>
<p>
The Linux IMX6 cpufreq cooling driver (drivers/thermal/imx_thermal.c) provides several functions:
</p>
<ul><li>display the thermal grade of CPU and min/max temperature
</li><li>thermal sensing of the IMX6 chip
</li><li>automatic CPU frequency throttling based on temperature feedback
</li></ul><p>
There is a Linux sysfs API for accessing this information:
</p>
<ul><li>Note in first line, hwmon1 may be hwmon2
<pre class="wiki">cat /sys/class/hwmon/hwmon1/temp1_input # current IMX temp in milicelcius
cat /sys/class/thermal/thermal_zone0/trip_point_0_temp # current passive temp in milicelcius
cat /sys/class/thermal/thermal_zone0/trip_point_1_temp # current critical temp in milicelcius
# set passive/crit to 105C/125C for automotive CPU
echo 105000 &gt; /sys/class/thermal/thermal_zone0/trip_point_0_temp
echo 125000 &gt; /sys/class/thermal/thermal_zone0/trip_point_1_temp
</pre></li></ul><p>
Notes:
</p>
<ul><li>the imx_thermal_zone temp currently starts scaling ARM cpufreq at 85C (until it lowers to 75C) and has a critical temp of 100C. This is really too conservative for the typical IMX6 temperature grades that Gateworks uses
</li><li>there is a 10C hysteresis such that the temperature needs to lower by 10C before the alarm is cancelled
</li><li>the <strong>passive</strong> trip point is a preventative measure before reaching critical that does things to lower temperature such as reducing cpu/gpu frequencies
</li><li>the <strong>critical</strong> trip point should not be exceeded to avoid damaging the CPU and as such when this trip point is reached the Linux shutdown function is called to attempt to gracefully shut down the OS. The default implementation will end up simply resetting the board but before that occurs a usermode helper will exec /sbin/poweroff which the user could implement to do whatever they choose (ie, sync filesystems, use GSC sleep for 'x' seconds, etc).
</li><li>the thresholds for the driver can be adjusted in userspace (see above)
</li><li>Gateworks has <a class="ext-link" href="http://thread.gmane.org/gmane.linux.ports.arm.kernel/409671/focus=411988"><span class="icon">​</span>an upstream Linux patch pending approval</a> that will set the initial setpoints according to the temperature grade of the CPU determined via eFUSE registers. This patch will eventually be rolled into our various kernel support.
</li></ul><h3 id="U-BootSupport">U-Boot Support</h3>
<p>
The Gateworks Ventana Bootloader driver (drivers/thermal/imx_thermal.c) provides several functions:
</p>
<ul><li>display the thermal grade of CPU and min/max temperature
</li><li>display current temperature of IMX6
</li><li>busyloop if over IMX6 temperature is greater or equal to max temp - 5C
</li></ul><p>
<span class="wikianchor" id="gpu-thermal"></span>
</p>
<h2 id="VivanteGPUthermalmanagement">Vivante GPU thermal management</h2>
<p>
The Vivante GPU has some frequency scaling based on temperature which enabled by default in the [drivers/mxc/gpu-viv/hal/os/linux/kernel/platform/freescale/gc_hal_kernel_platform_imx6q14.c Vivante driver]. If enabled the driver will scale the GPU frequency down by a specified divisor. By default this is 3/64 for the Gateworks Yocto and Android BSP's.
</p>
<p>
The GPU frequency scaling is triggered by the IMX thermal zone <strong>passive</strong> trip point (see <a class="wiki" href="/wiki/ventana/thermal#imx-thermal">above</a>). Note that because the temperature is triggered by the IMX thermal zone, the ARM cpu frequency will be reduced at the same time.
</p>
<p>
The minimum devisor used to reduce GPU frequency by default is 1 (meaning 1/64th frequency scaling which is the maximum amount of frequency reduction possible) you can use the drivers sysfs interface:
</p>
<ul><li>On Yocto v1.8 (3.14.x):
<pre class="wiki">echo 3 &gt; /sys/bus/platform/drivers/galcore/gpu3DMinClock # set GPU freq reduction to 3/64
</pre></li><li>On Yocto v1.6/v1.7 (3.10.17):
<pre class="wiki">echo 3 &gt; /sys/module/galcore/parameters/gpu3DMinClock # set GPU freq reduction to 3/64
</pre></li><li>On Linux 3.10.53 (Yocto master / Android kk)
<pre class="wiki">echo 3 &gt; /sys/bus/platform/drivers/galcore/gpu3DMinClock # set GPU freq reduction to 3/64
</pre></li></ul><p>
You can change this value from 1 to 64, where 1 is 1/64 frequency (maximum reduction) and 64 is no reduction. Note that depending on what the GPU is being used for, you may want to increase this value. We have found that a value of 3 for example offers adequate cooling without sacrificing significant performance.
</p>
}}}