Documentation/arm/samsung-s3c24xx/cpufreq.rst

   1 .. SPDX-License-Identifier: GPL-2.0-only
   2
   3 =======================
   4 S3C24XX CPUfreq support
   5 =======================
   6
   7 Introduction
   8 ------------
   9
  10  The S3C24XX series support a number of power saving systems, such as
  11  the ability to change the core, memory and peripheral operating
  12  frequencies. The core control is exported via the CPUFreq driver
  13  which has a number of different manual or automatic controls over the
  14  rate the core is running at.
  15
  16  There are two forms of the driver depending on the specific CPU and
  17  how the clocks are arranged. The first implementation used as single
  18  PLL to feed the ARM, memory and peripherals via a series of dividers
  19  and muxes and this is the implementation that is documented here. A
  20  newer version where there is a separate PLL and clock divider for the
  21  ARM core is available as a separate driver.
  22
  23
  24 Layout
  25 ------
  26
  27  The code core manages the CPU specific drivers, any data that they
  28  need to register and the interface to the generic drivers/cpufreq
  29  system. Each CPU registers a driver to control the PLL, clock dividers
  30  and anything else associated with it. Any board that wants to use this
  31  framework needs to supply at least basic details of what is required.
  32
  33  The core registers with drivers/cpufreq at init time if all the data
  34  necessary has been supplied.
  35
  36
  37 CPU support
  38 -----------
  39
  40  The support for each CPU depends on the facilities provided by the
  41  SoC and the driver as each device has different PLL and clock chains
  42  associated with it.
  43
  44
  45 Slow Mode
  46 ---------
  47
  48  The SLOW mode where the PLL is turned off altogether and the
  49  system is fed by the external crystal input is currently not
  50  supported.
  51
  52
  53 sysfs
  54 -----
  55
  56  The core code exports extra information via sysfs in the directory
  57  devices/system/cpu/cpu0/arch-freq.
  58
  59
  60 Board Support
  61 -------------
  62
  63  Each board that wants to use the cpufreq code must register some basic
  64  information with the core driver to provide information about what the
  65  board requires and any restrictions being placed on it.
  66
  67  The board needs to supply information about whether it needs the IO bank
  68  timings changing, any maximum frequency limits and information about the
  69  SDRAM refresh rate.
  70
  71
  72
  73
  74 Document Author
  75 ---------------
  76
  77 Ben Dooks, Copyright 2009 Simtec Electronics