2 * Copyright (C) 2012 - ARM Ltd
3 * Author: Marc Zyngier <marc.zyngier@arm.com>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 #include <linux/arm-smccc.h>
19 #include <linux/preempt.h>
20 #include <linux/kvm_host.h>
21 #include <linux/uaccess.h>
22 #include <linux/wait.h>
24 #include <asm/cputype.h>
25 #include <asm/kvm_emulate.h>
26 #include <asm/kvm_host.h>
28 #include <kvm/arm_psci.h>
31 * This is an implementation of the Power State Coordination Interface
32 * as described in ARM document number ARM DEN 0022A.
35 #define AFFINITY_MASK(level) ~((0x1UL << ((level) * MPIDR_LEVEL_BITS)) - 1)
37 static u32
smccc_get_function(struct kvm_vcpu
*vcpu
)
39 return vcpu_get_reg(vcpu
, 0);
42 static unsigned long smccc_get_arg1(struct kvm_vcpu
*vcpu
)
44 return vcpu_get_reg(vcpu
, 1);
47 static unsigned long smccc_get_arg2(struct kvm_vcpu
*vcpu
)
49 return vcpu_get_reg(vcpu
, 2);
52 static unsigned long smccc_get_arg3(struct kvm_vcpu
*vcpu
)
54 return vcpu_get_reg(vcpu
, 3);
57 static void smccc_set_retval(struct kvm_vcpu
*vcpu
,
63 vcpu_set_reg(vcpu
, 0, a0
);
64 vcpu_set_reg(vcpu
, 1, a1
);
65 vcpu_set_reg(vcpu
, 2, a2
);
66 vcpu_set_reg(vcpu
, 3, a3
);
69 static unsigned long psci_affinity_mask(unsigned long affinity_level
)
71 if (affinity_level
<= 3)
72 return MPIDR_HWID_BITMASK
& AFFINITY_MASK(affinity_level
);
77 static unsigned long kvm_psci_vcpu_suspend(struct kvm_vcpu
*vcpu
)
80 * NOTE: For simplicity, we make VCPU suspend emulation to be
81 * same-as WFI (Wait-for-interrupt) emulation.
83 * This means for KVM the wakeup events are interrupts and
84 * this is consistent with intended use of StateID as described
85 * in section 5.4.1 of PSCI v0.2 specification (ARM DEN 0022A).
87 * Further, we also treat power-down request to be same as
88 * stand-by request as-per section 5.4.2 clause 3 of PSCI v0.2
89 * specification (ARM DEN 0022A). This means all suspend states
90 * for KVM will preserve the register state.
93 kvm_clear_request(KVM_REQ_UNHALT
, vcpu
);
95 return PSCI_RET_SUCCESS
;
98 static void kvm_psci_vcpu_off(struct kvm_vcpu
*vcpu
)
100 vcpu
->arch
.power_off
= true;
101 kvm_make_request(KVM_REQ_SLEEP
, vcpu
);
105 static unsigned long kvm_psci_vcpu_on(struct kvm_vcpu
*source_vcpu
)
107 struct kvm
*kvm
= source_vcpu
->kvm
;
108 struct kvm_vcpu
*vcpu
= NULL
;
109 struct swait_queue_head
*wq
;
110 unsigned long cpu_id
;
111 unsigned long context_id
;
112 phys_addr_t target_pc
;
114 cpu_id
= smccc_get_arg1(source_vcpu
) & MPIDR_HWID_BITMASK
;
115 if (vcpu_mode_is_32bit(source_vcpu
))
116 cpu_id
&= ~((u32
) 0);
118 vcpu
= kvm_mpidr_to_vcpu(kvm
, cpu_id
);
121 * Make sure the caller requested a valid CPU and that the CPU is
125 return PSCI_RET_INVALID_PARAMS
;
126 if (!vcpu
->arch
.power_off
) {
127 if (kvm_psci_version(source_vcpu
, kvm
) != KVM_ARM_PSCI_0_1
)
128 return PSCI_RET_ALREADY_ON
;
130 return PSCI_RET_INVALID_PARAMS
;
133 target_pc
= smccc_get_arg2(source_vcpu
);
134 context_id
= smccc_get_arg3(source_vcpu
);
136 kvm_reset_vcpu(vcpu
);
138 /* Gracefully handle Thumb2 entry point */
139 if (vcpu_mode_is_32bit(vcpu
) && (target_pc
& 1)) {
140 target_pc
&= ~((phys_addr_t
) 1);
141 vcpu_set_thumb(vcpu
);
144 /* Propagate caller endianness */
145 if (kvm_vcpu_is_be(source_vcpu
))
146 kvm_vcpu_set_be(vcpu
);
148 *vcpu_pc(vcpu
) = target_pc
;
150 * NOTE: We always update r0 (or x0) because for PSCI v0.1
151 * the general puspose registers are undefined upon CPU_ON.
153 smccc_set_retval(vcpu
, context_id
, 0, 0, 0);
154 vcpu
->arch
.power_off
= false;
155 smp_mb(); /* Make sure the above is visible */
157 wq
= kvm_arch_vcpu_wq(vcpu
);
160 return PSCI_RET_SUCCESS
;
163 static unsigned long kvm_psci_vcpu_affinity_info(struct kvm_vcpu
*vcpu
)
165 int i
, matching_cpus
= 0;
167 unsigned long target_affinity
;
168 unsigned long target_affinity_mask
;
169 unsigned long lowest_affinity_level
;
170 struct kvm
*kvm
= vcpu
->kvm
;
171 struct kvm_vcpu
*tmp
;
173 target_affinity
= smccc_get_arg1(vcpu
);
174 lowest_affinity_level
= smccc_get_arg2(vcpu
);
176 /* Determine target affinity mask */
177 target_affinity_mask
= psci_affinity_mask(lowest_affinity_level
);
178 if (!target_affinity_mask
)
179 return PSCI_RET_INVALID_PARAMS
;
181 /* Ignore other bits of target affinity */
182 target_affinity
&= target_affinity_mask
;
185 * If one or more VCPU matching target affinity are running
188 kvm_for_each_vcpu(i
, tmp
, kvm
) {
189 mpidr
= kvm_vcpu_get_mpidr_aff(tmp
);
190 if ((mpidr
& target_affinity_mask
) == target_affinity
) {
192 if (!tmp
->arch
.power_off
)
193 return PSCI_0_2_AFFINITY_LEVEL_ON
;
198 return PSCI_RET_INVALID_PARAMS
;
200 return PSCI_0_2_AFFINITY_LEVEL_OFF
;
203 static void kvm_prepare_system_event(struct kvm_vcpu
*vcpu
, u32 type
)
206 struct kvm_vcpu
*tmp
;
209 * The KVM ABI specifies that a system event exit may call KVM_RUN
210 * again and may perform shutdown/reboot at a later time that when the
211 * actual request is made. Since we are implementing PSCI and a
212 * caller of PSCI reboot and shutdown expects that the system shuts
213 * down or reboots immediately, let's make sure that VCPUs are not run
214 * after this call is handled and before the VCPUs have been
217 kvm_for_each_vcpu(i
, tmp
, vcpu
->kvm
)
218 tmp
->arch
.power_off
= true;
219 kvm_make_all_cpus_request(vcpu
->kvm
, KVM_REQ_SLEEP
);
221 memset(&vcpu
->run
->system_event
, 0, sizeof(vcpu
->run
->system_event
));
222 vcpu
->run
->system_event
.type
= type
;
223 vcpu
->run
->exit_reason
= KVM_EXIT_SYSTEM_EVENT
;
226 static void kvm_psci_system_off(struct kvm_vcpu
*vcpu
)
228 kvm_prepare_system_event(vcpu
, KVM_SYSTEM_EVENT_SHUTDOWN
);
231 static void kvm_psci_system_reset(struct kvm_vcpu
*vcpu
)
233 kvm_prepare_system_event(vcpu
, KVM_SYSTEM_EVENT_RESET
);
236 static int kvm_psci_0_2_call(struct kvm_vcpu
*vcpu
)
238 struct kvm
*kvm
= vcpu
->kvm
;
239 u32 psci_fn
= smccc_get_function(vcpu
);
244 case PSCI_0_2_FN_PSCI_VERSION
:
246 * Bits[31:16] = Major Version = 0
247 * Bits[15:0] = Minor Version = 2
249 val
= KVM_ARM_PSCI_0_2
;
251 case PSCI_0_2_FN_CPU_SUSPEND
:
252 case PSCI_0_2_FN64_CPU_SUSPEND
:
253 val
= kvm_psci_vcpu_suspend(vcpu
);
255 case PSCI_0_2_FN_CPU_OFF
:
256 kvm_psci_vcpu_off(vcpu
);
257 val
= PSCI_RET_SUCCESS
;
259 case PSCI_0_2_FN_CPU_ON
:
260 case PSCI_0_2_FN64_CPU_ON
:
261 mutex_lock(&kvm
->lock
);
262 val
= kvm_psci_vcpu_on(vcpu
);
263 mutex_unlock(&kvm
->lock
);
265 case PSCI_0_2_FN_AFFINITY_INFO
:
266 case PSCI_0_2_FN64_AFFINITY_INFO
:
267 val
= kvm_psci_vcpu_affinity_info(vcpu
);
269 case PSCI_0_2_FN_MIGRATE_INFO_TYPE
:
271 * Trusted OS is MP hence does not require migration
273 * Trusted OS is not present
275 val
= PSCI_0_2_TOS_MP
;
277 case PSCI_0_2_FN_SYSTEM_OFF
:
278 kvm_psci_system_off(vcpu
);
280 * We should'nt be going back to guest VCPU after
281 * receiving SYSTEM_OFF request.
283 * If user space accidently/deliberately resumes
284 * guest VCPU after SYSTEM_OFF request then guest
285 * VCPU should see internal failure from PSCI return
286 * value. To achieve this, we preload r0 (or x0) with
287 * PSCI return value INTERNAL_FAILURE.
289 val
= PSCI_RET_INTERNAL_FAILURE
;
292 case PSCI_0_2_FN_SYSTEM_RESET
:
293 kvm_psci_system_reset(vcpu
);
295 * Same reason as SYSTEM_OFF for preloading r0 (or x0)
296 * with PSCI return value INTERNAL_FAILURE.
298 val
= PSCI_RET_INTERNAL_FAILURE
;
302 val
= PSCI_RET_NOT_SUPPORTED
;
306 smccc_set_retval(vcpu
, val
, 0, 0, 0);
310 static int kvm_psci_1_0_call(struct kvm_vcpu
*vcpu
)
312 u32 psci_fn
= smccc_get_function(vcpu
);
318 case PSCI_0_2_FN_PSCI_VERSION
:
319 val
= KVM_ARM_PSCI_1_0
;
321 case PSCI_1_0_FN_PSCI_FEATURES
:
322 feature
= smccc_get_arg1(vcpu
);
324 case PSCI_0_2_FN_PSCI_VERSION
:
325 case PSCI_0_2_FN_CPU_SUSPEND
:
326 case PSCI_0_2_FN64_CPU_SUSPEND
:
327 case PSCI_0_2_FN_CPU_OFF
:
328 case PSCI_0_2_FN_CPU_ON
:
329 case PSCI_0_2_FN64_CPU_ON
:
330 case PSCI_0_2_FN_AFFINITY_INFO
:
331 case PSCI_0_2_FN64_AFFINITY_INFO
:
332 case PSCI_0_2_FN_MIGRATE_INFO_TYPE
:
333 case PSCI_0_2_FN_SYSTEM_OFF
:
334 case PSCI_0_2_FN_SYSTEM_RESET
:
335 case PSCI_1_0_FN_PSCI_FEATURES
:
336 case ARM_SMCCC_VERSION_FUNC_ID
:
340 val
= PSCI_RET_NOT_SUPPORTED
;
345 return kvm_psci_0_2_call(vcpu
);
348 smccc_set_retval(vcpu
, val
, 0, 0, 0);
352 static int kvm_psci_0_1_call(struct kvm_vcpu
*vcpu
)
354 struct kvm
*kvm
= vcpu
->kvm
;
355 u32 psci_fn
= smccc_get_function(vcpu
);
359 case KVM_PSCI_FN_CPU_OFF
:
360 kvm_psci_vcpu_off(vcpu
);
361 val
= PSCI_RET_SUCCESS
;
363 case KVM_PSCI_FN_CPU_ON
:
364 mutex_lock(&kvm
->lock
);
365 val
= kvm_psci_vcpu_on(vcpu
);
366 mutex_unlock(&kvm
->lock
);
369 val
= PSCI_RET_NOT_SUPPORTED
;
373 smccc_set_retval(vcpu
, val
, 0, 0, 0);
378 * kvm_psci_call - handle PSCI call if r0 value is in range
379 * @vcpu: Pointer to the VCPU struct
381 * Handle PSCI calls from guests through traps from HVC instructions.
382 * The calling convention is similar to SMC calls to the secure world
383 * where the function number is placed in r0.
385 * This function returns: > 0 (success), 0 (success but exit to user
386 * space), and < 0 (errors)
389 * -EINVAL: Unrecognized PSCI function
391 static int kvm_psci_call(struct kvm_vcpu
*vcpu
)
393 switch (kvm_psci_version(vcpu
, vcpu
->kvm
)) {
394 case KVM_ARM_PSCI_1_0
:
395 return kvm_psci_1_0_call(vcpu
);
396 case KVM_ARM_PSCI_0_2
:
397 return kvm_psci_0_2_call(vcpu
);
398 case KVM_ARM_PSCI_0_1
:
399 return kvm_psci_0_1_call(vcpu
);
405 int kvm_hvc_call_handler(struct kvm_vcpu
*vcpu
)
407 u32 func_id
= smccc_get_function(vcpu
);
408 u32 val
= PSCI_RET_NOT_SUPPORTED
;
412 case ARM_SMCCC_VERSION_FUNC_ID
:
413 val
= ARM_SMCCC_VERSION_1_1
;
415 case ARM_SMCCC_ARCH_FEATURES_FUNC_ID
:
416 feature
= smccc_get_arg1(vcpu
);
418 case ARM_SMCCC_ARCH_WORKAROUND_1
:
419 if (kvm_arm_harden_branch_predictor())
425 return kvm_psci_call(vcpu
);
428 smccc_set_retval(vcpu
, val
, 0, 0, 0);
432 int kvm_arm_get_fw_num_regs(struct kvm_vcpu
*vcpu
)
434 return 1; /* PSCI version */
437 int kvm_arm_copy_fw_reg_indices(struct kvm_vcpu
*vcpu
, u64 __user
*uindices
)
439 if (put_user(KVM_REG_ARM_PSCI_VERSION
, uindices
))
445 int kvm_arm_get_fw_reg(struct kvm_vcpu
*vcpu
, const struct kvm_one_reg
*reg
)
447 if (reg
->id
== KVM_REG_ARM_PSCI_VERSION
) {
448 void __user
*uaddr
= (void __user
*)(long)reg
->addr
;
451 val
= kvm_psci_version(vcpu
, vcpu
->kvm
);
452 if (copy_to_user(uaddr
, &val
, KVM_REG_SIZE(reg
->id
)))
461 int kvm_arm_set_fw_reg(struct kvm_vcpu
*vcpu
, const struct kvm_one_reg
*reg
)
463 if (reg
->id
== KVM_REG_ARM_PSCI_VERSION
) {
464 void __user
*uaddr
= (void __user
*)(long)reg
->addr
;
468 if (copy_from_user(&val
, uaddr
, KVM_REG_SIZE(reg
->id
)))
471 wants_02
= test_bit(KVM_ARM_VCPU_PSCI_0_2
, vcpu
->arch
.features
);
474 case KVM_ARM_PSCI_0_1
:
477 vcpu
->kvm
->arch
.psci_version
= val
;
479 case KVM_ARM_PSCI_0_2
:
480 case KVM_ARM_PSCI_1_0
:
483 vcpu
->kvm
->arch
.psci_version
= val
;