mpconfigport.h 12.7 KB
Newer Older
1
/*
2
 * This file is part of the MicroPython project, http://micropython.org/
3
4
5
 *
 * The MIT License (MIT)
 *
6
 * Copyright (c) 2013-2017 Damien P. George
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

27
28
29
// Options to control how MicroPython is built for this port,
// overriding defaults in py/mpconfig.h.

30
31
32
33
#pragma once
#ifndef __INCLUDED_MPCONFIGPORT_H
#define __INCLUDED_MPCONFIGPORT_H

34
35
36
// board specific definitions
#include "mpconfigboard.h"

37
// memory allocation policies
38
#define MICROPY_ALLOC_PATH_MAX      (128)
39
40

// emitters
41
#define MICROPY_PERSISTENT_CODE_LOAD (1)
42
43
#define MICROPY_EMIT_THUMB          (1)
#define MICROPY_EMIT_INLINE_THUMB   (1)
44
45

// compiler configuration
46
#define MICROPY_COMP_MODULE_CONST   (1)
47
#define MICROPY_COMP_TRIPLE_TUPLE_ASSIGN (1)
48
49
50
51
52
53
54

// optimisations
#define MICROPY_OPT_COMPUTED_GOTO   (1)
#define MICROPY_OPT_CACHE_MAP_LOOKUP_IN_BYTECODE (0)
#define MICROPY_OPT_MPZ_BITWISE     (1)

// Python internal features
55
#define MICROPY_READER_VFS          (1)
56
#define MICROPY_ENABLE_GC           (1)
57
#define MICROPY_ENABLE_FINALISER    (1)
58
#define MICROPY_STACK_CHECK         (1)
59
60
#define MICROPY_ENABLE_EMERGENCY_EXCEPTION_BUF (1)
#define MICROPY_EMERGENCY_EXCEPTION_BUF_SIZE (0)
61
#define MICROPY_KBD_EXCEPTION       (1)
62
#define MICROPY_HELPER_REPL         (1)
63
#define MICROPY_REPL_EMACS_KEYS     (1)
64
#define MICROPY_REPL_AUTO_INDENT    (1)
65
#define MICROPY_LONGINT_IMPL        (MICROPY_LONGINT_IMPL_MPZ)
66
#define MICROPY_ENABLE_SOURCE_LINE  (1)
67
#define MICROPY_FLOAT_IMPL          (MICROPY_FLOAT_IMPL_FLOAT)
68
#define MICROPY_STREAMS_NON_BLOCK   (1)
69
#define MICROPY_MODULE_WEAK_LINKS   (1)
70
#define MICROPY_CAN_OVERRIDE_BUILTINS (1)
71
#define MICROPY_USE_INTERNAL_ERRNO  (1)
72
73
#define MICROPY_ENABLE_SCHEDULER    (1)
#define MICROPY_SCHEDULER_DEPTH     (8)
74
75
#define MICROPY_VFS                 (1)
#define MICROPY_VFS_FAT             (1)
76
77

// control over Python builtins
78
#define MICROPY_PY_FUNCTION_ATTRS   (1)
79
#define MICROPY_PY_BUILTINS_STR_UNICODE (1)
80
81
#define MICROPY_PY_BUILTINS_STR_CENTER (1)
#define MICROPY_PY_BUILTINS_STR_PARTITION (1)
82
#define MICROPY_PY_BUILTINS_STR_SPLITLINES (1)
83
#define MICROPY_PY_BUILTINS_MEMORYVIEW (1)
84
#define MICROPY_PY_BUILTINS_FROZENSET (1)
85
86
#define MICROPY_PY_BUILTINS_SLICE_ATTRS (1)
#define MICROPY_PY_ALL_SPECIAL_METHODS (1)
87
#define MICROPY_PY_BUILTINS_COMPILE (1)
88
#define MICROPY_PY_BUILTINS_EXECFILE (1)
89
#define MICROPY_PY_BUILTINS_POW3    (1)
90
91
#define MICROPY_PY_BUILTINS_HELP    (1)
#define MICROPY_PY_BUILTINS_HELP_TEXT stmhal_help_text
92
#define MICROPY_PY_BUILTINS_HELP_MODULES (1)
93
#define MICROPY_PY_MICROPYTHON_MEM_INFO (1)
94
#define MICROPY_PY_ARRAY_SLICE_ASSIGN (1)
95
96
97
98
99
#define MICROPY_PY_COLLECTIONS_ORDEREDDICT (1)
#define MICROPY_PY_MATH_SPECIAL_FUNCTIONS (1)
#define MICROPY_PY_CMATH            (1)
#define MICROPY_PY_IO               (1)
#define MICROPY_PY_IO_FILEIO        (1)
100
#define MICROPY_PY_SYS_MAXSIZE      (1)
101
#define MICROPY_PY_SYS_EXIT         (1)
102
#define MICROPY_PY_SYS_STDFILES     (1)
103
#define MICROPY_PY_SYS_STDIO_BUFFER (1)
104
105
106
#ifndef MICROPY_PY_SYS_PLATFORM     // let boards override it if they want
#define MICROPY_PY_SYS_PLATFORM     "pyboard"
#endif
107
#define MICROPY_PY_UERRNO           (1)
108
109
#define MICROPY_PY_THREAD           (0)
#define MICROPY_PY_THREAD_GIL       (0)
110
111

// extended modules
112
#define MICROPY_PY_UCTYPES          (1)
113
#define MICROPY_PY_UZLIB            (1)
114
#define MICROPY_PY_UJSON            (1)
115
#define MICROPY_PY_URE              (1)
Damien George's avatar
Damien George committed
116
#define MICROPY_PY_UHEAPQ           (1)
117
#define MICROPY_PY_UHASHLIB         (1)
118
119
120
121
122
#define MICROPY_PY_UBINASCII        (1)
#define MICROPY_PY_URANDOM          (1)
#define MICROPY_PY_URANDOM_EXTRA_FUNCS (1)
#define MICROPY_PY_USELECT          (1)
#define MICROPY_PY_UTIMEQ           (1)
123
#define MICROPY_PY_UTIME_MP_HAL     (1)
124
#define MICROPY_PY_MACHINE          (1)
125
#define MICROPY_PY_MACHINE_PULSE    (1)
126
#define MICROPY_PY_MACHINE_I2C      (1)
127
#define MICROPY_PY_MACHINE_I2C_MAKE_NEW machine_hard_i2c_make_new
128
#define MICROPY_PY_MACHINE_SPI      (1)
129
130
131
#define MICROPY_PY_MACHINE_SPI_MSB  (SPI_FIRSTBIT_MSB)
#define MICROPY_PY_MACHINE_SPI_LSB  (SPI_FIRSTBIT_LSB)
#define MICROPY_PY_MACHINE_SPI_MAKE_NEW machine_hard_spi_make_new
132
#define MICROPY_PY_MACHINE_SPI_MIN_DELAY (0)
133
#define MICROPY_PY_MACHINE_SPI_MAX_BAUDRATE (HAL_RCC_GetSysClockFreq() / 48)
134
#define MICROPY_PY_FRAMEBUF         (1)
135
136
137
138
139
140
141
#ifndef MICROPY_PY_USOCKET
#define MICROPY_PY_USOCKET          (1)
#endif
#ifndef MICROPY_PY_NETWORK
#define MICROPY_PY_NETWORK          (1)
#endif

142
143
144
145
146
147
// fatfs configuration used in ffconf.h
#define MICROPY_FATFS_ENABLE_LFN       (1)
#define MICROPY_FATFS_LFN_CODE_PAGE    (437) /* 1=SFN/ANSI 437=LFN/U.S.(OEM) */
#define MICROPY_FATFS_USE_LABEL        (1)
#define MICROPY_FATFS_RPATH            (2)
#define MICROPY_FATFS_MULTI_PARTITION  (1)
148
149
150
151
152
153
154
155
156

// TODO these should be generic, not bound to fatfs
#define mp_type_fileio fatfs_type_fileio
#define mp_type_textio fatfs_type_textio

// use vfs's functions for import stat and builtin open
#define mp_import_stat mp_vfs_import_stat
#define mp_builtin_open mp_vfs_open
#define mp_builtin_open_obj mp_vfs_open_obj
157

158
// extra built in names to add to the global namespace
159
#define MICROPY_PORT_BUILTINS \
160
161
    { MP_OBJ_NEW_QSTR(MP_QSTR_input), (mp_obj_t)&mp_builtin_input_obj }, \
    { MP_OBJ_NEW_QSTR(MP_QSTR_open), (mp_obj_t)&mp_builtin_open_obj },
162

163
// extra built in modules to add to the list of known ones
164
extern const struct _mp_obj_module_t machine_module;
165
extern const struct _mp_obj_module_t pyb_module;
166
extern const struct _mp_obj_module_t stm_module;
167
extern const struct _mp_obj_module_t mp_module_ubinascii;
168
extern const struct _mp_obj_module_t mp_module_ure;
169
extern const struct _mp_obj_module_t mp_module_uzlib;
170
extern const struct _mp_obj_module_t mp_module_ujson;
171
172
extern const struct _mp_obj_module_t mp_module_uheapq;
extern const struct _mp_obj_module_t mp_module_uhashlib;
173
174
extern const struct _mp_obj_module_t mp_module_uos;
extern const struct _mp_obj_module_t mp_module_utime;
175
176
extern const struct _mp_obj_module_t mp_module_usocket;
extern const struct _mp_obj_module_t mp_module_network;
177

178
179
180
181
182
183
184
185
186
187
188
189
190
191
#if MICROPY_PY_USOCKET
#define SOCKET_BUILTIN_MODULE               { MP_OBJ_NEW_QSTR(MP_QSTR_usocket), (mp_obj_t)&mp_module_usocket },
#define SOCKET_BUILTIN_MODULE_WEAK_LINKS    { MP_OBJ_NEW_QSTR(MP_QSTR_socket), (mp_obj_t)&mp_module_usocket },
#else
#define SOCKET_BUILTIN_MODULE
#define SOCKET_BUILTIN_MODULE_WEAK_LINKS
#endif

#if MICROPY_PY_NETWORK
#define NETWORK_BUILTIN_MODULE              { MP_OBJ_NEW_QSTR(MP_QSTR_network), (mp_obj_t)&mp_module_network },
#else
#define NETWORK_BUILTIN_MODULE
#endif

192
#define MICROPY_PORT_BUILTIN_MODULES \
193
    { MP_OBJ_NEW_QSTR(MP_QSTR_umachine), (mp_obj_t)&machine_module }, \
194
    { MP_OBJ_NEW_QSTR(MP_QSTR_pyb), (mp_obj_t)&pyb_module }, \
195
    { MP_OBJ_NEW_QSTR(MP_QSTR_stm), (mp_obj_t)&stm_module }, \
196
197
    { MP_OBJ_NEW_QSTR(MP_QSTR_uos), (mp_obj_t)&mp_module_uos }, \
    { MP_OBJ_NEW_QSTR(MP_QSTR_utime), (mp_obj_t)&mp_module_utime }, \
198
199
    SOCKET_BUILTIN_MODULE \
    NETWORK_BUILTIN_MODULE \
200

201
#define MICROPY_PORT_BUILTIN_MODULE_WEAK_LINKS \
202
    { MP_OBJ_NEW_QSTR(MP_QSTR_binascii), (mp_obj_t)&mp_module_ubinascii }, \
203
    { MP_OBJ_NEW_QSTR(MP_QSTR_collections), (mp_obj_t)&mp_module_collections }, \
204
    { MP_OBJ_NEW_QSTR(MP_QSTR_re), (mp_obj_t)&mp_module_ure }, \
205
    { MP_OBJ_NEW_QSTR(MP_QSTR_zlib), (mp_obj_t)&mp_module_uzlib }, \
206
    { MP_OBJ_NEW_QSTR(MP_QSTR_json), (mp_obj_t)&mp_module_ujson }, \
207
208
    { MP_OBJ_NEW_QSTR(MP_QSTR_heapq), (mp_obj_t)&mp_module_uheapq }, \
    { MP_OBJ_NEW_QSTR(MP_QSTR_hashlib), (mp_obj_t)&mp_module_uhashlib }, \
209
    { MP_OBJ_NEW_QSTR(MP_QSTR_io), (mp_obj_t)&mp_module_io }, \
210
    { MP_OBJ_NEW_QSTR(MP_QSTR_os), (mp_obj_t)&mp_module_uos }, \
211
    { MP_OBJ_NEW_QSTR(MP_QSTR_random), (mp_obj_t)&mp_module_urandom }, \
212
213
    { MP_OBJ_NEW_QSTR(MP_QSTR_time), (mp_obj_t)&mp_module_utime }, \
    { MP_OBJ_NEW_QSTR(MP_QSTR_select), (mp_obj_t)&mp_module_uselect }, \
214
    SOCKET_BUILTIN_MODULE_WEAK_LINKS \
215
    { MP_OBJ_NEW_QSTR(MP_QSTR_struct), (mp_obj_t)&mp_module_ustruct }, \
216
    { MP_OBJ_NEW_QSTR(MP_QSTR_machine), (mp_obj_t)&machine_module }, \
217
    { MP_OBJ_NEW_QSTR(MP_QSTR_errno), (mp_obj_t)&mp_module_uerrno }, \
218

219
// extra constants
220
#define MICROPY_PORT_CONSTANTS \
221
    { MP_OBJ_NEW_QSTR(MP_QSTR_umachine), (mp_obj_t)&machine_module }, \
222
    { MP_OBJ_NEW_QSTR(MP_QSTR_machine), (mp_obj_t)&machine_module }, \
223
224
225
    { MP_OBJ_NEW_QSTR(MP_QSTR_pyb), (mp_obj_t)&pyb_module }, \
    { MP_OBJ_NEW_QSTR(MP_QSTR_stm), (mp_obj_t)&stm_module }, \

226
#if defined(MCU_SERIES_F7)
227
#define PYB_EXTI_NUM_VECTORS (24)
228
#define MICROPY_HW_MAX_UART (8)
229
#else
230
#define PYB_EXTI_NUM_VECTORS (23)
231
#define MICROPY_HW_MAX_UART (6)
232
#endif
233
234
235
236
237
238

#define MP_STATE_PORT MP_STATE_VM

#define MICROPY_PORT_ROOT_POINTERS \
    const char *readline_hist[8]; \
    \
239
    mp_obj_t pyb_hid_report_desc; \
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
    \
    mp_obj_t pyb_config_main; \
    \
    mp_obj_t pyb_switch_callback; \
    \
    mp_obj_t pin_class_mapper; \
    mp_obj_t pin_class_map_dict; \
    \
    mp_obj_t pyb_extint_callback[PYB_EXTI_NUM_VECTORS]; \
    \
    /* Used to do callbacks to Python code on interrupt */ \
    struct _pyb_timer_obj_t *pyb_timer_obj_all[14]; \
    \
    /* stdio is repeated on this UART object if it's not null */ \
    struct _pyb_uart_obj_t *pyb_stdio_uart; \
    \
    /* pointers to all UART objects (if they have been created) */ \
257
    struct _pyb_uart_obj_t *pyb_uart_obj_all[MICROPY_HW_MAX_UART]; \
258
    \
259
260
261
    /* pointers to all CAN objects (if they have been created) */ \
    struct _pyb_can_obj_t *pyb_can_obj_all[2]; \
    \
262
263
    /* list of registered NICs */ \
    mp_obj_list_t mod_network_nic_list; \
264

265
266
267
268
// type definitions for the specific machine

#define BYTES_PER_WORD (4)

269
270
#define MICROPY_MAKE_POINTER_CALLABLE(p) ((void*)((mp_uint_t)(p) | 1))

271
272
#define MP_SSIZE_MAX (0x7fffffff)

273
274
#define UINT_FMT "%u"
#define INT_FMT "%d"
275

276
277
typedef int mp_int_t; // must be pointer size
typedef unsigned int mp_uint_t; // must be pointer size
278
typedef long mp_off_t;
279

280
281
#define MP_PLAT_PRINT_STRN(str, len) mp_hal_stdout_tx_strn_cooked(str, len)

282
283
284
285
286
287
288
289
// We have inlined IRQ functions for efficiency (they are generally
// 1 machine instruction).
//
// Note on IRQ state: you should not need to know the specific
// value of the state variable, but rather just pass the return
// value from disable_irq back to enable_irq.  If you really need
// to know the machine-specific values, see irq.h.

290
#include STM32_HAL_H
291
292
293
294

static inline void enable_irq(mp_uint_t state) {
    __set_PRIMASK(state);
}
Dave Hylands's avatar
Dave Hylands committed
295

296
297
298
299
300
301
302
303
static inline mp_uint_t disable_irq(void) {
    mp_uint_t state = __get_PRIMASK();
    __disable_irq();
    return state;
}

#define MICROPY_BEGIN_ATOMIC_SECTION()     disable_irq()
#define MICROPY_END_ATOMIC_SECTION(state)  enable_irq(state)
304
305
306
307

#if MICROPY_PY_THREAD
#define MICROPY_EVENT_POLL_HOOK \
    do { \
308
309
        extern void mp_handle_pending(void); \
        mp_handle_pending(); \
310
311
312
313
314
315
316
317
318
        if (pyb_thread_enabled) { \
            MP_THREAD_GIL_EXIT(); \
            pyb_thread_yield(); \
            MP_THREAD_GIL_ENTER(); \
        } else { \
            __WFI(); \
        } \
    } while (0);
#else
319
320
321
322
323
324
#define MICROPY_EVENT_POLL_HOOK \
    do { \
        extern void mp_handle_pending(void); \
        mp_handle_pending(); \
        __WFI(); \
    } while (0);
325
#endif
Dave Hylands's avatar
Dave Hylands committed
326

327
328
329
330
// There is no classical C heap in bare-metal ports, only Python
// garbage-collected heap. For completeness, emulate C heap via
// GC heap. Note that MicroPython core never uses malloc() and friends,
// so these defines are mostly to help extension module writers.
331
332
333
#define malloc(n) m_malloc(n)
#define free(p) m_free(p)
#define realloc(p, n) m_realloc(p, n)
334

335
336
// see stm32f4XX_hal_conf.h USE_USB_FS & USE_USB_HS
// at the moment only USB_FS is supported
337
338
#define USE_DEVICE_MODE
//#define USE_HOST_MODE
339

340
341
// We need to provide a declaration/definition of alloca()
#include <alloca.h>
Dave Hylands's avatar
Dave Hylands committed
342

343
#define MICROPY_PIN_DEFS_PORT_H "pin_defs_stmhal.h"
344
345

#endif // __INCLUDED_MPCONFIGPORT_H