`micropython` – 访问和控制MicroPython内部构件¶

函数¶

micropython.const(expr)¶

用于表示表达式为常量，这样编译就可以将其优化。该函数应按照下述说明使用：:

from micropython import const

CONST_X = const(123)
CONST_Y = const(2 * CONST_X + 1)

以此方式声明的常量仍可作为全局变量从其声明的模块外部访问。另一方面，若某常量以下划线开始，则会被隐藏，则该常量无法作为全局变量访问，且在执行时不会占据任何内存。

const 函数是由MicroPython解析器直接识别的，并作为 micropython – 访问和控制MicroPython内部构件模块的一部分提供，因此可通过以上模式编写在CPython和MicroPython下运行的脚本。

micropython.opt_level([level])¶: 若level给定，则该函数为后续脚本编译设置优化级别，并返回 None 。否则返回当前的优化级别。

micropython.alloc_emergency_exception_buf(size)¶

为紧急异常缓冲区（适宜大小为100字节）分配RAM的 size 字节。当正常的RAM分配失败时（如在中断处理程序中），缓冲区用来创建异常，因此在此情况下提供有用的回溯信息。

使用该函数的较好方法为将其置于主脚本的开始，然后紧急异常缓冲区将会为其后所有代码激活。

micropython.mem_info([verbose])¶

打印关于当前占用内存的信息。若给定 verbose 参数，则打印附加信息。

所打印的信息与实现相关，但当前包含存储栈和堆的使用量。在详细模式下会打印整个堆，并标明指示哪些已占用，哪些尚可用。

micropython.qstr_info([verbose])¶: 打印关于当前interned字符串的信息。若给定 verbose 参数，则打印附加信息。所打印的信息与实现相关，但当前包含interned字符串和RAM使用量。在详细模式下会打印所有RAM-interned字符串的名称。

micropython.stack_use()¶: 返回一个代表使用中的当前堆数量。该数值的绝对值并没有什么用处，但是这一数值应用于计算在不同点上堆使用的不同。

micropython.heap_unlock()¶

锁定或解锁堆。当锁定时，无法进行内存分配，若试图执行任何堆分配，会引发 MemoryError 。

这些函数可嵌套， heap_lock() 可在一行中调用多次，锁定深度将会增加，且 heap_unlock() 必须调用同样次数，以使堆重新可用。

micropython.kbd_intr(chr)¶

设置会引发 KeyboardInterrupt 异常的字符。在脚本执行中，其默认值为3，与Ctrl-C相对应。传递-1给此函数将禁用的捕捉，传递3将恢复。

该函数可用于在传入的字符流中捕捉ctrl-c（该字符流常用于REPL），以防止该流被用于其他目的。

micropython.schedule(func, arg)¶

将执行的函数调度为“非常快速”。该函数传递arg值作为其唯一参数。“非常快速”意味着运行时间将尽其所能尽早执行该函数，假定运行尽可能高效，以下条件依然有效：

预定函数不会抢占另一预定函数。
预定函数总在“操作码之间”执行，也就意味着所有基本Python操作（例如添加一个列表）都确保为极小的。
给定端口可能会定义“临界区”，预定函数不会在该区域中执行。函数可能在临界区内预定，但函数只在退出该区域后才会执行。临界区一个例子即抢占中断处理程序（一个IRQ）。

该函数可用来从抢占IRQ中预定回调。这样的IRQ对IRQ（例如，堆可能被锁定）中运行的代码进行了限制，并预定一个稍后会回调的函数能够接触这些限制。

有一个用来存放预定函数的堆栈，若堆栈已满，则 schedule 会引发 RuntimeError 。