调试助手--Q_Shell V1.0 发布(公布源码)

2019-12-11 18:32发布

Q_Shell V1.0使用说明
一.综述
Q_Shell是由酷享科技开发的一个串口调试组件,有了它你可以通过PC上的串口工具很方便的调试程序里的大多数函数(参数不超过四个);查看和赋值程序中的部分变量(支持u8,u16,u32类型的全局变量);读写指定地址处的寄存器值(32位)。其特点如下:

1.使用方便
需要调用的函数或变量只需在本文件中注_册,不需要手动添加任何声明。

2.功能齐全
函数参数支持十进制或十六进制数,字符串,指针。支持读写变量和寄存器。

3.占用资源极少
仅占用2K字节的ROM空间,2字节的全局变量空间,和20字节的栈空间。

4.拆卸容易
更改一个宏的值即可拆卸掉全部组件。

5.使用安全
使用前需要输入验证密码,可防止用户误操作。


二.移植
Q_Shell组件无需操作系统支持,可在裸机上直接进行移植。移植的步骤如下:

1.将Q_Shell.c和Q_Shell.h两个文件加入到工程中。

2.在需要使用Q_Shell功能的C文件中包含Q_Shell.h。

3.将Q_Shell.h中的宏USE_Q_SHELL_FUNCTION置1开启Q_Shell

4.按以下要求写好串口驱动:
(1)需要实现printf函数
(2)在串口工具中输入命令字符串并按下回车后,需要将从上位机接收到的字符串保存在一个字符串数组中,然后将其传至Q_Sh_CmdHandler来执行命令


三.使用举例
1.调用注_册的函数和变量
例如,我们想通过Q_Shell调用在*.c中定义的
全局变量unsigned char var; 以及
函数    unsigned char fun(char *str,unsigned int i,unsigned char j);
我们可以通过以下两个步骤来完成。

第一步: 在*。C中注_册需要调用的函数和变量
...
unsigned char Var;
QSH_VAR_REG(Var,“unsigned char Var”,“u8”);
...
unsigned char Fun(char *str, unsigned int i, char j)
{
        ...
}
QSH_FUN_REG(Fun,“unsigned char Fun(char *str,unsigned int i, char j)”);
...
其中QSH_VAR_REG的第一个参数填变量名;第二个参数填描述该变量的字符串,可以书写任意的内容;
第三个参数填变量类型描述字符串,根据所注_册的变量类型选填“u8”“u16”“u32”中的一个。
其中QSH_FUN_REG的第一个参数填函数名;第二个参数填描述该函数的字符串,可以书写任意的内容。

第二步:在PC上的串口工具中输入以下命令并按回车
lv()                     查看一共注_册了哪些变量
get(Var)                 查看变量Var的值。
set(Var,16)或set(Var,0x10) 给变量Var赋值
lf()                     查看一共注_册了哪些函数
fun(“123”,0x20001000,1)  调用已注_册的函数fun

2.读写指定地址处的寄存器
例如,我们想读写位于0xE000E004处寄存器
可在PC上的串口工具中输入以下命令
read(0xE000E004)          读出寄存器的值
write(0xE000E004,0xffffffff)  给寄存器赋值

四.版本记录
* Date             Author       Notes
* 2011-10-5      ChenYu       first version
点击此处下载 ourdev_682574M9WONJ.pdf(文件大小:163K) (原文件名:Q_Shell V1.0使用说明.pdf)
点击此处下载 ourdev_682575LLNHMM.rar(文件大小:5K) (原文件名:Q_Shell V1.0源码带注释.rar)
友情提示: 此问题已得到解决,问题已经关闭,关闭后问题禁止继续编辑,回答。
该问题目前已经被作者或者管理员关闭, 无法添加新回复
99条回答
ilovepp
1楼-- · 2019-12-16 23:38
 精彩回答 2  元偷偷看……
yinglively
2楼-- · 2019-12-17 01:10
LZ
我的问题还没有解决呢
为何会出现错误?
能否给个简单的工程文件??
ilovepp
3楼-- · 2019-12-17 05:14
回复【35楼】yinglively  
lz
我的问题还没有解决呢
为何会出现错误?
能否给个简单的工程文件??
-----------------------------------------------------------------------

回复【35楼】yinglively  
lz
我的问题还没有解决呢
为何会出现错误?
能否给个简单的工程文件??
-----------------------------------------------------------------------
我在31楼给你回复了,可能你没看到,呵呵。
ljt80158015
4楼-- · 2019-12-17 10:46
能否实现类似 uboot 的菜单界面?
   
同时包括:
    1、全用户界面的命令行(uboot)  方便用户使用
    2、全开发者界面的shell   方便开发者调试
ilovepp
5楼-- · 2019-12-17 16:15
回复【37楼】ljt80158015  

    能否实现类似 uboot 的菜单界面?
   
同时包括:
    1、全用户界面的命令行(uboot)  方便用户使用
    2、全开发者界面的shell   方便开发者调试

-----------------------------------------------------------------------
Q_Shell是一个串口调试的中间件,不会加入命令行,否则将影响架构和可移植性。软件的功能不是越多越好,架构更加重要,架构搭好了,功能可以随意加的。不过以后还想弄个Q_Boot,在这里面可能会加上类似uboot的菜单界面,呵呵,谢谢关注。
Onsunsl
6楼-- · 2019-12-17 16:17
 精彩回答 2  元偷偷看……

一周热门 更多>