前言
盡管仍然很多癡男怨女在 v1 v2 身上跌倒、跌倒、繼續跌倒，仍然阻止不了他們飛蛾撲火式的被 v1 v2 的缺陷所吸引而殉情。

它一如既往的保持著優良的特性，也有可能是很多人沒發現，主要是接受它的人很少。不過，這不影響今天它帶來新的特性。

阻塞超時
我們一直強調，它有與之前非同一般的兩個概念“阻塞”“非阻塞”。雖然 v2 熱火朝天的提出了這兩個概念，但是實現的效果卻不盡人意。

在之前的正式文檔里，我沒膽量承認一個事實，那就是，阻塞讀在無數據可讀的時候將永遠阻塞下去。某些應用場景并不希望這樣，我們希望等待某設備響應，若干時間后無響應超時，我們返回繼續做其它工作，而不是被無響應的設備永久占用。

給某些論壇提問里的解答時，我提到過幾次 serialX 可以通過以下技術手段應對這種場景。

方法一
使用非阻塞模式打開，超時讀過程偽代碼可能如下這樣：

while(timeout > 0) {
read
sleep 1
timeout -= 1
}
if (timeout == 0) {
// timeout here
} else {
// no timeout
}
方法二
使用完成中斷 indicate 回調函數發消息，這也是官方提供的讀串口設備的“標準”方式

static void serial_thread_entry(void parameter)
{
char ch;
while (1)
{
/ 從串口讀取一個字節的數據，沒有讀取到則等待接收信號量 /
while (rt_device_read(serial, -1, &ch, 1) != 1)
{
/ 阻塞等待接收信號量，等到信號量后再次讀取數據 */
rt_sem_take(&rx_sem, timeout);
}
...
}
}
注：此段代碼改編自官方文檔

大多數人第一次使用 rtt 的串口設備也是用這段代碼測試的。但是，serialX 不提倡大家使用 indicate 回調函數。

serialX 有它自己的特性，它有它自己的優美性，那就是盡可能不給應用層代碼帶來麻煩，不要寫太復雜難懂的邏輯，不要給應用層引入莫名未知的后果。

我們希望在不影響不改變之前的使用的前提下，rt_device_read 能夠在預定的時間內超時返回退出，并不是用于阻塞下去，同時 rt_device_read 返回 -RT_ETIMEOUT 錯誤碼。應用層可以根據 rt_device_read 返回值

== 0 無數據
0 有數據

< 0 有錯誤（-RT_ETIMEOUT 超時）
分別處理不同情況。
serialX 的實現
首先，rtdef.h 添加定義，用于設備超時配置

#define RT_DEVICE_CTRL_TIMEOUT 0x30 /**< timeout for blocking */
其次，struct rt_serial_device 添加 rt_tick_t timeout_tick; 變量，設備超時時間 tick 。

然后，rt_serial_control 函數添加超時配置宏選項處理

case RT_DEVICE_CTRL_TIMEOUT:
    rt_tick_t timeout_tick = (rt_tick_t)args;
    serial- >timeout_tick = timeout_tick;
break;

最后，在 serialX.c 文件中所有涉及到阻塞的地方（包括讀寫，不包含 flush）修改 rt_completion_wait 第二個參數為 serial->timeout_tick。并當 rt_completion_wait 返回 -RT_ETIMEOUT 時退出當前讀寫操作返回應用層。

注意：特別說明，我們希望一個設備以阻塞模式打開時，默認的阻塞超時時間是“永久”，所以，每次 rt_device_open 后 serialX 設定阻塞超時時間時間是 RT_WAITING_FOREVER 。如果需要指定某超時時間需要 rt_device_control(serial_dev, RT_DEVICE_CTRL_TIMEOUT, &timeout);

rt_tick_t timeout = 50;
if (rt_device_open(scpi_uart_dev, RT_DEVICE_OFLAG_RDWR
                           | RT_DEVICE_FLAG_INT_RX
                           | RT_DEVICE_FLAG_INT_TX
                           | RT_DEVICE_OFLAG_BLOCKING) != RT_EOK)
{
    rt_kprintf("Open device: %s failedn", UART_DEV_NAME);
    return;
}
rt_device_control(serial_dev, RT_DEVICE_CTRL_TIMEOUT, &timeout);
rt_ssize_t ret = rt_device_read(serial_dev, -1, &recvbuf[0], 128);
if (ret == -RT_ETIMEOUT) {
    rt_device_close(serial_dev);
    return;
} else {
}

這就是今天我們要講的第三種方法，相比前兩種，這種方法更優雅些，代碼邏輯也清晰。

總結
歡迎大家入坑 serialX。