1 /*
2  * Copyright (c) 2012-2018 LK Trusty Authors. All Rights Reserved.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining
5  * a copy of this software and associated documentation files
6  * (the "Software"), to deal in the Software without restriction,
7  * including without limitation the rights to use, copy, modify, merge,
8  * publish, distribute, sublicense, and/or sell copies of the Software,
9  * and to permit persons to whom the Software is furnished to do so,
10  * subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be
13  * included in all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
18  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
19  * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
20  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
21  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22  */
23 #pragma once
24 
25 #include <stdbool.h>
26 #include <sys/types.h>
27 
28 /**
29  * local_apic_init() -- Initialize Local APIC
30  * @level: LK init level
31  */
32 void local_apic_init(uint level);
33 
34 /**
35  * lapic_eoi() -- Trigger local APIC EOI
36  */
37 void lapic_eoi(void);
38 
39 /**
40  * lapic_software_disable() -- Software disable local APIC
41  *
42  * Trusty LK initialize local APIC to handle external interrupt, local APIC
43  * should be software disabled before switch back to Non-secure world if
44  * local APIC will be operated by Non-secure world.
45  */
46 void lapic_software_disable(void);
47 
48 /**
49  * send_self_ipi() -- Trigger self IPI via local APIC
50  * @vector: vector ID to be triggered.
51  */
52 bool send_self_ipi(uint32_t vector);
53