當(dāng)前位置:首頁 > 嵌入式培訓(xùn) > 嵌入式學(xué)習(xí) > 講師博文 > WRTnode進(jìn)階篇:stm32開發(fā)
1. 簡介
WRTnode2R大的特征,便是雙核雙系統(tǒng):MTK7688+STM32F103T8U6以及它們對(duì)應(yīng)的操作系統(tǒng)OpenWrt+RT-Thread。
在OpenWrt之外引入了MCU:既有完善OpenWrt的可用資源,如:模擬采集、定時(shí)器的捕獲、PWM的輸入,以及更多的PWM輸出,更多的GPIO和其他輸出具備可靠的“硬”實(shí)時(shí)能力,在Linux中無法承載毫秒級(jí)的精確延時(shí),而MCU則正好擅長此任務(wù);由此嫁接OpenWrt所帶來的Linux廣泛的現(xiàn)有軟件資源和多媒體、人工智能應(yīng)用的能力,同時(shí)STM32核心提供了更底層的開發(fā)能力和更加可靠的物理交互能力。
2. WRTnode 的stm32開發(fā)
在WRTnode2R核心板上,STM32和7688之間通過SPI總線連接,占用7688的CS1引腳。在WRTnode2R標(biāo)準(zhǔn)底板上,引出STM32的JTAG調(diào)試引腳、串口、I2C以及其他未使用的所有GPIO引腳。具體引腳布局圖,詳見WRTnode2R針腳定義和底板針腳定義
WRTnode2R的STM32上運(yùn)行著RT-Thread實(shí)時(shí)操作系統(tǒng),受益于RTT中友好的msh命令行調(diào)試組件,在出廠固件中實(shí)現(xiàn)了RTT的spi slave設(shè)備驅(qū)動(dòng),并且將msh的輸入輸出端口都映射到了spi總線上。同時(shí)提供了在7688上與STM32通過SPI總線通信的軟件(包括spiS0設(shè)備驅(qū)動(dòng)、spi-bridge通信軟件和flash-stm32固件升級(jí)程序)。
體驗(yàn)stm32上的msh: 登錄到WRTnode2R上。(登錄的方式有串口、telnet、ssh) 升級(jí)stm32固件
本文檔主要是針對(duì)新版本的stm32固件做的一些闡述,所以建議大家更新stm32固件。
$ wget //d.wrtnode.com/2R-stm32/flash-stm32 -O /usr/bin/flash-stm32$ flash-stm32
注:如果flash-stm32后面不跟參數(shù),會(huì)自動(dòng)下載并請(qǐng)求升級(jí)新的stm32固件;flash-stm32加上指定版本的固件(服務(wù)器上的或本地的版本),請(qǐng)求升級(jí)指定版的stm32固件。升級(jí)完以后stm32會(huì)自動(dòng)重啟。
root@OpenWrt:~# flash-stm32 --help
---------------------------------------------------------------------------Usage: flash-stm32
Example #1: Updated to the latest version
flash-stm32
Example #2: Update to the specified version(server or local)
flash-stm32 //d.wrtnode.com/2R-stm32/$Stm32Firmware
or
flash-stm32 /tmp/$Stm32Firmware
---------------------------------------------------------------------------
root@OpenWrt:~# flash-stm32
Download the latest version form //d.wrtnode.com/2R-stm32/update
Connecting to d.wrtnode.com (66.33.205.160:80)
- 100% |********************************************************************************************| 5 0:00:00 ETA
Connecting to d.wrtnode.com (66.33.205.160:80)
WRTnode2r_STM32_rtth 100% |********************************************************************************************| 30404 0:00:00 ETA
The latest version is 0.7
No gets to the current STM32 version. Ple input "Y" to continue to upgrade or input "N" to cancel upgrade!
input Y or N:Y
write ...###############################################################################################write end!
check ...
###############################################################################################check end!
restart ...
restart end
root@OpenWrt:~#
輸入spi-bridge即可打開和stm32的msh命令行終端,先按下tab鍵再按下enter鍵列出msh支持的所有命令。
$ spi-bridge
若要執(zhí)行某一條命令,輸入命令后按下enter即可執(zhí)行。
exit退出msh。
如果要單命令方式執(zhí)行,亦可以通過spi-bridge來實(shí)現(xiàn),僅需要輸入spi-bridge write [cmd]即可。如果stm32正在執(zhí)行之前的指令,導(dǎo)致寫緩存滿的話,此命令將阻塞,直至可以執(zhí)行。
如果要讀取命令執(zhí)行的結(jié)果,輸入spi-bridge read即可。如果stm32讀數(shù)據(jù)緩存為空,則命令會(huì)阻塞,直至有數(shù)據(jù)可讀。
[注]由于7688芯片上SPI總線的特殊性,現(xiàn)階段暫時(shí)未能給用戶提供標(biāo)準(zhǔn)的SPI CS1的操作接口,所以用戶暫時(shí)只能通過spi-bridge進(jìn)行通信。
$ spi-bridge write list_timer
$ spi-bridge read
Arduino函數(shù)的兼容:maple
WRTnode2R的STM32上已經(jīng)移植好了Maple固件庫。Maple固件庫為使用stm32的用戶提供了兼容Arduino代碼的接口。用戶如果要移植Arduino上的代碼到WRTnode2R的stm32上,需要做一點(diǎn)簡單的移植工作即可。
[注]因?yàn)锳rduino的應(yīng)用工程均為C++代碼,但是WRTnode2R的stm32上運(yùn)行的rtt是在c編譯器下編譯執(zhí)行的,所以在移植工程時(shí)必然需要做一點(diǎn)移植工作,F(xiàn)有的工程中,已經(jīng)將maple庫的所有接口增加了一層c語言的封裝,讓用戶可以在c代碼中直接調(diào)用,所以用戶可以選擇將Arduino的應(yīng)用代碼用C語言重構(gòu),或者將應(yīng)用代碼增加一層C語言的封裝,供RTT調(diào)用。
通過spi-bridge對(duì)STM32的IO口進(jìn)行控制 當(dāng)前版本已經(jīng)為用戶提供了msh調(diào)用Maple的GPIO庫的命令,這里為大家提供了一個(gè)參考例程。 控制IO語句的使用十分簡單,與arduino相仿,目前可以使用的語句包括pinMode/digitalRead/digitalWrite/togglePin/analogRead/pmwWrite 本文主要演示pinMode、digitalWrite及pwmWrite的用法。 先看針腳的定義:
extern const stm32_pin_info PIN_MAP[BOARD_NR_GPIO_PINS] = {
PMAP_ROW(GPIOA, 0, TIMER2, 1, ADC1, 0), /* D0/PA0 */
PMAP_ROW(GPIOA, 1, TIMER2, 2, ADC1, 1), /* D1/PA1 */
PMAP_ROW(GPIOA, 8, TIMER1, 1, NULL, ADCx), /* D2/PA8 */
PMAP_ROW(GPIOB, 2, NULL, 0, NULL, ADCx), /* D3/PB2 */
PMAP_ROW(GPIOA, 3, TIMER2, 4, ADC1, 3), /* D4/PA3 */
PMAP_ROW(GPIOB, 0, TIMER3, 3, ADC1, 8), /* D5/PB0 */
PMAP_ROW(GPIOA, 11, TIMER1, 4, NULL, ADCx), /* D6/PA11 */
PMAP_ROW(GPIOA, 12, NULL, 0, NULL, ADCx), /* D7/PA12 */
PMAP_ROW(GPIOB, 5, NULL, 0, NULL, ADCx), /* D8/PB5 */
PMAP_ROW(GPIOA, 10, TIMER1, 3, NULL, ADCx), /* D9/PA10 */
PMAP_ROW(GPIOA, 9, TIMER1, 2, NULL, ADCx), /* D10/PA9 */
PMAP_ROW(GPIOB, 6, TIMER4, 1, NULL, ADCx), /* D11/PB6 */
PMAP_ROW(GPIOB, 7, TIMER4, 2, NULL, ADCx), /* D12/PB7 */
PMAP_ROW(GPIOB, 1, TIMER3, 4, ADC1, 9), /* D13/PB1 */
PMAP_ROW(GPIOA, 2, TIMER2, 3, ADC1, 2), /* D14/PA2 */
PMAP_ROW(GPIOA, 4, NULL, 0, NULL, ADCx), /* D15/PA4 */
PMAP_ROW(GPIOA, 5, NULL, 0, NULL, ADCx), /* D16/PA5 */
PMAP_ROW(GPIOA, 6, NULL, 0, NULL, ADCx), /* D17/PA6 */
PMAP_ROW(GPIOA, 7, NULL, 0, NULL, ADCx), /* D18/PA7 */
};
注釋/* D0/PA0 / / D5/PB0 */等,Dxx就代表的xx引腳,Pxx就是對(duì)應(yīng)芯片的引腳(也就是對(duì)應(yīng)WRTnode2R標(biāo)準(zhǔn)底板絲印上的引腳);比如,下面我操作的是3引腳(D3),對(duì)應(yīng)底板上的PB2。 其中支持PWM的PIN為0, 1, 2, 4, 5, 6, 9, 10, 11, 12, 13, 14 支持ADC的PIN為0, 1, 4, 5, 13, 14 其中D15-D18引腳已經(jīng)被spi占用 完整的定義在github上可以找到: https://github.com/WRTnode/wrtnode2r_stm32/blob/master/maple/wirish/boards/wrtnode2/board.cpp#L67
root@OpenWrt:~# spi-bridge
RT-Thread shell commands:reset - reset to bootloader.2r_version - get wrtnode2r stm32 version.
pwmWrite - pwmWrite pinNum duty_cycle.
analogRead - analogRead pinNum.
togglePin - togglePin pinNum.
digitalWrite -digitalWrite pinNum 0x1/0x0.
digitalRead - digitalRead pinNum.
pinMode - pinMode pinNum mode.
list_device - list device in system
list_timer - list timer in system
list_mempool - list memory pool in system
list_mutex - lst mutex in system
list_event - list event in system
list_sem - list semaphore in system
list_thread - list threadversion - show RT-Thread version informationhelp - RT-Thread shell help.
free - Show th memory usage in the system.time - Execute command with time.
ps - List threads in the system.
msh >
msh > pinMode 3 OUTPUT //pinMode第一個(gè)參數(shù)指引腳3;第二個(gè)參數(shù)設(shè)置引腳3狀態(tài)為OUTPUT ;pinMode沒有返回值,命令執(zhí)行之后直接按下enter鍵即可
msh > digitalWrite 3 HIGH //digitalWrit第一個(gè)參數(shù)指引腳3;第二個(gè)參數(shù)設(shè)置引腳3的電平為高
msh > digitalWrite 3 LOW //digitalWrit第一個(gè)參數(shù)指引腳3;第二個(gè)參數(shù)設(shè)置引腳3的電平為低
pinMode用于設(shè)置管腳的屬性(輸入還是輸出),命令格式為
pinMode pinNum mode
mode可以數(shù)字或以下關(guān)鍵詞
OUTPUT
OUTPUT_OPEN_DRAIN
INPUT_ANALOG
INPUT_PULLUP
INPUT_PULLDOWN
INPUT_FLOATING
PWM
PWM_OPEN_DRAIN
完整的定義在github上可以找到: https://github.com/WRTnode/wrtnode2r_stm32/blob/master/applications/application.c#L66
digitalWrite用于控制輸出管腳的輸出電平,命令格式如下:
digitalWrite pinNum HIGH/LOW
再來介紹pwmWrite命令,命令格式如下:
pwmWrite pinNum duty_cycle
其中,duty_cycle的取值范圍是0~65535,占空比就是duty_cycle/65535 當(dāng)然,首先要將管腳設(shè)置為PWM模式,通過以下命令
$ pinMode 0 PWM
3. 在腳本語言中調(diào)用Arduino函數(shù)與STM32交互
用0、1、2、6引腳(PA0、PA1、PA8、PA11)做跑馬燈
#!/bin/sh
spi-bridge write "pinMode 0 0"
spi-bridge write "pinMode 1 0"
spi-bridge write "pinMode 2 0"
spi-bridge write "pinMode 6 0"while truedo
spi-bridge write "digitalWrite 0 1"
sleep 1
spi-bridge write "digitalWrite 0 0"
spi-bridge write "digitalWrite 1 1"
sleep 1
spi-bridge write "digitalWrite 1 0"
spi-bridge write "digitalWrite 2 1"
sleep 1
spi-bridge write "digitalWrite 2 0"
spi-bridge write "digitalWrite 6 1"
sleep 1
spi-bridge write "digitalWrite 6 0"
done
4. 代碼下載及編譯
WRTnode2R上STM32的全部代碼均開源,用戶可以任意下載。
Github repo:https://github.com/WRTnode/wrtnode2r_stm32
有些用戶希望能夠在usart1上使用msh,而不是通過7688的spi,將msh映射到usart1的branch,代碼庫如下:https://github.com/WRTnode/wrtnode2r_stm32/tree/uart-msh
編譯流程:
首先安裝python scons gcc-arm-none-eabi(4.8 or above),然后執(zhí)行以下代碼:$ mkdir wrtnode2r-stm32$ cd wrtnode2r-stm32$ git clone https://github.com/WRTnode/wrtnode2r_stm32 wrtnode2r_stm32$ git clone https://git.oschina.net/SchumyHao/rt-thread.git rtt$ cd wrtnode2r_stm32
設(shè)置gcc路徑:
$ vi rtconfig.py$ scons
編譯成功后,生成的rtthread.bin即為stm32的固件。 固件更新
在WRTnode2R的stm32上,為了實(shí)現(xiàn)在7688上更新stm32的固件,在stm32的前4k地址燒寫了一個(gè)bootloader程序,同時(shí)在7688上也提供了刷寫固件的程序flash-stm32。 如果使用flash-stm32,用戶僅需要執(zhí)行
flash-stm32 URL
URL這個(gè)命令行參數(shù)可以是stm32固件的鏈接,也可以是指定的本地stm32系統(tǒng);就可以將存在服務(wù)器上的固件或者本地的固件燒寫到stm32中。
如果用戶希望進(jìn)行stm32的開發(fā),建議用戶使用stlink等在線調(diào)試工具來開發(fā)、調(diào)試和燒寫代碼。在開發(fā)前只需要注意點(diǎn)三: 1.用戶開發(fā)的代碼中要將中斷向量表重定向到0x08001000位置。 2.用戶代碼下載時(shí),要下載到0x08001000位置。 3.如果用戶完全拋棄提供的代碼進(jìn)行開發(fā),但是又希望能夠支持在線更新固件的功能,需要在用戶開發(fā)的代碼中實(shí)現(xiàn)7688控制stm32復(fù)位的功能。(在提供的代碼中,已經(jīng)實(shí)現(xiàn)了reset這個(gè)cmd,所以基于提供的代碼進(jìn)行開發(fā),不需要完成這一步)