micropython – 访问和控制MicroPython内部构件¶
函数¶
- micropython.const(expr)¶
用于表示表达式为常量，这样编译就可以将其优化。该函数应按照下述说明使用:
from micropython import const CONST_X = const(123) CONST_Y = const(2 * CONST_X + 1)
以此方式声明的常量仍可作为全局变量从其声明的模块外部访问。另一方面，若某常量以下划线开始，则会被隐藏，则该常量无法作为全局变量访问，且在执行时不会占据任何内存。
This
constfunction is recognised directly by the MicroPython parser and is provided as part of themicropythonmodule mainly so that scripts can be written which run under both CPython and MicroPython, by following the above pattern.
- micropython.opt_level([level])¶
若level给定，则该函数为后续脚本编译设置优化级别，并返回
None。否则返回当前的优化级别。优化级别控制以下编译特性:
Assertions断言:在0级时，断言语句被启用并编译为字节码；1级及更高级别的断言不会编译。
内置
__debug__变量: 0级时，该变量扩展为True; 1级及以上时，该变量扩展为False。源代码行号:在0级、1级和2级时，源代码行号与字节码一起存储，以便异常可以报告它们发生的行号；3级及更高级别的行号不会存储。
默认的优化级别通常是0级。
- micropython.alloc_emergency_exception_buf(size)¶
为紧急异常缓冲区（适宜大小为100字节）分配RAM的 size 字节。当正常的RAM分配失败时（如在中断处理程序中），缓冲区用来创建异常，因此在此情况下提供有用的回溯信息。
使用该函数的较好方法为将其置于主脚本的开始(例如
boot.py或main.py)，然后紧急异常缓冲区将会为其后所有代码激活。
- micropython.mem_info([verbose])¶
打印关于当前占用内存的信息。若给定 verbose 参数，则打印附加信息。
打印关于当前interned字符串的信息。若给定 verbose 参数，则打印附加信息。所打印的信息与实现相关，但当前包含interned字符串和RAM使用量。在详细模式下会打印所有RAM-interned字符串的名称。
- micropython.qstr_info([verbose])¶
返回一个代表使用中的当前堆数量。该数值的绝对值并没有什么用处，但是这一数值应用于计算在不同点上堆使用的不同。
打印关于当前interned字符串的信息。若给定 verbose 参数，则打印附加信息。所打印的信息与实现相关，但当前包含interned字符串和RAM使用量。在详细模式下会打印所有RAM-interned字符串的名称。
- micropython.stack_use()¶
返回一个代表使用中的当前堆数量。该数值的绝对值并没有什么用处，但是这一数值应用于计算在不同点上堆使用的不同。
- micropython.heap_lock()¶
- micropython.heap_unlock()¶
- micropython.heap_locked()¶
锁定或解锁堆。当锁定时，无法进行内存分配，若试图执行任何堆分配，会引发
heap_locked()。这些函数可嵌套，heap_locked()可在一行中调用多次，锁定深度将会增加，且 heap_unlock() 必须调用同样次数，以使堆重新可用。此函数可用嵌套，
heap_lock()可用被多次调用，此时加锁的次数会增加，而对应的heap_unlock()必须被调用相同的次数，以使得堆再次可用。heap_unlock()和heap_locked()都会返回当前锁非负数的深度，当为0的时候，意味着堆没有被锁。如果 REPL被激活时堆时锁的状态，锁将被强制解除。
注意：
heap_locked()在大多数的移植中是没有使能的，可用查看MICROPY_PY_MICROPYTHON_HEAP_LOCKED
- micropython.kbd_intr(chr)¶
设置会引发
KeyboardInterrupt异常的字符。在脚本执行中，其默认值为3，与Ctrl-C相对应。传递-1给此函数将禁用的捕捉，传递3将恢复。该函数可用于在传入的字符流中捕捉ctrl-c（该字符流常用于REPL），以防止该流被用于其他目的。
- micropython.schedule(func, arg)¶
将执行的函数调度为“非常快速”。该函数传递arg值作为其唯一参数。“非常快速”意味着运行时间将尽其所能尽早执行该函数，假定运行尽可能高效，以下条件依然有效：
预定函数不会抢占另一预定函数。
预定函数总在“操作码之间”执行，也就意味着所有基本Python操作（例如添加一个列表）都确保为极小的。
给定端口可能会定义“临界区”，预定函数不会在该区域中执行。函数可能在临界区内预定，但函数只在退出该区域后才会执行。临界区一个例子即抢占中断处理程序（一个IRQ）。
该函数可用来从抢占IRQ中预定回调。这样的IRQ对IRQ（例如，堆可能被锁定）中运行的代码进行了限制，并预定一个稍后会回调的函数能够接触这些限制。
注意：如果从抢占式IRQ中调用
schedule()，当不允许内存分配并且要传递给schedule()的回调是绑定方法时，则直接传递该方法将失败。 这是因为创建对绑定方法的引用会导致内存分配。一种解决方案是在类构造函数中创建对该方法的引用，并将该引用传递给schedule()。 这里将详细讨论 reference documentation 在 “Creation of Python object创建Python对象”章节中。There is a finite queue to hold the scheduled functions and
schedule()will raise aRuntimeErrorif the queue is full.