USB CDC 可变形参

控制台的三种连接方式：

　　1、IP网络

　　2、USB

　　3、UART

一：介绍USB CDC方式：

1、控制台配置如下：

2、USB

　　　　Product ID 可以是：0x0000/0x5300/0x0238

　　　　不同的值代表不同的COM口

3、CDC配置

二：介绍UART配置：

　　注意UART配置通道、波特率以及中断优先级，如下：

#include "g_testThread.h"void led_toggle_callback(sf_console_cb_args_t * p_args);const sf_console_command_t g_sf_console_commands[] =
{{ .command = (uint8_t *)"TOGGLE",              //CMD.help = (uint8_t *)"Toggle an LED",.callback = led_toggle_callback,             //控制台命令回调.context =  NULL},{.command  = (uint8_t *)"cell",.help     = (uint8_t *)"Cell Provisioning info to be saved\r\n""             Usage:\r\n""               cell <APN> <Context ID> <PDP Type>",.callback = led_toggle_callback,.context  = NULL},
};/* 1. Create Menu Structure */
const sf_console_menu_t g_sf_console_root_menu =
{.menu_prev = NULL,.menu_name = (uint8_t *)"Command",.num_commands = (sizeof(g_sf_console_commands)) / (sizeof(g_sf_console_commands[0])),.command_list = &g_sf_console_commands[0]
};/***********************************************************************************************************************
* Function Name: led_toggle_callback
* Description  : Implement Callbacks
*                   Callback function provided to g_sf_console_commands[0]. Function is invoked when user inputs
*                   TOGGLE<CR> in the Console
* Arguments    : p_args -
*                   Pointer to an instance type sf_console_cb_args_t
* Return Value : None
***********************************************************************************************************************/
void led_toggle_callback(sf_console_cb_args_t * p_args)
{bsp_leds_t leds;ioport_level_t level;/* Get LED list from BSP */R_BSP_LedsGet(&leds);/* Read current level */g_ioport.p_api->pinRead(leds.p_leds[0], &level);/* Invert level */g_ioport.p_api->pinWrite(leds.p_leds[0], (ioport_level_t)!level);
}/* Test Thread entry function */
void g_testThread_entry(void)
{/* TODO: add your own code here */while (1){g_sf_console0.p_api->prompt(g_sf_console0.p_ctrl, NULL, TX_WAIT_FOREVER);//TX_WAIT_FOREVER//TX_NO_WAIT//tx_thread_sleep (50);
    }
}

测试如下：

　　控制台支持CMD：　　

　　　　“TOGGLE”

　　　　“CELL”

　　　　“?”

　　　　“?”：为帮助信息

可变形参：

　　1、_vsnprintf，_vsnprintf是C库函数之一，属于可变参数。用于向字符串中打印数据、数据格式用户自定义。头文件是#include <stdarg.h>。

头文件:

#include <stdarg.h>

函数声明:

int _vsnprintf(char* str, size_t size, const char* format, va_list ap);

char *str [out],把生成的格式化的字符串存放在这里.
size_t size [in], str可接受的最大字符数 [1] (非字节数，UNICODE一个字符两个字节),防止产生数组越界.
const char *format [in], 指定输出格式的字符串，它决定了你需要提供的可变参数的类型、个数和顺序。
va_list ap [in], va_list变量. va:variable-argument:可变参数

函数功能：将可变参数格式化输出到一个字符数组。

用法类似于vsprintf，不过加了size的限制，防止了内存溢出（size为str所指的存储空间的大小）。

返回值：执行成功，返回最终生成字符串的长度，若生成字符串的长度大于size，则将字符串的前size个字符复制到str，同时将原串的长度返回（不包含终止符）；执行失败，返回负值，并置errno. [2]

　　2、va_star

va_start，函数名称，读取可变参数的过程其实就是在堆栈中，使用指针,遍历堆栈段中的参数列表,从低地址到高地址一个一个地把参数内容读出来的过程·

具备了上述两个API，可变形参到控制台如下：

void print_to_console(const char *pFmt, ...)
{UINT status;char str[128];uint8_t u8Len;va_list args;memset(str,0,128);status = tx_mutex_get(&g_console_print_mutex, TX_WAIT_FOREVER);if (status != TX_SUCCESS)return;va_start(args, pFmt);u8Len = (uint8_t)vsnprintf(str, 128, pFmt, args);va_end(args);if (u8Len > 0){g_sf_console0.p_api->write(g_sf_console0.p_ctrl, (const uint8_t *)str, TX_WAIT_FOREVER);}tx_mutex_put(&g_console_print_mutex);
}

如使用宏实现：

//#define SEMI_HOSTING

#ifdef SEMI_HOSTING
#ifdef __GNUC__
extern void initialise_monitor_handles (void);
#endif
#endif#ifdef SEMI_HOSTING
#define xp_log(format, args...)             printf(format, ##args)
#else
#define xp_log(format, args...)             print_to_console(format, ##args)
#endif

转载于:https://www.cnblogs.com/jiangzhaowei/p/8982172.html