cosyos/Shell

CosyOS3Shell 简介

CosyOS3Shell 是由CosyOS官方推出的一款串口调试工具，可实现任务管理器、命令行、printf，
三者共用同一个串口并分屏显示，用户可使用该软件来呈现 printf、任务管理器，并进行命令行调试。


CosyOS3Shell 使用说明

【功能说明】
1.串口设置：选择串口、波特率、编码等。
2.打开串口：打开串口时会自动发送命令，打开任务管理器。
3.关闭串口：关闭串口时会自动发送命令，退出任务管理器。
4.任务管理器：呈现接收到的任务管理器内容。
5.命令行窗口：交互式的收发窗口，分为发送行（行首标识：>>>）与接收行（行首标识：<<<）；
  当前发送行输入命令后回车发送，行首右键可弹出命令菜单，实现快速输入常用命令或重输上一次发送的内容。
6.printf窗口：菜单栏 printf 按钮弹出，呈现用户的 printf 内容。
7.字体//背景：各窗口标题栏中的字体//背景按钮，可设置字体//背景色，右键按钮恢复默认。

【快捷键】（命令行窗口）
Enter  —— 发送当前输入
F3     —— 快速重输上一次发送的内容
Ctrl+Z —— 撤销当前发送行输入的内容
Ctrl+C —— 复制选中文本
Ctrl+V —— 粘贴


printf 注意事项

CosyOS3Shell 是以 "\r\n" 做为接收包尾标识的，并以 "  "（两个空格）、"<>" 做为任务管理器的接收包头标识，
"ACK:"（忽略大小写）做为命令行的接收包头标识。因此要求用户的 printf，包头不能使用 "  "、"<>"、"ACK:"，
并以 "\r\n" 做为包尾，如此才能实现正常的分屏显示。

【错误示例】
printf("task_1."); // 包尾非 "\r\n"
printf("    u%\r\n", var); // 包头为 "  "
printf("ack:u%\r\n", var); // 包头为 "ACK:"
printf("var:u%\r\n<>\r\n", var); // 第二包的包头为 "<>"

【正确示例】
printf("task_1\r\n");
printf("var:u%\r\n", var);
printf("var:u%\r\n\r\n", var);
printf("task_1\r\nvar:u%\r\n", var);


其它事项

任务中打印，可调用 uPrintf 来替代标准库的 printf，以此来保证多任务打印时的线程安全。
uPrintf 仍然会调用 printf，因此相关文件中应包含 <stdio.h>。