高云FPGA系列教程(10):letter-shell移植

文章目录

      • letter-shell简介
      • letter-shell源码获取
      • letter-shell移植
      • 函数和变量应用示例

本文是高云FPGA系列教程的第10篇文章。

shell,中文是外壳的意思,就是操作系统的外壳。通过shell命令可以操作和控制操作系统,比如Linux中的Shell命令就包括ls、cd、pwd等等。总结来说,Shell是一个命令解释器,它通过接受用户输入的Shell命令来启动、暂停、停止程序的运行或对计算机进行控制。

嵌入式平台可以基于串口实现shell功能,通过对串口命令的解析,可以执行相应的函数,查询变量的值等等。

本文介绍letter-shell开源shell库在高云GW1NSR-4C ARM处理器上的移植和应用。

letter-shell简介

letter-shell,一个功能强大的嵌入式shell,由标准C语言开发,可以在各种嵌入式平台上使用,可以通过命令行来执行函数,查询变量的值等等,支持裸机运行或RTOS运行,最新的发布版本是v3.1.2,letter-shell有以下功能:

  • 命令自动补全
  • 快捷键功能定义
  • 命令权限管理
  • 用户管理
  • 变量支持
  • 代理函数和参数代理解析

代码完全开源,并遵循MIT开源协议,Github收获近1K Star。

开源地址:

https://github.com/NevermindZZT/letter-shell

作者的主页地址:

https://nevermindzzt.github.io/

目前还保持更新状态,最近的一次提交是2023.07.25。

letter-shell源码获取

打开上文中letter-shell的开源地址,直接下载最新版本的Release代码,

或者,通过Git命令获取目前最新的代码,

$ git clone https://github.com/NevermindZZT/letter-shell.git --depth=1Cloning into 'letter-shell'...
remote: Enumerating objects: 72, done.
remote: Counting objects: 100% (72/72), done.
remote: Compressing objects: 100% (66/66), done.
remote: Total 72 (delta 3), reused 35 (delta 2), pack-reused 0
Receiving objects: 100% (72/72), 783.28 KiB | 344.00 KiB/s, done.
Resolving deltas: 100% (3/3), done.

src目录中就是letter-shell的源文件,demo文件夹下是基于ESP32和STM32的移植示例代码。

letter-shell移植

首先把src文件夹的所有文件复制到GW1NSR-4C Keil工程的用户目录下,并新建两个接口文件:shell_port.cshell_port.h,用来对接shell库。

把这些文件都导入到我们的工程中,并包含头文件路径。

shell_cfg.h文件通过宏定义,可以实现功能的配置,非常灵活。

在shell_port.c文件中实现shell_write函数(串口发送字符串),并进行shell初始化:

#include "shell.h"
#include "drv_uart.h"Shell shell;
char shellBuffer[512];short userShellWrite(char *data, unsigned short len)
{UART_SendString(UART0, data);return len;
}void userShellInit(void)
{shell.write = userShellWrite;shellInit(&shell, shellBuffer, 512);
}

对于裸机移植,不用实现shell read函数,只需要实现write函数。

并在shellport.h文件中进行声明:

#ifndef __SHELL_PORT_H__
#define __SHELL_PORT_H__#include "shell.h"extern Shell shell;void userShellInit(void);#endif

然后在串口接收中断服务函数,每接收到一字节数据调用shellHandler函数。

void UART0_Handler(void)
{char rx = 0;if(UART_GetRxIRQStatus(UART0) == SET){rx = UART_ReceiveChar(UART0);shellHandler(&shell, rx);}UART_ClearRxIRQ(UART0);
}

主程序初始化时调用userShellInit函数,

#include "main.h"int main(void)
{delay_init();uart0_init(115200); //enable rx interruptuserShellInit();while(1){}
}

重新编译生成bin文件,并下载到开发板,打开串口终端,如SercureCRT,可以看到串口输出如下信息,说明移植成功,按下tab键,会提示当前支持的一些命令:

函数和变量应用示例

移植成功之后,我们来演示函数和变量的调用,即通过在终端输入函数名和参数可以直接执行函数,输入变量名可以直接打印变量的实时值。

定义一些变量和函数,并注册到shell命令解析列表中。

#include "main.h"char str[100] = "Hello GoWin GW1NSR-4C (TangNano 4K)";
int cnt = 0;int func(int i, char ch, char *str)
{printf("input int: %d, char: %c, string: %s\r\n", i, ch, str);return 1;
}
//获取系统频率
int get_sysclk(void)
{printf("SystemCoreClock = %d\r\n", SystemCoreClock);printf("APB1 CLK = %d\r\n", PCLK1);printf("APB2 CLK = %d\r\n", PCLK2);printf("AHB CLK  = %d\r\n", HCLK);return 2;
}SHELL_EXPORT_CMD(SHELL_CMD_PERMISSION(0)|SHELL_CMD_TYPE(SHELL_TYPE_CMD_FUNC), get_sysclk, get_sysclk, test);
SHELL_EXPORT_CMD(SHELL_CMD_PERMISSION(0)|SHELL_CMD_TYPE(SHELL_TYPE_CMD_FUNC), func, func, test);
SHELL_EXPORT_VAR(SHELL_CMD_PERMISSION(0)|SHELL_CMD_TYPE(SHELL_TYPE_VAR_INT), cnt, &cnt, test);
SHELL_EXPORT_VAR(SHELL_CMD_PERMISSION(0)|SHELL_CMD_TYPE(SHELL_TYPE_VAR_STRING), str, str, test);int main(void)
{delay_init();uart0_init(115200); //enable rx interruptprintf("SystemCoreClock = %d\r\n", SystemCoreClock);printf("APB1 CLK = %d\r\n", PCLK1);printf("APB2 CLK = %d\r\n", PCLK2);printf("AHB CLK  = %d\r\n", HCLK);printf("Hello GW1NSR-4C SoC(ARM Cortex-M3)\r\n");printf("letter-shell Example\r\n");userShellInit();while(1){delay_ms(1000);cnt++;}
}

下载,运行。

在终端中直接输入对应的函数名即可直接运行函数,如果函数带参数,还可以在后面输入参数,参数类型支持整形、字符、字符串等多种类型,而且运行结束可以看到函数的返回值,输入变量的名字,可以直接获取到当前实时值,变量类型值整形和字符、字符串多种类型,非常强大、方便。

本文是高云FPGA系列教程的第10篇文章。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/138393.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

C# 流Stream详解(3)——FileStream源码

【FileStream】 构造函数 如果创建一个FileStream,常见的参数例如路径Path、操作方式FileMode、权限FileAccess。 这里说下FileShare和SafeFileHandle。 我们知道在读取文件时,通常会有两个诉求:一是如何更快的读取文件内容;二…

安装社区版本OB

获取一键安装包 https://www.oceanbase.com/softwarecenter 离线安装 [admintest001 ~]$ tar -xzf oceanbase-all-in-one-*.tar.gz [admintest001 ~]$ cd oceanbase-all-in-one/bin/ [admintest001 bin]$ ./install.sh [admintest001 bin]$ source ~/.oceanbase-all-in-one/…

pytorch环境搭建到pycharm项目映射配置(成功后回顾性记录/自用)

利用Anaconda创建pytorch虚拟环境 前提:成功安装Anaconda,确保可以打开NVIDIA控制面板 开始-》搜索“Anaconda Prompt” 打开后输入:conda create -n 你的虚拟环境名 python3.9。输入y,继续安装,完成。 输入&#…

微调大型语言模型(一):为什么要微调(Why finetune)?

今天我们来学习Deeplearning的在线课程 微调大型语言模型(一)的第一课:为什么要微调(Why finetune)。 我们知道像GPT-3.5这样的大型语言模型(LLM)它所学到的知识截止到2021年9月,那么如果我们向ChatGPT询问2022年以后发生的事情,它可能会产生…

spring security教程(一)--认证

零.简介 【1】简介 【2】登录校验流程 【3】原理(入门的时候先了解一下就好) 一.思路分析 二.建表 确保你已经建立好一张用户表,并且引入springboot,mybatis,mp,slf4j等基础依赖。 即使你有多个角色你也可以将他们的…

Denoising Diffusion Autoencoders are Unified Self-supervised Learners

Denoising Diffusion Autoencoders are Unified Self-supervised Learners (Paper reading) Weilai Xiang, Beihang University, arXiv23, Code, Paper 1. 前言 受最近扩散模型进展的启发,这让人想起去噪自编码器,我们研究了它们是否可以通过生成预训…

wx.canvasToTempFilePath导出的图片不清晰

使用wx.canvasToTempFilePath接口,导出的canvas图片在手机上看不清晰 解决办法:本质上就是生成一个更大的图片,因为手机的屏幕设备的像素比现在一般都是超过2的。实际上我们只需要在使用wx.canvasToTempFilePath的时候,设置参数d…

STM32 CAN使用记录:FDCAN基础通讯

文章目录 目的基础说明关键配置与代码轮询方式中断方式收发测试 示例链接总结 目的 CAN是非常常用的一种数据总线,被广泛用在各种车辆系统中。这篇文章将对STM32中FDCAN的使用做个示例。 CAN的一些基础介绍与使用可以参考下面文章: 《CAN基础概念》htt…

Visual Studio 2017 安装

C自学精简实践教程 目录(必读) 这篇文章会保证你第一次安装VS2017就成功运行Hello World! 下载Visual Studio Installer Gitee 下载 VS2017/vs2017_Community.exe CalmReason/VisualStudio - 码云 - 开源中国 (gitee.com) 百度云下载 链接:https://pan.baidu…

华为HCIA(三)

链路本地地址接口标识64bit 当STP端口到了Forwarding状态后,会转发流量,也处理报文 在TCP/IP模型中,会话层,表示层和应用层,都规划成了应用层 路由表包含目的地址和掩码,优先级,cost,下一跳和…

c: Sorting Algorithms

SortAlgorithm.h /*****************************************************************//*** \file SortAlgorithm.h* \brief 业务操作方法* VSCODE c11 https://github.com/hustcc/JS-Sorting-Algorithm/blob/master/2.selectionSort.md* https://www.programiz.com/d…

PyTorch深度学习(七)【循环神经网络-提高】

数据集文末分享。 模型: 做完padding之后,就可以转换为张量了。 bidirectional是是否使用双向RNN: 输出隐层两个: 代码: import csvimport timeimport matplotlib.pyplot as pltimport numpy as npimport mathimport gzip # 用…

29.CSS边框动画特效

效果 源码 index.html <!DOCTYPE html> <html> <head> <title>Quick CSS Border Trick</title> <link rel="stylesheet" type="text/css" href="style.css"> </head> <body><div class=&q…

three.js——辅助器AxesHelper和轨道控制器OrbitControls的使用

辅助器AxesHelper和轨道控制器OrbitControls的使用 前言效果图1、辅助器AxesHelper:是物体出现辅助的x/y/z轴2、轨道控制器OrbitControls2.1导入OrbitControls文件2.2 使用2.3 如果OrbitControls改变了相机参数&#xff0c;重新调用渲染器渲染三维场景 前言 1、AxesHelper 官网…

网站整站优化-网站整站优化工具

您是否曾为您的网站在搜索引擎中的排名而感到焦虑&#xff1f;是否苦苦思考如何提高流量、吸引更多用户&#xff1f; 什么是整站优化。简而言之&#xff0c;它是一项用于提升网站在搜索引擎中排名的策略和技巧。通过对网站的内容、结构、速度等方面进行优化&#xff0c;可以使…

WPF 类库 使用handycontrol 配置

在学习wpf发现了一个非常好用的UI库 handycontrol 但是很多地方讲的都是WPF应用程序怎么用&#xff0c;很少有讲类库那么引用的问题&#xff0c;所以在这里自己总结一下&#xff0c;希望能帮助到大家&#xff1a; 1.添加 handycontrol 的引用&#xff1b;安装&#xff0c;我已…

[python 刷题] 167 Two Sum II - Input Array Is Sorted 15 3Sum

[python 刷题] 167 Two Sum II - Input Array Is Sorted & 15 3Sum 虽然 3 sum 出来的比较早&#xff0c;不过按照解法来说&#xff0c;2 sum II 算是 3 sum 的前置解法 167 Two Sum II - Input Array Is Sorted 题目&#xff1a; Given a 1-indexed array of integers …

Python中TensorFlow的长短期记忆神经网络(LSTM)、指数移动平均法预测股票市场和可视化...

原文链接&#xff1a;http://tecdat.cn/?p23689 本文探索Python中的长短期记忆&#xff08;LSTM&#xff09;网络&#xff0c;以及如何使用它们来进行股市预测&#xff08;点击文末“阅读原文”获取完整代码数据&#xff09;。 相关视频 在本文中&#xff0c;你将看到如何使用…

使用 FHE 实现加密大语言模型

近来&#xff0c;大语言模型 (LLM) 已被证明是提高编程、内容生成、文本分析、网络搜索及远程学习等诸多领域生产力的可靠工具。 大语言模型对用户隐私的影响 尽管 LLM 很有吸引力&#xff0c;但如何保护好 输入给这些模型的用户查询中的隐私 这一问题仍然存在。一方面&#xf…

【计算机网络】图解路由器(一)

图解路由器&#xff08;一&#xff09; 1、什么是路由器&#xff1f;2、什么是路由选择&#xff1f;3、什么是转发&#xff1f;4、路由器设备有哪些类型&#xff1f;5、根据性能分类&#xff0c;路由器有哪些类型&#xff1f;5.1 高端路由器5.2 中端路由器5.3 低端路由器 6、什…