mirror of
https://gitee.com/cosyos/cosyos.git
synced 2026-10-06 04:59:34 +08:00
51 lines
2.2 KiB
Plaintext
51 lines
2.2 KiB
Plaintext
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>。
|
||
|