## **machine** – 与硬件相关的功能

**machine** 模块包含与特定开发板上的硬件相关的特定函数。 在这个模块中的大多数功能允许实现直接和不受限制地访问和控制系统上的硬件块（如CPU，定时器，总线等）。如果使用不当，会导致故障，死机，崩溃，在极端的情况下，硬件会损坏。

需要注意的是，由于不同开发板的硬件资源不同，MicroPython 移植所能控制的硬件也是不一样的。因此对于控制硬件的例程来说，在使用前需要修改相关的配置参数来适配不同的开发板，或者直接运行已经对某一开发板适配好的 MicroPython 示例程序。本文档中的例程都是基于 RT-Thread IoT Board 潘多拉开发板而讲解的。

### 函数

#### 复位相关函数

##### **machine.info**()  
  显示关于系统介绍和内存占用等信息。

##### **machine.reset**()  注：暂未实现
  重启设备，类似于按下复位按钮。

##### **machine.reset_cause**()  注：暂未实现
  获得复位的原因，查看可能的返回值的常量。

#### 中断相关函数

##### **machine.disable_irq**()  
  禁用中断请求。返回先前的 `IRQ` 状态，该状态应该被认为是一个未知的值。这个返回值应该在 `disable_irq` 函数被调用之前被传给 `enable_irq` 函数来重置中断到初始状态。

##### **machine.enable_irq**(state)  
  重新使能中断请求。状态参数应该是从最近一次禁用功能的调用中返回的值。

#### 功耗相关函数

##### **machine.freq**()  
  返回 `CPU` 的运行频率。

##### **machine.idle**()  注：暂未实现
  阻断给 `CPU` 的时钟信号，在较短或者较长的周期里减少功耗。当中断发生时，外设将继续工作。

##### **machine.sleep**()  注：暂未实现
  停止 `CPU` 并禁止除了 `WLAN` 之外的所有外设。系统会从睡眠请求的地方重新恢复工作。为了确保唤醒一定会发生，应当首先配置中断源。

##### **machine.deepsleep**()  注：暂未实现
  停止 `CPU` 和所有外设（包括网络接口）。执行从主函数中恢复，就像被复位一样。复位的原因可以检查 `machine.DEEPSLEEP` 参数获得。为了确保唤醒一定会发生，应该首先配置中断源，比如一个引脚的变换或者 `RTC` 的超时。