- 现象:当打开 finsh 组件后,控制台会打相应的信息,如下图说是:
\ | /
- RT - Thread Operating System
/ | \ 3.1.5 build Jul 6 2022
2006 - 2020 Copyright by rt-thread team
do components initialization.
initialize rti_board_end:0 done
initialize finsh_system_init:0 done
RT-Thread Start......
msh >
但是输入回车或任意内容时,无反应。当然导致这样的现象有两种可能,一种可能是未正常开启相应的配置,第二种是未对接收字符的函数进行实现,具体看下面内容
- FinSH 组件在 rtconfig.h 中的配置,如下所示:
/* --------------------------------- RT-Thread 内核部分 --------------------------------- */
/* 表示内核对象的名称的最大长度,若代码中对象名称的最大长度大于宏定义的长度,
* 多余的部分将被截掉。*/
#define RT_NAME_MAX 8
/* 字节对齐时设定对齐的字节个数。常使用 ALIGN(RT_ALIGN_SIZE) 进行字节对齐。*/
#define RT_ALIGN_SIZE 4
/* 定义系统线程优先级数;通常用 RT_THREAD_PRIORITY_MAX-1 定义空闲线程的优先级 */
#define RT_THREAD_PRIORITY_MAX 32
/* 定义时钟节拍,为 100 时表示 100 个 tick 每秒,一个 tick 为 10ms */
#define RT_TICK_PER_SECOND 1000
/* 检查栈是否溢出,未定义则关闭 */
#define RT_USING_OVERFLOW_CHECK
/* 定义该宏开启 debug 模式,未定义则关闭 */
#define RT_DEBUG
/* 开启 debug 模式时:该宏定义为 0 时表示关闭打印组件初始化信息,定义为 1 时表示启用 */
#define RT_DEBUG_INIT 1
/* 开启 debug 模式时:该宏定义为 0 时表示关闭打印线程切换信息,定义为 1 时表示启用 */
#define RT_DEBUG_THREAD 0
/* 定义该宏表示开启钩子函数的使用,未定义则关闭 */
//#define RT_USING_HOOK
/* 定义了空闲线程的栈大小 */
#define IDLE_THREAD_STACK_SIZE 1024
FinSH 移植
FinSH 组件使用有三种种方式,如下:
-
通过 rt_hw_console_getchar() 函数获取控制台数据
FinSH 线程的使用方式主要是通过实现rt_hw_console_getchar()函数,获取控制台输入的数据,具体方式看我之前的笔记,STM32 移植 RT-Thread 标准版的 FinSH 组件 。 -
通过外设驱动中的 数据流(stm32_getc函数) 获取控制台数据
具体实现方式见UART外设的移植,稍后我也会将我移植的过程发出来,有需要的可以看我之后的笔记。 -
通过外设驱动中的 中断方式 获取控制台数据
中断的方式包涵了DMA的方式获取控制台数据。
注意: 第二和第三中方式其实都是通过RT-Thread中的外设驱动获取的,这里我为啥会将 数据流和中断 分开说明,是因为他们之间会引入一个新的问题,具体见之后的流程
二、设备为空问题-
现象:msh >(dev != RT_NULL) assertion failed at function:rt_device_read, line number:320
-
原因:出现这个现象主要是在注册设备的时候导致的,在注册设备的时候才用了数据流的方式回去了数据,如下所示:
/* 配置串口设备 */ result = rt_hw_serial_register(&uart_obj[i].serial, uart_obj[i].config->name, RT_DEVICE_OFLAG_RDWR | RT_DEVICE_FLAG_INT_RX | RT_DEVICE_FLAG_INT_TX , NULL);
相应的配置宏如下所示:
#define RT_DEVICE_FLAG_RDONLY 0x001 /* 只读 */ #define RT_DEVICE_FLAG_WRONLY 0x002 /* 只写 */ #define RT_DEVICE_FLAG_RDWR 0x003 /* 读写 */ #define RT_DEVICE_FLAG_REMOVABLE 0x004 /* 可移除 */ #define RT_DEVICE_FLAG_STANDALONE 0x008 /* 独立 */ #define RT_DEVICE_FLAG_SUSPENDED 0x020 /* 挂起 */ #define RT_DEVICE_FLAG_STREAM 0x040 /* 流模式 */ #define RT_DEVICE_FLAG_INT_RX 0x100 /* 中断接收 */ #define RT_DEVICE_FLAG_DMA_RX 0x200 /* DMA 接收 */ #define RT_DEVICE_FLAG_INT_TX 0x400 /* 中断发送 */ #define RT_DEVICE_FLAG_DMA_TX 0x800 /* DMA 发送 */
认真思考的小伙伴就会存在一个疑问,为啥将数据接收注册为 流模式 会导致设备为空了,可以猜测在某处导致了设备丢失,我们仔细找一下代码就会发现在shell.c文件中,通过了中断的方式打开了设备,如下图所示:
现在原因找到了,那么解决方式有两种,如下所示:
-
将注册设备时,改为中断接收的方式注册设备
-
将shell.c文件中的发开方式改为流模式即可,只需要将 RT_DEVICE_FLAG_INT_RX 屏蔽,如下所示:
void finsh_set_device(const char *device_name) { rt_device_t dev = RT_NULL; RT_ASSERT(shell != RT_NULL); dev = rt_device_find(device_name); if (dev == RT_NULL) { rt_kprintf("finsh: can not find device: %s\n", device_name); return; } /* check whether it's a same device */ if (dev == shell->device) return; /* open this device and set the new device in finsh shell */ if (rt_device_open(dev, RT_DEVICE_OFLAG_RDWR | // RT_DEVICE_FLAG_INT_RX | RT_DEVICE_FLAG_STREAM) == RT_EOK) { if (shell->device != RT_NULL) { /* close old finsh device */ rt_device_close(shell->device); rt_device_set_rx_indicate(shell->device, RT_NULL); } /* clear line buffer before switch to new device */ memset(shell->line, 0, sizeof(shell->line)); shell->line_curpos = shell->line_position = 0; shell->device = dev; rt_device_set_rx_indicate(dev, finsh_rx_ind); } }
** 注意:** 改为流模式后,会发现一个奇怪的现象,就是当你使用调试模式时,可以正常接收指令,但是正常运行时,就无任何响应,遇到这样的现象不要慌,接着往下看。
-
现象:FinSH线程卡死,明显的发现就是,使用调试模式时,可以正常接收指令,但是正常运行时,就无任何响应。
-
原因:深入分析后,会在 shell.c 文件中的 finsh_getchar 函数中看到信号量的使用,如下图所示:
现在原因找到了,那么我们只需要在适当的时候释放信号量即可,那我们在找找看看有么有信号释放的函数,接下来我们会发现在 shell.c 文件中 finsh_rx_ind 函数就是释放信号量的,如图所示:
那么新的问题又来了,怎么调用这个函数了,因为在shell.h文件中也没有这个函数的定义, 不要怕我们接着找,最后在shell.c 文件中的 finsh_set_device 函数中,会将释放信号量的函数指针放入 rt_device 结构体中,如下图所示:
那么问题就变得简单了,解决办法如下
-
解决办法:我们已经知道怎么释放信号量了,所以只需要在 数据接收函数(stm32_getc)中,完成数据接收后,释放信号量即可,如下所示:
/** * 接收一个字符数据 */ static int stm32_getc(struct rt_serial_device *serial) { int ch; struct stm32_uart *uart; RT_ASSERT(serial != RT_NULL); uart = rt_container_of(serial, struct stm32_uart, serial); ch = -1; if (USART_GetFlagStatus(uart->handle.Instance, USART_FLAG_RXNE) != RESET) { #if defined(SOC_SERIES_STM32L4) || defined(SOC_SERIES_STM32F7) || defined(SOC_SERIES_STM32F0) \ || defined(SOC_SERIES_STM32L0) || defined(SOC_SERIES_STM32G0) || defined(SOC_SERIES_STM32H7) \ || defined(SOC_SERIES_STM32G4) ch = uart->handle.Instance->RDR & 0xff; #else // ch = (uint16_t)uart->handle.Instance->DR & (uint16_t)0x00ff; ch = (char)USART_ReceiveData(uart->handle.Instance); #endif } /* 调用设备接收数据回调,释放信号量 */ uart->serial.parent.rx_indicate(&serial->parent, 0); return ch; }
解决完问题后,在控制台输入回车有相应的回应就没问题,如下图所示:
如本博客的内容侵犯了你的权益,请与以下地址联系,本人获知后,马上删除。同时本人深表歉意,并致以崇高的谢意! computer_wx@foxmail.com