vsf_trace.c File Reference

#include "service/vsf_service_cfg.h"
#include "hal/vsf_hal.h"
#include "kernel/vsf_kernel.h"
#include "./vsf_trace.h"
#include <stdio.h>

Data Structures
struct	vsf_trace_t

Macros
#define	__VSF_TRACE_CLASS_IMPLEMENT
#define	VSF_TRACE_CFG_BUFSIZE   1024
	todo: remove this dependency
#define	VSF_TRACE_CFG_COLOR_EN   ENABLED
#define	VSF_TRACE_LINEBUF_SIZE   128
#define	VSF_TRACE_CFG_PROTECT_LEVEL   interrupt
#define	vsf_trace_protect   vsf_protect(VSF_TRACE_CFG_PROTECT_LEVEL)
#define	vsf_trace_unprotect   vsf_unprotect(VSF_TRACE_CFG_PROTECT_LEVEL)

Typedefs
typedef struct vsf_trace_t	vsf_trace_t

Functions
uint_fast32_t	__vsf_trace_output (const char *buff, uint_fast32_t size)
void	__vsf_trace_init (vsf_stream_t *stream)
void	vsf_trace_fini (void)
void	vsf_trace_output_string (const char *str)
void	vsf_trace_string (vsf_trace_level_t level, const char *str)
void	__vsf_trace_buffer (vsf_trace_level_t level, void *buffer, uint_fast16_t len, uint_fast32_t flag)
void	vsf_trace_arg (vsf_trace_level_t level, const char *format, va_list arg)
void	vsf_trace (vsf_trace_level_t level, const char *format,...)
void	vsf_trace_dump_stack (void)
void	vsf_trace_assert (const char *expr, const char *file, int line, const char *func)
	system macros
void	vsf_bgtrace_clear (vsf_bgtrace_t *bgtrace)
uint32_t	vsf_bgtrace_total (vsf_bgtrace_t *bgtrace)
void	vsf_bgtrace_append (vsf_bgtrace_t *bgtrace, void *element)
void	vsf_bgtrace_print (vsf_bgtrace_t *bgtrace, int cnt)
void	vsf_stdout_init (void)
void	vsf_stderr_init (void)
void	vsf_stdin_init (void)
int	vsf_stdout_putchar (char ch)
int	vsf_stderr_putchar (char ch)

Variables
__VSF_VPLT_DECORATOR__ vsf_trace_vplt_t	vsf_trace_vplt

Macro Definition Documentation

__VSF_TRACE_CLASS_IMPLEMENT

#define __VSF_TRACE_CLASS_IMPLEMENT

VSF_TRACE_CFG_BUFSIZE

#define VSF_TRACE_CFG_BUFSIZE   1024

todo: remove this dependency

VSF_TRACE_CFG_COLOR_EN

#define VSF_TRACE_CFG_COLOR_EN   ENABLED

VSF_TRACE_LINEBUF_SIZE

#define VSF_TRACE_LINEBUF_SIZE   128

VSF_TRACE_CFG_PROTECT_LEVEL

#define VSF_TRACE_CFG_PROTECT_LEVEL   interrupt

Note

By default, the driver tries to make all APIs interrupt-safe, ! ! in the case when you want to disable it, ! please use following macro: ! #define VSF_TRACE_CFG_PROTECT_LEVEL none ! ! in the case when you want to use interrupt-safe, ! please use following macro: ! #define VSF_TRACE_CFG_PROTECT_LEVEL interrupt ! ! NOTE: This macro should be defined in vsf_usr_CFG.h

vsf_trace_protect

#define vsf_trace_protect   vsf_protect(VSF_TRACE_CFG_PROTECT_LEVEL)

vsf_trace_unprotect

#define vsf_trace_unprotect   vsf_unprotect(VSF_TRACE_CFG_PROTECT_LEVEL)

Typedef Documentation

vsf_trace_t

typedef struct vsf_trace_t vsf_trace_t

Function Documentation

__vsf_trace_output()

uint_fast32_t __vsf_trace_output	(	const char *	buff,
		uint_fast32_t	size
	)

__vsf_trace_init()

void __vsf_trace_init

(

vsf_stream_t *

stream

)

vsf_trace_fini()

void vsf_trace_fini

(

void

)

vsf_trace_output_string()

void vsf_trace_output_string

(

const char *

str

)

vsf_trace_string()

void vsf_trace_string	(	vsf_trace_level_t	level,
		const char *	str
	)

__vsf_trace_buffer()

void __vsf_trace_buffer	(	vsf_trace_level_t	level,
		void *	buffer,
		uint_fast16_t	len,
		uint_fast32_t	flag
	)

vsf_trace_arg()

void vsf_trace_arg	(	vsf_trace_level_t	level,
		const char *	format,
		va_list	arg
	)

vsf_trace()

void vsf_trace	(	vsf_trace_level_t	level,
		const char *	format,
			...
	)

vsf_trace_dump_stack()

void vsf_trace_dump_stack

(

void

)

vsf_trace_assert()

void vsf_trace_assert	(	const char *	expr,
		const char *	file,
		int	line,
		const char *	func
	)

system macros

Note

IMPORTANT ! - Every time when you try to add some 'common' header file including ! into __type.h, please take more time to think your decision, and ! make sure that the header file is available in all the compiler ! environment and platforms. ! ! - If you know what you are doing, and there is still some concerns ! which others need to know, please DO add necessary information ! besides the "#include <xxxx>" ! ! - If you want to introduce a system header file (as part of c ! standard) and you haven't encounter any known case where the header ! file is absent, we can assume that it is safe to put it in __type.h. ! If you do encounter scenarios where the header files is missing, ! please move it to the platform specific type.h

vsf_bgtrace_clear()

void vsf_bgtrace_clear

(

vsf_bgtrace_t *

bgtrace

)

vsf_bgtrace_total()

uint32_t vsf_bgtrace_total

(

vsf_bgtrace_t *

bgtrace

)

vsf_bgtrace_append()

void vsf_bgtrace_append	(	vsf_bgtrace_t *	bgtrace,
		void *	element
	)

vsf_bgtrace_print()

void vsf_bgtrace_print	(	vsf_bgtrace_t *	bgtrace,
		int	cnt
	)

vsf_stdout_init()

void vsf_stdout_init

(

void

)

vsf_stderr_init()

void vsf_stderr_init

(

void

)

vsf_stdin_init()

void vsf_stdin_init

(

void

)

vsf_stdout_putchar()

int vsf_stdout_putchar

(

char

ch

)

vsf_stderr_putchar()

int vsf_stderr_putchar

(

char

ch

)

Variable Documentation

vsf_trace_vplt

__VSF_VPLT_DECORATOR__ vsf_trace_vplt_t vsf_trace_vplt

Initial value:

= {
    VSF_APPLET_VPLT_INFO(vsf_trace_vplt_t, 0, 0, true),
 
    VSF_APPLET_VPLT_ENTRY_FUNC(__vsf_trace_buffer),
    VSF_APPLET_VPLT_ENTRY_FUNC(__vsf_trace_output),
    VSF_APPLET_VPLT_ENTRY_FUNC(vsf_trace_string),
    VSF_APPLET_VPLT_ENTRY_FUNC(vsf_trace_arg),
    VSF_APPLET_VPLT_ENTRY_FUNC(vsf_trace_assert),
    VSF_APPLET_VPLT_ENTRY_FUNC(vsf_trace),
}