^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/class/devfreq/.../
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: September 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Provide a place in sysfs for the devfreq objects.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) This allows accessing various devfreq specific variables.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) The name of devfreq object denoted as ... is same as the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) name of device using devfreq.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) What: /sys/class/devfreq/.../name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Date: November 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Contact: Chanwoo Choi <cw00.choi@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) The /sys/class/devfreq/.../name shows the name of device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) of the corresponding devfreq object.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) What: /sys/class/devfreq/.../governor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Date: September 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) The /sys/class/devfreq/.../governor show or set the name of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) governor used by the corresponding devfreq object.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) What: /sys/class/devfreq/.../cur_freq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Date: September 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) The /sys/class/devfreq/.../cur_freq shows the current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) frequency of the corresponding devfreq object. Same as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) target_freq when get_cur_freq() is not implemented by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) devfreq driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) What: /sys/class/devfreq/.../target_freq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Date: September 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Contact: Rajagopal Venkat <rajagopal.venkat@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) The /sys/class/devfreq/.../target_freq shows the next governor
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) predicted target frequency of the corresponding devfreq object.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) What: /sys/class/devfreq/.../polling_interval
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Date: September 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) The /sys/class/devfreq/.../polling_interval shows and sets
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) the requested polling interval of the corresponding devfreq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) object. The values are represented in ms. If the value is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) less than 1 jiffy, it is considered to be 0, which means
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) no polling. This value is meaningless if the governor is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) not polling; thus. If the governor is not using
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) devfreq-provided central polling
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) (/sys/class/devfreq/.../central_polling is 0), this value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) may be useless.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) What: /sys/class/devfreq/.../trans_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) Date: October 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) This ABI shows or clears the statistics of devfreq behavior
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) on a specific device. It shows the time spent in each state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) and the number of transitions between states.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) In order to activate this ABI, the devfreq target device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) driver should provide the list of available frequencies
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) with its profile. If need to reset the statistics of devfreq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) behavior on a specific device, enter 0(zero) to 'trans_stat'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) as following::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) echo 0 > /sys/class/devfreq/.../trans_stat
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) What: /sys/class/devfreq/.../userspace/set_freq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) Date: September 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) The /sys/class/devfreq/.../userspace/set_freq shows and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) sets the requested frequency for the devfreq object if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) userspace governor is in effect.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) What: /sys/class/devfreq/.../available_frequencies
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Date: October 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) Contact: Nishanth Menon <nm@ti.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) The /sys/class/devfreq/.../available_frequencies shows
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) the available frequencies of the corresponding devfreq object.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) This is a snapshot of available frequencies and not limited
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) by the min/max frequency restrictions.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) What: /sys/class/devfreq/.../available_governors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) Date: October 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) Contact: Nishanth Menon <nm@ti.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) The /sys/class/devfreq/.../available_governors shows
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) currently available governors in the system.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) What: /sys/class/devfreq/.../min_freq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) Date: January 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) The /sys/class/devfreq/.../min_freq shows and stores
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) the minimum frequency requested by users. It is 0 if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) the user does not care. min_freq overrides the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) frequency requested by governors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) What: /sys/class/devfreq/.../max_freq
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) Date: January 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) Contact: MyungJoo Ham <myungjoo.ham@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) The /sys/class/devfreq/.../max_freq shows and stores
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) the maximum frequency requested by users. It is 0 if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) the user does not care. max_freq overrides the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) frequency requested by governors and min_freq.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) The max_freq overrides min_freq because max_freq may be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) used to throttle devices to avoid overheating.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) What: /sys/class/devfreq/.../timer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) Date: July 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) Contact: Chanwoo Choi <cw00.choi@samsung.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) This ABI shows and stores the kind of work timer by users.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) This work timer is used by devfreq workqueue in order to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) monitor the device status such as utilization. The user
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) can change the work timer on runtime according to their demand
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) as following::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) echo deferrable > /sys/class/devfreq/.../timer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) echo delayed > /sys/class/devfreq/.../timer