本次内测内容如下：

1. 编译 Iot Board MicroPython 固件并下载到 IoT Board 潘多拉开发板
2. 将开发板通过 stlink 虚拟串口连接到 PC 机
3. 使用 mkfs filesystem 命令创建文件系统，重启开发板使系统重新挂载文件系统用于存放 Python 脚本
4. 在 VScode 搜索并安装 RT-Thread MicroPython 插件，阅读插件的说明文档，按照推荐步骤操作
5. 在 VScode 上创建 MicroPython 工程
6. 连接开发板到 RT-Thread MicroPython 插件
7. 运行插件提供的示例程序
8. 修改 main.py 文件，实现开机启动自动运行 Python 脚本

各位小伙伴可以随时向我们反馈使用时出现的问题，我们会在第一时间进行改进，更新 MicroPython 固件和插件，让大家能更流畅地使用 MicroPython 进行开发。

MicroPython 是 Python 3 编程语言的一种精简而高效的实现，它包含 Python 标准库的一个子集，并被优化为在微控制器和受限环境中运行。它具有交互式提示、任意精度整数、闭包函数、列表解析、生成器、异常处理等高级特性，具有很强的可移植性。它能够帮助开发者快速控制各种硬件外设，不用再去研究底层硬件模块的使用方法，翻看寄存器手册。降低了开发难度，而且减少了重复开发工作，可以加快开发速度，提高开发效率。

本例程作将介绍如何在 rt-thread 上使用 MicroPython ，并通过命令行展示 MicroPython 代码的输入与运行，最后使用一个示例，演示使用 MicroPython 控制硬件。

本例程将使用 MicroPython 控制 IoT Board 上的各种硬件，请确保开发板上的相关硬件可以正常工作。

main 程序代码位于 applications/main.c 中, 主要是为 MicroPython 的提供必要的运行环境。

在 main 函数中，主要完成以下几个任务：

• 创建 block 设备

• 挂载 FAT 文件系统

• 启动自动连接

• 打开 MicroPython 命令交互界面

main 函数代码如下所示

int main(void)
{
    /* 分区表初始化 */
    fal_init();

    /* 在文件系统分区上创建块设备*/
    struct rt_device *flash_dev = fal_blk_device_create(FS_PARTITION_NAME);
    if (flash_dev == NULL)
    {
        LOG_E("Can't create a block device on '%s' partition.", FS_PARTITION_NAME);
    }

    /* 在文件系统分区上挂载文件系统 */
    if (dfs_mount(FS_PARTITION_NAME, "/", "elm", 0, 0) == 0)
    {
        LOG_I("Filesystem initialized!");
    }
    else
    {
        /* 创建文件系统 */
        dfs_mkfs(FS_PARTITION_NAME, "elm");
        /* 重新挂载文件系统 */
        if (dfs_mount(FS_PARTITION_NAME, "/", "elm", 0, 0) == 0)
        {
            LOG_E("Failed to initialize filesystem! The mpy fs module is not available.");
        }
    }

    extern void wlan_autoconnect_init(void);
    /* 自动连接初始化 */
    wlan_autoconnect_init();
    /* 打开自动连接 */
    rt_wlan_config_autoreconnect(RT_TRUE);

    /* 等待系统初始化完毕 */
    rt_thread_mdelay(100);

    /* 打开 MicroPython 命令交互界面 */
    extern void mpy_main(const char *filename);
    mpy_main(NULL);

   LOG_D("MicroPython will reset by user");
   rt_hw_cpu_reset();
}

• MDK：双击 project.uvprojx 打开 MDK5 工程，执行编译。
• IAR：双击 project.eww 打开 IAR 工程，执行编译。

编译完成后，将固件下载至开发板。

在 PC 端使用终端工具打开开发板的 uart0 串口，设置 115200 8 1 N 。正常运行后，终端输出信息如下：

 \ | /
- RT -     Thread Operating System
 / | \     4.0.1 build Apr  4 2019
 2006 - 2019 Copyright by rt-thread team
lwIP-2.0.2 initialized!
[SFUD] Find a Winbond flash chip. Size is 16777216 bytes.
[SFUD] w25q128 flash device is initialize success.
[25] I/SAL_SKT: Socket Abstraction Layer initialize success.
[I/FAL] RT-Thread Flash Abstraction Layer (V0.3.0) initialize success.
[I/OTA] RT-Thread OTA package(V0.1.3) initialize success.
[I/OTA] Verify 'wifi_image' partition(fw ver: 1.0, timestamp: 1529386280) success.
[I/WICED] wifi initialize done. wiced version 3.3.1
[1836] I/WLAN.dev: wlan init success
[1842] I/WLAN.lwip: eth device init ok name:w0
msh />[I/FAL] The FAL block device (filesystem) created successfully
[1859] I/main: Filesystem initialized!
[Flash] EasyFlash V3.2.1 is initialize success.
[Flash] You can get the latest version on https://github.com/armink/EasyFlash .

MicroPython v1.10 on 2019-02-13; Universal python platform with RT-Thread
Type "help()" for more information.
>>> join ssid:aptest
[4742] I/WLAN.mgnt: wifi connect success ssid:aptest
[7750] I/WLAN.lwip: Got IP address : 192.168.12.158

>>>

此时 MicroPython 命令交互界面就已经启动，可以通过命令行与 MicroPython 进行交互。下面将使用一个示例展示如何使用 MicroPython 控制硬件。

• MicroPython 是 Python 3 编程语言的一种精简而高效的实现，语法和 Python 3 相同，并带有丰富的内建函数，使用 MicroPython 交互命令行即可运行 Python 代码。

在交互命令行输入 print('hello RT-Thread!') ，然后输入回车，将运行这行语句，在下一行输出 hello RT-Thread! 字样。运行效果如下：

MicroPython 比一般的 python 交互环境多了一个特别的粘贴模式，可以一次粘贴输入多行 python 代码。

• 按下 Ctrl-E 组合键，进入粘贴模式，界面上会出现提示：paste mode; Ctrl-C to cancel, Ctrl-D to finish 。该模式下可一次粘贴多行代码。

• 按下 Ctlr-D 组合键，退出粘贴模式。同时粘贴输入的代码也会自动执行。

• 按下 Ctrl-C 组合键，终止正在执行的程序。

注意：进入粘贴模式后，不要使用 Ctrl-C 粘贴代码。可使用鼠标右键进行粘贴。

使用粘贴模式执行下面代码：

for i in range(1,10):
    print(i)

执行效果如下：

MicroPython 提供丰富的内建模块用来完成相关的程序功能。同时 RT-Thread 也提供了 rtthread 模块用来返回系统运行相关的信息。

• 使用 rtthread 模块查看当前运行线程，调用方法及效果如下图所示：

• 使用 time 模块进行毫秒延时，调用方法及效果如下图所示：

通过 MicroPython 可以用非常简单的方式来控制开发板的硬件资源，使用一个简单的例子来说明：

• 在开发板上: PE7 引脚连接 LED 灯，PE7 引脚对应的引脚号为 71，下面代码将周期闪烁 LED 灯。

import utime as time
from machine import Pin

PIN_LED_R = 71    # PE7, get the pin number from get_pin_number.py

# create led object from pin PIN_LED_R, Set pin PIN_LED_R to output mode
led = Pin(("led_red", PIN_LED_R), Pin.OUT_PP)

while True:
    led.value(0)  # Set led turn on
    time.sleep(0.5)
    led.value(1)  # Set led turn off
    time.sleep(0.5)

针对自己的开发板修改引脚号，将以上脚本使用粘贴模式输入，即可看到 LED 灯按照指定的频率闪烁。使用 Ctrl-C 可以取消当前正在运行程序。

除了 LED 之外，还可以使用 MicroPython 控制各种各样的硬件模块，如 Pin、I2C、SPI、UART、LCD、RTC、PWM、ADC、WDT、TIMER 等，想要了解这些硬件的详细控制方式，可以查阅 《MicroPython用户手册》，里面有详细的介绍。

除了可以通过阅读用户手册来了解 MicroPython 的使用方式，还可以直接在 VScode 中搜索 RT-Thread MicroPython 来使用 RT-Thread 推出的 MicroPython 开发环境，在开发环境中直接运行示例程序来学习 MicroPython 开发。如下图所示：

《RT-Thread 编程指南》: docs/RT-Thread 编程指南.pdf

《MicroPython用户手册》: docs/UM1011-RT-Thread-MicroPython 用户手册