Branch data Line data Source code
1 : : /*
2 : : * This file is part of the MicroPython project, http://micropython.org/
3 : : *
4 : : * The MIT License (MIT)
5 : : *
6 : : * Copyright (c) 2013, 2014 Damien P. George
7 : : * Copyright (c) 2014 Paul Sokolovsky
8 : : *
9 : : * Permission is hereby granted, free of charge, to any person obtaining a copy
10 : : * of this software and associated documentation files (the "Software"), to deal
11 : : * in the Software without restriction, including without limitation the rights
12 : : * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13 : : * copies of the Software, and to permit persons to whom the Software is
14 : : * furnished to do so, subject to the following conditions:
15 : : *
16 : : * The above copyright notice and this permission notice shall be included in
17 : : * all copies or substantial portions of the Software.
18 : : *
19 : : * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20 : : * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 : : * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22 : : * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23 : : * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24 : : * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 : : * THE SOFTWARE.
26 : : */
27 : :
28 : : #include <string.h>
29 : : #include <assert.h>
30 : :
31 : : #include "py/objtuple.h"
32 : : #include "py/objfun.h"
33 : : #include "py/runtime.h"
34 : : #include "py/bc.h"
35 : : #include "py/stackctrl.h"
36 : :
37 : : #if MICROPY_DEBUG_VERBOSE // print debugging info
38 : : #define DEBUG_PRINT (1)
39 : : #else // don't print debugging info
40 : : #define DEBUG_PRINT (0)
41 : : #define DEBUG_printf(...) (void)0
42 : : #endif
43 : :
44 : : // Note: the "name" entry in mp_obj_type_t for a function type must be
45 : : // MP_QSTR_function because it is used to determine if an object is of generic
46 : : // function type.
47 : :
48 : : /******************************************************************************/
49 : : /* builtin functions */
50 : :
51 : 310540 : STATIC mp_obj_t fun_builtin_0_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
52 : 310540 : (void)args;
53 [ + - - + ]: 310540 : assert(mp_obj_is_type(self_in, &mp_type_fun_builtin_0));
54 : 310540 : mp_obj_fun_builtin_fixed_t *self = MP_OBJ_TO_PTR(self_in);
55 : 310540 : mp_arg_check_num(n_args, n_kw, 0, 0, false);
56 : 310540 : return self->fun._0();
57 : : }
58 : :
59 : : MP_DEFINE_CONST_OBJ_TYPE(
60 : : mp_type_fun_builtin_0, MP_QSTR_function, MP_TYPE_FLAG_BINDS_SELF | MP_TYPE_FLAG_BUILTIN_FUN,
61 : : call, fun_builtin_0_call,
62 : : unary_op, mp_generic_unary_op
63 : : );
64 : :
65 : 517623 : STATIC mp_obj_t fun_builtin_1_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
66 [ + - - + ]: 517623 : assert(mp_obj_is_type(self_in, &mp_type_fun_builtin_1));
67 : 517623 : mp_obj_fun_builtin_fixed_t *self = MP_OBJ_TO_PTR(self_in);
68 : 517623 : mp_arg_check_num(n_args, n_kw, 1, 1, false);
69 : 517623 : return self->fun._1(args[0]);
70 : : }
71 : :
72 : : MP_DEFINE_CONST_OBJ_TYPE(
73 : : mp_type_fun_builtin_1, MP_QSTR_function, MP_TYPE_FLAG_BINDS_SELF | MP_TYPE_FLAG_BUILTIN_FUN,
74 : : call, fun_builtin_1_call,
75 : : unary_op, mp_generic_unary_op
76 : : );
77 : :
78 : 496130 : STATIC mp_obj_t fun_builtin_2_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
79 [ + - - + ]: 496130 : assert(mp_obj_is_type(self_in, &mp_type_fun_builtin_2));
80 : 496130 : mp_obj_fun_builtin_fixed_t *self = MP_OBJ_TO_PTR(self_in);
81 : 496130 : mp_arg_check_num(n_args, n_kw, 2, 2, false);
82 : 496116 : return self->fun._2(args[0], args[1]);
83 : : }
84 : :
85 : : MP_DEFINE_CONST_OBJ_TYPE(
86 : : mp_type_fun_builtin_2, MP_QSTR_function, MP_TYPE_FLAG_BINDS_SELF | MP_TYPE_FLAG_BUILTIN_FUN,
87 : : call, fun_builtin_2_call,
88 : : unary_op, mp_generic_unary_op
89 : : );
90 : :
91 : 7184 : STATIC mp_obj_t fun_builtin_3_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
92 [ + - - + ]: 7184 : assert(mp_obj_is_type(self_in, &mp_type_fun_builtin_3));
93 : 7184 : mp_obj_fun_builtin_fixed_t *self = MP_OBJ_TO_PTR(self_in);
94 : 7184 : mp_arg_check_num(n_args, n_kw, 3, 3, false);
95 : 7182 : return self->fun._3(args[0], args[1], args[2]);
96 : : }
97 : :
98 : : MP_DEFINE_CONST_OBJ_TYPE(
99 : : mp_type_fun_builtin_3, MP_QSTR_function, MP_TYPE_FLAG_BINDS_SELF | MP_TYPE_FLAG_BUILTIN_FUN,
100 : : call, fun_builtin_3_call,
101 : : unary_op, mp_generic_unary_op
102 : : );
103 : :
104 : 1041277 : STATIC mp_obj_t fun_builtin_var_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
105 [ + - - + ]: 1041277 : assert(mp_obj_is_type(self_in, &mp_type_fun_builtin_var));
106 : 1041277 : mp_obj_fun_builtin_var_t *self = MP_OBJ_TO_PTR(self_in);
107 : :
108 : : // check number of arguments
109 : 1041277 : mp_arg_check_num_sig(n_args, n_kw, self->sig);
110 : :
111 [ + + ]: 1041273 : if (self->sig & 1) {
112 : : // function allows keywords
113 : :
114 : : // we create a map directly from the given args array
115 : 486104 : mp_map_t kw_args;
116 : 486104 : mp_map_init_fixed_table(&kw_args, n_kw, args + n_args);
117 : :
118 : 486104 : return self->fun.kw(n_args, args, &kw_args);
119 : :
120 : : } else {
121 : : // function takes a variable number of arguments, but no keywords
122 : :
123 : 555169 : return self->fun.var(n_args, args);
124 : : }
125 : : }
126 : :
127 : : MP_DEFINE_CONST_OBJ_TYPE(
128 : : mp_type_fun_builtin_var, MP_QSTR_function, MP_TYPE_FLAG_BINDS_SELF | MP_TYPE_FLAG_BUILTIN_FUN,
129 : : call, fun_builtin_var_call,
130 : : unary_op, mp_generic_unary_op
131 : : );
132 : :
133 : : /******************************************************************************/
134 : : /* byte code functions */
135 : :
136 : 31 : STATIC qstr mp_obj_code_get_name(const mp_obj_fun_bc_t *fun, const byte *code_info) {
137 [ - + ]: 31 : MP_BC_PRELUDE_SIZE_DECODE(code_info);
138 : 31 : mp_uint_t name = mp_decode_uint_value(code_info);
139 : : #if MICROPY_EMIT_BYTECODE_USES_QSTR_TABLE
140 : 31 : name = fun->context->constants.qstr_table[name];
141 : : #endif
142 : 31 : return name;
143 : : }
144 : :
145 : : #if MICROPY_EMIT_NATIVE
146 : : STATIC const mp_obj_type_t mp_type_fun_native;
147 : : #endif
148 : :
149 : 47 : qstr mp_obj_fun_get_name(mp_const_obj_t fun_in) {
150 : 47 : const mp_obj_fun_bc_t *fun = MP_OBJ_TO_PTR(fun_in);
151 : : #if MICROPY_EMIT_NATIVE
152 [ + + + + ]: 47 : if (fun->base.type == &mp_type_fun_native || fun->base.type == &mp_type_native_gen_wrap) {
153 : : // TODO native functions don't have name stored
154 : : return MP_QSTR_;
155 : : }
156 : : #endif
157 : :
158 : 31 : const byte *bc = fun->bytecode;
159 [ + + ]: 47 : MP_BC_PRELUDE_SIG_DECODE(bc);
160 : 31 : return mp_obj_code_get_name(fun, bc);
161 : : }
162 : :
163 : : #if MICROPY_CPYTHON_COMPAT
164 : 5 : STATIC void fun_bc_print(const mp_print_t *print, mp_obj_t o_in, mp_print_kind_t kind) {
165 : 5 : (void)kind;
166 : 5 : mp_obj_fun_bc_t *o = MP_OBJ_TO_PTR(o_in);
167 : 5 : mp_printf(print, "<function %q at 0x%p>", mp_obj_fun_get_name(o_in), o);
168 : 5 : }
169 : : #endif
170 : :
171 : : #if DEBUG_PRINT
172 : : STATIC void dump_args(const mp_obj_t *a, size_t sz) {
173 : : DEBUG_printf("%p: ", a);
174 : : for (size_t i = 0; i < sz; i++) {
175 : : DEBUG_printf("%p ", a[i]);
176 : : }
177 : : DEBUG_printf("\n");
178 : : }
179 : : #else
180 : : #define dump_args(...) (void)0
181 : : #endif
182 : :
183 : : // With this macro you can tune the maximum number of function state bytes
184 : : // that will be allocated on the stack. Any function that needs more
185 : : // than this will try to use the heap, with fallback to stack allocation.
186 : : #define VM_MAX_STATE_ON_STACK (sizeof(mp_uint_t) * 11)
187 : :
188 : : #define DECODE_CODESTATE_SIZE(bytecode, n_state_out_var, state_size_out_var) \
189 : : { \
190 : : const uint8_t *ip = bytecode; \
191 : : size_t n_exc_stack, scope_flags, n_pos_args, n_kwonly_args, n_def_args; \
192 : : MP_BC_PRELUDE_SIG_DECODE_INTO(ip, n_state_out_var, n_exc_stack, scope_flags, n_pos_args, n_kwonly_args, n_def_args); \
193 : : (void)scope_flags; (void)n_pos_args; (void)n_kwonly_args; (void)n_def_args; \
194 : : \
195 : : /* state size in bytes */ \
196 : : state_size_out_var = n_state_out_var * sizeof(mp_obj_t) \
197 : : + n_exc_stack * sizeof(mp_exc_stack_t); \
198 : : }
199 : :
200 : : #define INIT_CODESTATE(code_state, _fun_bc, _n_state, n_args, n_kw, args) \
201 : : code_state->fun_bc = _fun_bc; \
202 : : code_state->n_state = _n_state; \
203 : : mp_setup_code_state(code_state, n_args, n_kw, args); \
204 : : code_state->old_globals = mp_globals_get();
205 : :
206 : : #if MICROPY_STACKLESS
207 : : mp_code_state_t *mp_obj_fun_bc_prepare_codestate(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
208 : : MP_STACK_CHECK();
209 : : mp_obj_fun_bc_t *self = MP_OBJ_TO_PTR(self_in);
210 : :
211 : : size_t n_state, state_size;
212 : : DECODE_CODESTATE_SIZE(self->bytecode, n_state, state_size);
213 : :
214 : : mp_code_state_t *code_state;
215 : : #if MICROPY_ENABLE_PYSTACK
216 : : code_state = mp_pystack_alloc(sizeof(mp_code_state_t) + state_size);
217 : : #else
218 : : // If we use m_new_obj_var(), then on no memory, MemoryError will be
219 : : // raised. But this is not correct exception for a function call,
220 : : // RuntimeError should be raised instead. So, we use m_new_obj_var_maybe(),
221 : : // return NULL, then vm.c takes the needed action (either raise
222 : : // RuntimeError or fallback to stack allocation).
223 : : code_state = m_new_obj_var_maybe(mp_code_state_t, byte, state_size);
224 : : if (!code_state) {
225 : : return NULL;
226 : : }
227 : : #endif
228 : :
229 : : INIT_CODESTATE(code_state, self, n_state, n_args, n_kw, args);
230 : :
231 : : // execute the byte code with the correct globals context
232 : : mp_globals_set(self->context->module.globals);
233 : :
234 : : return code_state;
235 : : }
236 : : #endif
237 : :
238 : 7597315 : STATIC mp_obj_t fun_bc_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
239 : 7597315 : MP_STACK_CHECK();
240 : :
241 : 7680210 : DEBUG_printf("Input n_args: " UINT_FMT ", n_kw: " UINT_FMT "\n", n_args, n_kw);
242 : 7680210 : DEBUG_printf("Input pos args: ");
243 : 7680210 : dump_args(args, n_args);
244 : 7680210 : DEBUG_printf("Input kw args: ");
245 : 7680210 : dump_args(args + n_args, n_kw * 2);
246 : :
247 : 7680210 : mp_obj_fun_bc_t *self = MP_OBJ_TO_PTR(self_in);
248 : :
249 : 7680210 : size_t n_state, state_size;
250 [ + + ]: 7948799 : DECODE_CODESTATE_SIZE(self->bytecode, n_state, state_size);
251 : :
252 : : // allocate state for locals and stack
253 : 7680210 : mp_code_state_t *code_state = NULL;
254 : : #if MICROPY_ENABLE_PYSTACK
255 : : code_state = mp_pystack_alloc(sizeof(mp_code_state_t) + state_size);
256 : : #else
257 [ + + ]: 7680210 : if (state_size > VM_MAX_STATE_ON_STACK) {
258 : 248262 : code_state = m_new_obj_var_maybe(mp_code_state_t, byte, state_size);
259 : : #if MICROPY_DEBUG_VM_STACK_OVERFLOW
260 : : if (code_state != NULL) {
261 : : memset(code_state->state, 0, state_size);
262 : : }
263 : : #endif
264 : : }
265 [ + + ]: 249319 : if (code_state == NULL) {
266 : 7431964 : code_state = alloca(sizeof(mp_code_state_t) + state_size);
267 : : #if MICROPY_DEBUG_VM_STACK_OVERFLOW
268 : : memset(code_state->state, 0, state_size);
269 : : #endif
270 : 7431964 : state_size = 0; // indicate that we allocated using alloca
271 : : }
272 : : #endif
273 : :
274 : 7681267 : INIT_CODESTATE(code_state, self, n_state, n_args, n_kw, args);
275 : :
276 : : // execute the byte code with the correct globals context
277 : 8094727 : mp_globals_set(self->context->module.globals);
278 : 7981319 : mp_vm_return_kind_t vm_return_kind = mp_execute_bytecode(code_state, MP_OBJ_NULL);
279 : 7589083 : mp_globals_set(code_state->old_globals);
280 : :
281 : : #if MICROPY_DEBUG_VM_STACK_OVERFLOW
282 : : if (vm_return_kind == MP_VM_RETURN_NORMAL) {
283 : : if (code_state->sp < code_state->state) {
284 : : mp_printf(MICROPY_DEBUG_PRINTER, "VM stack underflow: " INT_FMT "\n", code_state->sp - code_state->state);
285 : : assert(0);
286 : : }
287 : : }
288 : : const byte *bytecode_ptr = self->bytecode;
289 : : size_t n_state_unused, n_exc_stack_unused, scope_flags_unused;
290 : : size_t n_pos_args, n_kwonly_args, n_def_args_unused;
291 : : MP_BC_PRELUDE_SIG_DECODE_INTO(bytecode_ptr, n_state_unused, n_exc_stack_unused,
292 : : scope_flags_unused, n_pos_args, n_kwonly_args, n_def_args_unused);
293 : : // We can't check the case when an exception is returned in state[0]
294 : : // and there are no arguments, because in this case our detection slot may have
295 : : // been overwritten by the returned exception (which is allowed).
296 : : if (!(vm_return_kind == MP_VM_RETURN_EXCEPTION && n_pos_args + n_kwonly_args == 0)) {
297 : : // Just check to see that we have at least 1 null object left in the state.
298 : : bool overflow = true;
299 : : for (size_t i = 0; i < n_state - n_pos_args - n_kwonly_args; ++i) {
300 : : if (code_state->state[i] == MP_OBJ_NULL) {
301 : : overflow = false;
302 : : break;
303 : : }
304 : : }
305 : : if (overflow) {
306 : : mp_printf(MICROPY_DEBUG_PRINTER, "VM stack overflow state=%p n_state+1=" UINT_FMT "\n", code_state->state, n_state);
307 : : assert(0);
308 : : }
309 : : }
310 : : #endif
311 : :
312 : 7974235 : mp_obj_t result;
313 [ + + ]: 7974235 : if (vm_return_kind == MP_VM_RETURN_NORMAL) {
314 : : // return value is in *sp
315 : 7912033 : result = *code_state->sp;
316 : : } else {
317 : : // must be an exception because normal functions can't yield
318 [ - + ]: 62202 : assert(vm_return_kind == MP_VM_RETURN_EXCEPTION);
319 : : // returned exception is in state[0]
320 : 62202 : result = code_state->state[0];
321 : : }
322 : :
323 : : #if MICROPY_ENABLE_PYSTACK
324 : : mp_pystack_free(code_state);
325 : : #else
326 : : // free the state if it was allocated on the heap
327 [ + + ]: 7974235 : if (state_size != 0) {
328 : 249216 : m_del_var(mp_code_state_t, byte, state_size, code_state);
329 : : }
330 : : #endif
331 : :
332 [ + + ]: 7974317 : if (vm_return_kind == MP_VM_RETURN_NORMAL) {
333 : 7912115 : return result;
334 : : } else { // MP_VM_RETURN_EXCEPTION
335 : 62202 : nlr_raise(result);
336 : : }
337 : : }
338 : :
339 : : #if MICROPY_PY_FUNCTION_ATTRS
340 : 8873 : void mp_obj_fun_bc_attr(mp_obj_t self_in, qstr attr, mp_obj_t *dest) {
341 [ + + ]: 8873 : if (dest[0] != MP_OBJ_NULL) {
342 : : // not load attribute
343 : : return;
344 : : }
345 [ + + ]: 8863 : if (attr == MP_QSTR___name__) {
346 : 26 : dest[0] = MP_OBJ_NEW_QSTR(mp_obj_fun_get_name(self_in));
347 : : }
348 [ + + ]: 8863 : if (attr == MP_QSTR___globals__) {
349 : 32 : mp_obj_fun_bc_t *self = MP_OBJ_TO_PTR(self_in);
350 : 32 : dest[0] = MP_OBJ_FROM_PTR(self->context->module.globals);
351 : : }
352 : : }
353 : : #endif
354 : :
355 : : #if MICROPY_CPYTHON_COMPAT
356 : : #define FUN_BC_TYPE_PRINT print, fun_bc_print,
357 : : #else
358 : : #define FUN_BC_TYPE_PRINT
359 : : #endif
360 : :
361 : : #if MICROPY_PY_FUNCTION_ATTRS
362 : : #define FUN_BC_TYPE_ATTR attr, mp_obj_fun_bc_attr,
363 : : #else
364 : : #define FUN_BC_TYPE_ATTR
365 : : #endif
366 : :
367 : : MP_DEFINE_CONST_OBJ_TYPE(
368 : : mp_type_fun_bc,
369 : : MP_QSTR_function,
370 : : MP_TYPE_FLAG_BINDS_SELF,
371 : : FUN_BC_TYPE_PRINT
372 : : FUN_BC_TYPE_ATTR
373 : : call, fun_bc_call,
374 : : unary_op, mp_generic_unary_op
375 : : );
376 : :
377 : 17423 : mp_obj_t mp_obj_new_fun_bc(const mp_obj_t *def_args, const byte *code, const mp_module_context_t *context, struct _mp_raw_code_t *const *child_table) {
378 : 17423 : size_t n_def_args = 0;
379 : 17423 : size_t n_extra_args = 0;
380 : 17423 : mp_obj_tuple_t *def_pos_args = NULL;
381 : 17423 : mp_obj_t def_kw_args = MP_OBJ_NULL;
382 [ + + + + ]: 17423 : if (def_args != NULL && def_args[0] != MP_OBJ_NULL) {
383 [ - + - + : 287 : assert(mp_obj_is_type(def_args[0], &mp_type_tuple));
- + - + +
- - + ]
384 : 287 : def_pos_args = MP_OBJ_TO_PTR(def_args[0]);
385 : 287 : n_def_args = def_pos_args->len;
386 : 287 : n_extra_args = def_pos_args->len;
387 : : }
388 [ + + + + ]: 17423 : if (def_args != NULL && def_args[1] != MP_OBJ_NULL) {
389 [ - + - + : 37 : assert(mp_obj_is_type(def_args[1], &mp_type_dict));
- + - + +
- - + ]
390 : 37 : def_kw_args = def_args[1];
391 : 37 : n_extra_args += 1;
392 : : }
393 : 17423 : mp_obj_fun_bc_t *o = mp_obj_malloc_var(mp_obj_fun_bc_t, mp_obj_t, n_extra_args, &mp_type_fun_bc);
394 : 17423 : o->bytecode = code;
395 : 17423 : o->context = context;
396 : 17423 : o->child_table = child_table;
397 [ + + ]: 17423 : if (def_pos_args != NULL) {
398 : 287 : memcpy(o->extra_args, def_pos_args->items, n_def_args * sizeof(mp_obj_t));
399 : : }
400 [ + + ]: 17423 : if (def_kw_args != MP_OBJ_NULL) {
401 : 37 : o->extra_args[n_def_args] = def_kw_args;
402 : : }
403 : 17423 : return MP_OBJ_FROM_PTR(o);
404 : : }
405 : :
406 : : /******************************************************************************/
407 : : /* native functions */
408 : :
409 : : #if MICROPY_EMIT_NATIVE
410 : :
411 : 567018 : STATIC mp_obj_t fun_native_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
412 : 567018 : MP_STACK_CHECK();
413 : 567015 : mp_obj_fun_bc_t *self = MP_OBJ_TO_PTR(self_in);
414 : 567015 : mp_call_fun_t fun = MICROPY_MAKE_POINTER_CALLABLE((void *)self->bytecode);
415 : 567015 : return fun(self_in, n_args, n_kw, args);
416 : : }
417 : :
418 : : #if MICROPY_CPYTHON_COMPAT
419 : : #define FUN_BC_TYPE_PRINT print, fun_bc_print,
420 : : #else
421 : : #define FUN_BC_TYPE_PRINT
422 : : #endif
423 : : #if MICROPY_PY_FUNCTION_ATTRS
424 : : #define FUN_BC_TYPE_ATTR attr, mp_obj_fun_bc_attr,
425 : : #else
426 : : #define FUN_BC_TYPE_ATTR
427 : : #endif
428 : :
429 : : STATIC MP_DEFINE_CONST_OBJ_TYPE(
430 : : mp_type_fun_native,
431 : : MP_QSTR_function,
432 : : MP_TYPE_FLAG_BINDS_SELF,
433 : : FUN_BC_TYPE_PRINT
434 : : FUN_BC_TYPE_ATTR
435 : : call, fun_native_call,
436 : : unary_op, mp_generic_unary_op
437 : : );
438 : :
439 : 8304 : mp_obj_t mp_obj_new_fun_native(const mp_obj_t *def_args, const void *fun_data, const mp_module_context_t *mc, struct _mp_raw_code_t *const *child_table) {
440 : 8304 : mp_obj_fun_bc_t *o = MP_OBJ_TO_PTR(mp_obj_new_fun_bc(def_args, (const byte *)fun_data, mc, child_table));
441 : 8304 : o->base.type = &mp_type_fun_native;
442 : 8304 : return MP_OBJ_FROM_PTR(o);
443 : : }
444 : :
445 : : #endif // MICROPY_EMIT_NATIVE
446 : :
447 : : /******************************************************************************/
448 : : /* inline assembler functions */
449 : :
450 : : #if MICROPY_EMIT_INLINE_ASM
451 : :
452 : : typedef struct _mp_obj_fun_asm_t {
453 : : mp_obj_base_t base;
454 : : size_t n_args;
455 : : const void *fun_data; // GC must be able to trace this pointer
456 : : mp_uint_t type_sig;
457 : : } mp_obj_fun_asm_t;
458 : :
459 : : typedef mp_uint_t (*inline_asm_fun_0_t)(void);
460 : : typedef mp_uint_t (*inline_asm_fun_1_t)(mp_uint_t);
461 : : typedef mp_uint_t (*inline_asm_fun_2_t)(mp_uint_t, mp_uint_t);
462 : : typedef mp_uint_t (*inline_asm_fun_3_t)(mp_uint_t, mp_uint_t, mp_uint_t);
463 : : typedef mp_uint_t (*inline_asm_fun_4_t)(mp_uint_t, mp_uint_t, mp_uint_t, mp_uint_t);
464 : :
465 : : // convert a MicroPython object to a sensible value for inline asm
466 : : STATIC mp_uint_t convert_obj_for_inline_asm(mp_obj_t obj) {
467 : : // TODO for byte_array, pass pointer to the array
468 : : if (mp_obj_is_small_int(obj)) {
469 : : return MP_OBJ_SMALL_INT_VALUE(obj);
470 : : } else if (obj == mp_const_none) {
471 : : return 0;
472 : : } else if (obj == mp_const_false) {
473 : : return 0;
474 : : } else if (obj == mp_const_true) {
475 : : return 1;
476 : : } else if (mp_obj_is_exact_type(obj, &mp_type_int)) {
477 : : return mp_obj_int_get_truncated(obj);
478 : : } else if (mp_obj_is_str(obj)) {
479 : : // pointer to the string (it's probably constant though!)
480 : : size_t l;
481 : : return (mp_uint_t)mp_obj_str_get_data(obj, &l);
482 : : } else {
483 : : const mp_obj_type_t *type = mp_obj_get_type(obj);
484 : : #if MICROPY_PY_BUILTINS_FLOAT
485 : : if (type == &mp_type_float) {
486 : : // convert float to int (could also pass in float registers)
487 : : return (mp_int_t)mp_obj_float_get(obj);
488 : : }
489 : : #endif
490 : : if (type == &mp_type_tuple || type == &mp_type_list) {
491 : : // pointer to start of tuple (could pass length, but then could use len(x) for that)
492 : : size_t len;
493 : : mp_obj_t *items;
494 : : mp_obj_get_array(obj, &len, &items);
495 : : return (mp_uint_t)items;
496 : : } else {
497 : : mp_buffer_info_t bufinfo;
498 : : if (mp_get_buffer(obj, &bufinfo, MP_BUFFER_READ)) {
499 : : // supports the buffer protocol, return a pointer to the data
500 : : return (mp_uint_t)bufinfo.buf;
501 : : } else {
502 : : // just pass along a pointer to the object
503 : : return (mp_uint_t)obj;
504 : : }
505 : : }
506 : : }
507 : : }
508 : :
509 : : STATIC mp_obj_t fun_asm_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
510 : : mp_obj_fun_asm_t *self = MP_OBJ_TO_PTR(self_in);
511 : :
512 : : mp_arg_check_num(n_args, n_kw, self->n_args, self->n_args, false);
513 : :
514 : : const void *fun = MICROPY_MAKE_POINTER_CALLABLE(self->fun_data);
515 : :
516 : : mp_uint_t ret;
517 : : if (n_args == 0) {
518 : : ret = ((inline_asm_fun_0_t)fun)();
519 : : } else if (n_args == 1) {
520 : : ret = ((inline_asm_fun_1_t)fun)(convert_obj_for_inline_asm(args[0]));
521 : : } else if (n_args == 2) {
522 : : ret = ((inline_asm_fun_2_t)fun)(convert_obj_for_inline_asm(args[0]), convert_obj_for_inline_asm(args[1]));
523 : : } else if (n_args == 3) {
524 : : ret = ((inline_asm_fun_3_t)fun)(convert_obj_for_inline_asm(args[0]), convert_obj_for_inline_asm(args[1]), convert_obj_for_inline_asm(args[2]));
525 : : } else {
526 : : // compiler allows at most 4 arguments
527 : : assert(n_args == 4);
528 : : ret = ((inline_asm_fun_4_t)fun)(
529 : : convert_obj_for_inline_asm(args[0]),
530 : : convert_obj_for_inline_asm(args[1]),
531 : : convert_obj_for_inline_asm(args[2]),
532 : : convert_obj_for_inline_asm(args[3])
533 : : );
534 : : }
535 : :
536 : : return mp_native_to_obj(ret, self->type_sig);
537 : : }
538 : :
539 : : STATIC MP_DEFINE_CONST_OBJ_TYPE(
540 : : mp_type_fun_asm,
541 : : MP_QSTR_function,
542 : : MP_TYPE_FLAG_BINDS_SELF,
543 : : call, fun_asm_call,
544 : : unary_op, mp_generic_unary_op
545 : : );
546 : :
547 : : mp_obj_t mp_obj_new_fun_asm(size_t n_args, const void *fun_data, mp_uint_t type_sig) {
548 : : mp_obj_fun_asm_t *o = mp_obj_malloc(mp_obj_fun_asm_t, &mp_type_fun_asm);
549 : : o->n_args = n_args;
550 : : o->fun_data = fun_data;
551 : : o->type_sig = type_sig;
552 : : return MP_OBJ_FROM_PTR(o);
553 : : }
554 : :
555 : : #endif // MICROPY_EMIT_INLINE_ASM
|