小飞飞 发表于 2020-6-26 20:27:31

RISC-V单片机快速入门04-基于RT_Thread Nano添加FinSH

本帖最后由 小飞飞 于 2020-8-28 19:51 编辑

RISC-V单片机快速入门01-开发环境搭建
RISC-V单片机快速入门02-移植RT_Thread Nano
RISC-V单片机快速入门03-基于RT_Thread Nano添加控制台
RISC-V单片机快速入门04-基于RT_Thread Nano添加FinSH
RISC-V单片机快速入门05-串口助手发送AT指令启动TCP Server
RISC-V单片机快速入门06-控制ESP8266启动Http Server
RISC-V单片机快速入门07-板载LCD显示ESP8266数据

本系列上一篇:RISC-V单片机快速入门03-基于RT_Thread Nano添加控制台

一基础知识
1.FinSH简介
RT-Thread FinSH 是 RT-Thread 的命令行组件(shell),提供一套供用户在命令行调用的操作接口,主要用于调试或查看系统信息。它可以使用串口 / 以太网 / USB 等与 PC 机进行通信,本文使用串口进行通信,使用 FinSH 组件基本命令的效果图如下所示:

二,添加步骤

1.导入工程
将上一节内容进行复制,修改.project中工程名字为FinSH,然后重新import进来新的工程

2.添加FinSH源码到工程
将rt-thread-3.1.3/components/finsh下文件添加到RT-Thread下。


添加成功后结果如下:


3.添加头文件路径
右击工程,点击 properties 进入下图所示界面,点击 C/C++ Build -> settings ,添加头文件路径


4.打开宏定义
添加号FinSH组件源码后,可以看到实际功能并没有打开,需要开启RT_USING_FINSH宏定义。


打开rtconfig.h文件,增加宏定义:#define RT_USING_FINSH

5.适配FinSH组件接口
(1) 修改GD32VF103xB.lds文件



在上图.text中添加如下代码:/* section information for finsh shell */
. = ALIGN(4);
__fsymtab_start = .;
KEEP(*(FSymTab))
__fsymtab_end = .;
. = ALIGN(4);
__vsymtab_start = .;
KEEP(*(VSymTab))
__vsymtab_end = .;
. = ALIGN(4);

/* section information for initial. */
. = ALIGN(4);
__rt_init_start = .;
KEEP(*(SORT(.rti_fn*)))
__rt_init_end = .;
. = ALIGN(4);

/* section information for modules */
. = ALIGN(4);
__rtmsymtab_start = .;
KEEP(*(RTMSymTab))
__rtmsymtab_end = .;

修改后如下所示


(2) 移植函数
本文采用中断方式获取串口接收到字符,原理是,在 uart 接收到数据时产生中断,在中断中把数据存入 ringbuffer 缓冲区,然后释放信号量,tshell 线程接收信号量,然后读取存在 ringbuffer 中的数据。
在gd32vf102c_start.c文件中,实现rt_hw_console_getchar如下:#define UART_RX_BUF_LEN 128
rt_uint8_t uart_rx_buf = {0};
struct rt_ringbuffer uart_rxcb; /* 定义一个 ringbuffer cb */
static struct rt_semaphore shell_rx_sem; /* 定义一个静态信号量 */
void gd_eval_com_init(uint32_t com)
{
uint32_t com_id = 0U;
if(EVAL_COM0 == com){
      com_id = 0U;
    }else if(EVAL_COM1 == com){
      com_id = 1U;
    }

/* 初始化串口接收 ringbuffer*/
    rt_ringbuffer_init(&uart_rxcb, uart_rx_buf, UART_RX_BUF_LEN);

/* 初始化串口接收数据的信号量 */
    rt_sem_init(&(shell_rx_sem), "shell_rx", 0, 0);

    eclic_irq_enable(USART0_IRQn, 1, 0);

/* enable GPIO clock */
    rcu_periph_clock_enable(COM_GPIO_CLK);

/* enable USART clock */
    rcu_periph_clock_enable(COM_CLK);

/* connect port to USARTx_Tx */
    gpio_init(COM_GPIO_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, COM_TX_PIN);

/* connect port to USARTx_Rx */
    gpio_init(COM_GPIO_PORT, GPIO_MODE_IN_FLOATING, GPIO_OSPEED_50MHZ, COM_RX_PIN);

/* USART configure */
    usart_deinit(com);
    usart_baudrate_set(com, 115200U);
    usart_word_length_set(com, USART_WL_8BIT);
    usart_stop_bit_set(com, USART_STB_1BIT);
    usart_parity_config(com, USART_PM_NONE);
    usart_hardware_flow_rts_config(com, USART_RTS_DISABLE);
    usart_hardware_flow_cts_config(com, USART_CTS_DISABLE);
    usart_receive_config(com, USART_RECEIVE_ENABLE);
    usart_transmit_config(com, USART_TRANSMIT_ENABLE);
    usart_enable(com);
    usart_interrupt_enable(com, USART_INT_RBNE);
}

char rt_hw_console_getchar(const char str)
{
int ch = 0;
    / 从 ringbuffer 中拿出数据 */
while (rt_ringbuffer_getchar(&uart_rxcb, (rt_uint8_t *)&ch) != 1)
    {
      rt_sem_take(&shell_rx_sem, RT_WAITING_FOREVER);
    }
return ch;
}

void USART0_IRQHandler() {
int ch = -1;
int recv_flag = 0;
/* enter interrupt /
    rt_interrupt_enter();
if(RESET != usart_interrupt_flag_get(EVAL_COM0, USART_INT_FLAG_RBNE)){
while (1)
      {
            ch = -1;
if (RESET != usart_interrupt_flag_get(EVAL_COM0, USART_INT_FLAG_RBNE))
            {
                ch =usart_data_receive(EVAL_COM0);
//                rt_kprintf("recv data is :%x\r\n", ch);
            }
if (ch == -1)
            {
break;
            }
            recv_flag = 1;
            / 读取到数据,将数据存入 ringbuffer */
            rt_ringbuffer_putchar(&uart_rxcb, ch);
      }
//      if (1 == recv_flag)
//      {
            rt_sem_release(&shell_rx_sem);
//      }
    }
    rt_interrupt_leave();
}

新增ringbuffer.c函数
/* 第一部分:ringbuffer 实现部分 */
#include <rtthread.h>
#include <string.h>
#include "ringbuffer.h"
rt_inline enum rt_ringbuffer_state rt_ringbuffer_status(struct rt_ringbuffer *rb)
{
if (rb->read_index == rb->write_index)
    {
if (rb->read_mirror == rb->write_mirror)
return RT_RINGBUFFER_EMPTY;
else
return RT_RINGBUFFER_FULL;
    }
return RT_RINGBUFFER_HALFFULL;
}
/**
* get the size of data in rb
*/
rt_size_t rt_ringbuffer_data_len(struct rt_ringbuffer *rb)
{
switch (rt_ringbuffer_status(rb))
    {
case RT_RINGBUFFER_EMPTY:
return 0;
case RT_RINGBUFFER_FULL:
return rb->buffer_size;
case RT_RINGBUFFER_HALFFULL:
default:
if (rb->write_index > rb->read_index)
return rb->write_index - rb->read_index;
else
return rb->buffer_size - (rb->read_index - rb->write_index);
    };
}

void rt_ringbuffer_init(struct rt_ringbuffer *rb,
                        rt_uint8_t         *pool,
                        rt_int16_t            size)
{
    RT_ASSERT(rb != RT_NULL);
    RT_ASSERT(size > 0);

/* initialize read and write index */
    rb->read_mirror = rb->read_index = 0;
    rb->write_mirror = rb->write_index = 0;

/* set buffer pool and size */
    rb->buffer_ptr = pool;
    rb->buffer_size = RT_ALIGN_DOWN(size, RT_ALIGN_SIZE);
}

/**
* put a character into ring buffer
*/
rt_size_t rt_ringbuffer_putchar(struct rt_ringbuffer *rb, const rt_uint8_t ch)
{
    RT_ASSERT(rb != RT_NULL);

/* whether has enough space */
if (!rt_ringbuffer_space_len(rb))
return 0;

    rb->buffer_ptr = ch;

/* flip mirror */
if (rb->write_index == rb->buffer_size-1)
    {
      rb->write_mirror = ~rb->write_mirror;
      rb->write_index = 0;
    }
else
    {
      rb->write_index++;
    }

return 1;
}
/**
* get a character from a ringbuffer
*/
rt_size_t rt_ringbuffer_getchar(struct rt_ringbuffer *rb, rt_uint8_t *ch)
{
    RT_ASSERT(rb != RT_NULL);

/* ringbuffer is empty */
if (!rt_ringbuffer_data_len(rb))
return 0;

/* put character */
    *ch = rb->buffer_ptr;

if (rb->read_index == rb->buffer_size-1)
    {
      rb->read_mirror = ~rb->read_mirror;
      rb->read_index = 0;
    }
else
    {
      rb->read_index++;
    }

return 1;
}
三,运行结果
使用jlink烧录,通过控制台输入version,运行结果如下所示

四,结语如在使用过程中有任何问题,请加QQ群进一步交流。QQ交流群:728522642 (备注:物联网项目交流)
本篇完,感谢关注:RISC-V单片机中文网
页: [1]
查看完整版本: RISC-V单片机快速入门04-基于RT_Thread Nano添加FinSH