1 /*
2  * Copyright 2023, Cypress Semiconductor Corporation (an Infineon company)
3  * SPDX-License-Identifier: Apache-2.0
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  *     http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17 
18 #include <stdio.h>
19 #include <stdio.h>
20 #include <string.h>
21 #include "whd.h"
22 
23 #ifndef INCLUDED_WHD_DEBUG_H
24 #define INCLUDED_WHD_DEBUG_H
25 
26 #ifdef __cplusplus
27 extern "C"
28 {
29 #endif
30 
31 /******************************************************
32 *                      Macros
33 ******************************************************/
34 #define WPRINT_ENABLE_WHD_ERROR
35 /* #define WPRINT_ENABLE_WHD_INFO */
36 /* #define WPRINT_ENABLE_WHD_DEBUG */
37 
38 #define WHD_ENABLE_STATS
39 /*#define WHD_LOGGING_BUFFER_ENABLE*/
40 
41 #if defined (__GNUC__)
42 #define WHD_TRIGGER_BREAKPOINT( ) do { __asm__ ("bkpt"); } while (0)
43 
44 #elif defined (__IAR_SYSTEMS_ICC__)
45 #define WHD_TRIGGER_BREAKPOINT( ) do { __asm("bkpt 0"); } while (0)
46 
47 #else
48 #define WHD_TRIGGER_BREAKPOINT( )
49 #endif
50 
51 #ifdef WPRINT_ENABLE_ERROR
52 #define WPRINT_ERROR(args)                      do { WPRINT_MACRO(args); } while (0)
53 #define whd_assert(error_string, assertion) do { if (!(assertion) ){ WHD_TRIGGER_BREAKPOINT(); } } while (0)
54 #define whd_minor_assert(error_string, \
55                          assertion)   do { if (!(assertion) ) WPRINT_MACRO( (error_string) ); } while (0)
56 #else
57 #define whd_assert(error_string, \
58                    assertion)         do { if (!(assertion) ){ WPRINT_MACRO( (error_string) ); } } while (0)
59 #define whd_minor_assert(error_string, assertion)   do { (void)(assertion); } while (0)
60 #endif
61 
62 /******************************************************
63 *             Print declarations
64 ******************************************************/
65 /* IF MFG TEST is enabled then disable all LOGGING VIA UART as
66  + * this interrupts communication between WL TOOL and MFG Test APP
67  + * via STDIO UART causing Wrong Message Exchange and failure.
68  + */
69 #if defined(WLAN_MFG_FIRMWARE) || defined(WHD_PRINT_DISABLE)
70 #define WPRINT_MACRO(args)
71 #else
72 #if defined(WHD_LOGGING_BUFFER_ENABLE)
73 #define WPRINT_MACRO(args) do { whd_buffer_printf args; } while (0 == 1)
74 #else
75 #define WPRINT_MACRO(args) do { printf args;} while (0 == 1)
76 #endif
77 #endif
78 
79 
80 /* WICED printing macros for Wiced Wi-Fi Driver*/
81 #ifdef WPRINT_ENABLE_WHD_INFO
82 #define WPRINT_WHD_INFO(args) WPRINT_MACRO(args)
83 #else
84 #define WPRINT_WHD_INFO(args)
85 #endif
86 
87 #ifdef WPRINT_ENABLE_WHD_DEBUG
88 #define WPRINT_WHD_DEBUG(args) WPRINT_MACRO(args)
89 #else
90 #define WPRINT_WHD_DEBUG(args)
91 #endif
92 
93 #ifdef WPRINT_ENABLE_WHD_ERROR
94 #define WPRINT_WHD_ERROR(args) WPRINT_MACRO(args);
95 #else
96 #define WPRINT_WHD_ERROR(args)
97 #endif
98 
99 #ifdef WPRINT_ENABLE_WHD_DATA_LOG
100 #define WPRINT_WHD_DATA_LOG(args) WPRINT_MACRO(args)
101 #else
102 #define WPRINT_WHD_DATA_LOG(args)
103 #endif
104 
105 #define WHD_STATS_INCREMENT_VARIABLE(whd_driver, var) \
106     do { whd_driver->whd_stats.var++; } while (0)
107 
108 #define WHD_STATS_CONDITIONAL_INCREMENT_VARIABLE(whd_driver, condition, var) \
109     do { if (condition){ whd_driver->whd_stats.var++; }} while (0)
110 
111 #if (defined(__GNUC__) && (__GNUC__ >= 6) )
112 #define __FUNCTION__ __func__
113 #endif
114 
115 
116 void whd_init_stats(whd_driver_t whd_driver);
117 void whd_print_logbuffer(void);
118 
119 
120 #ifdef WHD_LOGGING_BUFFER_ENABLE
121 #define LOGGING_BUFFER_SIZE (4 * 1024)
122 int whd_buffer_printf(const char *format, ...);
123 
124 typedef struct
125 {
126     uint32_t buffer_write;
127     uint32_t buffer_read;
128     char buffer[LOGGING_BUFFER_SIZE + 1];
129     whd_bool_t roll_over;
130     whd_bool_t over_write;
131 } whd_logging_t;
132 #else
133 #define whd_print_logbuffer()
134 #endif /* WHD_LOGGING_BUFFER_ENABLE */
135 
136 #ifdef WHD_IOCTL_LOG_ENABLE
137 #define WHD_IOCTL_LOG_ADD(x, y, z) whd_ioctl_log_add(x, y, z)
138 #define WHD_IOCTL_LOG_ADD_EVENT(w, x, y, z) whd_ioctl_log_add_event(w, x, y, z)
139 #define WHD_IOCTL_PRINT(x) whd_ioctl_print(x)
140 #else
141 #define WHD_IOCTL_LOG_ADD(x, y, z)
142 #define WHD_IOCTL_LOG_ADD_EVENT(w, x, y, z)
143 #define WHD_IOCTL_PRINT(x)
144 #endif
145 
146 #ifdef __cplusplus
147 } /* extern "C" */
148 #endif
149 #endif /* ifndef INCLUDED_WHD_DEBUG_H */
150 
151