FinSH

关于用STM32CubeMAX 生成的Keil工程，如何添加finsh shell 问题

发布于 2017-11-16 12:43:12 浏览：5639 订阅该版

9 个回答

tanek 2017-11-16

这家伙很懒，什么也没写！

cnbeta2004 2017-12-04

这家伙很懒，什么也没写！

bernard 2017-12-04

这家伙很懒，什么也没写！

cnbeta2004 2017-12-04

这家伙很懒，什么也没写！

bernard 2017-12-04

这家伙很懒，什么也没写！

cnbeta2004 2017-12-04

这家伙很懒，什么也没写！

kklili 2017-12-05

这家伙很懒，什么也没写！

串口是实现控制台的主要途径，主要需要修改以下内容：
?在Cubemx里面打开串口中断。
?打开设备的时候选择中断收发：

```
rt_device_open(shell->device, (RT_DEVICE_OFLAG_RDWR | RT_DEVICE_FLAG_INT_TX | RT_DEVICE_FLAG_STREAM | RT_DEVICE_FLAG_INT_RX));
```

?去掉CubeMX里面串口收发函数里面的lock，否则由于shell回显的原因，程序有概率锁死。

串口初始化原来是在usart.c里面实现的，之前主要有以下几个函数和相关宏定义。

?开头的结构定义

```
#define UART_BUF_LEN 256
struct drv_uart
{
    UART_HandleTypeDef* UartHandle;	//保存了HAL库里面串口的Handle
	uint8_t uartBuf[UART_BUF_LEN];				//中断接收的缓存，一个个接收
	uint8_t uartLenWr;					//当前未处理数据的长度
	uint8_t uartLenRd;					//当前未处理数据的长度
};
#ifdef RT_USING_UART1
extern UART_HandleTypeDef huart1;	//自动生成的变量，在Main.c中
struct drv_uart uart1;		//本模块注册用的变量,保存在serial的usdate中
struct rt_serial_device serial1;	//RT用的变量
#endif
```

?串口控制宏定义，在rtConfig.h中

```
#define RT_USING_SERIAL

#define RT_USING_UART1
#define RT_USING_UART2
//#define RT_USING_UART3
//#define RT_USING_UART4
//#define RT_USING_UART5
//#define RT_USING_UART6
```

注意，务必保证USING的串口和CubeMX里面定义的串口一致。

?本地变量定义,这些变量用于和rtthread的接口函数交互

```
/* STM32 uart driver */
struct drv_uart
{
    UART_HandleTypeDef* UartHandle;	//保存了HAL库里面串口的Handle
	uint8_t uartBuf[1];				//中断接收的缓存，一个个接收
	int uartLen;					//当前未处理数据的长度
};
#ifdef RT_USING_UART1
extern UART_HandleTypeDef huart1;	//自动生成的变量，在Main.c中
static struct drv_uart uart1;		//本模块注册用的变量
struct rt_serial_device serial1;	//RT用的变量
#endif
```

?和RT交互的函数指针

```
static const struct rt_uart_ops drv_uart_ops =
{
    drv_configure,
    drv_control,
    drv_putc,
    drv_getc,
};
```

这个是一个函数指针，包括了串口的配置、控制、读取和写入的函数。
目前所有的配置都是由CubeMX自动生成的代码完成，所以对函数进行以下修改：
drv_configure ：直接为空函数。
drv_control ：直接为空函数。
drv_putc ：改为调用HAL_UART_Transmit函数，具体参见下面。
drv_getc ：具体参见下面接收说明。
hw_usart_init ：初始化函数，目前只需要根据宏定义注册对应的串口即可。

根据CubeMX的特点，对本程序进行一下修改：
?初始化函数stm32_hw_usart_init()：这里配置什么的已经没用了，只是单纯的注册了一个uart1的设备，并启动接收。

```
int stm32_hw_usart_init(void)
{
    struct drv_uart *uart;
    struct serial_configure config = RT_SERIAL_CONFIG_DEFAULT;
#ifdef RT_USING_UART1
    uart = &uart1;
    uart->UartHandle = &huart1;
    serial1.ops    = &drv_uart_ops;
    serial1.config = config;

/* register UART1 device */
    rt_hw_serial_register(&serial1, "uart1",
    RT_DEVICE_FLAG_RDWR | RT_DEVICE_FLAG_INT_RX,
    uart);
    HAL_UART_Receive_IT(uart->UartHandle, uart->uartBuf, sizeof(uart->uartBuf));//启动中断接收
#endif /* RT_USING_UART1 */
}
```

中断接收回调函数HAL_UART_RxCpltCallback，目前HAL库的接收模式是首先在HAL_UART_Receive_IT函数中启动接收，收到后调用HAL_UART_RxCpltCallback函数进行处理，在本函数收将收到的数保持到对应的buf中，系统会自动调用getc函数进行接收处理，注意getc后需要继续调用HAL_UART_Receive_IT函数进行接收。

```
//HAL库接收回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
	struct rt_serial_device *serial = getSerialDevByHandle(huart);//根据Handle获得serial
	if (serial == NULL)
		return;
	struct drv_uart *uart = serial->parent.user_data;
	uart->uartLen++;
	rt_hw_serial_isr(serial, RT_SERIAL_EVENT_RX_IND);
}
static int drv_getc(struct rt_serial_device *serial)
{
	struct drv_uart *uart = serial->parent.user_data;
	if (uart->uartLen)
	{
		uart->uartLen--;
		HAL_UART_Receive_IT(uart->UartHandle, uart->uartBuf, sizeof(uart->uartBuf));//继续接收
		return uart->uartBuf[0];
	}
	return -1;
}
```

//注意，这里发送必须使用中断发送
static int drv_putc(struct rt_serial_device *serial, char c)
{
	struct drv_uart *uart = serial->parent.user_data;
	HAL_UART_Transmit_IT(uart->UartHandle, (uint8_t*)&c, 1);
    return 1;
}
//由于改为了中断发送，在open设备的时候必须加上RT_DEVICE_FLAG_INT_TX标志位（rt_console_set_device函数和finsh_set_device函数）
rt_device_open(new, RT_DEVICE_OFLAG_RDWR | RT_DEVICE_FLAG_INT_TX |RT_DEVICE_FLAG_STREAM);

?为了使用Finsh，需要在Linker加上 --keep __fsym_* --keep __vsym_*

?最后记得在main函数硬件初始化完成后调用shell和finsh的初始化函数。
#ifdef RT_USING_FINSH
	/* initialize finsh */
	finsh_system_init();
	finsh_set_device(RT_CONSOLE_DEVICE_NAME);
#endif