Skip to content

Commit df4ce93

Browse files
committed
py/modmicropython: Add stack_use, heap_lock and heap_unlock functions.
micropython.stack_use() returns an integer being the number of bytes used on the stack. micropython.heap_lock() and heap_unlock() can be used to prevent the memory manager from allocating anything on the heap. Calls to these are allowed to be nested.
1 parent 42a6364 commit df4ce93

2 files changed

Lines changed: 35 additions & 0 deletions

File tree

py/modmicropython.c

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,8 +91,29 @@ STATIC mp_obj_t mp_micropython_qstr_info(size_t n_args, const mp_obj_t *args) {
9191
}
9292
STATIC MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(mp_micropython_qstr_info_obj, 0, 1, mp_micropython_qstr_info);
9393

94+
#if MICROPY_STACK_CHECK
95+
STATIC mp_obj_t mp_micropython_stack_use(void) {
96+
return MP_OBJ_NEW_SMALL_INT(mp_stack_usage());
97+
}
98+
STATIC MP_DEFINE_CONST_FUN_OBJ_0(mp_micropython_stack_use_obj, mp_micropython_stack_use);
99+
#endif
100+
94101
#endif // MICROPY_PY_MICROPYTHON_MEM_INFO
95102

103+
#if MICROPY_ENABLE_GC
104+
STATIC mp_obj_t mp_micropython_heap_lock(void) {
105+
gc_lock();
106+
return mp_const_none;
107+
}
108+
STATIC MP_DEFINE_CONST_FUN_OBJ_0(mp_micropython_heap_lock_obj, mp_micropython_heap_lock);
109+
110+
STATIC mp_obj_t mp_micropython_heap_unlock(void) {
111+
gc_unlock();
112+
return mp_const_none;
113+
}
114+
STATIC MP_DEFINE_CONST_FUN_OBJ_0(mp_micropython_heap_unlock_obj, mp_micropython_heap_unlock);
115+
#endif
116+
96117
#if MICROPY_ENABLE_EMERGENCY_EXCEPTION_BUF && (MICROPY_EMERGENCY_EXCEPTION_BUF_SIZE == 0)
97118
STATIC MP_DEFINE_CONST_FUN_OBJ_1(mp_alloc_emergency_exception_buf_obj, mp_alloc_emergency_exception_buf);
98119
#endif
@@ -107,10 +128,17 @@ STATIC const mp_rom_map_elem_t mp_module_micropython_globals_table[] = {
107128
#endif
108129
{ MP_ROM_QSTR(MP_QSTR_mem_info), MP_ROM_PTR(&mp_micropython_mem_info_obj) },
109130
{ MP_ROM_QSTR(MP_QSTR_qstr_info), MP_ROM_PTR(&mp_micropython_qstr_info_obj) },
131+
#if MICROPY_STACK_CHECK
132+
{ MP_ROM_QSTR(MP_QSTR_stack_use), MP_ROM_PTR(&mp_micropython_stack_use_obj) },
133+
#endif
110134
#endif
111135
#if MICROPY_ENABLE_EMERGENCY_EXCEPTION_BUF && (MICROPY_EMERGENCY_EXCEPTION_BUF_SIZE == 0)
112136
{ MP_ROM_QSTR(MP_QSTR_alloc_emergency_exception_buf), MP_ROM_PTR(&mp_alloc_emergency_exception_buf_obj) },
113137
#endif
138+
#if MICROPY_ENABLE_GC
139+
{ MP_ROM_QSTR(MP_QSTR_heap_lock), MP_ROM_PTR(&mp_micropython_heap_lock_obj) },
140+
{ MP_ROM_QSTR(MP_QSTR_heap_unlock), MP_ROM_PTR(&mp_micropython_heap_unlock_obj) },
141+
#endif
114142
};
115143

116144
STATIC MP_DEFINE_CONST_DICT(mp_module_micropython_globals, mp_module_micropython_globals_table);

py/qstrdefs.h

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -432,6 +432,13 @@ Q(mem_peak)
432432
#endif
433433
Q(mem_info)
434434
Q(qstr_info)
435+
#if MICROPY_STACK_CHECK
436+
Q(stack_use)
437+
#endif
438+
#endif
439+
#if MICROPY_ENABLE_GC
440+
Q(heap_lock)
441+
Q(heap_unlock)
435442
#endif
436443

437444
#if MICROPY_ENABLE_EMERGENCY_EXCEPTION_BUF && (MICROPY_EMERGENCY_EXCEPTION_BUF_SIZE == 0)

0 commit comments

Comments
 (0)