原子核-kinetis核心板光盘v1.05、软件chshell说明书

1、CH SV 1.0 使用说明CHSV 1.0 是由 YNALD 开发的一个灵巧的串口调试交互组件，通过它你可以通过串口调试助手调用程序里面的任何函数并执行。只需要随意更改函数的输入参数（目前只能以 10进制数字、字符串作为参数），并在串口调试助手中点击发送并执行输入的函数。同时，该组件支持函数返回值显示。本组件的编写借鉴了正点原子的 USMARTV2.0 消化改良，重新编写。将一些内容删减，代码压缩所完成。编写过程中测试环境为 Freescale MK10DN512VLL10。如果您使用中发现有任何 BUG，或者问题，欢迎联系作者 Yandld。CHSV 1.0 的特点如下：1、可以调用绝大部

2、分用户直接编写的函数；2、资源占用少；3、可支持十进制数字、字符串等参数类型；4、支持函数返回值显示；5、使用方便。通过使用 CHSV 1.0，你可以轻易的修改函数参数、查看函数运行结果，从而快速解决问题。比如你调试液晶屏显示模块，为了得到想要的最佳效果，通常的做法是：写函数-修改参数-查看结果-不满意-修改参数-查看结果-不满意不停的循环，直到满意为止。这样做一方面麻烦又啰嗦，另一方面又要不断的对单片机刷程序，影响其。而利用 CHSV 1.0，只需要在串口调试助手中输入函数及其参数，然后直接串口发送给单片机，就执行了一次参数调整；如果对运行结果不满意，在串口调试助手中修改参数之后点击发送就能

3、看到相应的运行结果，直到你满意为止。因此，通过 CHSV 1.0，修改参数十分方便，不需要编译，不需要，不会让单片机折寿。由于 CHSV 1.0 支持十进制数字、字符串等参数类型，因此用户编写的绝大部分函数可以直接被 CHSV 1.0 调用；对于不能直接调用的，你只需要重写一个函数，把影响调用的参数去掉即可。这个重写后的函数，即可以被 CHSV 1.0 调用了。前面对 CHSV 1.0 进行了简单的说明，下面从 CHSV 1.0 的组成、移植、使用进行详细的介绍。一、CV 1.0 的组成CHSV 1.0 组件共包含三个文件，如下图所示：图 1.1 CHSV 1.0 组件的从上图可以看出，CHS

4、V 1.0 组件由 chs.c、chs.h、chs_port.c 三个文件组成。其中 chs.c 文件包含功能实现函数，并且负责与外部交互，一般不需要修改；chs_port.c 文件主要关于 CHSV 1.0 的移植，需要用户修改。chs.h 是头文件，含有几个用户配置宏定义，可以用来配置 CHSV 1.0 的功能、参数类型以及参数长度。二、CV 1.0 的移植要完成 CHS（1）chs 在 CHKV2.2V 1.0 的移植，只需要实现两个函数_port.c 里面的 void CHS_Init(void)函数，该函数功能为实现串口初始化。板上该函数的实现代码如下：/S系统初始化/实现 初始化系

5、统系统void CHS_Init(void)/在这里包含你的串口初始化函数UART_Init(UART3,115200); /初始化调试串口 /默认 UART3 115200 在 UART.H 中定义从上述代码可以看出，对串口 3 进行初始化，初始化串口波特率为 115200。大家在对 CHSV 1.0 进行移植时，要根据自己开发板的情况更改相应的设置。（2）是串口接收与发送中断服务函数，其在 CHKV2.2板上的实现代码为：extern void chs_rec1(u8 ch);/外部函数void UART3_RX_TX_IRQHandler(void)u8 ch;if(UART_Re1(U

6、ART3,&ch)CHS_Rev1(ch); /调用 1 次CHS_Rev1(ch)函数并将接收到的字符 ch 传给 CHS_Rev1用户在移植使用 CHSV 1.0 组件时，需要在串口源程序中添加此函数。当从串口调试助手输入函数或者字符时，系统会自动进入此中断服务函数，并执行相应操作。完成这两个函数的移植，你就可以使用 CHSV 1.0 了。三、CV 1.0 的使用（一）CHS使用 CHSV 1.0 使用之前准备工作V 1.0 之前要完成三个操作：CHS文件、添加头文件路径、完成CHSV1.0 移植。下面结合具体实例进行演示说明。1、文件CHS在这一步骤中，示：要进行的操作是CHS文件夹到工

7、程文件夹下面，如下图所图 3.1CHS文件夹到工程文件夹下2、添加头文件路径在添加头文件路径之前，要先打开实例的工程文件，如下图所示：图 3.2 打开实例的工程文件一步操作中已经将 CHSHEL 文件夹到工程文件夹下面文件夹添加到头文件包含路径，具体操作如下图所示：由于作是把 CHS现在要进行的操图 3.3 添加头文件路径还要在主函数里面加入#include chs完成这一步操作之后，.h。3、完成 CHSV 1.0 移植关于 CHSV 1.0 移植的具体实现代码已经在第二部分进行了介绍，在这里要说明的是如何将 CHSV 1.0 成功移植到演示例程上面来。这一步骤包含两项操作：（1）实现串口初

8、始化串口的初始化是在 chs_port.c 文件中进行的，完成之后的程序如下所示：图 3.4 串口初始化（2）添加中断服务函数串口接收与发送中断服务函数要添加在 uart.c 函数中，如下图所示：图 3.5 添加中断服务函数通过串口调试助手输入函数或者字符时，系统便会进入此中断服务函数，串口中当断服务函数通过调用 CHS_Rev1(ch)函数产生相应操作。完成这三步操作之后，就可以使用 CHSV 1.0 了，不过在主程序中还要执行CHS_Dev 函数的初始化， 另外还要针对你自己想要被 CHSV 1.0 调用的函数在V 1.0 的具体使用中以chs_port.c 里面进行添加。关于这一步操作，

9、在 CHS例程方式进行介绍。（二）CHSV 1.0 使用例程前面已经介绍过，CHSV 1.0 使用准备工作完成之后还要进行 CHS_Dev 的初始化操作、被调用函数的添加操作，之后才能通过串口调试助手进行函数的调用。为了让大家对CHSV1.0 的这一使用流程有更直观的了解，在这一部分将采用几个例程来为大家进行演示。1、添加被调用函数被调用函数的添加是在 chs_port.c 里面进行的。例程中添加完被调用函数之后的_port.c 文件如下图所示：chs图 3.6 添加需要被 CHSV 1.0 调用的函数这里的添加函数很简单，只要把函数所在头文件添加进来，并把函数名按上图所示的方式增加即可。在例

10、程中，添加了 7 个函数：LCD_ShowString（液晶屏显示字符串）、SPILCD_Clear(液晶屏清屏操作)、set_i（控制 LED 灯闪烁周期）、CHS_大家在使用时，根据自己的需要按上述格式添加其他函数即可。（求 mn 次方）等。2、程序编译及代码添加完被调用函数之后，要对程序进行编译，然后代码到 CHKV2.2板上，就可以通过串口来调用在图 3.6 中添加的程序。在这里简单介绍一下，完代码之后，可以看到 LED1 不停闪烁，然后串口调试助手屏幕上显示了一些字符（就是主函数里面要显示的字符）。图 3.7 启动串口助手3、串口调用操作在打开的串口调试助手字符串输入框中输入各种指令

11、（？，help，list 等），就可以得到执行结果如下图：图 3.8 输入“？/help”指令由上图可见，在字符串输入框中输入“？/help”指令可以在窗口中得到 CHSV 1.0的说明以及 CHSV1.0 组件的 3 个系统指令和函数，能够为用户提供很大帮助。图 3.9 输入“list”指令可以获得当前 CHSV 1.0 所管理的全部函数。通过“list”指令，已经通过图 3.8、3.9 查看到了 CHS将通过较为具体的操作演示进行说明。V 1.0 所能调用的具体函数，下面a)执行：LCD_ShowString(u16 x,u16 y,const u8 *p)函数这个函数的功能是在LCD 坐

12、标点（u16 x，u16 y）处显示字符串。大家在这里要注意一点，所要显示的字符串是放在const u8 *p 的位置的，而且两边要加双引号。比如，入函数：LCD_ShowString(50,50,“How are you”)，点击发送，如下图所示：输图 3.10 执行 LCD_ShowString(50,50,“How are you”)函数程序运行之后，可以看到在LCD 屏幕上显示 How are you，如果大家想要在 LCD 其他位置显示其他字符。只需更改 u16 x、u16 y 和 const u8 *p 对应的参数即可。b)执行： CHS_(u8 m,u8 n)函数面已经介绍过，C

13、HS(u8 m,u8 n)函数验证 CHSV 1.0 支持函数返回值显示。因此，在这儿通过CHS_V 1.0 的函数返回值显示功能。CHS_(u8 m,u8 n)函数的作用是求出 m 的 n 次方。比如，想要求出 5 的 3 次方的值，只需要在 u8 m 的位置写上 5，u8 n 的位置写上 3，在字符串输入框中写上此函数之后点击发送，行结果如下：可以看到执图 3.11 执行 CHS_(5,3)函数从上图可以看出，执行函数 CHS_(5,3)之后，在串口调试助手中得到了返回值：125，如图中红圈标示。通过两个简单的例程向大家对 CHSV 1.0 的使用进行了说明，如果大家想要通过CHSV 1.0 对其他函数进行操作，只需按照上边所述步骤进行操作即可。四、CV