STM32F103 STM32Cube 移植 Finsh（附全部工程文件）

发布于 2020-06-20 17:42:29 浏览：1452 订阅该版

* 本帖最后由 00703zbq 于 2020-6-20 17:41 编辑 *

一直都是使用大神们提供的BSP包，各种设备组件齐全，十分方便；
但是这些BSP包和STM32CubeMX结合的不是很好，如果BSP包内没有我们需要的芯片，那就得自己动手移植了；

*_此篇文档适用于，只想要精简的nano内核，但又不想放弃finsh以及STM32CubeMX，这些实用工具的小伙伴，已经实际在板测试ok，可以直接使用；_*

**软件资源：**
STM32CubeMX  V5.6.1
MDK    V5.29.0.0
nano    V3.1.3
XCOM  V2.0

**硬件资源：**
ALIENTEK  MiniSTM32开发板
(MCU STM32F103RCT6)
控制台使用串口：UART1

**开始移植**

**1. 在STM32CubeMX加载nano内核和shell；**
详细步骤请参考官方文档：[https://www.rt-thread.org/document/site/tutorial/nano/finsh-port/an0045-finsh-port/](https://www.rt-thread.org/document/site/tutorial/nano/finsh-port/an0045-finsh-port/)
官方文档已经写得很详细了，此处不再过多描述；

**2. 配置UART1串口参数，并打开UART1串口中断（STM32CubeMX中完成）**

其他参数都设置完毕后，点击生成代码，然后打开工程文件；

![uart1打开中断.jpg](/uploads/202006/20/160818efbrzsvfz58ffz85.jpg) 
![UART1配置参数.jpg](/uploads/202006/20/160439r2gvicn33q3csc3n.jpg)

**3. 参考官方关于移植finsh，中断示例，进行移植（在MDK中完成）**

**3.1  **将官方文档提供的各种定义复制，并添加到“main.c”文件头部，**请特别注意添加的位置**。
**必须放置在/* USER CODE BEGIN ××××× */ 与 /* USER CODE END ××××× */ 中间，**
**否则下次在STM32CubeMX中改变设置，生成代码时，你的代码都会被清除掉；**

```/* Includes ------------------------------------------------------------------*/
#include "main.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include <rtthread.h>
#include <string.h>
/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

struct rt_ringbuffer
{
    rt_uint8_t *buffer_ptr;

rt_uint16_t read_mirror : 1;
    rt_uint16_t read_index : 15;
    rt_uint16_t write_mirror : 1;
    rt_uint16_t write_index : 15;

rt_int16_t buffer_size;
};

enum rt_ringbuffer_state
{
    RT_RINGBUFFER_EMPTY,
    RT_RINGBUFFER_FULL,
    /* half full is neither full nor empty */
    RT_RINGBUFFER_HALFFULL,
};

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
#define rt_ringbuffer_space_len(rb) ((rb)->buffer_size - rt_ringbuffer_data_len(rb))

/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/
UART_HandleTypeDef huart1;

/* USER CODE BEGIN PV */

/* 第二部分：finsh 移植对接部分 */
#define UART_RX_BUF_LEN 16
rt_uint8_t uart_rx_buf[UART_RX_BUF_LEN] = {0};
struct rt_ringbuffer  uart_rxcb;         /* 定义丿丿 ringbuffer cb */
//static UART_HandleTypeDef UartHandle;
struct rt_semaphore shell_rx_sem; /* 定义丿个静态信号量 */

/* USER CODE END PV */```

**3.2 复制函数****（ctrl+c and ****ctrl+v）**
复制如下所有函数及内容到“main.c”文件中（注意：此工程中我们使用的是*huart1*）
![函数.jpg](/uploads/202006/20/173346jmdhbdphphmdm3zo.jpg)这些函数是干什么用的，请自行参看官方文档，官方文档的注释已经写得很详细了；
 **3.3 与****STM32Cube****MX高度融合****（注意：*****和******官方文档不一样的地方出现了*****）** 官方文档中还有三个函数，我们尚未移植：
 **static** **int** **uart_init**(**void**) **void** **HAL_UART_MspInit**(UART_HandleTypeDef *huart) **void** **USART2_IRQHandler**(**void**)
 由于我们使用STM32CubeMX自动生成了工程和代码（很是方便），所以上面三个函数STM32CubeMX其实已经帮我们写好了，我们只需要在工程中找到这些函数，加上我们需要的代码就可以了，和芯片寄存器操作的活就全部交给STM32CubeMX；
 **3.3.1 **STM32CubeMX生成的工程中，串口初始化在“main.c”文件中，名字“void MX_USART1_UART_Init(void)”；我们迅速定位到这个函数，将官方文档中“**static** **int** **uart_init**(**void**)”部分代码复制过来，见下方蓝色部分；只修改**/* USER CODE BEGIN ××××× */ 与 /* USER CODE END ××××× */ 中间**部分，其他不要动，其他部分是STM32CubeMX自动生成的；
```static void MX_USART1_UART_Init(void)
{

/* USER CODE BEGIN USART1_Init 0 */

/* USER CODE END USART1_Init 0 */

/* USER CODE BEGIN USART1_Init 1 */
 
 /* 初始化串口接政 ringbuffer */
 rt_ringbuffer_init(&uart_rxcb, uart_rx_buf, UART_RX_BUF_LEN);

/* 初始化串口接收数据的信号釿 */
 rt_sem_init(&(shell_rx_sem), "shell_rx", 0, 0);
 
 /* USER CODE END USART1_Init 1 */
 huart1.Instance = USART1;
 huart1.Init.BaudRate = 115200;
 huart1.Init.WordLength = UART_WORDLENGTH_8B;
 huart1.Init.StopBits = UART_STOPBITS_1;
 huart1.Init.Parity = UART_PARITY_NONE;
 huart1.Init.Mode = UART_MODE_TX_RX;
 huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
 huart1.Init.OverSampling = UART_OVERSAMPLING_16;
 if (HAL_UART_Init(&huart1) != HAL_OK)
 {
 Error_Handler();
 }
 /* USER CODE BEGIN USART1_Init 2 */

/* 中断配置 */
 __HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE); //Receive Data register not empty interrupt enable
// HAL_NVIC_EnableIRQ(USART1_IRQn); //如下两条语句已经在 stm32f1xx_hal_msp.c 中STM32CUBE自动生成
// HAL_NVIC_SetPriority(USART1_IRQn, 3, 0);
 
 /* USER CODE END USART1_Init 2 */

}```

**3.3.2  **STM32CubeMX生成的工程中，串口IO口初始化在“void MX_USART1_UART_Init(void)”已经由STM32CubeMX自动生成，这里不再详述，感兴趣自己找找看看，STM32CubeMX是怎么帮我们初始化的；

*_字数限制，下页接着发_*

![stm32cubemxtest001.rar](/uploads/202006/20/172605skqsqhcsk2oe2kbc.rar)