84 lines
3.2 KiB
C
84 lines
3.2 KiB
C
/*
|
|
* Trace messages sent over HBUS
|
|
*
|
|
* Portions of this code are copyright (c) 2017 Cypress Semiconductor Corporation
|
|
*
|
|
* Copyright (C) 1999-2017, Broadcom Corporation
|
|
*
|
|
* Unless you and Broadcom execute a separate written software license
|
|
* agreement governing use of this software, this software is licensed to you
|
|
* under the terms of the GNU General Public License version 2 (the "GPL"),
|
|
* available at http://www.broadcom.com/licenses/GPLv2.php, with the
|
|
* following added to such license:
|
|
*
|
|
* As a special exception, the copyright holders of this software give you
|
|
* permission to link this software with independent modules, and to copy and
|
|
* distribute the resulting executable under terms of your choice, provided that
|
|
* you also meet, for each linked independent module, the terms and conditions of
|
|
* the license of that module. An independent module is a module which is not
|
|
* derived from this software. The special exception does not apply to any
|
|
* modifications of the software.
|
|
*
|
|
* Notwithstanding the above, under no circumstances may you combine this
|
|
* software in any way with any other Broadcom software provided under a license
|
|
* other than the GPL, without Broadcom's express prior written consent.
|
|
*
|
|
*
|
|
* <<Broadcom-WL-IPTag/Open:>>
|
|
*
|
|
* $Id: msgtrace.h 514727 2014-11-12 03:02:48Z $
|
|
*/
|
|
|
|
#ifndef _MSGTRACE_H
|
|
#define _MSGTRACE_H
|
|
|
|
#ifndef _TYPEDEFS_H_
|
|
#include <typedefs.h>
|
|
#endif
|
|
|
|
|
|
/* This marks the start of a packed structure section. */
|
|
#include <packed_section_start.h>
|
|
/* for osl_t */
|
|
#include <osl_decl.h>
|
|
#define MSGTRACE_VERSION 1
|
|
|
|
/* Message trace header */
|
|
typedef BWL_PRE_PACKED_STRUCT struct msgtrace_hdr {
|
|
uint8 version;
|
|
uint8 trace_type;
|
|
#define MSGTRACE_HDR_TYPE_MSG 0
|
|
#define MSGTRACE_HDR_TYPE_LOG 1
|
|
uint16 len; /* Len of the trace */
|
|
uint32 seqnum; /* Sequence number of message. Useful if the messsage has been lost
|
|
* because of DMA error or a bus reset (ex: SDIO Func2)
|
|
*/
|
|
/* Msgtrace type only */
|
|
uint32 discarded_bytes; /* Number of discarded bytes because of trace overflow */
|
|
uint32 discarded_printf; /* Number of discarded printf because of trace overflow */
|
|
} BWL_POST_PACKED_STRUCT msgtrace_hdr_t;
|
|
|
|
#define MSGTRACE_HDRLEN sizeof(msgtrace_hdr_t)
|
|
|
|
/* The hbus driver generates traces when sending a trace message. This causes endless traces.
|
|
* This flag must be set to TRUE in any hbus traces. The flag is reset in the function msgtrace_put.
|
|
* This prevents endless traces but generates hasardous lost of traces only in bus device code.
|
|
* It is recommendat to set this flag in macro SD_TRACE but not in SD_ERROR for avoiding missing
|
|
* hbus error traces. hbus error trace should not generates endless traces.
|
|
*/
|
|
extern bool msgtrace_hbus_trace;
|
|
|
|
typedef void (*msgtrace_func_send_t)(void *hdl1, void *hdl2, uint8 *hdr,
|
|
uint16 hdrlen, uint8 *buf, uint16 buflen);
|
|
extern void msgtrace_start(void);
|
|
extern void msgtrace_stop(void);
|
|
extern int msgtrace_sent(void);
|
|
extern void msgtrace_put(char *buf, int count);
|
|
extern void msgtrace_init(void *hdl1, void *hdl2, msgtrace_func_send_t func_send);
|
|
extern bool msgtrace_event_enabled(void);
|
|
|
|
/* This marks the end of a packed structure section. */
|
|
#include <packed_section_end.h>
|
|
|
|
#endif /* _MSGTRACE_H */
|