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_lock()
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