前面已經(jīng)將MicroPython移植到了LPC1788，其中的一些功能已經(jīng)可以使用董习。但是片上外設(shè)烈和、板載外設(shè)還不能訪問，需要我們?nèi)?shí)現(xiàn)皿淋，然后才能在MicroPython中訪問招刹。官方文檔MicroPython external C modules中對(duì)這部分有說明恬试，比較簡單。下面通過實(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測試是否成功再芋，不報(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ù)