| /* |
| * Trace messages sent over HBUS |
| * |
| * Copyright 1999-2016, Broadcom Corporation |
| * All rights reserved, |
| * |
| * Redistribution and use in source and binary forms, with or without modification, |
| * are permitted provided that the following conditions are met: |
| * 1. Redistributions of source code must retain the above copyright notice, |
| * this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright notice, |
| * this list of conditions and the following disclaimer in the documentation |
| * and/or other materials provided with the distribution. |
| * |
| * This software is provided by the copyright holder "as is" and any express or |
| * implied warranties, including, but not limited to, the implied warranties of |
| * merchantability and fitness for a particular purpose are disclaimed. In no event |
| * shall copyright holder be liable for any direct, indirect, incidental, special, |
| * exemplary, or consequential damages (including, but not limited to, procurement |
| * of substitute goods or services; loss of use, data, or profits; or business |
| * interruption) however caused and on any theory of liability, whether in |
| * contract, strict liability, or tort (including negligence or otherwise) arising |
| * in any way out of the use of this software, even if advised of the possibility |
| * of such damage |
| * |
| * |
| * <<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 */ |