前言

終于來(lái)到了 serialX 的實(shí)踐篇，期待很久了。

筆者曾經(jīng)在 [rt-thread 使用寶典（2022-0516更新）](https://club.rt-thread.org/ask/article/2460fcd7db4821ae.html) 這篇文章的“使用篇： Q1. 串口通訊數(shù)據(jù)被分多次接收了，怎么辦？”里貼了一段代碼，那段代碼有很強(qiáng)的適用性，稍作修改就能用到多種串口協(xié)議處理場(chǎng)合。今天我們嘗試在 finsh 上應(yīng)用 serialX，看看它能給我們帶來(lái)什么神奇效果。

打開(kāi)控制臺(tái)

我們的 serialX 支持中斷收發(fā)、DMA 收發(fā)。所以我們可以隨意組合使用 中斷收、中斷發(fā)、DMA 收、DMA 發(fā)，共四種組合（前提是對(duì)應(yīng)芯片底層驅(qū)動(dòng)支持 DMA）。

   if (rt_device_open(new_device, RT_DEVICE_OFLAG_RDWR                                | RT_DEVICE_FLAG_STREAM                                | RT_DEVICE_FLAG_INT_RX                                | RT_DEVICE_FLAG_INT_TX       ) == RT_EOK) {   }

或者

   if (rt_device_open(new_device, RT_DEVICE_OFLAG_RDWR                                | RT_DEVICE_FLAG_STREAM                                | RT_DEVICE_FLAG_DMA_RX                                | RT_DEVICE_FLAG_DMA_TX       ) == RT_EOK) {   }

因?yàn)?serialX 自帶阻塞讀特性，所以它不需要執(zhí)行 `rt_device_set_rx_indicate(dev, finsh_rx_ind);` 這句代碼，我們接收數(shù)據(jù)自有同步妙法，請(qǐng)往下看。

finsh 線程

對(duì) finsh 線程入口函數(shù)稍作修改：

void finsh_thread_entry(void *parameter){   int i, cnt;   char istream[32];   ... 省略部分操作   while (1) {       cnt = finsh_instream(istream, 32);       for (i = 0; i < cnt; i++) {           finsh_handle_onebyte(istream[i]);       }   }}

1. finsh 線程提供一個(gè)應(yīng)用層的數(shù)據(jù)緩存 `istream` ，這里只用的 32 個(gè)字節(jié)。
2. `finsh_instream` 函數(shù)代替 `finsh_getchar` ，它用來(lái)讀串口終端設(shè)備數(shù)據(jù)流，函數(shù)實(shí)現(xiàn)見(jiàn)下文。它可能返回多個(gè)字節(jié)數(shù)據(jù)，返回值表示有效數(shù)據(jù)個(gè)數(shù)
3. 接下來(lái)對(duì) `finsh_instream` 讀到的每字節(jié)數(shù)據(jù)進(jìn)行處理
4. `finsh_handle_onebyte` 是對(duì)原來(lái) `finsh_thread_entry` 函數(shù)中的 `while` 循環(huán)進(jìn)行的改造

讀終端串口設(shè)備

如果 serialX 的阻塞模式打開(kāi)的，同時(shí)串口接收緩存里是空的，執(zhí)行 `rt_device_read` 會(huì)永久等待下去，當(dāng)前線程進(jìn)入睡眠態(tài)。

int finsh_instream(char *buf, int len){#ifdef RT_USING_DEVICE   int i;   RT_ASSERT(shell != RT_NULL);   i = rt_device_read(shell->device, -1, buf, len);   return i;#else   extern char rt_hw_console_getchar(void);   return rt_hw_console_getchar();#endif /* RT_USING_DEVICE */}

讀串口設(shè)備的數(shù)據(jù)放到 buf 指向的內(nèi)存中，最多 len 個(gè)字節(jié)，最終返回實(shí)際讀到的數(shù)據(jù)量。

注：`rt_device_read` 的返回值可能是 0，也可能會(huì)是 -1。

處理命令行字符

這部分筆者把他們放到了一個(gè)單獨(dú)的函數(shù)，不這么做也沒(méi)影響。
筆者做了一點(diǎn)兒小改進(jìn)。

static void finsh_handle_onebyte(int ch){   static int last_ch = 0x20;   ...   /* handle end of line, break */   if (last_ch == '\r' && ch == '\n') {       last_ch = ch;       return;   }   if (ch == '\r' || ch == '\n')   {#ifdef FINSH_USING_HISTORY       shell_push_history(shell);#endif       if (shell->echo_mode)           rt_kprintf("\n");       msh_exec(shell->line, shell->line_position);       rt_kprintf(FINSH_PROMPT);       rt_memset(shell->line, 0, sizeof(shell->line));       shell->line_curpos = shell->line_position = 0;       last_ch = ch;       return;   }   ...   last_ch = ch;   //        ch = 0;   ...}

這樣一來(lái)，對(duì)以 '\r' '\n' "\r\n" 三種組合結(jié)束的命令都能識(shí)別，**更重要的是，它可以識(shí)別以 '\r' '\n' "\r\n" 分割的多條命令?。?！**
如下命令列表，可以全復(fù)制，粘貼到終端，四條命令逐個(gè)被執(zhí)行。

lspslist_devicelist_thread

效果圖

結(jié)束語(yǔ)

在 rt-thread 的 finsh 終端串口設(shè)備使用 serialX 驅(qū)動(dòng)。初戰(zhàn)告捷！

這次解決兩個(gè)問(wèn)題：一個(gè)是， finsh 執(zhí)行 `rt_device_read` 時(shí)可以一次返回多個(gè)字節(jié)。另一個(gè)是，我們可以在終端里粘貼多條命令執(zhí)行啦。

審核編輯：湯梓紅