Lines Matching full:policy
82 static unsigned int __cpufreq_get(struct cpufreq_policy *policy);
83 static int cpufreq_init_governor(struct cpufreq_policy *policy);
84 static void cpufreq_exit_governor(struct cpufreq_policy *policy);
85 static void cpufreq_governor_limits(struct cpufreq_policy *policy);
86 static int cpufreq_set_policy(struct cpufreq_policy *policy,
92 * Two notifier lists: the "policy" list is involved in the
93 * validation process for a new CPU frequency policy; the
120 struct kobject *get_governor_parent_kobj(struct cpufreq_policy *policy) in get_governor_parent_kobj() argument
123 return &policy->kobj; in get_governor_parent_kobj()
172 * - policy->cpus with all possible CPUs
174 void cpufreq_generic_init(struct cpufreq_policy *policy, in cpufreq_generic_init() argument
178 policy->freq_table = table; in cpufreq_generic_init()
179 policy->cpuinfo.transition_latency = transition_latency; in cpufreq_generic_init()
185 cpumask_setall(policy->cpus); in cpufreq_generic_init()
191 struct cpufreq_policy *policy = per_cpu(cpufreq_cpu_data, cpu); in cpufreq_cpu_get_raw() local
193 return policy && cpumask_test_cpu(cpu, policy->cpus) ? policy : NULL; in cpufreq_cpu_get_raw()
199 struct cpufreq_policy *policy = cpufreq_cpu_get_raw(cpu); in cpufreq_generic_get() local
201 if (!policy || IS_ERR(policy->clk)) { in cpufreq_generic_get()
203 __func__, policy ? "clk" : "policy", cpu); in cpufreq_generic_get()
207 return clk_get_rate(policy->clk) / 1000; in cpufreq_generic_get()
212 * cpufreq_cpu_get - Return policy for a CPU and mark it as busy.
213 * @cpu: CPU to find the policy for.
215 * Call cpufreq_cpu_get_raw() to obtain a cpufreq policy for @cpu and increment
216 * the kobject reference counter of that policy. Return a valid policy on
219 * The policy returned by this function has to be released with the help of
224 struct cpufreq_policy *policy = NULL; in cpufreq_cpu_get() local
235 policy = cpufreq_cpu_get_raw(cpu); in cpufreq_cpu_get()
236 if (policy) in cpufreq_cpu_get()
237 kobject_get(&policy->kobj); in cpufreq_cpu_get()
242 return policy; in cpufreq_cpu_get()
247 * cpufreq_cpu_put - Decrement kobject usage counter for cpufreq policy.
248 * @policy: cpufreq policy returned by cpufreq_cpu_get().
250 void cpufreq_cpu_put(struct cpufreq_policy *policy) in cpufreq_cpu_put() argument
252 kobject_put(&policy->kobj); in cpufreq_cpu_put()
257 * cpufreq_cpu_release - Unlock a policy and decrement its usage counter.
258 * @policy: cpufreq policy returned by cpufreq_cpu_acquire().
260 void cpufreq_cpu_release(struct cpufreq_policy *policy) in cpufreq_cpu_release() argument
262 if (WARN_ON(!policy)) in cpufreq_cpu_release()
265 lockdep_assert_held(&policy->rwsem); in cpufreq_cpu_release()
267 up_write(&policy->rwsem); in cpufreq_cpu_release()
269 cpufreq_cpu_put(policy); in cpufreq_cpu_release()
273 * cpufreq_cpu_acquire - Find policy for a CPU, mark it as busy and lock it.
274 * @cpu: CPU to find the policy for.
276 * Call cpufreq_cpu_get() to get a reference on the cpufreq policy for @cpu and
277 * if the policy returned by it is not NULL, acquire its rwsem for writing.
278 * Return the policy if it is active or release it and return NULL otherwise.
280 * The policy returned by this function has to be released with the help of
286 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); in cpufreq_cpu_acquire() local
288 if (!policy) in cpufreq_cpu_acquire()
291 down_write(&policy->rwsem); in cpufreq_cpu_acquire()
293 if (policy_is_inactive(policy)) { in cpufreq_cpu_acquire()
294 cpufreq_cpu_release(policy); in cpufreq_cpu_acquire()
298 return policy; in cpufreq_cpu_acquire()
341 * @policy: cpufreq policy to enable fast frequency switching for.
349 static void cpufreq_notify_transition(struct cpufreq_policy *policy, in cpufreq_notify_transition() argument
360 freqs->policy = policy; in cpufreq_notify_transition()
372 if (policy->cur && policy->cur != freqs->old) { in cpufreq_notify_transition()
374 freqs->old, policy->cur); in cpufreq_notify_transition()
375 freqs->old = policy->cur; in cpufreq_notify_transition()
387 cpumask_pr_args(policy->cpus)); in cpufreq_notify_transition()
389 for_each_cpu(cpu, policy->cpus) in cpufreq_notify_transition()
395 cpufreq_stats_record_transition(policy, freqs->new); in cpufreq_notify_transition()
396 policy->cur = freqs->new; in cpufreq_notify_transition()
401 static void cpufreq_notify_post_transition(struct cpufreq_policy *policy, in cpufreq_notify_post_transition() argument
404 cpufreq_notify_transition(policy, freqs, CPUFREQ_POSTCHANGE); in cpufreq_notify_post_transition()
409 cpufreq_notify_transition(policy, freqs, CPUFREQ_PRECHANGE); in cpufreq_notify_post_transition()
410 cpufreq_notify_transition(policy, freqs, CPUFREQ_POSTCHANGE); in cpufreq_notify_post_transition()
413 void cpufreq_freq_transition_begin(struct cpufreq_policy *policy, in cpufreq_freq_transition_begin() argument
426 && current == policy->transition_task); in cpufreq_freq_transition_begin()
429 wait_event(policy->transition_wait, !policy->transition_ongoing); in cpufreq_freq_transition_begin()
431 spin_lock(&policy->transition_lock); in cpufreq_freq_transition_begin()
433 if (unlikely(policy->transition_ongoing)) { in cpufreq_freq_transition_begin()
434 spin_unlock(&policy->transition_lock); in cpufreq_freq_transition_begin()
438 policy->transition_ongoing = true; in cpufreq_freq_transition_begin()
439 policy->transition_task = current; in cpufreq_freq_transition_begin()
441 spin_unlock(&policy->transition_lock); in cpufreq_freq_transition_begin()
443 cpufreq_notify_transition(policy, freqs, CPUFREQ_PRECHANGE); in cpufreq_freq_transition_begin()
447 void cpufreq_freq_transition_end(struct cpufreq_policy *policy, in cpufreq_freq_transition_end() argument
450 if (WARN_ON(!policy->transition_ongoing)) in cpufreq_freq_transition_end()
453 cpufreq_notify_post_transition(policy, freqs, transition_failed); in cpufreq_freq_transition_end()
455 arch_set_freq_scale(policy->related_cpus, in cpufreq_freq_transition_end()
456 policy->cur, in cpufreq_freq_transition_end()
457 arch_scale_freq_ref(policy->cpu)); in cpufreq_freq_transition_end()
459 spin_lock(&policy->transition_lock); in cpufreq_freq_transition_end()
460 policy->transition_ongoing = false; in cpufreq_freq_transition_end()
461 policy->transition_task = NULL; in cpufreq_freq_transition_end()
462 spin_unlock(&policy->transition_lock); in cpufreq_freq_transition_end()
464 wake_up(&policy->transition_wait); in cpufreq_freq_transition_end()
490 * cpufreq_enable_fast_switch - Enable fast frequency switching for policy.
491 * @policy: cpufreq policy to enable fast frequency switching for.
493 * Try to enable fast frequency switching for @policy.
500 void cpufreq_enable_fast_switch(struct cpufreq_policy *policy) in cpufreq_enable_fast_switch() argument
502 lockdep_assert_held(&policy->rwsem); in cpufreq_enable_fast_switch()
504 if (!policy->fast_switch_possible) in cpufreq_enable_fast_switch()
510 policy->fast_switch_enabled = true; in cpufreq_enable_fast_switch()
513 policy->cpu); in cpufreq_enable_fast_switch()
521 * cpufreq_disable_fast_switch - Disable fast frequency switching for policy.
522 * @policy: cpufreq policy to disable fast frequency switching for.
524 void cpufreq_disable_fast_switch(struct cpufreq_policy *policy) in cpufreq_disable_fast_switch() argument
527 if (policy->fast_switch_enabled) { in cpufreq_disable_fast_switch()
528 policy->fast_switch_enabled = false; in cpufreq_disable_fast_switch()
536 static unsigned int __resolve_freq(struct cpufreq_policy *policy, in __resolve_freq() argument
541 target_freq = clamp_val(target_freq, policy->min, policy->max); in __resolve_freq()
543 if (!policy->freq_table) in __resolve_freq()
546 idx = cpufreq_frequency_table_target(policy, target_freq, relation); in __resolve_freq()
547 policy->cached_resolved_idx = idx; in __resolve_freq()
548 policy->cached_target_freq = target_freq; in __resolve_freq()
549 return policy->freq_table[idx].frequency; in __resolve_freq()
555 * @policy: associated policy to interrogate
558 * The target to driver frequency mapping is cached in the policy.
561 * given target_freq, subject to policy (min/max) and driver limitations.
563 unsigned int cpufreq_driver_resolve_freq(struct cpufreq_policy *policy, in cpufreq_driver_resolve_freq() argument
566 return __resolve_freq(policy, target_freq, CPUFREQ_RELATION_LE); in cpufreq_driver_resolve_freq()
570 unsigned int cpufreq_policy_transition_delay_us(struct cpufreq_policy *policy) in cpufreq_policy_transition_delay_us() argument
574 if (policy->transition_delay_us) in cpufreq_policy_transition_delay_us()
575 return policy->transition_delay_us; in cpufreq_policy_transition_delay_us()
577 latency = policy->cpuinfo.transition_latency / NSEC_PER_USEC; in cpufreq_policy_transition_delay_us()
627 static ssize_t show_local_boost(struct cpufreq_policy *policy, char *buf) in show_local_boost() argument
629 return sysfs_emit(buf, "%d\n", policy->boost_enabled); in show_local_boost()
632 static ssize_t store_local_boost(struct cpufreq_policy *policy, in store_local_boost() argument
644 if (policy->boost_enabled == enable) in store_local_boost()
648 ret = cpufreq_driver->set_boost(policy, enable); in store_local_boost()
654 policy->boost_enabled = enable; in store_local_boost()
723 * Write out information from cpufreq_driver->policy[cpu]; object must be
729 (struct cpufreq_policy *policy, char *buf) \
731 return sprintf(buf, "%u\n", policy->object); \
745 static ssize_t show_scaling_cur_freq(struct cpufreq_policy *policy, char *buf) in show_scaling_cur_freq() argument
750 freq = arch_freq_get_on_cpu(policy->cpu); in show_scaling_cur_freq()
754 ret = sprintf(buf, "%u\n", cpufreq_driver->get(policy->cpu)); in show_scaling_cur_freq()
756 ret = sprintf(buf, "%u\n", policy->cur); in show_scaling_cur_freq()
765 (struct cpufreq_policy *policy, const char *buf, size_t count) \
774 ret = freq_qos_update_request(policy->object##_freq_req, val);\
784 static ssize_t show_cpuinfo_cur_freq(struct cpufreq_policy *policy, in show_cpuinfo_cur_freq() argument
787 unsigned int cur_freq = __cpufreq_get(policy); in show_cpuinfo_cur_freq()
796 * show_scaling_governor - show the current policy for the specified CPU
798 static ssize_t show_scaling_governor(struct cpufreq_policy *policy, char *buf) in show_scaling_governor() argument
800 if (policy->policy == CPUFREQ_POLICY_POWERSAVE) in show_scaling_governor()
802 else if (policy->policy == CPUFREQ_POLICY_PERFORMANCE) in show_scaling_governor()
804 else if (policy->governor) in show_scaling_governor()
806 policy->governor->name); in show_scaling_governor()
811 * store_scaling_governor - store policy for the specified CPU
813 static ssize_t store_scaling_governor(struct cpufreq_policy *policy, in store_scaling_governor() argument
830 ret = cpufreq_set_policy(policy, NULL, new_pol); in store_scaling_governor()
838 ret = cpufreq_set_policy(policy, new_gov, in store_scaling_governor()
850 static ssize_t show_scaling_driver(struct cpufreq_policy *policy, char *buf) in show_scaling_driver() argument
858 static ssize_t show_scaling_available_governors(struct cpufreq_policy *policy, in show_scaling_available_governors() argument
905 static ssize_t show_related_cpus(struct cpufreq_policy *policy, char *buf) in show_related_cpus() argument
907 return cpufreq_show_cpus(policy->related_cpus, buf); in show_related_cpus()
913 static ssize_t show_affected_cpus(struct cpufreq_policy *policy, char *buf) in show_affected_cpus() argument
915 return cpufreq_show_cpus(policy->cpus, buf); in show_affected_cpus()
918 static ssize_t store_scaling_setspeed(struct cpufreq_policy *policy, in store_scaling_setspeed() argument
924 if (!policy->governor || !policy->governor->store_setspeed) in store_scaling_setspeed()
931 policy->governor->store_setspeed(policy, freq); in store_scaling_setspeed()
936 static ssize_t show_scaling_setspeed(struct cpufreq_policy *policy, char *buf) in show_scaling_setspeed() argument
938 if (!policy->governor || !policy->governor->show_setspeed) in show_scaling_setspeed()
941 return policy->governor->show_setspeed(policy, buf); in show_scaling_setspeed()
947 static ssize_t show_bios_limit(struct cpufreq_policy *policy, char *buf) in show_bios_limit() argument
951 ret = cpufreq_driver->bios_limit(policy->cpu, &limit); in show_bios_limit()
954 return sprintf(buf, "%u\n", policy->cpuinfo.max_freq); in show_bios_limit()
993 struct cpufreq_policy *policy = to_policy(kobj); in show() local
1000 down_read(&policy->rwsem); in show()
1001 if (likely(!policy_is_inactive(policy))) in show()
1002 ret = fattr->show(policy, buf); in show()
1003 up_read(&policy->rwsem); in show()
1011 struct cpufreq_policy *policy = to_policy(kobj); in store() local
1018 down_write(&policy->rwsem); in store()
1019 if (likely(!policy_is_inactive(policy))) in store()
1020 ret = fattr->store(policy, buf, count); in store()
1021 up_write(&policy->rwsem); in store()
1028 struct cpufreq_policy *policy = to_policy(kobj); in cpufreq_sysfs_release() local
1030 complete(&policy->kobj_unregister); in cpufreq_sysfs_release()
1044 static void add_cpu_dev_symlink(struct cpufreq_policy *policy, unsigned int cpu, in add_cpu_dev_symlink() argument
1050 if (cpumask_test_and_set_cpu(cpu, policy->real_cpus)) in add_cpu_dev_symlink()
1054 if (sysfs_create_link(&dev->kobj, &policy->kobj, "cpufreq")) in add_cpu_dev_symlink()
1058 static void remove_cpu_dev_symlink(struct cpufreq_policy *policy, int cpu, in remove_cpu_dev_symlink() argument
1063 cpumask_clear_cpu(cpu, policy->real_cpus); in remove_cpu_dev_symlink()
1066 static int cpufreq_add_dev_interface(struct cpufreq_policy *policy) in cpufreq_add_dev_interface() argument
1074 ret = sysfs_create_file(&policy->kobj, &((*drv_attr)->attr)); in cpufreq_add_dev_interface()
1080 ret = sysfs_create_file(&policy->kobj, &cpuinfo_cur_freq.attr); in cpufreq_add_dev_interface()
1085 ret = sysfs_create_file(&policy->kobj, &scaling_cur_freq.attr); in cpufreq_add_dev_interface()
1090 ret = sysfs_create_file(&policy->kobj, &bios_limit.attr); in cpufreq_add_dev_interface()
1096 ret = sysfs_create_file(&policy->kobj, &local_boost.attr); in cpufreq_add_dev_interface()
1104 static int cpufreq_init_policy(struct cpufreq_policy *policy) in cpufreq_init_policy() argument
1111 /* Update policy governor to the one used before hotplug. */ in cpufreq_init_policy()
1112 gov = get_governor(policy->last_governor); in cpufreq_init_policy()
1115 gov->name, policy->cpu); in cpufreq_init_policy()
1127 /* Use the default policy if there is no last_policy. */ in cpufreq_init_policy()
1128 if (policy->last_policy) { in cpufreq_init_policy()
1129 pol = policy->last_policy; in cpufreq_init_policy()
1134 * nor "powersave", fall back to the initial policy in cpufreq_init_policy()
1138 pol = policy->policy; in cpufreq_init_policy()
1145 ret = cpufreq_set_policy(policy, gov, pol); in cpufreq_init_policy()
1152 static int cpufreq_add_policy_cpu(struct cpufreq_policy *policy, unsigned int cpu) in cpufreq_add_policy_cpu() argument
1157 if (cpumask_test_cpu(cpu, policy->cpus)) in cpufreq_add_policy_cpu()
1160 down_write(&policy->rwsem); in cpufreq_add_policy_cpu()
1162 cpufreq_stop_governor(policy); in cpufreq_add_policy_cpu()
1164 cpumask_set_cpu(cpu, policy->cpus); in cpufreq_add_policy_cpu()
1167 ret = cpufreq_start_governor(policy); in cpufreq_add_policy_cpu()
1171 up_write(&policy->rwsem); in cpufreq_add_policy_cpu()
1175 void refresh_frequency_limits(struct cpufreq_policy *policy) in refresh_frequency_limits() argument
1177 if (!policy_is_inactive(policy)) { in refresh_frequency_limits()
1178 pr_debug("updating policy for CPU %u\n", policy->cpu); in refresh_frequency_limits()
1180 cpufreq_set_policy(policy, policy->governor, policy->policy); in refresh_frequency_limits()
1187 struct cpufreq_policy *policy = in handle_update() local
1190 pr_debug("handle_update for cpu %u called\n", policy->cpu); in handle_update()
1191 down_write(&policy->rwsem); in handle_update()
1192 refresh_frequency_limits(policy); in handle_update()
1193 up_write(&policy->rwsem); in handle_update()
1199 struct cpufreq_policy *policy = container_of(nb, struct cpufreq_policy, nb_min); in cpufreq_notifier_min() local
1201 schedule_work(&policy->update); in cpufreq_notifier_min()
1208 struct cpufreq_policy *policy = container_of(nb, struct cpufreq_policy, nb_max); in cpufreq_notifier_max() local
1210 schedule_work(&policy->update); in cpufreq_notifier_max()
1214 static void cpufreq_policy_put_kobj(struct cpufreq_policy *policy) in cpufreq_policy_put_kobj() argument
1219 down_write(&policy->rwsem); in cpufreq_policy_put_kobj()
1220 cpufreq_stats_free_table(policy); in cpufreq_policy_put_kobj()
1221 kobj = &policy->kobj; in cpufreq_policy_put_kobj()
1222 cmp = &policy->kobj_unregister; in cpufreq_policy_put_kobj()
1223 up_write(&policy->rwsem); in cpufreq_policy_put_kobj()
1238 struct cpufreq_policy *policy; in cpufreq_policy_alloc() local
1245 policy = kzalloc(sizeof(*policy), GFP_KERNEL); in cpufreq_policy_alloc()
1246 if (!policy) in cpufreq_policy_alloc()
1249 if (!alloc_cpumask_var(&policy->cpus, GFP_KERNEL)) in cpufreq_policy_alloc()
1252 if (!zalloc_cpumask_var(&policy->related_cpus, GFP_KERNEL)) in cpufreq_policy_alloc()
1255 if (!zalloc_cpumask_var(&policy->real_cpus, GFP_KERNEL)) in cpufreq_policy_alloc()
1258 init_completion(&policy->kobj_unregister); in cpufreq_policy_alloc()
1259 ret = kobject_init_and_add(&policy->kobj, &ktype_cpufreq, in cpufreq_policy_alloc()
1260 cpufreq_global_kobject, "policy%u", cpu); in cpufreq_policy_alloc()
1262 dev_err(dev, "%s: failed to init policy->kobj: %d\n", __func__, ret); in cpufreq_policy_alloc()
1264 * The entire policy object will be freed below, but the extra in cpufreq_policy_alloc()
1268 kobject_put(&policy->kobj); in cpufreq_policy_alloc()
1272 freq_constraints_init(&policy->constraints); in cpufreq_policy_alloc()
1274 policy->nb_min.notifier_call = cpufreq_notifier_min; in cpufreq_policy_alloc()
1275 policy->nb_max.notifier_call = cpufreq_notifier_max; in cpufreq_policy_alloc()
1277 ret = freq_qos_add_notifier(&policy->constraints, FREQ_QOS_MIN, in cpufreq_policy_alloc()
1278 &policy->nb_min); in cpufreq_policy_alloc()
1285 ret = freq_qos_add_notifier(&policy->constraints, FREQ_QOS_MAX, in cpufreq_policy_alloc()
1286 &policy->nb_max); in cpufreq_policy_alloc()
1293 INIT_LIST_HEAD(&policy->policy_list); in cpufreq_policy_alloc()
1294 init_rwsem(&policy->rwsem); in cpufreq_policy_alloc()
1295 spin_lock_init(&policy->transition_lock); in cpufreq_policy_alloc()
1296 init_waitqueue_head(&policy->transition_wait); in cpufreq_policy_alloc()
1297 INIT_WORK(&policy->update, handle_update); in cpufreq_policy_alloc()
1299 policy->cpu = cpu; in cpufreq_policy_alloc()
1300 return policy; in cpufreq_policy_alloc()
1303 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MIN, in cpufreq_policy_alloc()
1304 &policy->nb_min); in cpufreq_policy_alloc()
1306 cpufreq_policy_put_kobj(policy); in cpufreq_policy_alloc()
1308 free_cpumask_var(policy->real_cpus); in cpufreq_policy_alloc()
1310 free_cpumask_var(policy->related_cpus); in cpufreq_policy_alloc()
1312 free_cpumask_var(policy->cpus); in cpufreq_policy_alloc()
1314 kfree(policy); in cpufreq_policy_alloc()
1319 static void cpufreq_policy_free(struct cpufreq_policy *policy) in cpufreq_policy_free() argument
1325 * The callers must ensure the policy is inactive by now, to avoid any in cpufreq_policy_free()
1328 if (unlikely(!policy_is_inactive(policy))) in cpufreq_policy_free()
1329 pr_warn("%s: Freeing active policy\n", __func__); in cpufreq_policy_free()
1331 /* Remove policy from list */ in cpufreq_policy_free()
1333 list_del(&policy->policy_list); in cpufreq_policy_free()
1335 for_each_cpu(cpu, policy->related_cpus) in cpufreq_policy_free()
1339 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MAX, in cpufreq_policy_free()
1340 &policy->nb_max); in cpufreq_policy_free()
1341 freq_qos_remove_notifier(&policy->constraints, FREQ_QOS_MIN, in cpufreq_policy_free()
1342 &policy->nb_min); in cpufreq_policy_free()
1344 /* Cancel any pending policy->update work before freeing the policy. */ in cpufreq_policy_free()
1345 cancel_work_sync(&policy->update); in cpufreq_policy_free()
1347 if (policy->max_freq_req) { in cpufreq_policy_free()
1354 CPUFREQ_REMOVE_POLICY, policy); in cpufreq_policy_free()
1355 freq_qos_remove_request(policy->max_freq_req); in cpufreq_policy_free()
1358 freq_qos_remove_request(policy->min_freq_req); in cpufreq_policy_free()
1359 kfree(policy->min_freq_req); in cpufreq_policy_free()
1361 cpufreq_policy_put_kobj(policy); in cpufreq_policy_free()
1362 free_cpumask_var(policy->real_cpus); in cpufreq_policy_free()
1363 free_cpumask_var(policy->related_cpus); in cpufreq_policy_free()
1364 free_cpumask_var(policy->cpus); in cpufreq_policy_free()
1365 kfree(policy); in cpufreq_policy_free()
1370 struct cpufreq_policy *policy; in cpufreq_online() local
1378 /* Check if this CPU already has a policy to manage it */ in cpufreq_online()
1379 policy = per_cpu(cpufreq_cpu_data, cpu); in cpufreq_online()
1380 if (policy) { in cpufreq_online()
1381 WARN_ON(!cpumask_test_cpu(cpu, policy->related_cpus)); in cpufreq_online()
1382 if (!policy_is_inactive(policy)) in cpufreq_online()
1383 return cpufreq_add_policy_cpu(policy, cpu); in cpufreq_online()
1385 /* This is the only online CPU for the policy. Start over. */ in cpufreq_online()
1387 down_write(&policy->rwsem); in cpufreq_online()
1388 policy->cpu = cpu; in cpufreq_online()
1389 policy->governor = NULL; in cpufreq_online()
1392 policy = cpufreq_policy_alloc(cpu); in cpufreq_online()
1393 if (!policy) in cpufreq_online()
1395 down_write(&policy->rwsem); in cpufreq_online()
1399 /* Recover policy->cpus using related_cpus */ in cpufreq_online()
1400 cpumask_copy(policy->cpus, policy->related_cpus); in cpufreq_online()
1402 ret = cpufreq_driver->online(policy); in cpufreq_online()
1409 cpumask_copy(policy->cpus, cpumask_of(cpu)); in cpufreq_online()
1415 ret = cpufreq_driver->init(policy); in cpufreq_online()
1423 * The initialization has succeeded and the policy is online. in cpufreq_online()
1427 ret = cpufreq_table_validate_and_sort(policy); in cpufreq_online()
1431 /* related_cpus should at least include policy->cpus. */ in cpufreq_online()
1432 cpumask_copy(policy->related_cpus, policy->cpus); in cpufreq_online()
1439 cpumask_and(policy->cpus, policy->cpus, cpu_online_mask); in cpufreq_online()
1442 for_each_cpu(j, policy->related_cpus) { in cpufreq_online()
1443 per_cpu(cpufreq_cpu_data, j) = policy; in cpufreq_online()
1444 add_cpu_dev_symlink(policy, j, get_cpu_device(j)); in cpufreq_online()
1447 policy->min_freq_req = kzalloc(2 * sizeof(*policy->min_freq_req), in cpufreq_online()
1449 if (!policy->min_freq_req) { in cpufreq_online()
1454 ret = freq_qos_add_request(&policy->constraints, in cpufreq_online()
1455 policy->min_freq_req, FREQ_QOS_MIN, in cpufreq_online()
1462 kfree(policy->min_freq_req); in cpufreq_online()
1463 policy->min_freq_req = NULL; in cpufreq_online()
1472 policy->max_freq_req = policy->min_freq_req + 1; in cpufreq_online()
1474 ret = freq_qos_add_request(&policy->constraints, in cpufreq_online()
1475 policy->max_freq_req, FREQ_QOS_MAX, in cpufreq_online()
1478 policy->max_freq_req = NULL; in cpufreq_online()
1483 CPUFREQ_CREATE_POLICY, policy); in cpufreq_online()
1487 policy->cur = cpufreq_driver->get(policy->cpu); in cpufreq_online()
1488 if (!policy->cur) { in cpufreq_online()
1505 * for the next freq which is >= policy->cur ('cur' must be set by now, in cpufreq_online()
1509 * We are passing target-freq as "policy->cur - 1" otherwise in cpufreq_online()
1510 * __cpufreq_driver_target() would simply fail, as policy->cur will be in cpufreq_online()
1515 unsigned int old_freq = policy->cur; in cpufreq_online()
1518 ret = cpufreq_frequency_table_get_index(policy, old_freq); in cpufreq_online()
1520 ret = __cpufreq_driver_target(policy, old_freq - 1, in cpufreq_online()
1530 __func__, policy->cpu, old_freq, policy->cur); in cpufreq_online()
1535 ret = cpufreq_add_dev_interface(policy); in cpufreq_online()
1539 cpufreq_stats_create_table(policy); in cpufreq_online()
1542 list_add(&policy->policy_list, &cpufreq_policy_list); in cpufreq_online()
1549 * once the energy model is properly initialized for the policy in cpufreq_online()
1552 * Also, this should be called before the policy is registered in cpufreq_online()
1556 cpufreq_driver->register_em(policy); in cpufreq_online()
1559 ret = cpufreq_init_policy(policy); in cpufreq_online()
1561 pr_err("%s: Failed to initialize policy for cpu: %d (%d)\n", in cpufreq_online()
1566 up_write(&policy->rwsem); in cpufreq_online()
1568 kobject_uevent(&policy->kobj, KOBJ_ADD); in cpufreq_online()
1570 /* Callback for handling stuff after policy is ready */ in cpufreq_online()
1572 cpufreq_driver->ready(policy); in cpufreq_online()
1575 policy->cdev = of_cpufreq_cooling_register(policy); in cpufreq_online()
1582 for_each_cpu(j, policy->real_cpus) in cpufreq_online()
1583 remove_cpu_dev_symlink(policy, j, get_cpu_device(j)); in cpufreq_online()
1587 cpufreq_driver->offline(policy); in cpufreq_online()
1591 cpufreq_driver->exit(policy); in cpufreq_online()
1594 cpumask_clear(policy->cpus); in cpufreq_online()
1595 up_write(&policy->rwsem); in cpufreq_online()
1597 cpufreq_policy_free(policy); in cpufreq_online()
1608 struct cpufreq_policy *policy; in cpufreq_add_dev() local
1621 policy = per_cpu(cpufreq_cpu_data, cpu); in cpufreq_add_dev()
1622 if (policy) in cpufreq_add_dev()
1623 add_cpu_dev_symlink(policy, cpu, dev); in cpufreq_add_dev()
1628 static void __cpufreq_offline(unsigned int cpu, struct cpufreq_policy *policy) in __cpufreq_offline() argument
1633 cpufreq_stop_governor(policy); in __cpufreq_offline()
1635 cpumask_clear_cpu(cpu, policy->cpus); in __cpufreq_offline()
1637 if (!policy_is_inactive(policy)) { in __cpufreq_offline()
1639 if (cpu == policy->cpu) in __cpufreq_offline()
1640 policy->cpu = cpumask_any(policy->cpus); in __cpufreq_offline()
1642 /* Start the governor again for the active policy. */ in __cpufreq_offline()
1644 ret = cpufreq_start_governor(policy); in __cpufreq_offline()
1653 strscpy(policy->last_governor, policy->governor->name, in __cpufreq_offline()
1656 policy->last_policy = policy->policy; in __cpufreq_offline()
1659 cpufreq_cooling_unregister(policy->cdev); in __cpufreq_offline()
1660 policy->cdev = NULL; in __cpufreq_offline()
1664 cpufreq_exit_governor(policy); in __cpufreq_offline()
1671 cpufreq_driver->offline(policy); in __cpufreq_offline()
1673 cpufreq_driver->exit(policy); in __cpufreq_offline()
1674 policy->freq_table = NULL; in __cpufreq_offline()
1680 struct cpufreq_policy *policy; in cpufreq_offline() local
1684 policy = cpufreq_cpu_get_raw(cpu); in cpufreq_offline()
1685 if (!policy) { in cpufreq_offline()
1690 down_write(&policy->rwsem); in cpufreq_offline()
1692 __cpufreq_offline(cpu, policy); in cpufreq_offline()
1694 up_write(&policy->rwsem); in cpufreq_offline()
1706 struct cpufreq_policy *policy = per_cpu(cpufreq_cpu_data, cpu); in cpufreq_remove_dev() local
1708 if (!policy) in cpufreq_remove_dev()
1711 down_write(&policy->rwsem); in cpufreq_remove_dev()
1714 __cpufreq_offline(cpu, policy); in cpufreq_remove_dev()
1716 remove_cpu_dev_symlink(policy, cpu, dev); in cpufreq_remove_dev()
1718 if (!cpumask_empty(policy->real_cpus)) { in cpufreq_remove_dev()
1719 up_write(&policy->rwsem); in cpufreq_remove_dev()
1725 cpufreq_driver->exit(policy); in cpufreq_remove_dev()
1727 up_write(&policy->rwsem); in cpufreq_remove_dev()
1729 cpufreq_policy_free(policy); in cpufreq_remove_dev()
1734 * @policy: Policy managing CPUs.
1740 static void cpufreq_out_of_sync(struct cpufreq_policy *policy, in cpufreq_out_of_sync() argument
1746 policy->cur, new_freq); in cpufreq_out_of_sync()
1748 freqs.old = policy->cur; in cpufreq_out_of_sync()
1751 cpufreq_freq_transition_begin(policy, &freqs); in cpufreq_out_of_sync()
1752 cpufreq_freq_transition_end(policy, &freqs, 0); in cpufreq_out_of_sync()
1755 static unsigned int cpufreq_verify_current_freq(struct cpufreq_policy *policy, bool update) in cpufreq_verify_current_freq() argument
1759 new_freq = cpufreq_driver->get(policy->cpu); in cpufreq_verify_current_freq()
1764 * If fast frequency switching is used with the given policy, the check in cpufreq_verify_current_freq()
1765 * against policy->cur is pointless, so skip it in that case. in cpufreq_verify_current_freq()
1767 if (policy->fast_switch_enabled || !has_target()) in cpufreq_verify_current_freq()
1770 if (policy->cur != new_freq) { in cpufreq_verify_current_freq()
1778 if (abs(policy->cur - new_freq) < KHZ_PER_MHZ) in cpufreq_verify_current_freq()
1779 return policy->cur; in cpufreq_verify_current_freq()
1781 cpufreq_out_of_sync(policy, new_freq); in cpufreq_verify_current_freq()
1783 schedule_work(&policy->update); in cpufreq_verify_current_freq()
1790 * cpufreq_quick_get - get the CPU frequency (in kHz) from policy->cur
1798 struct cpufreq_policy *policy; in cpufreq_quick_get() local
1812 policy = cpufreq_cpu_get(cpu); in cpufreq_quick_get()
1813 if (policy) { in cpufreq_quick_get()
1814 ret_freq = policy->cur; in cpufreq_quick_get()
1815 cpufreq_cpu_put(policy); in cpufreq_quick_get()
1830 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); in cpufreq_quick_get_max() local
1833 if (policy) { in cpufreq_quick_get_max()
1834 ret_freq = policy->max; in cpufreq_quick_get_max()
1835 cpufreq_cpu_put(policy); in cpufreq_quick_get_max()
1850 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); in cpufreq_get_hw_max_freq() local
1853 if (policy) { in cpufreq_get_hw_max_freq()
1854 ret_freq = policy->cpuinfo.max_freq; in cpufreq_get_hw_max_freq()
1855 cpufreq_cpu_put(policy); in cpufreq_get_hw_max_freq()
1862 static unsigned int __cpufreq_get(struct cpufreq_policy *policy) in __cpufreq_get() argument
1864 if (unlikely(policy_is_inactive(policy))) in __cpufreq_get()
1867 return cpufreq_verify_current_freq(policy, true); in __cpufreq_get()
1878 struct cpufreq_policy *policy = cpufreq_cpu_get(cpu); in cpufreq_get() local
1881 if (policy) { in cpufreq_get()
1882 down_read(&policy->rwsem); in cpufreq_get()
1884 ret_freq = __cpufreq_get(policy); in cpufreq_get()
1885 up_read(&policy->rwsem); in cpufreq_get()
1887 cpufreq_cpu_put(policy); in cpufreq_get()
1905 int cpufreq_generic_suspend(struct cpufreq_policy *policy) in cpufreq_generic_suspend() argument
1909 if (!policy->suspend_freq) { in cpufreq_generic_suspend()
1915 policy->suspend_freq); in cpufreq_generic_suspend()
1917 ret = __cpufreq_driver_target(policy, policy->suspend_freq, in cpufreq_generic_suspend()
1921 __func__, policy->suspend_freq, ret); in cpufreq_generic_suspend()
1937 struct cpufreq_policy *policy; in cpufreq_suspend() local
1947 for_each_active_policy(policy) { in cpufreq_suspend()
1949 down_write(&policy->rwsem); in cpufreq_suspend()
1950 cpufreq_stop_governor(policy); in cpufreq_suspend()
1951 up_write(&policy->rwsem); in cpufreq_suspend()
1954 if (cpufreq_driver->suspend && cpufreq_driver->suspend(policy)) in cpufreq_suspend()
1971 struct cpufreq_policy *policy; in cpufreq_resume() local
1987 for_each_active_policy(policy) { in cpufreq_resume()
1988 if (cpufreq_driver->resume && cpufreq_driver->resume(policy)) { in cpufreq_resume()
1992 down_write(&policy->rwsem); in cpufreq_resume()
1993 ret = cpufreq_start_governor(policy); in cpufreq_resume()
1994 up_write(&policy->rwsem); in cpufreq_resume()
1997 pr_err("%s: Failed to start governor for CPU%u's policy\n", in cpufreq_resume()
1998 __func__, policy->cpu); in cpufreq_resume()
2056 * of notifiers that ron on cpufreq policy changes.
2142 * @policy: cpufreq policy to switch the frequency for.
2152 * This function must not be called if policy->fast_switch_enabled is unset.
2155 * twice in parallel for the same policy and that it will never be called in
2156 * parallel with either ->target() or ->target_index() for the same policy.
2163 unsigned int cpufreq_driver_fast_switch(struct cpufreq_policy *policy, in cpufreq_driver_fast_switch() argument
2169 target_freq = clamp_val(target_freq, policy->min, policy->max); in cpufreq_driver_fast_switch()
2170 freq = cpufreq_driver->fast_switch(policy, target_freq); in cpufreq_driver_fast_switch()
2175 policy->cur = freq; in cpufreq_driver_fast_switch()
2176 arch_set_freq_scale(policy->related_cpus, freq, in cpufreq_driver_fast_switch()
2177 arch_scale_freq_ref(policy->cpu)); in cpufreq_driver_fast_switch()
2178 cpufreq_stats_record_transition(policy, freq); in cpufreq_driver_fast_switch()
2181 for_each_cpu(cpu, policy->cpus) in cpufreq_driver_fast_switch()
2203 * This function must not be called if policy->fast_switch_enabled is unset.
2230 static int __target_intermediate(struct cpufreq_policy *policy, in __target_intermediate() argument
2235 freqs->new = cpufreq_driver->get_intermediate(policy, index); in __target_intermediate()
2242 __func__, policy->cpu, freqs->old, freqs->new); in __target_intermediate()
2244 cpufreq_freq_transition_begin(policy, freqs); in __target_intermediate()
2245 ret = cpufreq_driver->target_intermediate(policy, index); in __target_intermediate()
2246 cpufreq_freq_transition_end(policy, freqs, ret); in __target_intermediate()
2255 static int __target_index(struct cpufreq_policy *policy, int index) in __target_index() argument
2257 struct cpufreq_freqs freqs = {.old = policy->cur, .flags = 0}; in __target_index()
2259 unsigned int newfreq = policy->freq_table[index].frequency; in __target_index()
2263 if (newfreq == policy->cur) in __target_index()
2267 restore_freq = policy->cur; in __target_index()
2273 retval = __target_intermediate(policy, &freqs, index); in __target_index()
2285 __func__, policy->cpu, freqs.old, freqs.new); in __target_index()
2287 cpufreq_freq_transition_begin(policy, &freqs); in __target_index()
2290 retval = cpufreq_driver->target_index(policy, index); in __target_index()
2296 cpufreq_freq_transition_end(policy, &freqs, retval); in __target_index()
2307 cpufreq_freq_transition_begin(policy, &freqs); in __target_index()
2308 cpufreq_freq_transition_end(policy, &freqs, 0); in __target_index()
2315 int __cpufreq_driver_target(struct cpufreq_policy *policy, in __cpufreq_driver_target() argument
2324 target_freq = __resolve_freq(policy, target_freq, relation); in __cpufreq_driver_target()
2327 policy->cpu, target_freq, relation, old_target_freq); in __cpufreq_driver_target()
2335 if (target_freq == policy->cur && in __cpufreq_driver_target()
2344 if (!policy->efficiencies_available) in __cpufreq_driver_target()
2347 return cpufreq_driver->target(policy, target_freq, relation); in __cpufreq_driver_target()
2353 return __target_index(policy, policy->cached_resolved_idx); in __cpufreq_driver_target()
2357 int cpufreq_driver_target(struct cpufreq_policy *policy, in cpufreq_driver_target() argument
2363 down_write(&policy->rwsem); in cpufreq_driver_target()
2365 ret = __cpufreq_driver_target(policy, target_freq, relation); in cpufreq_driver_target()
2367 up_write(&policy->rwsem); in cpufreq_driver_target()
2378 static int cpufreq_init_governor(struct cpufreq_policy *policy) in cpufreq_init_governor() argument
2389 if (!policy->governor) in cpufreq_init_governor()
2393 if (policy->governor->flags & CPUFREQ_GOV_DYNAMIC_SWITCHING && in cpufreq_init_governor()
2399 policy->governor->name, gov->name); in cpufreq_init_governor()
2400 policy->governor = gov; in cpufreq_init_governor()
2406 if (!try_module_get(policy->governor->owner)) in cpufreq_init_governor()
2409 pr_debug("%s: for CPU %u\n", __func__, policy->cpu); in cpufreq_init_governor()
2411 if (policy->governor->init) { in cpufreq_init_governor()
2412 ret = policy->governor->init(policy); in cpufreq_init_governor()
2414 module_put(policy->governor->owner); in cpufreq_init_governor()
2419 policy->strict_target = !!(policy->governor->flags & CPUFREQ_GOV_STRICT_TARGET); in cpufreq_init_governor()
2424 static void cpufreq_exit_governor(struct cpufreq_policy *policy) in cpufreq_exit_governor() argument
2426 if (cpufreq_suspended || !policy->governor) in cpufreq_exit_governor()
2429 pr_debug("%s: for CPU %u\n", __func__, policy->cpu); in cpufreq_exit_governor()
2431 if (policy->governor->exit) in cpufreq_exit_governor()
2432 policy->governor->exit(policy); in cpufreq_exit_governor()
2434 module_put(policy->governor->owner); in cpufreq_exit_governor()
2437 int cpufreq_start_governor(struct cpufreq_policy *policy) in cpufreq_start_governor() argument
2444 if (!policy->governor) in cpufreq_start_governor()
2447 pr_debug("%s: for CPU %u\n", __func__, policy->cpu); in cpufreq_start_governor()
2450 cpufreq_verify_current_freq(policy, false); in cpufreq_start_governor()
2452 if (policy->governor->start) { in cpufreq_start_governor()
2453 ret = policy->governor->start(policy); in cpufreq_start_governor()
2458 if (policy->governor->limits) in cpufreq_start_governor()
2459 policy->governor->limits(policy); in cpufreq_start_governor()
2464 void cpufreq_stop_governor(struct cpufreq_policy *policy) in cpufreq_stop_governor() argument
2466 if (cpufreq_suspended || !policy->governor) in cpufreq_stop_governor()
2469 pr_debug("%s: for CPU %u\n", __func__, policy->cpu); in cpufreq_stop_governor()
2471 if (policy->governor->stop) in cpufreq_stop_governor()
2472 policy->governor->stop(policy); in cpufreq_stop_governor()
2475 static void cpufreq_governor_limits(struct cpufreq_policy *policy) in cpufreq_governor_limits() argument
2477 if (cpufreq_suspended || !policy->governor) in cpufreq_governor_limits()
2480 pr_debug("%s: for CPU %u\n", __func__, policy->cpu); in cpufreq_governor_limits()
2482 if (policy->governor->limits) in cpufreq_governor_limits()
2483 policy->governor->limits(policy); in cpufreq_governor_limits()
2511 struct cpufreq_policy *policy; in cpufreq_unregister_governor() local
2522 for_each_inactive_policy(policy) { in cpufreq_unregister_governor()
2523 if (!strcmp(policy->last_governor, governor->name)) { in cpufreq_unregister_governor()
2524 policy->governor = NULL; in cpufreq_unregister_governor()
2525 strcpy(policy->last_governor, "\0"); in cpufreq_unregister_governor()
2538 * POLICY INTERFACE *
2543 * @policy: struct cpufreq_policy into which the current cpufreq_policy
2545 * @cpu: CPU to find the policy for
2547 * Reads the current cpufreq policy.
2549 int cpufreq_get_policy(struct cpufreq_policy *policy, unsigned int cpu) in cpufreq_get_policy() argument
2552 if (!policy) in cpufreq_get_policy()
2559 memcpy(policy, cpu_policy, sizeof(*policy)); in cpufreq_get_policy()
2567 * cpufreq_set_policy - Modify cpufreq policy parameters.
2568 * @policy: Policy object to modify.
2569 * @new_gov: Policy governor pointer.
2570 * @new_pol: Policy value (for drivers with built-in governors).
2573 * limits to be set for the policy, update @policy with the verified limits
2575 * carry out a governor update for @policy. That is, run the current governor's
2577 * @policy) or replace the governor for @policy with @new_gov.
2579 * The cpuinfo part of @policy is not updated by this function.
2581 static int cpufreq_set_policy(struct cpufreq_policy *policy, in cpufreq_set_policy() argument
2589 memcpy(&new_data.cpuinfo, &policy->cpuinfo, sizeof(policy->cpuinfo)); in cpufreq_set_policy()
2590 new_data.freq_table = policy->freq_table; in cpufreq_set_policy()
2591 new_data.cpu = policy->cpu; in cpufreq_set_policy()
2596 new_data.min = freq_qos_read_value(&policy->constraints, FREQ_QOS_MIN); in cpufreq_set_policy()
2597 new_data.max = freq_qos_read_value(&policy->constraints, FREQ_QOS_MAX); in cpufreq_set_policy()
2599 pr_debug("setting new policy for CPU %u: %u - %u kHz\n", in cpufreq_set_policy()
2611 * Resolve policy min/max to available frequencies. It ensures in cpufreq_set_policy()
2615 policy->min = new_data.min; in cpufreq_set_policy()
2616 policy->max = new_data.max; in cpufreq_set_policy()
2617 policy->min = __resolve_freq(policy, policy->min, CPUFREQ_RELATION_L); in cpufreq_set_policy()
2618 policy->max = __resolve_freq(policy, policy->max, CPUFREQ_RELATION_H); in cpufreq_set_policy()
2619 trace_cpu_frequency_limits(policy); in cpufreq_set_policy()
2621 policy->cached_target_freq = UINT_MAX; in cpufreq_set_policy()
2624 policy->min, policy->max); in cpufreq_set_policy()
2627 policy->policy = new_pol; in cpufreq_set_policy()
2629 return cpufreq_driver->setpolicy(policy); in cpufreq_set_policy()
2632 if (new_gov == policy->governor) { in cpufreq_set_policy()
2634 cpufreq_governor_limits(policy); in cpufreq_set_policy()
2641 old_gov = policy->governor; in cpufreq_set_policy()
2644 cpufreq_stop_governor(policy); in cpufreq_set_policy()
2645 cpufreq_exit_governor(policy); in cpufreq_set_policy()
2649 policy->governor = new_gov; in cpufreq_set_policy()
2650 ret = cpufreq_init_governor(policy); in cpufreq_set_policy()
2652 ret = cpufreq_start_governor(policy); in cpufreq_set_policy()
2657 cpufreq_exit_governor(policy); in cpufreq_set_policy()
2661 pr_debug("starting governor %s failed\n", policy->governor->name); in cpufreq_set_policy()
2663 policy->governor = old_gov; in cpufreq_set_policy()
2664 if (cpufreq_init_governor(policy)) in cpufreq_set_policy()
2665 policy->governor = NULL; in cpufreq_set_policy()
2667 cpufreq_start_governor(policy); in cpufreq_set_policy()
2674 * cpufreq_update_policy - Re-evaluate an existing cpufreq policy.
2675 * @cpu: CPU to re-evaluate the policy for.
2677 * Update the current frequency for the cpufreq policy of @cpu and use
2679 * evaluation of policy notifiers and the cpufreq driver's ->verify() callback
2680 * for the policy in question, among other things.
2684 struct cpufreq_policy *policy = cpufreq_cpu_acquire(cpu); in cpufreq_update_policy() local
2686 if (!policy) in cpufreq_update_policy()
2694 (cpufreq_suspended || WARN_ON(!cpufreq_verify_current_freq(policy, false)))) in cpufreq_update_policy()
2697 refresh_frequency_limits(policy); in cpufreq_update_policy()
2700 cpufreq_cpu_release(policy); in cpufreq_update_policy()
2705 * cpufreq_update_limits - Update policy limits for a given CPU.
2706 * @cpu: CPU to update the policy limits for.
2723 static int cpufreq_boost_set_sw(struct cpufreq_policy *policy, int state) in cpufreq_boost_set_sw() argument
2727 if (!policy->freq_table) in cpufreq_boost_set_sw()
2730 ret = cpufreq_frequency_table_cpuinfo(policy, policy->freq_table); in cpufreq_boost_set_sw()
2732 pr_err("%s: Policy frequency update failed\n", __func__); in cpufreq_boost_set_sw()
2736 ret = freq_qos_update_request(policy->max_freq_req, policy->max); in cpufreq_boost_set_sw()
2745 struct cpufreq_policy *policy; in cpufreq_boost_trigger_state() local
2757 for_each_active_policy(policy) { in cpufreq_boost_trigger_state()
2758 ret = cpufreq_driver->set_boost(policy, state); in cpufreq_boost_trigger_state()
2762 policy->boost_enabled = state; in cpufreq_boost_trigger_state()