Zsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/cpu-freq/cpu-driversmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Simplified)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/zh_CN/cpu-freq/cpu-driversmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/it_IT/cpu-freq/cpu-driversmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ja_JP/cpu-freq/cpu-driversmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ko_KR/cpu-freq/cpu-driversmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/sp_SP/cpu-freq/cpu-driversmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Traditional)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhU/var/lib/git/docbuild/linux/Documentation/translations/zh_TW/cpu-freq/cpu-drivers.rsthKubhwarning)}(hX1此文件的目的是爲讓中文讀者更容易閱讀和理解，而不是作爲一個分支。因此， 如果您對此文件有任何意見或改動，請先嘗試更新原始英文文件。如果要更改或 修正某處翻譯文件，請將意見或補丁發送給維護者（聯繫方式見下）。h]h paragraph)}(hX1此文件的目的是爲讓中文讀者更容易閱讀和理解，而不是作爲一個分支。因此， 如果您對此文件有任何意見或改動，請先嘗試更新原始英文文件。如果要更改或 修正某處翻譯文件，請將意見或補丁發送給維護者（聯繫方式見下）。h]hX1此文件的目的是爲讓中文讀者更容易閱讀和理解，而不是作爲一個分支。因此， 如果您對此文件有任何意見或改動，請先嘗試更新原始英文文件。如果要更改或 修正某處翻譯文件，請將意見或補丁發送給維護者（聯繫方式見下）。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_TW/disclaimer-zh_TW.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubhnote)}(h如果您發現本文檔與原始文件有任何不同或者有翻譯問題，請聯繫該文件的譯者， 或者發送電子郵件給胡皓文以獲取幫助：<2023002089@link.tyut.edu.cn>。h]h)}(h如果您發現本文檔與原始文件有任何不同或者有翻譯問題，請聯繫該文件的譯者， 或者發送電子郵件給胡皓文以獲取幫助：<2023002089@link.tyut.edu.cn>。h](h如果您發現本文檔與原始文件有任何不同或者有翻譯問題，請聯繫該文件的譯者， 或者發送電子郵件給胡皓文以獲取幫助：<}(hhhhhNhNubh reference)}(h2023002089@link.tyut.edu.cnh]h2023002089@link.tyut.edu.cn}(hhhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:2023002089@link.tyut.edu.cnuh1hhhubh>。}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j hjhhhKubh field_body)}(h'Documentation/cpu-freq/cpu-drivers.rst h]h)}(h&Documentation/cpu-freq/cpu-drivers.rsth]h&Documentation/cpu-freq/cpu-drivers.rst}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(hhh](j )}(h翻譯h]h翻譯}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j hj;hhhKubj)}(h-司延騰 Yanteng Si h]h)}(h,司延騰 Yanteng Si h](h司延騰 Yanteng Si <}(hjPhhhNhNubh)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjXhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1hhjPubh>}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hjLubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(hhh](j )}(h校譯h]h校譯}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j hj~hhhKubj)}(h.唐藝舟 Tang Yizhou h]h)}(h-唐藝舟 Tang Yizhou h](h唐藝舟 Tang Yizhou <}(hjhhhNhNubh)}(htangyeechou@gmail.comh]htangyeechou@gmail.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tangyeechou@gmail.comuh1hhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhhhK hjhhubeh}(h]h ]h"]h$]h&]uh1jhhhhhhhKubhsection)}(hhh](htitle)}(h7如何實現一個新的CPUFreq處理器驅動程序？h]h7如何實現一個新的CPUFreq處理器驅動程序？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(h作者:h]h作者:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh block_quote)}(h- Dominik Brodowski - Rafael J. Wysocki - Viresh Kumar h]h bullet_list)}(hhh](h list_item)}(h#Dominik Brodowski h]h)}(hjh](hDominik Brodowski <}(hjhhhNhNubh)}(hlinux@brodo.deh]hlinux@brodo.de}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:linux@brodo.deuh1hhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h.Rafael J. Wysocki h]h)}(hj$h](hRafael J. Wysocki <}(hj&hhhNhNubh)}(hrafael.j.wysocki@intel.comh]hrafael.j.wysocki@intel.com}(hj-hhhNhNubah}(h]h ]h"]h$]h&]refuri!mailto:rafael.j.wysocki@intel.comuh1hhj&ubh>}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj"ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h'Viresh Kumar h]h)}(h&Viresh Kumar h](hViresh Kumar <}(hjQhhhNhNubh)}(hviresh.kumar@linaro.orgh]hviresh.kumar@linaro.org}(hjYhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:viresh.kumar@linaro.orguh1hhjQubh>}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjMubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(hContents 1. 怎麼做？ 1.1 初始化 1.2 Per-CPU 初始化 1.3 驗證 1.4 target/target_index 或 setpolicy? 1.5 target/target_index 1.6 setpolicy 1.7 get_intermediate 與 target_intermediate 2. 頻率表助手h]hContents 1. 怎麼做？ 1.1 初始化 1.2 Per-CPU 初始化 1.3 驗證 1.4 target/target_index 或 setpolicy? 1.5 target/target_index 1.6 setpolicy 1.7 get_intermediate 與 target_intermediate 2. 頻率表助手}hjsbah}(h]h ]h"]h$]h&]hhuh1hhjhhhhhK'ubj)}(hhh](j)}(h1. 怎麼做？h]h1. 怎麼做？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhK)ubh)}(h如果，你剛剛得到了一個全新的CPU/芯片組及其數據手冊，並希望爲這個CPU/芯片組添加cpufreq 支持？很好，這裏有一些至關重要的提示：h]h如果，你剛剛得到了一個全新的CPU/芯片組及其數據手冊，並希望爲這個CPU/芯片組添加cpufreq 支持？很好，這裏有一些至關重要的提示：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjhhubj)}(hhh](j)}(h 1.1 初始化h]h 1.1 初始化}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhK0ubh)}(h首先，在 __initcall level 7 (module_init())或更靠後的函數中檢查這個內核是否 運行在正確的CPU和正確的芯片組上。如果是，則使用cpufreq_register_driver()向 CPUfreq核心層註冊一個cpufreq_driver結構體。h]h首先，在 __initcall level 7 (module_init())或更靠後的函數中檢查這個內核是否 運行在正確的CPU和正確的芯片組上。如果是，則使用cpufreq_register_driver()向 CPUfreq核心層註冊一個cpufreq_driver結構體。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjhhubh)}(h0結構體cpufreq_driver應該包含什麼成員?h]h0結構體cpufreq_driver應該包含什麼成員?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubj)}(h.name - 驅動的名字。 .init - 一個指向per-policy初始化函數的指針。 .verify - 一個指向"verification"函數的指針。 .setpolicy 或 .fast_switch 或 .target 或 .target_index - 差異見 下文。 h](h)}(h.name - 驅動的名字。h]h.name - 驅動的名字。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjubh)}(h9.init - 一個指向per-policy初始化函數的指針。h]h9.init - 一個指向per-policy初始化函數的指針。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubh)}(h6.verify - 一個指向"verification"函數的指針。h]h:.verify - 一個指向”verification”函數的指針。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhK8hjhhubh)}(h其它可選成員h]h其它可選成員}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjhhubj)}(hX".flags - 給cpufreq核心的提示。 .driver_data - cpufreq驅動程序的特有數據。 .get_intermediate 和 target_intermediate - 用於在改變CPU頻率時切換到穩定 的頻率。 .get - 返回CPU的當前頻率。 .bios_limit - 返回HW/BIOS對CPU的最大頻率限制值。 .exit - 一個指向per-policy清理函數的指針，該函數在CPU熱插拔過程的CPU_POST_DEAD 階段被調用。 .suspend - 一個指向per-policy暫停函數的指針，該函數在關中斷且在該策略的調節器停止 後被調用。 .resume - 一個指向per-policy恢復函數的指針，該函數在關中斷且在調節器再一次啓動前被 調用。 .ready - 一個指向per-policy準備函數的指針，該函數在策略完全初始化之後被調用。 .attr - 一個指向NULL結尾的"struct freq_attr"列表的指針，該列表允許導出值到 sysfs。 .boost_enabled - 如果設置，則啓用提升(boost)頻率。 .set_boost - 一個指向per-policy函數的指針，該函數用來開啓/關閉提升(boost)頻率功能。 h](h)}(h%.flags - 給cpufreq核心的提示。h]h%.flags - 給cpufreq核心的提示。}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChj1ubh)}(h4.driver_data - cpufreq驅動程序的特有數據。h]h4.driver_data - cpufreq驅動程序的特有數據。}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhj1ubh)}(hc.get_intermediate 和 target_intermediate - 用於在改變CPU頻率時切換到穩定 的頻率。h]hc.get_intermediate 和 target_intermediate - 用於在改變CPU頻率時切換到穩定 的頻率。}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhj1ubh)}(h".get - 返回CPU的當前頻率。h]h".get - 返回CPU的當前頻率。}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhj1ubh)}(h<.bios_limit - 返回HW/BIOS對CPU的最大頻率限制值。h]h<.bios_limit - 返回HW/BIOS對CPU的最大頻率限制值。}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhj1ubh)}(hw.exit - 一個指向per-policy清理函數的指針，該函數在CPU熱插拔過程的CPU_POST_DEAD 階段被調用。h]hw.exit - 一個指向per-policy清理函數的指針，該函數在CPU熱插拔過程的CPU_POST_DEAD 階段被調用。}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhj1ubh)}(h.suspend - 一個指向per-policy暫停函數的指針，該函數在關中斷且在該策略的調節器停止 後被調用。h]h.suspend - 一個指向per-policy暫停函數的指針，該函數在關中斷且在該策略的調節器停止 後被調用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhj1ubh)}(h{.resume - 一個指向per-policy恢復函數的指針，該函數在關中斷且在調節器再一次啓動前被 調用。h]h{.resume - 一個指向per-policy恢復函數的指針，該函數在關中斷且在調節器再一次啓動前被 調用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThj1ubh)}(hj.ready - 一個指向per-policy準備函數的指針，該函數在策略完全初始化之後被調用。h]hj.ready - 一個指向per-policy準備函數的指針，該函數在策略完全初始化之後被調用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj1ubh)}(hi.attr - 一個指向NULL結尾的"struct freq_attr"列表的指針，該列表允許導出值到 sysfs。h]hm.attr - 一個指向NULL結尾的”struct freq_attr”列表的指針，該列表允許導出值到 sysfs。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhj1ubh)}(h?.boost_enabled - 如果設置，則啓用提升(boost)頻率。h]h?.boost_enabled - 如果設置，則啓用提升(boost)頻率。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hj1ubh)}(hm.set_boost - 一個指向per-policy函數的指針，該函數用來開啓/關閉提升(boost)頻率功能。h]hm.set_boost - 一個指向per-policy函數的指針，該函數用來開啓/關閉提升(boost)頻率功能。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hj1ubeh}(h]h ]h"]h$]h&]uh1jhhhKChjhhubeh}(h]id2ah ]h"] 1.1 初始化ah$]h&]uh1jhjhhhhhK0ubj)}(hhh](j)}(h1.2 Per-CPU 初始化h]h1.2 Per-CPU 初始化}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKbubh)}(hX每當一個新的CPU被註冊到設備模型中，或者當cpufreq驅動註冊自身之後，如果此CPU的cpufreq策 略不存在，則會調用per-policy的初始化函數cpufreq_driver.init。請注意，.init()和.exit()例程 只爲某個策略調用一次，而不是對該策略管理的每個CPU調用一次。它需要一個 ``struct cpufreq_policy *policy`` 作爲參數。現在該怎麼做呢？h](hXP每當一個新的CPU被註冊到設備模型中，或者當cpufreq驅動註冊自身之後，如果此CPU的cpufreq策 略不存在，則會調用per-policy的初始化函數cpufreq_driver.init。請注意，.init()和.exit()例程 只爲某個策略調用一次，而不是對該策略管理的每個CPU調用一次。它需要一個 }(hjhhhNhNubhliteral)}(h!``struct cpufreq_policy *policy``h]hstruct cpufreq_policy *policy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh( 作爲參數。現在該怎麼做呢？}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKdhjhhubh)}(h@如果有必要，請在你的CPU上激活CPUfreq功能支持。h]h@如果有必要，請在你的CPU上激活CPUfreq功能支持。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjhhubh)}(h+然後，驅動程序必須填寫以下值:h]h+然後，驅動程序必須填寫以下值:}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK#uh1jDhjAubjE)}(hhh]h}(h]h ]h"]h$]h&]colwidthK&uh1jDhjAubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h4policy->cpuinfo.min_freq和 policy->cpuinfo.max_freqh]h4policy->cpuinfo.min_freq和 policy->cpuinfo.max_freq}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjfubah}(h]h ]h"]h$]h&]uh1jdhjaubje)}(hhh]h)}(h-該CPU支持的最低和最高頻率（kHz）h]h-該CPU支持的最低和最高頻率（kHz）}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhj}ubah}(h]h ]h"]h$]h&]uh1jdhjaubeh}(h]h ]h"]h$]h&]uh1j_hj\ubj`)}(hhh](je)}(hhh]h)}(h"policy->cpuinfo.transition_latencyh]h"policy->cpuinfo.transition_latency}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jdhjubje)}(hhh]h)}(hqCPU在兩個頻率之間切換所需的時間，以 納秒爲單位（如不適用，設定爲 CPUFREQ_ETERNAL）h]hqCPU在兩個頻率之間切換所需的時間，以 納秒爲單位（如不適用，設定爲 CPUFREQ_ETERNAL）}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jdhjubeh}(h]h ]h"]h$]h&]uh1j_hj\ubj`)}(hhh](je)}(hhh]h)}(h policy->curh]h policy->cur}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubah}(h]h ]h"]h$]h&]uh1jdhjubje)}(hhh]h)}(h&該CPU當前的工作頻率(如適用)h]h&該CPU當前的工作頻率(如適用)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubah}(h]h ]h"]h$]h&]uh1jdhjubeh}(h]h ]h"]h$]h&]uh1j_hj\ubj`)}(hhh](je)}(hhh]h)}(hLpolicy->min, policy->max, policy->policy and, if necessary, policy->governorh]hLpolicy->min, policy->max, policy->policy and, if necessary, policy->governor}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhj ubah}(h]h ]h"]h$]h&]uh1jdhjubje)}(hhh]h)}(h必須包含該CPU的"默認策略"。稍後 會用這些值調用 cpufreq_driver.verify和下面函數 之一：cpufreq_driver.setpolicy或 cpufreq_driver.target/target_indexh]h必須包含該CPU的”默認策略”。稍後 會用這些值調用 cpufreq_driver.verify和下面函數 之一：cpufreq_driver.setpolicy或 cpufreq_driver.target/target_index}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhj"ubah}(h]h ]h"]h$]h&]uh1jdhjubeh}(h]h ]h"]h$]h&]uh1j_hj\ubj`)}(hhh](je)}(hhh]h)}(h policy->cpush]h policy->cpus}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjBubah}(h]h ]h"]h$]h&]uh1jdhj?ubje)}(hhh]h)}(h該policy通過DVFS框架影響的全部CPU (即與本CPU共享"時鐘/電壓"對)構成 掩碼(同時包含在線和離線CPU)，用掩碼 更新本字段h]h該policy通過DVFS框架影響的全部CPU (即與本CPU共享”時鐘/電壓”對)構成 掩碼(同時包含在線和離線CPU)，用掩碼 更新本字段}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjYubah}(h]h ]h"]h$]h&]uh1jdhj?ubeh}(h]h ]h"]h$]h&]uh1j_hj\ubeh}(h]h ]h"]h$]h&]uh1jZhjAubeh}(h]h ]h"]h$]h&]colsKuh1j?hj<ubah}(h]h ]h"]h$]h&]uh1j:hjhhhhhNubh)}(h對於設置其中的一些值(cpuinfo.min[max]_freq, policy->min[max])，頻率表輔助函數可能會有幫 助。關於它們的更多信息，請參見第2節。h]h對於設置其中的一些值(cpuinfo.min[max]_freq, policy->min[max])，頻率表輔助函數可能會有幫 助。關於它們的更多信息，請參見第2節。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]per-cpuah ]h"]1.2 per-cpu 初始化ah$]h&]uh1jhjhhhhhKbubj)}(hhh](j)}(h 1.3 驗證h]h 1.3 驗證}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hXz當用戶決定設置一個新的策略(由"policy,governor,min,max組成")時，必須對這個策略進行驗證， 以便糾正不兼容的值。爲了驗證這些值，cpufreq_verify_within_limits(``struct cpufreq_policy *policy``, ``unsigned int min_freq``, ``unsigned int max_freq``)函數可能會有幫助。 關於頻率表輔助函數的詳細內容請參見第2節。h](h當用戶決定設置一個新的策略(由”policy,governor,min,max組成”)時，必須對這個策略進行驗證， 以便糾正不兼容的值。爲了驗證這些值，cpufreq_verify_within_limits(}(hjhhhNhNubj)}(h!``struct cpufreq_policy *policy``h]hstruct cpufreq_policy *policy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }(hjhhhNhNubj)}(h``unsigned int min_freq``h]hunsigned int min_freq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, }hjsbj)}(h``unsigned int max_freq``h]hunsigned int max_freq}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhZ)函數可能會有幫助。 關於頻率表輔助函數的詳細內容請參見第2節。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h您需要確保至少有一個有效頻率（或工作範圍）在 policy->min 和 policy->max 範圍內。如果有必 要，先增大policy->max，只有在沒有解決方案的情況下，才減小policy->min。h]h您需要確保至少有一個有效頻率（或工作範圍）在 policy->min 和 policy->max 範圍內。如果有必 要，先增大policy->max，只有在沒有解決方案的情況下，才減小policy->min。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id3ah ]h"] 1.3 驗證ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h:1.4 target 或 target_index 或 setpolicy 或 fast_switch?h]h:1.4 target 或 target_index 或 setpolicy 或 fast_switch?}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj hhhhhKubh)}(h大多數cpufreq驅動甚至大多數CPU頻率升降算法只允許將CPU頻率設置爲預定義的固定值。對於這些，你 可以使用->target()，->target_index()或->fast_switch()回調。h]h大多數cpufreq驅動甚至大多數CPU頻率升降算法只允許將CPU頻率設置爲預定義的固定值。對於這些，你 可以使用->target()，->target_index()或->fast_switch()回調。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(h有些具有硬件調頻能力的處理器可以自行依據某些限制來切換CPU頻率。它們應使用->setpolicy()回調。h]h有些具有硬件調頻能力的處理器可以自行依據某些限制來切換CPU頻率。它們應使用->setpolicy()回調。}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h])target-target-index-setpolicy-fast-switchah ]h"]:1.4 target 或 target_index 或 setpolicy 或 fast_switch?ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h1.5. target/target_indexh]h1.5. target/target_index}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?hhhhhKubh)}(htarget_index調用有兩個參數： ``struct cpufreq_policy * policy`` 和 ``unsigned int`` 索引(用於索引頻率表項)。h](h%target_index調用有兩個參數： }(hjPhhhNhNubj)}(h"``struct cpufreq_policy * policy``h]hstruct cpufreq_policy * policy}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh 和 }(hjPhhhNhNubj)}(h``unsigned int``h]h unsigned int}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh$ 索引(用於索引頻率表項)。}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj?hhubh)}(hv當調用這裏時，CPUfreq驅動必須設置新的頻率。實際頻率必須由freq_table[index].frequency決定。h]hv當調用這裏時，CPUfreq驅動必須設置新的頻率。實際頻率必須由freq_table[index].frequency決定。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj?hhubh)}(h在發生錯誤的情況下總是應該恢復到之前的頻率(即policy->restore_freq)，即使我們已經切換到了 中間頻率。h]h在發生錯誤的情況下總是應該恢復到之前的頻率(即policy->restore_freq)，即使我們已經切換到了 中間頻率。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj?hhubeh}(h]target-target-indexah ]h"]1.5. target/target_indexah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h 已棄用h]h 已棄用}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hwtarget調用有三個參數。``struct cpufreq_policy * policy``, unsigned int target_frequency, unsigned int relation.h](htarget調用有三個參數。}(hjhhhNhNubj)}(h"``struct cpufreq_policy * policy``h]hstruct cpufreq_policy * policy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh7, unsigned int target_frequency, unsigned int relation.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hmCPUfreq驅動在調用這裏時必須設置新的頻率。實際的頻率必須使用以下規則來確定。h]hmCPUfreq驅動在調用這裏時必須設置新的頻率。實際的頻率必須使用以下規則來確定。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh](j)}(h儘量貼近"目標頻率"。h]h)}(hjh]h!儘量貼近”目標頻率”。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hApolicy->min <= new_freq <= policy->max (這必須是有效的!!!)h]h)}(hjh]hApolicy->min <= new_freq <= policy->max (這必須是有效的!!!)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h如果 relation==CPUFREQ_REL_L，嘗試選擇一個高於或等於 target_freq 的 new_freq。("L代表 最低，但不能低於")h]h)}(h如果 relation==CPUFREQ_REL_L，嘗試選擇一個高於或等於 target_freq 的 new_freq。("L代表 最低，但不能低於")h]h如果 relation==CPUFREQ_REL_L，嘗試選擇一個高於或等於 target_freq 的 new_freq。(“L代表 最低，但不能低於”)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h如果 relation==CPUFREQ_REL_H，嘗試選擇一個低於或等於 target_freq 的 new_freq。("H代表 最高，但不能高於") h]h)}(h如果 relation==CPUFREQ_REL_H，嘗試選擇一個低於或等於 target_freq 的 new_freq。("H代表 最高，但不能高於")h]h如果 relation==CPUFREQ_REL_H，嘗試選擇一個低於或等於 target_freq 的 new_freq。(“H代表 最高，但不能高於”)}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj.ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubh)}(hD這裏，頻率表輔助函數可能會幫助你 -- 詳見第2節。h]hD這裏，頻率表輔助函數可能會幫助你 -- 詳見第2節。}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id4ah ]h"] 已棄用ah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h1.6. fast_switchh]h1.6. fast_switch}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhjbhhhhhKubh)}(h這個函數用於從調度器的上下文進行頻率切換。並非所有的驅動都要實現它，因爲不允許在這個回調中睡眠。這 個回調必須經過高度優化，以儘可能快地進行切換。h]h這個函數用於從調度器的上下文進行頻率切換。並非所有的驅動都要實現它，因爲不允許在這個回調中睡眠。這 個回調必須經過高度優化，以儘可能快地進行切換。}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjbhhubh)}(hi這個函數有兩個參數： ``struct cpufreq_policy *policy`` 和 ``unsigned int target_frequency``。h](h這個函數有兩個參數： }(hjhhhNhNubj)}(h!``struct cpufreq_policy *policy``h]hstruct cpufreq_policy *policy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 和 }(hjhhhNhNubj)}(h!``unsigned int target_frequency``h]hunsigned int target_frequency}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjbhhubeh}(h] fast-switchah ]h"]1.6. fast_switchah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h 1.7 setpolicyh]h 1.7 setpolicy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hXsetpolicy調用只需要一個 ``struct cpufreq_policy * policy`` 作爲參數。需要將處理器內或芯片組內動態頻 率切換的下限設置爲policy->min，上限設置爲policy->max，如果支持的話，當policy->policy爲 CPUFREQ_POLICY_PERFORMANCE時選擇面向性能的設置，爲CPUFREQ_POLICY_POWERSAVE時選擇面向省電的設置。 也可以查看drivers/cpufreq/longrun.c中的參考實現。h](hsetpolicy調用只需要一個 }(hjhhhNhNubj)}(h"``struct cpufreq_policy * policy``h]hstruct cpufreq_policy * policy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhXc 作爲參數。需要將處理器內或芯片組內動態頻 率切換的下限設置爲policy->min，上限設置爲policy->max，如果支持的話，當policy->policy爲 CPUFREQ_POLICY_PERFORMANCE時選擇面向性能的設置，爲CPUFREQ_POLICY_POWERSAVE時選擇面向省電的設置。 也可以查看drivers/cpufreq/longrun.c中的參考實現。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] setpolicyah ]h"] 1.7 setpolicyah$]h&]uh1jhjhhhhhKubj)}(hhh](j)}(h,1.8 get_intermediate 和 target_intermediateh]h,1.8 get_intermediate 和 target_intermediate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hP僅適用於未設置 target_index() 和 CPUFREQ_ASYNC_NOTIFICATION 的驅動。h]hP僅適用於未設置 target_index() 和 CPUFREQ_ASYNC_NOTIFICATION 的驅動。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX!get_intermediate應該返回一個平臺想要切換到的穩定的中間頻率，target_intermediate()應該將CPU設置爲 該頻率，然後再跳轉到'index'對應的頻率。cpufreq核心會負責發送通知，驅動不必在 target_intermediate()或target_index()中處理它們。h]hX%get_intermediate應該返回一個平臺想要切換到的穩定的中間頻率，target_intermediate()應該將CPU設置爲 該頻率，然後再跳轉到’index’對應的頻率。cpufreq核心會負責發送通知，驅動不必在 target_intermediate()或target_index()中處理它們。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h在驅動程序不想爲某個目標頻率切換到中間頻率的情況下，它們可以讓get_intermediate()返回'0'。 在這種情況下，cpufreq核心將直接調用->target_index()。h]h在驅動程序不想爲某個目標頻率切換到中間頻率的情況下，它們可以讓get_intermediate()返回’0’。 在這種情況下，cpufreq核心將直接調用->target_index()。}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h注意：->target_index()應該在發生失敗的情況下將頻率恢復到policy->restore_freq， 因爲cpufreq核心會爲此發送通知。h]h注意：->target_index()應該在發生失敗的情況下將頻率恢復到policy->restore_freq， 因爲cpufreq核心會爲此發送通知。}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]$get-intermediate-target-intermediateah ]h"],1.8 get_intermediate 和 target_intermediateah$]h&]uh1jhjhhhhhKubeh}(h]id1ah ]h"]1. 怎麼做？ah$]h&]uh1jhjhhhhhK)ubj)}(hhh](j)}(h2. 頻率表輔助函數h]h2. 頻率表輔助函數}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjMhhhhhKubh)}(hX由於大多數支持cpufreq的處理器只允許被設置爲幾個特定的頻率，因此，"頻率表"和一些相關函數可能會輔助處理器驅動 程序的一些工作。這樣的"頻率表"是一個由struct cpufreq_frequency_table的條目構成的數組，"driver_data"成員包 含驅動程序的專用值，"frequency"成員包含了相應的頻率，此外還有標誌成員。在表的最後，需要添加一個 cpufreq_frequency_table條目，頻率設置爲CPUFREQ_TABLE_END。如果想跳過表中的一個條目，則將頻率設置爲 CPUFREQ_ENTRY_INVALID。這些條目不需要按照任何特定的順序排序，如果排序了，cpufreq核心執行DVFS會更快一點， 因爲搜索最佳匹配會更快。h]hX由於大多數支持cpufreq的處理器只允許被設置爲幾個特定的頻率，因此，”頻率表”和一些相關函數可能會輔助處理器驅動 程序的一些工作。這樣的”頻率表”是一個由struct cpufreq_frequency_table的條目構成的數組，”driver_data”成員包 含驅動程序的專用值，”frequency”成員包含了相應的頻率，此外還有標誌成員。在表的最後，需要添加一個 cpufreq_frequency_table條目，頻率設置爲CPUFREQ_TABLE_END。如果想跳過表中的一個條目，則將頻率設置爲 CPUFREQ_ENTRY_INVALID。這些條目不需要按照任何特定的順序排序，如果排序了，cpufreq核心執行DVFS會更快一點， 因爲搜索最佳匹配會更快。}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(hy如果在policy->freq_table字段中包含一個有效的頻率表指針，頻率表就會被cpufreq核心自動驗證。h]hy如果在policy->freq_table字段中包含一個有效的頻率表指針，頻率表就會被cpufreq核心自動驗證。}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(hcpufreq_frequency_table_verify()保證至少有一個有效的頻率在policy->min和policy->max範圍內，並且所有其他 準則都被滿足。這對->verify調用很有幫助。h]hcpufreq_frequency_table_verify()保證至少有一個有效的頻率在policy->min和policy->max範圍內，並且所有其他 準則都被滿足。這對->verify調用很有幫助。}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(hcpufreq_frequency_table_target()是對應於->target階段的頻率表輔助函數。只要把值傳遞給這個函數，這個函數就會返 回包含CPU要設置的頻率的頻率表條目。h]hcpufreq_frequency_table_target()是對應於->target階段的頻率表輔助函數。只要把值傳遞給這個函數，這個函數就會返 回包含CPU要設置的頻率的頻率表條目。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(h;以下宏可以作爲cpufreq_frequency_table的迭代器。h]h;以下宏可以作爲cpufreq_frequency_table的迭代器。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(hFcpufreq_for_each_entry(pos, table) - 遍歷頻率表的所有條目。h]hFcpufreq_for_each_entry(pos, table) - 遍歷頻率表的所有條目。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(hXcpufreq_for_each_valid_entry(pos, table) - 該函數遍歷所有條目，不包括CPUFREQ_ENTRY_INVALID頻率。 使用參數"pos" -- 一個 ``cpufreq_frequency_table *`` 作爲循環指針，使用參數"table" -- 作爲你想迭代 的 ``cpufreq_frequency_table *`` 。h](hcpufreq_for_each_valid_entry(pos, table) - 該函數遍歷所有條目，不包括CPUFREQ_ENTRY_INVALID頻率。 使用參數”pos” -- 一個 }(hjhhhNhNubj)}(h``cpufreq_frequency_table *``h]hcpufreq_frequency_table *}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhH 作爲循環指針，使用參數”table” -- 作爲你想迭代 的 }(hjhhhNhNubj)}(h``cpufreq_frequency_table *``h]hcpufreq_frequency_table *}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh)}(h例如::h]h例如:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMhhubh literal_block)}(hstruct cpufreq_frequency_table *pos, *driver_freq_table; cpufreq_for_each_entry(pos, driver_freq_table) { /* Do something with pos */ pos->frequency = ... }h]hstruct cpufreq_frequency_table *pos, *driver_freq_table; cpufreq_for_each_entry(pos, driver_freq_table) { /* Do something with pos */ pos->frequency = ... }}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjMhhubh)}(h如果你需要在driver_freq_table中處理pos的位置，不要做指針減法，因爲它的代價相當高。作爲替代，使用宏 cpufreq_for_each_entry_idx() 和 cpufreq_for_each_valid_entry_idx() 。h]h如果你需要在driver_freq_table中處理pos的位置，不要做指針減法，因爲它的代價相當高。作爲替代，使用宏 cpufreq_for_each_entry_idx() 和 cpufreq_for_each_valid_entry_idx() 。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjMhhubeh}(h]id5ah ]h"]2. 頻率表輔助函數ah$]h&]uh1jhjhhhhhKubeh}(h]cpufreqah ]h"]7如何實現一個新的cpufreq處理器驅動程序？ah$]h&]uh1jhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jN generatorN datestampN source_linkN source_urlN toc_backlinksjdfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjB error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j j jJjGjjjjjjj<j9jjj_j\jjjjjBj?j j u nametypes}(j jJjjjj<jj_jjjBj uh}(j jjGjjjjjjjj9j jj?j\jjjbjjj?jj jMu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jP KsRparse_messages]transform_messages] transformerN include_log]9Documentation/translations/zh_TW/cpu-freq/cpu-drivers.rst(NNNNta decorationNhhub.