MicroPython-TPYBoard固件編譯教程

ID:130183 · 發(fā)表于 2017-8-18 11:00

　　本文主要介紹一下，在Linux環(huán)境下編譯micropython固件的方法和流程。

　　首先，我們先來看一下MicroPython的源碼結(jié)構(gòu)。

　　github地址：https://github.com/micropython/micropython

　　你會(huì)發(fā)現(xiàn)，micropython根據(jù)不同的MCU運(yùn)行平臺(tái)進(jìn)行了分類，比如esp8266目錄下就是esp8266-WIFI模塊上的micropython的源碼，stmhal是運(yùn)行在stm32上的，還有cc3200等。

py/	Python實(shí)現(xiàn)的核心部分，包括編譯器、運(yùn)行時(shí)、核心庫
mpy-cross/	MicroPython 自帶的交叉編譯器，可以將python腳本編譯為mpy加密文件
unix/	在UNIX上運(yùn)行的MicroPython
stmhal/	在TPYBoard和類似的STM32開發(fā)板上運(yùn)行的MicroPython
minimal/	MicroPthon的最小集，用于移植到其他微處理器
tests/	測試框架和測試腳本
docs/	MicroPython官方的reStructuredText文檔資料。地址：http://docs.micropython.org
bare-arm/	在ARM上MicroPython的最小版本
teensy/	在Teensy 3.1上運(yùn)行的MicroPython
pic16bit/	在16 位 PIC 微控制器上運(yùn)行的MicroPython
esp8266/	在ESP8266 WIFI模塊上運(yùn)行的MicroPython
extmod/	C 實(shí)現(xiàn)的模塊
tools/	各種工具
examples/	Python腳本實(shí)例
READ.md	說明文檔

　　開始編譯固件

　　本人的系統(tǒng)環(huán)境：ubuntu15.0464位系統(tǒng)

　　Ubuntu官網(wǎng)：http://cn.ubuntu.com/?_ga=2.2645 ... 95108721.1502953593

　　1、安裝arm-none-eabi-gcc交叉編譯工具和gcc編譯器

　　打開終端執(zhí)行命令

sudo apt-get install gcc-arm-none-eabi
sudo apt-get install gcc

復(fù)制代碼

　　2、下載micropython的源碼包

　　我放在了/opt目錄下

git clone --recursive https://github.com/micropython/micropython.git

復(fù)制代碼

　　等待git完畢，進(jìn)入stmhal/boards/目錄下，里面又根據(jù)不同型號(hào)的芯片進(jìn)行了分類。

　　3、開始編譯

　　切換到stmhal目錄

cd /opt/micropython/stmhal

復(fù)制代碼

　　執(zhí)行編譯命令，等待編譯完成。

make BOARD=PYBV10

復(fù)制代碼

　　BOARD參數(shù)為stmhal/boards/目錄下相應(yīng)的開發(fā)板名稱。

　　本次教程用的是TPYBoardv102（藍(lán)色）開發(fā)板，兼容PYBV10，所以選擇PYBV10開發(fā)板繼續(xù)編譯。

　　若是TPYBoardv102（綠色）基礎(chǔ)板，同樣選擇PYBV10。

　　若是TPYBoardv102（黑色）開發(fā)板，需選擇PYBV11。

　　編譯成功。生成的固件文件stmhal/build-PYBV10/firmware.dfu和firmware.hex。

　　4、燒寫固件

　　請參考教程：tpyboard點(diǎn)com/support/reference11/302.html

　　增加自定義類庫

　　使用過micropython的小伙伴都知道，里面有一個(gè)重要的模塊pyb。下面我們就嘗試在micropython源碼中新建一個(gè)名為tpyboard的pyb子類，里面添加一個(gè)簡單的函數(shù)display，輸出一句”HelloTPYBoard”。

　　5、首先大體來看一下stmhal目錄下的各種.c和.h文件。基本上根據(jù)他們的名稱就能判斷出功能來。

　　6、先來參考一下led.c文件，了解一下大體的流程。

　　找到了led_obj_on函數(shù)，這就是我們平時(shí)用的pyb.LED(1).on()

/// Turn the LED on
mp_obj_t led_obj_on(mp_obj_t self_in) {
pyb_led_obj_t *self = self_in;
led_state(self->led_id, 1);
return mp_const_none;
}

復(fù)制代碼

　　聲明注冊一下on函數(shù)，MP_DEFINE_CONST_FUN_OBJ_1最后的數(shù)字跟參數(shù)的數(shù)量相對(duì)應(yīng)。

STATIC MP_DEFINE_CONST_FUN_OBJ_1(led_obj_on_obj, led_obj_on);

復(fù)制代碼

　　再往下可以看到led_locals_dict_table，將上面聲明的函數(shù)添加到led模塊函數(shù)字典中。

STATIC const mp_rom_map_elem_t led_locals_dict_table[] = {
{ MP_ROM_QSTR(MP_QSTR_on), MP_ROM_PTR(&led_obj_on_obj) },
{ MP_ROM_QSTR(MP_QSTR_off), MP_ROM_PTR(&led_obj_off_obj) },
{ MP_ROM_QSTR(MP_QSTR_toggle), MP_ROM_PTR(&led_obj_toggle_obj) },
{ MP_ROM_QSTR(MP_QSTR_intensity), MP_ROM_PTR(&led_obj_intensity_obj) },
};
STATIC MP_DEFINE_CONST_DICT(led_locals_dict, led_locals_dict_table);

復(fù)制代碼

　　建立micropython對(duì)象，遵循以下原則。

const mp_obj_type_t pyb_led_type = {
{ &mp_type_type },
.name = MP_QSTR_LED,
.print = led_obj_print,
.make_new = led_obj_make_new,
.locals_dict = (mp_obj_dict_t*)&led_locals_dict,
};

復(fù)制代碼

　　7、接下來我們在stmhal目錄下新建一個(gè)tpyboard.c文件，內(nèi)容如下：

#include <stdio.h>
#include "py/nlr.h"
#include "py/runtime.h"
#include "py/mphal.h"
mp_obj_t tpyboard_obj_display() {
printf("Hello TPYBoard\n");
return mp_const_none;
}
STATIC MP_DEFINE_CONST_FUN_OBJ_0(tpyboard_obj_display_obj, tpyboard_obj_display);
STATIC const mp_rom_map_elem_t tpyboard_locals_dict_table[] = {
{ MP_ROM_QSTR(MP_QSTR_display), MP_ROM_PTR(&tpyboard_obj_display_obj) },
};
STATIC MP_DEFINE_CONST_DICT(tpyboard_locals_dict, tpyboard_locals_dict_table);
const mp_obj_type_t pyb_tpyboard_type = {
{ &mp_type_type },
.name = MP_QSTR_tpyboard,
.locals_dict = (mp_obj_dict_t*)&tpyboard_locals_dict,
};