xref: /rk3399_ARM-atf/common/runtime_svc.c (revision 0a30cf54af7bb1f77b405062b1d5b44e809d0290)
1 /*
2  * Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  * Redistributions of source code must retain the above copyright notice, this
8  * list of conditions and the following disclaimer.
9  *
10  * Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  *
14  * Neither the name of ARM nor the names of its contributors may be used
15  * to endorse or promote products derived from this software without specific
16  * prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28  * POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 #include <stdio.h>
32 #include <string.h>
33 #include <errno.h>
34 #include <assert.h>
35 #include <arch_helpers.h>
36 #include <console.h>
37 #include <platform.h>
38 #include <semihosting.h>
39 #include <bl_common.h>
40 #include <psci.h>
41 #include <runtime_svc.h>
42 #include <context.h>
43 #include <debug.h>
44 #include <context_mgmt.h>
45 
46 /*******************************************************************************
47  * The 'rt_svc_descs' array holds the runtime service descriptors exported by
48  * services by placing them in the 'rt_svc_descs' linker section.
49  * The 'rt_svc_descs_indices' array holds the index of a descriptor in the
50  * 'rt_svc_descs' array. When an SMC arrives, the OEN[29:24] bits and the call
51  * type[31] bit in the function id are combined to get an index into the
52  * 'rt_svc_descs_indices' array. This gives the index of the descriptor in the
53  * 'rt_svc_descs' array which contains the SMC handler.
54  ******************************************************************************/
55 #define RT_SVC_DESCS_START	((uint64_t) (&__RT_SVC_DESCS_START__))
56 #define RT_SVC_DESCS_END	((uint64_t) (&__RT_SVC_DESCS_END__))
57 uint8_t rt_svc_descs_indices[MAX_RT_SVCS];
58 static rt_svc_desc *rt_svc_descs;
59 
60 /*******************************************************************************
61  * Simple routine to sanity check a runtime service descriptor before using it
62  ******************************************************************************/
63 static int32_t validate_rt_svc_desc(rt_svc_desc *desc)
64 {
65 	if (desc == NULL)
66 		return -EINVAL;
67 
68 	if (desc->start_oen > desc->end_oen)
69 		return -EINVAL;
70 
71 	if (desc->end_oen >= OEN_LIMIT)
72 		return -EINVAL;
73 
74 	if (desc->call_type != SMC_TYPE_FAST && desc->call_type != SMC_TYPE_STD)
75 		return -EINVAL;
76 
77 	/* A runtime service having no init or handle function doesn't make sense */
78 	if (desc->init == NULL && desc->handle == NULL)
79 		return -EINVAL;
80 
81 	return 0;
82 }
83 
84 /*******************************************************************************
85  * This function calls the initialisation routine in the descriptor exported by
86  * a runtime service. Once a descriptor has been validated, its start & end
87  * owning entity numbers and the call type are combined to form a unique oen.
88  * The unique oen is used as an index into the 'rt_svc_descs_indices' array.
89  * The index of the runtime service descriptor is stored at this index.
90  ******************************************************************************/
91 void runtime_svc_init()
92 {
93 	int32_t rc = 0;
94 	uint32_t index, start_idx, end_idx;
95 	uint64_t rt_svc_descs_num;
96 
97 	/* If no runtime services are implemented then simply bail out */
98 	rt_svc_descs_num = RT_SVC_DESCS_END - RT_SVC_DESCS_START;
99 	rt_svc_descs_num /= sizeof(rt_svc_desc);
100 	if (rt_svc_descs_num == 0)
101 		return;
102 
103 	/* Initialise internal variables to invalid state */
104 	memset(rt_svc_descs_indices, -1, sizeof(rt_svc_descs_indices));
105 
106 	rt_svc_descs = (rt_svc_desc *) RT_SVC_DESCS_START;
107 	for (index = 0; index < rt_svc_descs_num; index++) {
108 
109 		/*
110 		 * An invalid descriptor is an error condition since it is
111 		 * difficult to predict the system behaviour in the absence
112 		 * of this service.
113 		 */
114 		rc = validate_rt_svc_desc(&rt_svc_descs[index]);
115 		if (rc) {
116 			ERROR("Invalid runtime service descriptor 0x%x (%s)\n",
117 					&rt_svc_descs[index],
118 					rt_svc_descs[index].name);
119 			goto error;
120 		}
121 
122 		/* Call the initialisation routine for this runtime service */
123 		rc = rt_svc_descs[index].init();
124 		if (rc) {
125 			ERROR("Error initializing runtime service %s\n",
126 					rt_svc_descs[index].name);
127 		} else {
128 			/*
129 			 * Fill the indices corresponding to the start and end
130 			 * owning entity numbers with the index of the
131 			 * descriptor which will handle the SMCs for this owning
132 			 * entity range.
133 			 */
134 			start_idx = get_unique_oen(rt_svc_descs[index].start_oen,
135 					rt_svc_descs[index].call_type);
136 			end_idx = get_unique_oen(rt_svc_descs[index].end_oen,
137 					rt_svc_descs[index].call_type);
138 
139 			for (; start_idx <= end_idx; start_idx++)
140 				rt_svc_descs_indices[start_idx] = index;
141 		}
142 	}
143 
144 	return;
145 error:
146 	panic();
147 }
148 
149 void fault_handler(void *handle)
150 {
151 	gp_regs *gpregs_ctx = get_gpregs_ctx(handle);
152 	ERROR("Unhandled synchronous fault. Register dump @ 0x%x \n",
153 	      gpregs_ctx);
154 	panic();
155 }
156