cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

core.rst (3513B)


      1.. SPDX-License-Identifier: GPL-2.0
      2
      3.. include:: ../disclaimer-zh_TW.rst
      4
      5:Original: :doc:`../../../cpu-freq/core`
      6:Translator: Yanteng Si <siyanteng@loongson.cn>
      7             Hu Haowen <src.res@email.cn>
      8
      9.. _tw_core.rst:
     10
     11
     12====================================
     13CPUFreq核心和CPUFreq通知器的通用說明
     14====================================
     15
     16作者:
     17	- Dominik Brodowski  <linux@brodo.de>
     18	- David Kimdon <dwhedon@debian.org>
     19	- Rafael J. Wysocki <rafael.j.wysocki@intel.com>
     20	- Viresh Kumar <viresh.kumar@linaro.org>
     21
     22.. 目錄:
     23
     24   1.  CPUFreq核心和接口
     25   2.  CPUFreq通知器
     26   3.  含有Operating Performance Point (OPP)的CPUFreq表的生成
     27
     281. CPUFreq核心和接口
     29======================
     30
     31cpufreq核心代碼位於drivers/cpufreq/cpufreq.c中。這些cpufreq代碼爲CPUFreq架構的驅
     32動程序(那些操作硬體切換頻率的代碼)以及 "通知器 "提供了一個標準化的接口。
     33這些是設備驅動程序或需要了解策略變化的其它內核部分(如 ACPI 熱量管理)或所有頻率更改(除
     34計時代碼外),甚至需要強制確定速度限制的通知器(如 ARM 架構上的 LCD 驅動程序)。
     35此外, 內核 "常數" loops_per_jiffy會根據頻率變化而更新。
     36
     37cpufreq策略的引用計數由 cpufreq_cpu_get 和 cpufreq_cpu_put 來完成,以確保 cpufreq 驅
     38動程序被正確地註冊到核心中,並且驅動程序在 cpufreq_put_cpu 被調用之前不會被卸載。這也保證
     39了每個CPU核的cpufreq 策略在使用期間不會被釋放。
     40
     412. CPUFreq 通知器
     42====================
     43
     44CPUFreq通知器符合標準的內核通知器接口。
     45關於通知器的細節請參閱 linux/include/linux/notifier.h。
     46
     47這裡有兩個不同的CPUfreq通知器 - 策略通知器和轉換通知器。
     48
     49
     502.1 CPUFreq策略通知器
     51----------------------------
     52
     53當創建或移除策略時,這些都會被通知。
     54
     55階段是在通知器的第二個參數中指定的。當第一次創建策略時,階段是CPUFREQ_CREATE_POLICY,當
     56策略被移除時,階段是CPUFREQ_REMOVE_POLICY。
     57
     58第三個參數 ``void *pointer`` 指向一個結構體cpufreq_policy,其包括min,max(新策略的下限和
     59上限(單位爲kHz))這幾個值。
     60
     61
     622.2 CPUFreq轉換通知器
     63--------------------------------
     64
     65當CPUfreq驅動切換CPU核心頻率時,策略中的每個在線CPU都會收到兩次通知,這些變化沒有任何外部干
     66預。
     67
     68第二個參數指定階段 - CPUFREQ_PRECHANGE or CPUFREQ_POSTCHANGE.
     69
     70第三個參數是一個包含如下值的結構體cpufreq_freqs:
     71
     72=====	====================
     73cpu	受影響cpu的編號
     74old	舊頻率
     75new	新頻率
     76flags	cpufreq驅動的標誌
     77=====	====================
     78
     793. 含有Operating Performance Point (OPP)的CPUFreq表的生成
     80==================================================================
     81關於OPP的細節請參閱 Documentation/power/opp.rst
     82
     83dev_pm_opp_init_cpufreq_table -
     84	這個功能提供了一個隨時可用的轉換程序,用來將OPP層關於可用頻率的內部信息翻譯成一種容易提供給
     85	cpufreq的格式。
     86
     87	.. Warning::
     88
     89		不要在中斷上下文中使用此函數。
     90
     91	例如::
     92
     93	 soc_pm_init()
     94	 {
     95		/* Do things */
     96		r = dev_pm_opp_init_cpufreq_table(dev, &freq_table);
     97		if (!r)
     98			policy->freq_table = freq_table;
     99		/* Do other things */
    100	 }
    101
    102	.. note::
    103
    104		該函數只有在CONFIG_PM_OPP之外還啓用了CONFIG_CPU_FREQ時才可用。
    105
    106dev_pm_opp_free_cpufreq_table
    107	釋放dev_pm_opp_init_cpufreq_table分配的表。
    108