nativeglue.h 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. /*
  2. * This file is part of the MicroPython project, http://micropython.org/
  3. *
  4. * The MIT License (MIT)
  5. *
  6. * Copyright (c) 2013-2019 Damien P. George
  7. *
  8. * Permission is hereby granted, free of charge, to any person obtaining a copy
  9. * of this software and associated documentation files (the "Software"), to deal
  10. * in the Software without restriction, including without limitation the rights
  11. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12. * copies of the Software, and to permit persons to whom the Software is
  13. * furnished to do so, subject to the following conditions:
  14. *
  15. * The above copyright notice and this permission notice shall be included in
  16. * all copies or substantial portions of the Software.
  17. *
  18. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24. * THE SOFTWARE.
  25. */
  26. #ifndef MICROPY_INCLUDED_PY_NATIVEGLUE_H
  27. #define MICROPY_INCLUDED_PY_NATIVEGLUE_H
  28. #include <stdarg.h>
  29. #include "py/obj.h"
  30. #include "py/persistentcode.h"
  31. #include "py/stream.h"
  32. typedef enum {
  33. MP_F_CONST_NONE_OBJ = 0,
  34. MP_F_CONST_FALSE_OBJ,
  35. MP_F_CONST_TRUE_OBJ,
  36. MP_F_CONVERT_OBJ_TO_NATIVE,
  37. MP_F_CONVERT_NATIVE_TO_OBJ,
  38. MP_F_NATIVE_SWAP_GLOBALS,
  39. MP_F_LOAD_NAME,
  40. MP_F_LOAD_GLOBAL,
  41. MP_F_LOAD_BUILD_CLASS,
  42. MP_F_LOAD_ATTR,
  43. MP_F_LOAD_METHOD,
  44. MP_F_LOAD_SUPER_METHOD,
  45. MP_F_STORE_NAME,
  46. MP_F_STORE_GLOBAL,
  47. MP_F_STORE_ATTR,
  48. MP_F_OBJ_SUBSCR,
  49. MP_F_OBJ_IS_TRUE,
  50. MP_F_UNARY_OP,
  51. MP_F_BINARY_OP,
  52. MP_F_BUILD_TUPLE,
  53. MP_F_BUILD_LIST,
  54. MP_F_BUILD_MAP,
  55. MP_F_BUILD_SET,
  56. MP_F_STORE_SET,
  57. MP_F_LIST_APPEND,
  58. MP_F_STORE_MAP,
  59. MP_F_MAKE_FUNCTION_FROM_PROTO_FUN,
  60. MP_F_NATIVE_CALL_FUNCTION_N_KW,
  61. MP_F_CALL_METHOD_N_KW,
  62. MP_F_CALL_METHOD_N_KW_VAR,
  63. MP_F_NATIVE_GETITER,
  64. MP_F_NATIVE_ITERNEXT,
  65. MP_F_NLR_PUSH,
  66. MP_F_NLR_POP,
  67. MP_F_NATIVE_RAISE,
  68. MP_F_IMPORT_NAME,
  69. MP_F_IMPORT_FROM,
  70. MP_F_IMPORT_ALL,
  71. MP_F_NEW_SLICE,
  72. MP_F_UNPACK_SEQUENCE,
  73. MP_F_UNPACK_EX,
  74. MP_F_DELETE_NAME,
  75. MP_F_DELETE_GLOBAL,
  76. MP_F_NEW_CLOSURE,
  77. MP_F_ARG_CHECK_NUM_SIG,
  78. MP_F_SETUP_CODE_STATE,
  79. MP_F_SMALL_INT_FLOOR_DIVIDE,
  80. MP_F_SMALL_INT_MODULO,
  81. MP_F_NATIVE_YIELD_FROM,
  82. MP_F_SETJMP,
  83. MP_F_NUMBER_OF,
  84. } mp_fun_kind_t;
  85. typedef struct _mp_fun_table_t {
  86. mp_const_obj_t const_none;
  87. mp_const_obj_t const_false;
  88. mp_const_obj_t const_true;
  89. mp_uint_t (*native_from_obj)(mp_obj_t obj, mp_uint_t type);
  90. mp_obj_t (*native_to_obj)(mp_uint_t val, mp_uint_t type);
  91. mp_obj_dict_t *(*swap_globals)(mp_obj_dict_t * new_globals);
  92. mp_obj_t (*load_name)(qstr qst);
  93. mp_obj_t (*load_global)(qstr qst);
  94. mp_obj_t (*load_build_class)(void);
  95. mp_obj_t (*load_attr)(mp_obj_t base, qstr attr);
  96. void (*load_method)(mp_obj_t base, qstr attr, mp_obj_t *dest);
  97. void (*load_super_method)(qstr attr, mp_obj_t *dest);
  98. void (*store_name)(qstr qst, mp_obj_t obj);
  99. void (*store_global)(qstr qst, mp_obj_t obj);
  100. void (*store_attr)(mp_obj_t base, qstr attr, mp_obj_t val);
  101. mp_obj_t (*obj_subscr)(mp_obj_t base, mp_obj_t index, mp_obj_t val);
  102. bool (*obj_is_true)(mp_obj_t arg);
  103. mp_obj_t (*unary_op)(mp_unary_op_t op, mp_obj_t arg);
  104. mp_obj_t (*binary_op)(mp_binary_op_t op, mp_obj_t lhs, mp_obj_t rhs);
  105. mp_obj_t (*new_tuple)(size_t n, const mp_obj_t *items);
  106. mp_obj_t (*new_list)(size_t n, mp_obj_t *items);
  107. mp_obj_t (*new_dict)(size_t n_args);
  108. mp_obj_t (*new_set)(size_t n_args, mp_obj_t *items);
  109. void (*set_store)(mp_obj_t self_in, mp_obj_t item);
  110. mp_obj_t (*list_append)(mp_obj_t self_in, mp_obj_t arg);
  111. mp_obj_t (*dict_store)(mp_obj_t self_in, mp_obj_t key, mp_obj_t value);
  112. mp_obj_t (*make_function_from_proto_fun)(mp_proto_fun_t proto_fun, const mp_module_context_t *cm, const mp_obj_t *def_args);
  113. mp_obj_t (*call_function_n_kw)(mp_obj_t fun_in, size_t n_args_kw, const mp_obj_t *args);
  114. mp_obj_t (*call_method_n_kw)(size_t n_args, size_t n_kw, const mp_obj_t *args);
  115. mp_obj_t (*call_method_n_kw_var)(bool have_self, size_t n_args_n_kw, const mp_obj_t *args);
  116. mp_obj_t (*getiter)(mp_obj_t obj, mp_obj_iter_buf_t *iter);
  117. mp_obj_t (*iternext)(mp_obj_iter_buf_t *iter);
  118. unsigned int (*nlr_push)(nlr_buf_t *);
  119. void (*nlr_pop)(void);
  120. void (*raise)(mp_obj_t o);
  121. mp_obj_t (*import_name)(qstr name, mp_obj_t fromlist, mp_obj_t level);
  122. mp_obj_t (*import_from)(mp_obj_t module, qstr name);
  123. void (*import_all)(mp_obj_t module);
  124. mp_obj_t (*new_slice)(mp_obj_t start, mp_obj_t stop, mp_obj_t step);
  125. void (*unpack_sequence)(mp_obj_t seq, size_t num, mp_obj_t *items);
  126. void (*unpack_ex)(mp_obj_t seq, size_t num, mp_obj_t *items);
  127. void (*delete_name)(qstr qst);
  128. void (*delete_global)(qstr qst);
  129. mp_obj_t (*new_closure)(mp_obj_t fun, size_t n_closed_over, const mp_obj_t *closed);
  130. void (*arg_check_num_sig)(size_t n_args, size_t n_kw, uint32_t sig);
  131. void (*setup_code_state_native)(mp_code_state_native_t *code_state, size_t n_args, size_t n_kw, const mp_obj_t *args);
  132. mp_int_t (*small_int_floor_divide)(mp_int_t num, mp_int_t denom);
  133. mp_int_t (*small_int_modulo)(mp_int_t dividend, mp_int_t divisor);
  134. bool (*yield_from)(mp_obj_t gen, mp_obj_t send_value, mp_obj_t *ret_value);
  135. void *setjmp_;
  136. // Additional entries for dynamic runtime, starts at index 50
  137. void *(*memset_)(void *s, int c, size_t n);
  138. void *(*memmove_)(void *dest, const void *src, size_t n);
  139. void *(*realloc_)(void *ptr, size_t n_bytes, bool allow_move);
  140. int (*printf_)(const mp_print_t *print, const char *fmt, ...);
  141. int (*vprintf_)(const mp_print_t *print, const char *fmt, va_list args);
  142. #if defined(__GNUC__)
  143. NORETURN // Only certain compilers support no-return attributes in function pointer declarations
  144. #endif
  145. void (*raise_msg)(const mp_obj_type_t *exc_type, mp_rom_error_text_t msg);
  146. const mp_obj_type_t *(*obj_get_type)(mp_const_obj_t o_in);
  147. mp_obj_t (*obj_new_str)(const char *data, size_t len);
  148. mp_obj_t (*obj_new_bytes)(const byte *data, size_t len);
  149. mp_obj_t (*obj_new_bytearray_by_ref)(size_t n, void *items);
  150. mp_obj_t (*obj_new_float_from_f)(float f);
  151. mp_obj_t (*obj_new_float_from_d)(double d);
  152. float (*obj_get_float_to_f)(mp_obj_t o);
  153. double (*obj_get_float_to_d)(mp_obj_t o);
  154. void (*load_method_maybe)(mp_obj_t base, qstr attr, mp_obj_t *dest);
  155. bool (*get_buffer)(mp_obj_t obj, mp_buffer_info_t *bufinfo, mp_uint_t flags);
  156. const mp_stream_p_t *(*get_stream_raise)(mp_obj_t self_in, int flags);
  157. void (*arg_parse_all)(size_t n_pos, const mp_obj_t *pos, mp_map_t *kws, size_t n_allowed, const mp_arg_t *allowed, mp_arg_val_t *out_vals);
  158. void (*arg_parse_all_kw_array)(size_t n_pos, size_t n_kw, const mp_obj_t *args, size_t n_allowed, const mp_arg_t *allowed, mp_arg_val_t *out_vals);
  159. size_t (*binary_get_size)(char struct_type, char val_type, size_t *palign);
  160. mp_obj_t (*binary_get_val_array)(char typecode, void *p, size_t index);
  161. void (*binary_set_val_array)(char typecode, void *p, size_t index, mp_obj_t val_in);
  162. const mp_print_t *plat_print;
  163. // The following entries start at index 73 and are referenced by tools-mpy_ld.py,
  164. // see constant MP_FUN_TABLE_MP_TYPE_TYPE_OFFSET.
  165. const mp_obj_type_t *type_type;
  166. const mp_obj_type_t *type_str;
  167. const mp_obj_type_t *type_list;
  168. const mp_obj_type_t *type_dict;
  169. const mp_obj_type_t *type_fun_builtin_0;
  170. const mp_obj_type_t *type_fun_builtin_1;
  171. const mp_obj_type_t *type_fun_builtin_2;
  172. const mp_obj_type_t *type_fun_builtin_3;
  173. const mp_obj_type_t *type_fun_builtin_var;
  174. const mp_obj_type_t *type_Exception;
  175. const mp_obj_fun_builtin_var_t *stream_read_obj;
  176. const mp_obj_fun_builtin_var_t *stream_readinto_obj;
  177. const mp_obj_fun_builtin_var_t *stream_unbuffered_readline_obj;
  178. const mp_obj_fun_builtin_var_t *stream_write_obj;
  179. } mp_fun_table_t;
  180. #if (MICROPY_EMIT_NATIVE && !MICROPY_DYNAMIC_COMPILER) || MICROPY_ENABLE_DYNRUNTIME
  181. extern const mp_fun_table_t mp_fun_table;
  182. #elif MICROPY_EMIT_NATIVE && MICROPY_DYNAMIC_COMPILER
  183. // In dynamic-compiler mode eliminate dependency on entries in mp_fun_table.
  184. // This only needs to be an independent pointer, content doesn't matter.
  185. extern const int mp_fun_table;
  186. #endif
  187. #endif // MICROPY_INCLUDED_PY_NATIVEGLUE_H