對于做linux開發(fā)的研發(fā)人員來說，大家都喜歡通過輸入指令符來執(zhí)行一些命令操作，如果在MCU編程過程中有一個類似linux的shell命令工具可以通過串口調(diào)試助手輸入命令然后運(yùn)行一些調(diào)試函數(shù)，將會為編程提供極大的幫助。

對于MCU來說，每次修改程序調(diào)試就需要重新下載，有時候僅僅是調(diào)試修改幾個參數(shù)，這樣反復(fù)修改程序編譯下載就顯得很繁瑣，浪費(fèi)時間，而且在調(diào)試電機(jī)、電源等高壓電源類應(yīng)用時，如果出現(xiàn)操作錯誤，有可能會造成炸機(jī)毀壞電腦等危險，如果有一個類似linux的命令行操作，這樣就可以省出很多時間，但是由于MCU存儲資源和運(yùn)算速度等限制，所以想實(shí)現(xiàn)一個同樣功能的操作，就需要做一些處理優(yōu)化。

目前有很多類似的shell代碼，本次介紹如何在MM32 MCU上使用shell來輔助開發(fā)，由于篇幅過長，所以將分三個章節(jié)講述實(shí)現(xiàn)方式，本章節(jié)將教大家基礎(chǔ)的軟件配置，后面章節(jié)將帶領(lǐng)大家學(xué)習(xí)如何配置Jlink RTT和shell的程序配置。硬件資源如下：本次實(shí)驗(yàn)將在基于MM32L073的MiniBoard上進(jìn)行測試驗(yàn)證，實(shí)現(xiàn)shell的通信端口可以使用任意通信方式，如UART、USB、SPI、IIC、485等方式，本次使用MM32L073PF的UART1作為shell輸入輸出通道，

如圖2。PA15作為狀態(tài)指示 LED1的控制引腳，如圖3。

圖1?串口硬件原理圖

圖2??LED硬件原理圖 ?軟件資源如下：結(jié)合上述使用到的硬件資源，下面我們著重介紹軟件實(shí)現(xiàn)流程以及相關(guān)配置代碼，主要涉及如何移植shell的輸入輸出以及如何執(zhí)行命令。

以下為主函數(shù)初始化配置及相關(guān)全局變量定義內(nèi)容，代碼如下：
//>>>狀態(tài)指示 LED1的初始化配置>>>
void LED_Init(void)
{
GPIO_InitTypeDef??GPIO_InitStructure;
RCC_AHBPeriphclockCmd(RCC_AHBPeriph_GPIOA, ENABLE); //開啟GPIOA時鐘
GPIO_InitStructure.GPIO_Pin??=??GPIO_Pin_15;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(GPIOA, &GPIO_InitStructure);
LED1_OFF();
}
void uart_nvic_init(u32 bound)
{
//>>>GPIO端口設(shè)置>>>
GPIO_InitTypeDef GPIO_InitStructure;
UART_InitTypeDef UART_InitStructure;
NVIC_InitTypeDef NVIC_InitStructure;
//>>>使能外設(shè)時鐘>>>
RCC_APB2PeriphClockCmd(RCC_APB2Periph_UART1, ENABLE); //使能UART1
RCC_AHBPeriphClockCmd(RCC_AHBPeriph_GPIOA, ENABLE);??//開啟GPIOA時鐘
//>>>UART1 NVIC 配置>>>
NVIC_InitStructure.NVIC_IRQChannel = UART1_IRQn;
NVIC_InitStructure.NVIC_IRQChannelPriority = 3;??//子優(yōu)先級3
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; //IRQ通道使能
NVIC_Init(&NVIC_InitStructure); //根據(jù)指定的參數(shù)初始化NVIC寄存器
//>>>UART的GPIO復(fù)用功能配置>>>
GPIO_PinAFConfig(GPIOA, GPIO_PinSource9, GPIO_AF_1);
GPIO_PinAFConfig(GPIOA, GPIO_PinSource10, GPIO_AF_1);
//>>>UART 初始化設(shè)置>>>
UART_InitStructure.UART_BaudRate = bound;//串口波特率
UART_InitStructure.UART_WordLength = UART_WordLength_8b;//字長為8位數(shù)據(jù)格式
UART_InitStructure.UART_StopBits = UART_StopBits_1;//一個停止位
UART_InitStructure.UART_Parity = UART_Parity_No;//無奇偶校驗(yàn)位
UART_InitStructure.UART_HardwareFlowControl = UART_HardwareFlowControl_None;//無硬件數(shù)據(jù)流控制
UART_InitStructure.UART_Mode = UART_Mode_Rx | UART_Mode_Tx; //收發(fā)模式
UART_Init(UART1, &UART_InitStructure); //初始化串口1
UART_ITConfig(UART1, UART_IT_RXIEN, ENABLE);//開啟串口接受中斷
UART_Cmd(UART1, ENABLE);? ?? ?? ?? ?? ?? ???//使能串口1
//>>>UART1_TX? ?GPIOA.9>>> UART1_RX? ? GPIOA.10>>>
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; //PA.9
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; //復(fù)用推挽輸出
GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化GPIOA.9
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;//PA10
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOAtiNG;//浮空輸入
GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化GPIOA.10
}
//>>>UART發(fā)送一個字節(jié) >>>
void Uart_PutChar(char chByte)
{
while ((UART1->CSR & UART_IT_TXIEN) == 0);
UART1->TDR = (chByte & (uint16_t)0x00FF);
}
//>>>UART 發(fā)送字符串>>>
void Uart_PutBuff(uint8_t *pchBuff, uint32_t wLen)
{
while (wLen--) {
Uart_PutChar(*pchBuff);
pchBuff++;
}
}
//>>>main主函數(shù) >>>
int main(void)
{
delay_init();
LED_Init();
uart_nvic_init(115200);??//串口初始化為115200
//uart_shell.read = shellRead;
uart_shell.write = Uart_PutChar;
shellInit(&uart_shell);//shell初始化
while (1)
{
}
}
移植的步驟先定義一個shell對象，即：SHELL_TypeDef uart_shell;
然后實(shí)例化對象的操作接口，對于本次我們采用中斷接收，所以不用調(diào)用讀取接口函數(shù)，所以接收接口如下修改：
//uart_shell.read = shellRead; 注釋掉讀取接口，采用中斷處理代碼如下：
void UART1_IRQHandler(void)? ?? ?? ?? ?? ???//串口1中斷服務(wù)程序
{
u8 Res;
IF?(UART_GetITStatus(UART1, UART_IT_RXIEN)??!= RESET){
UART_ClearITPendingBit(UART1, UART_IT_RXIEN);
Res = UART_ReceiveData(UART1);//讀取接收到的數(shù)據(jù)
shellHandler(&uart_shell, Res);//shell處理函數(shù)
}
}
然后實(shí)例化發(fā)送接口，代碼如下：uart_shell.write = Uart_PutChar;
最后實(shí)例化對象，代碼如下：shellInit(&uart_shell);
完成shell對象的全部實(shí)例化，那么我們?nèi)绾渭尤胛覀冃枰拿詈瘮?shù)呢？很簡單，有多種方式，本次我們介紹最簡單的一個，即SHELL_EXPORT_CMD();其它參考源碼，本次我們加入測試代碼如下：
void led1_on(void)
{
LED1_ON();
}
SHELL_EXPORT_CMD(led1_on, led1_on, led1_on);//三個變量：命令，功能，描述
void led1_off(void)
{
LED1_OFF();
}
SHELL_EXPORT_CMD(led1_off, led1_off, led1_off);//同上
void led1_toggle(void)
{
LED1_TOGGLE();
}
SHELL_EXPORT_CMD(led1_toggle, led1_toggle, led1_toggle);
void reboot(void)
{
NVIC_SystemReset();
}
SHELL_EXPORT_CMD(reboot, reboot, reboot);
如上完成所有代碼后下載燒寫進(jìn)入，然后打開PuTTY，設(shè)置為115200，界面如下：



?

圖3??命令列表 選擇輸入對應(yīng)的指令命令，MCU執(zhí)行對應(yīng)的指令操作；比如輸入led1_on即可打開led1，輸入led1_off關(guān)閉led1，輸入led1_toggle反轉(zhuǎn)led1亮滅，輸入reboot則MCU重啟，輸入cls清除當(dāng)前窗口。 ?

圖4??控制LED1亮

本次實(shí)驗(yàn)的的外設(shè)配置及操作如上所述，在下一章節(jié)將帶領(lǐng)大家學(xué)習(xí)shell的程序和Jlink RTT的配置等。

原文標(biāo)題：基于MM32 MCU的shell調(diào)試教程（一）

文章出處：【微信公眾號：MCU開發(fā)加油站】歡迎添加關(guān)注！文章轉(zhuǎn)載請注明出處。