micropython開發(fā)者指南


Author shaniadolphin
e-mail 349948204@qq.com

獲取git工程

mkdir micropython
cd micropython
git clone https://github.com/micropython/micropython.git
git submodule update --init

運行的結(jié)果如下:

dolphin@DESKTOP-DR5OKOG:/mnt/h/proj/micropython$ cd micropython/
dolphin@DESKTOP-DR5OKOG:/mnt/h/proj/micropython/micropython$ git submodule update --init
Submodule 'lib/axtls' (https://github.com/pfalcon/axtls) registered for path 'lib/axtls'
Submodule 'lib/berkeley-db-1.xx' (https://github.com/pfalcon/berkeley-db-1.xx) registered for path 'lib/berkeley-db-1.xx'
Submodule 'lib/libffi' (https://github.com/atgreen/libffi) registered for path 'lib/libffi'
Submodule 'lib/lwip' (https://git.savannah.gnu.org/r/lwip.git) registered for path 'lib/lwip'
Submodule 'lib/nrfx' (https://github.com/NordicSemiconductor/nrfx.git) registered for path 'lib/nrfx'
Submodule 'lib/stm32lib' (https://github.com/micropython/stm32lib) registered for path 'lib/stm32lib'
Cloning into '/mnt/h/proj/micropython/micropython/lib/axtls'...
Cloning into '/mnt/h/proj/micropython/micropython/lib/berkeley-db-1.xx'...
Cloning into '/mnt/h/proj/micropython/micropython/lib/libffi'...
Cloning into '/mnt/h/proj/micropython/micropython/lib/lwip'...

GIT倉庫里的主要組件:

  • py/ -- Python核心應(yīng)用,包括編譯器,runtime和核心庫趴乡。
  • mpy-cross/ -- MicroPython交叉編譯器,用于將腳本轉(zhuǎn)換成預(yù)編譯的字節(jié)碼。
  • ports/unix/ -- 運行在UNIX上的MyPython版本威创。
  • ports/stm32/ -- 運行在PyBoard(使用ST Cube HAL驅(qū)動)和類似的STM32板上的MicroPython版本。
  • ports/esp32/ -- 運行在Espressif的ESP32 SoC上的MicroPython版本谎懦。
  • ports/nrf/ -- 運行在Nordic的NRF 51和NFR52 MCU上的MicroPython版本肚豺。
  • ports/minimal/ -- 最小的MicroPython接口,用于將MicroPython移植到另一個MCU界拦。
  • tests/ -- 測試框架和測試腳本吸申。
  • docs/ -- 用戶文檔。
  • extmod/ -- 附加(非內(nèi)核)C模塊。
  • tools/ -- 各種工具截碴,包括PyBoard.Py模塊梳侨。
  • examples/ -- 一些Python腳本示例。

安裝gcc-arm-embedded

Build instructions

在為目標板編譯固件之前隐岛,必須編譯MicroPython交叉編譯器猫妙,它用于將一些內(nèi)置的腳本預(yù)編譯為字節(jié)碼。在主機上編譯交叉編譯器:

dolphin@DESKTOP-DR5OKOG:/mnt/h/proj/micropython/micropython$ make -C mpy-cross
make: Entering directory '/mnt/h/proj/micropython/micropython/mpy-cross'
Use make V=1 or set BUILD_VERBOSE in your environment to increase build verbosity.
mkdir -p build/genhdr
GEN build/genhdr/mpversion.h
GEN build/genhdr/qstr.i.last
GEN build/genhdr/qstr.split
GEN build/genhdr/qstrdefs.collected.h
QSTR updated
GEN build/genhdr/qstrdefs.generated.h
mkdir -p build/py/
CC ../py/mpstate.c

編譯完后生成mpy-cross

LINK mpy-cross
   text    data     bss     dec     hex filename
 139992   12976     864  153832   258e8 mpy-cross
make: Leaving directory '/mnt/h/proj/micropython/micropython/mpy-cross'

編譯PYBV11

STM32的目標板需要ARM編譯器arm-none-eabi-gcc

sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
sudo apt-get update
sudo apt-get install gcc-arm-embedded

安裝好編譯器后即可進行編譯聚凹,可以通過參數(shù)BOARD= 來指定目標板割坠,比如make BOARD=PYBV11make BOARD=STM32F4DISC

dolphin@DESKTOP-DR5OKOG:/mnt/h/proj/micropython/micropython$ cd ports/stm32
dolphin@DESKTOP-DR5OKOG:/mnt/h/proj/micropython/micropython/ports/stm32$ make BOARD=PYBV11
Use make V=1 or set BUILD_VERBOSE in your environment to increase build verbosity.
mkdir -p build-PYBV11/genhdr
GEN build-PYBV11/genhdr/pins.h
GEN stmconst build-PYBV11/modstm_qstr.h
GEN build-PYBV11/genhdr/pybcdc.inf
GEN build-PYBV11/genhdr/pybcdc_inf.h
GEN build-PYBV11/genhdr/pllfreqtable.h
GEN build-PYBV11/genhdr/mpversion.h
GEN build-PYBV11/genhdr/qstr.i.last

編譯生成firmware妒牙,隨后便可通過windows端的JFLASH或者DFU工具將固件燒錄到目標板中:

LINK build-PYBV11/firmware.elf
   text    data     bss     dec     hex filename
 331204      36   28028  359268   57b64 build-PYBV11/firmware.elf
GEN build-PYBV11/firmware.dfu
GEN build-PYBV11/firmware.hex

也可通過將PYBV11的P1/DFU引腳連接到3.3V彼哼,按復(fù)位按鍵重啟,進入DFU模式來更新(非win10的UBUNTU子系統(tǒng)中):

make BOARD=PYBV11 deploy

編譯ESP32

ESP32的esp-idf在github倉庫中的地址:https://github.com/espressif/esp-idf湘今。在本地創(chuàng)建esp-idf所在的目錄敢朱,比如/mnt/h/proj/,使用git clone將esp-idf下載到該目錄中:

cd /mnt/h/proj/
git clone --recursive https://github.com/espressif/esp-idf.git

更新esp-idf中的子模塊:

#Do not miss the --recursive option. If you have already cloned ESP-IDF without this option, run another command to get all the submodules:
cd ~/esp/esp-idf
git submodule update --init --recursive

由于micropython僅支持hash值30545f4cccec7460634b656d278782dd7151098e的版本摩瞎,所以需要切換到這個版本拴签,否則會丟失一些定義,造成編譯失敗旗们。

git reset 30545f4cccec7460634b656d278782dd7151098e --hard

進入esp-idf的目錄蚓哩,通過以下指令安裝requirements.txt中的Python包。

pip3 install --user -r $IDF_PATH/requirements.txt

注意esp32中的相關(guān)文件:

esp-idf

components
docs
examples
make
tools
xtensa-esp32-elf

其中xtensa-esp32-elf是工具鏈上渴,可以通過官網(wǎng)下載:

下載完后運行tar -xzf解壓到esp-idf目錄中岸梨。
進入前文下載的micropython的ports/esp32目錄,在目錄下新建腳本env.sh稠氮,將esp-idf及xtensa-esp32-elf所在的路徑寫入腳本中曹阔,在命令行中運行source env.sh設(shè)置編譯所需的環(huán)境變量:

if ! echo "${PATH}" | grep -q "xtensa-esp32-elf"; then
    export PATH="/mnt/h/proj/esp-idf/xtensa-esp32-elf/bin:$PATH"
fi
export IDF_PATH=/mnt/h/proj/esp-idf
export CROSS_COMPILE=xtensa-esp32-elf-

再在該目錄下新建makefie文檔,在文檔中寫入以下內(nèi)容:

#PORT = /dev/ttyUSB0
#FLASH_MODE = qio
#FLASH_SIZE = 4MB
#CROSS_COMPILE = xtensa-esp32-elf-
CONFIG_SPIRAM_SUPPORT = 1
include Makefile

通過以下命令編譯micropython

$ cd ports/esp32
$ make

編譯生成固件的有關(guān)信息:

LINK build/application.elf
   text    data     bss     dec     hex filename
 787097  192024   74368 1053489  101331 build/application.elf
Create build/application.bin
esptool.py v2.5.1
Create build/firmware.bin
bootloader     17808
partitions      3072
application   979264
total        1044800

esp32所需要的bootloader.bin隔披、partitions.bin和application.bin生成在build目錄中赃份。
將esp32連接到電腦的串口上,串口的端口奢米,F(xiàn)LASH的設(shè)置預(yù)定義在Makefile中抓韩,也可以通過makefile重新定義。
在燒錄前請用以下命令擦除FLASH:

$ make erase

如果要將micropython固件寫入esp32恃慧,運行以下指令园蝠,通過esp-idf中的esptool.py腳本下載固件:

$ make deploy

以下是micropython連接WiFi的一個應(yīng)用示例:

def wlan_connect(ssid='MYSSID', password='MYPASS'):
    import network
    wlan = network.WLAN(network.STA_IF)
    if not wlan.active() or not wlan.isconnected():
        wlan.active(True)
        print('connecting to:', ssid)
        wlan.connect(ssid, password)
        while not wlan.isconnected():
            pass
    print('network config:', wlan.ifconfig())

參考文檔

# 鏈接地址 文檔名稱
1 http://www.micropython.org/ 官網(wǎng)資料
2 http://www.micropython.org.cn/bbs/ 官方社區(qū)
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市痢士,隨后出現(xiàn)的幾起案子彪薛,更是在濱河造成了極大的恐慌茂装,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,290評論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件善延,死亡現(xiàn)場離奇詭異少态,居然都是意外死亡,警方通過查閱死者的電腦和手機易遣,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,107評論 2 385
  • 文/潘曉璐 我一進店門彼妻,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人豆茫,你說我怎么就攤上這事侨歉。” “怎么了揩魂?”我有些...
    開封第一講書人閱讀 156,872評論 0 347
  • 文/不壞的土叔 我叫張陵幽邓,是天一觀的道長。 經(jīng)常有香客問我火脉,道長牵舵,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,415評論 1 283
  • 正文 為了忘掉前任倦挂,我火速辦了婚禮畸颅,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘方援。我一直安慰自己没炒,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 65,453評論 6 385
  • 文/花漫 我一把揭開白布肯骇。 她就那樣靜靜地躺著窥浪,像睡著了一般祖很。 火紅的嫁衣襯著肌膚如雪笛丙。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,784評論 1 290
  • 那天假颇,我揣著相機與錄音胚鸯,去河邊找鬼。 笑死笨鸡,一個胖子當(dāng)著我的面吹牛姜钳,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播形耗,決...
    沈念sama閱讀 38,927評論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼哥桥,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了激涤?” 一聲冷哼從身側(cè)響起拟糕,我...
    開封第一講書人閱讀 37,691評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后送滞,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體侠草,經(jīng)...
    沈念sama閱讀 44,137評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,472評論 2 326
  • 正文 我和宋清朗相戀三年犁嗅,在試婚紗的時候發(fā)現(xiàn)自己被綠了边涕。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,622評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡褂微,死狀恐怖功蜓,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情宠蚂,我是刑警寧澤霞赫,帶...
    沈念sama閱讀 34,289評論 4 329
  • 正文 年R本政府宣布,位于F島的核電站肥矢,受9級特大地震影響端衰,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜甘改,卻給世界環(huán)境...
    茶點故事閱讀 39,887評論 3 312
  • 文/蒙蒙 一旅东、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧十艾,春花似錦抵代、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,741評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至庆冕,卻和暖如春康吵,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背访递。 一陣腳步聲響...
    開封第一講書人閱讀 31,977評論 1 265
  • 我被黑心中介騙來泰國打工晦嵌, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人拷姿。 一個月前我還...
    沈念sama閱讀 46,316評論 2 360
  • 正文 我出身青樓惭载,卻偏偏與公主長得像,于是被迫代替她去往敵國和親响巢。 傳聞我的和親對象是個殘疾皇子描滔,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,490評論 2 348

推薦閱讀更多精彩內(nèi)容