Agile Console

马龙伟...大约 3 分钟

Agile Console

1、介绍

Agile Console 是基于 RT-Thread 的一个简单易用的调试设备中间件。

接管 console 设备，支持 device 接口和 posix 接口。
后端实现极其方便，任何接口都可快速接入。

注意 : 由于 Agile Console 会直接接管 console 设备，建议将 RT-Thread Kernel 中的 RT_CONSOLE_DEVICE_NAME 配置为一个不存在的设备。

Agile Console 目前支持的后端接口如下：

串口后端
USB CDC 后端
使用到 tinyusbopen in new window。
Telnet 后端
使用到 agile_telnetopen in new window。

1.1、目录结构

名称	说明
doc	文档
examples	示例
figures	素材
inc	头文件
src	源代码

1.2、许可证

Agile Console package 遵循 LGPLv2.1 许可，详见 LICENSE 文件。

1.3、依赖

RT-Thread 4.0.3
RT-Thread 4.0.5 ~ master

2、使用 Agile Console

帮助文档请查看 doc/doxygen/Agile_Console.chm

使用 Agile Console package 需要在 RT-Thread 的包管理器中选择它，具体路径如下：

RT-Thread online packages
    peripheral libraries and drivers  --->
         [*] agile_console: Simple debugging device Middleware.  --->
            (1024) Set agile_console rx buffer size
            (tty) Set agile_console device name
            (9)  Set agile_console thread priority
            (2048) Set agile_console thread stack size
            [*]   Enable agile_console serial example
            (uart1) Set serial device name
            [*]   Enable telnet plugin
            [*]   Enable tinyusb plugin (RT-Thread 版本 >= 4.1.0)
                  Version (latest)  --->

Set agile_console rx buffer size ：Agile Console 接受环形缓冲区大小
Set agile_console device name ：Agile Console 设备名
Set agile_console thread priority ：Agile Console 线程优先级
Set agile_console thread stack size ：Agile Console 线程堆栈大小
Enable agile_console serial example ：使能串口例程
Set serial device name ：串口设备名
Enable telnet plugin ：使能 telnet 后端插件
使能后会选中 agile_telnetopen in new window 软件包。
Enable tinyusb plugin ：使能 tinyusb 后端插件
RT-Thread 版本 >= 4.1.0 才有该选项。使能后会选中 tinyusbopen in new window 软件包。

Doxygen 文档生成
- 使用 Doxywizard 打开 Doxyfile 运行，生成的文件在 doxygen/output 下。
- 需要更改 Graphviz 路径。
- HTML 生成未使用 chm 格式的，如果使能需要更改 hhc.exe 路径。
多后端演示
演示使用开发板：正点原子探索者
- 串口、Telnet 和 USB CDC 同时交互演示：
  whole
- USB CDC Ymodem 传输文件
  CDC Fifo 接收大小修改为 1024
  CDC Fifo 发送大小修改为 2048
  usb_file

3、新的后端接入 Agile Console

可以参考 examples 文件夹中的例子和 agile_telnetopen in new window 软件包
USB CDC 后端例子中展示了如何屏蔽输入输出

Agile Console 提供了后端接口结构体定义：

/**
 * @brief   Agile Console 后端接口结构体
 */
struct agile_console_backend {
    void (*output)(rt_device_t dev, const uint8_t *buf, int len); /**< 向后端输出数据接口 */
    int (*read)(rt_device_t dev, uint8_t *buf, int len);          /**< 从后端读取数据接口 */
    int (*control)(rt_device_t dev, int cmd, void *arg);          /**< 对后端进行设置接口 */
    rt_slist_t slist;                                             /**< 单向链表节点 */
};

实现一个新的后端并接入 Agile Console 的步骤如下：
1. 定义后端变量
2. 实现后端的 output、read 和 control 接口
  - output 接口
    实现时 不能调用任何可能导致线程挂起的 API 。建议将数据放入 ringbuffer 并创建线程异步发送。
  - read 接口
    除了保护资源而使用的互斥锁外，其他引起阻塞的 API 不建议调用。已有的数据存放到数据区后立马返回。
  - control 接口
    该接口用作控制后端。除 TCFLSH 命令，其他命令均会调用该接口。可不实现。
3. 调用 agile_console_backend_register 注册后端
4. 后端收到数据时调用 agile_console_wakeup 唤醒接收线程