前面已經(jīng)將MicroPython移植到了LPC1788，其中的一些功能已經(jīng)可以使用。但是片上外設(shè)、板載外設(shè)還不能訪問，需要我們?nèi)?shí)現(xiàn)，然后才能在MicroPython中訪問。官方文檔MicroPython external C modules中對(duì)這部分有說明，比較簡(jiǎn)單。下面通過實(shí)戰(zhàn)來進(jìn)一步理解這部分文檔。

添加源文件

第一步肯定是創(chuàng)建源文件了，給它命名為machine.c。

SRC_C = \
    main.c \
    uart_core.c \
    ...
    ./modules/machine.c
    ...

創(chuàng)建一個(gè)Module

源文件已經(jīng)建好，接下來就是編碼了。在MicroPython中，modules是有確定的結(jié)構(gòu)的?？梢园堰@個(gè)結(jié)構(gòu)理解為模板，跟著模板走，總沒有錯(cuò)的。先來看看這個(gè)模板：

#include "py/obj.h"
#include "py/runtime.h"
#include "py/builtin.h"

STATIC const mp_rom_map_elem_t machine_module_globals_table[] = {
    {MP_ROM_QSTR(MP_QSTR___name__), MP_ROM_QSTR(MP_QSTR_machine)},
};

STATIC MP_DEFINE_CONST_DICT(machine_module_globals, machine_module_globals_table);

const mp_obj_module_t machine_module = {
    .base = {&mp_type_module},
    .globals = (mp_obj_dict_t *)&machine_module_globals,
};

上面這部分代碼使用mp_obj_module_t類型定義了一個(gè)module，并初始化了相關(guān)的部分，如基本類型、模塊的字典。在字典中，定義了__name__，為machine，這個(gè)就是我們這個(gè)module的名字。
為了讓這個(gè)模塊能在MicroPython中被import，需要將模塊添加到mpconfigport.h的MICROPY_PORT_BUILTIN_MODULES中。注意：不是MICROPY_PORT_BUILTINS!!!

// extra built in modules to add to the list of known ones
extern const struct _mp_obj_module_t machine_module;  // 注意_mp_obj_module_t是帶下劃線前綴的

#define MICROPY_PORT_BUILTIN_MODULES \
    {MP_ROM_QSTR(MP_QSTR_machine), MP_ROM_PTR(&machine_module)},

編譯并燒錄，在MicroPython中使用import machine測(cè)試是否成功，不報(bào)錯(cuò)就是成功了。

添加一個(gè)Function

現(xiàn)在，我們可以添加一個(gè)函數(shù)到這個(gè)模塊里面。首先定義一個(gè)函數(shù)，這里以reset函數(shù)來具體說明。

STATIC mp_obj_t machine_reset(void)
{
    NVIC_SystemReset();
    return mp_const_none;
}
STATIC MP_DEFINE_CONST_FUN_OBJ_0(machine_reset_obj, machine_reset);

這段代碼創(chuàng)建了一個(gè)名為machine_reset_obj的函數(shù)對(duì)象，該函數(shù)沒有參數(shù)，被調(diào)用時(shí)會(huì)執(zhí)行C函數(shù)machine_reset。此外，所有的Python函數(shù)都必須返回一個(gè)mp_obj_t結(jié)構(gòu)對(duì)象，但是我們這沒有什么可返回的，因此返回None。接下來將這個(gè)函數(shù)添加到前面創(chuàng)建好的module中。

STATIC const mp_rom_map_elem_t machine_module_globals_table[] = {
    {MP_ROM_QSTR(MP_QSTR___name__), MP_ROM_QSTR(MP_QSTR_machine)},
    {MP_ROM_QSTR(MP_QSTR_reset), MP_ROM_PTR(&machine_reset_obj)},
};

好了，編譯看看。報(bào)錯(cuò)了，提示下面的信息

In file included from modules/machine.c:1:0:
modules/machine.c:17:18: error: 'MP_QSTR_sys_reset' undeclared here (not in a function)
     {MP_ROM_QSTR(MP_QSTR_sys_reset), MP_ROM_PTR(&machine_reset_obj)},
                  ^
../../py/obj.h:92:56: note: in definition of macro 'MP_OBJ_NEW_QSTR'
 #define MP_OBJ_NEW_QSTR(qst) ((mp_obj_t)((((mp_uint_t)(qst)) << 2) | 2))
                                                        ^
modules/machine.c:17:6: note: in expansion of macro 'MP_ROM_QSTR'
     {MP_ROM_QSTR(MP_QSTR_sys_reset), MP_ROM_PTR(&machine_reset_obj)},
      ^
make: *** [build/./modules/machine.o] Error 1

其實(shí)上面的操作還缺少一個(gè)步驟，就是在qstrdefsport.h.中定義一個(gè)Q(reset)，再編譯就OK了。

Function的參數(shù)

前面添加一個(gè)函數(shù)時(shí)使用了MP_DEFINE_CONST_FUN_OBJ_0宏來定義一個(gè)不帶參數(shù)的函數(shù)。同樣也可以定義一個(gè)或多個(gè)參數(shù)的函數(shù)。下面列舉出所有支持的類型，具體的使用方法不細(xì)說，可以查看各個(gè)移植的例子。

在MicroPython中使用Module

import machine  # 添加的module的名字叫‘machine’，要使用這個(gè)模塊首先得導(dǎo)入它

machine.reset()  # 調(diào)用這個(gè)模塊的函數(shù)