《DNK210使用指南 -CanMV版 V1.0》第十六章 machine模块实验

正点原子

1）实验平台：正点原子DNK210开发板
2）购买链接：https://detail.tmall.com/item.htm?id=768499342659
3）全套实验源码+手册+视频下载地址：http://www.openedv.com/thread-347618-1-1.html
4）正点原子官方B站：https://space.bilibili.com/394620890
5）正点原子手把手教你学ESP32S3快速入门视频教程：https://www.bilibili.com/video/BV1sH4y1W7Tc
6）正点原子FPGA交流群：132780729

第十六章 machine模块实验

       本章实验将介绍machine模块的基础知识，以及machine模块内部分函数的使用。通过本章的学习，读者将学习到machine模块的基本使用方法。
       本章分为如下几个小节：
       16.1 machine模块介绍
       16.2 硬件设计
       16.3 程序设计
       16.4 运行验证

       16.1 machine模块介绍
       machine模块是CanMV内置的模块，machine模块包含了与Kendryte K210硬件相关的特定功能，machine模块中的大部分功能允许实现对Kendryte K210上硬件（例如CPU、UART、Timer等）的直接且不受限制的访问和控制，因此能够帮助开发者快速地实验一些硬件功能。
       machine模块提供了3个函数和7个类，machine模块提供的函数，如下表所示：

表16.1.1 machine模块提供的函数

       machine模块提供的类，如下表所示：

表16.1.2 machine模块提供的类

       本章着重介绍machine模块提供的函数，在后续章节将陆续对machine模块提供的部分类进行介绍。
       machine模块提供了unique_id()函数，用于获取Kendryte K210的32字节唯一ID，unique_id()函数如下所示：

1. machine.unique_id()

复制代码

       unique_id()函数用于获取Kendryte K210的32字节唯一ID，32字节唯一 ID可以被作为每颗Kendryte K210芯片的“身份证”。
       unique_id()函数的使用示例如下所示：

1. import machine
   
2. 
   
3. uid = machine.unique.id()

复制代码

       machine模块提供了reset()函数，用于对Kednryte K210进行软件复位，reset()函数如下所示：

1. machine.reset()

复制代码

       reset()函数用于对Kendryte K210进行软件复位，相当于对板卡进行重启操作。
       reset()函数的使用示例如下所示：

1. import machine
   
2. 
   
3. machine.reset()

复制代码

       machine模块提供了reset_cause()函数，用于获取Kendryte K210的复位原因，reset_cause()函数如下所示：

1. machine.reset_cause()

复制代码

       reset_cause()函数可以获取Kendryte K210本次运行前复位的复位原因，其中复位原因如下表所示：

表16.1.3 复位原因描述表

       reset_cause()函数的使用示例如下所示：

1. import machine
   
2. 
   
3. cause = machine.reset_cause()

复制代码

       16.2 硬件设计

       16.2.1 例程功能
       1. 使用unique_id()函数，获取Kendryte K210的唯一ID，并打印输出
       2. 使用reset_cause()函数，获取Kendryte K210本次运行的复位原因，并打印输出
       3. 使用reset()函数，对Kendryte K210进行软件复位

       16.2.2 硬件资源
       本章实验内容，主要讲解machine模块中函数的使用，无需关注硬件资源。

       16.2.3 原理图
       本章实验内容，主要讲解machine模块中函数的使用，无需关注原理图。

       16.3 程序设计

       16.3.1 machine函数
       有关machine函数的介绍，请见第16.1小节《machine模块介绍》。

       16.3.2 程序流程图

图16.3.2.1 machine模块实验流程图

       16.3.3 main.py代码
       main.py中的脚本代码如下所示：

1. import machine
   
2. import time
   
3. 
   
4. # 获取唯一ID并打印输出
   
5. uid = machine.unique_id()
   
6. print(uid)
   
7. print("".join(["%02X" % byte for byte in uid]))
   
8. 
   
9. # 获取复位原因并打印输出
   
10. cause = machine.reset_cause()
    
11. def decode_cause(cause):
    
12.     if cause == (machine.PWRON_RESET or machine.HARD_RESET):
    
13.         return "Pin reset"
    
14.     elif cause == machine.WDT_RESET:
    
15.         return "WDT0 reset"
    
16.     elif cause == machine.WDT1_RESET:
    
17.         return "WDT1 reset"
    
18.     elif cause == machine.SOFT_RESET:
    
19.         return "Software reset"
    
20.     else:
    
21.         return "Unknow"
    
22. print(decode_cause(cause))
    
23. 
    
24. # 延时一段时间
    
25. time.sleep_ms(500)
    
26. 
    
27. # 软件复位
    
28. machine.reset()

复制代码

       可以看到，首先是通过machine.unique_id()函数获取Kendryte K210的唯一ID，并通过print()函数将其打印输出，但由于该函数返回的是bytes类型的数据，为了方便查看，同时将其格式化为十六进制数据进行打印输出。
       接着是使用machine.reset_cause()函数获取复位原因，该函数返回的是一个int类型的数据，复位原因对应的int数据都以常量的形式保存在machine模块中如表16.1.3，在将复位原因转换为对应的字符串后，通过print()函数将其打印输出。
       在最后是使用machine.reset()函数对Kendryte K210进行软件复位，复位后Kendryte K210将重新启动，CanMV也将重新运行。

       16.4 运行验证
       将DNK210开发板连接CanMV IDE，并点击CanMV IDE上的“开始(运行脚本)”按钮后，可以看到“串行终端”输出了一些信息，如下图所示：

图16.4.1 “串行终端”窗口打印输出

       从“串行终端”的窗口中可以看到，前两行输出的是Kendryte K210的唯一ID，值得一提的是，虽然打印输出了64字节的唯一ID，但有效的只有前32字节。可以看到第三行，输出的是“Pin reset”，说明本次运行前的复位原因是“引脚复位”。
       由于在main.py中的最后执行了machine.reset()函数，因此Kendryte K210将会执行一次复位，因此，通过CanMV IDE软件能观察到在执行完main.py后，原本处于“已连接”状态的Kendryte K210设备变为了“未连接”状态，如下图所示：

图16.4.2 设备断开连接