1 /* 2 * Copyright (c) 2018,2020-2021, The Linux Foundation. All rights reserved. 3 * 4 * Permission to use, copy, modify, and/or distribute this software for 5 * any purpose with or without fee is hereby granted, provided that the 6 * above copyright notice and this permission notice appear in all 7 * copies. 8 * 9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL 10 * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED 11 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE 12 * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL 13 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR 14 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER 15 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 16 * PERFORMANCE OF THIS SOFTWARE. 17 */ 18 19 #ifndef _HTC_CREDIT_HISTORY_H_ 20 #define _HTC_CREDIT_HISTORY_H_ 21 22 #include "htc_internal.h" 23 24 #ifdef FEATURE_HTC_CREDIT_HISTORY 25 26 /** 27 * htc_credit_history_init() - Init helper function 28 * 29 * The htc_credit_history_init() function, helps to initialize 30 * HTC credit history buffers and variable. 31 * 32 * Return: None 33 */ 34 void htc_credit_history_init(void); 35 36 /** 37 * htc_credit_history_deinit() - Deinit helper function 38 * 39 * The htc_credit_history_deinit() function, helps to remove 40 * the HTC credit history buffers from minidump. 41 * 42 * Return: None 43 */ 44 void htc_credit_history_deinit(void); 45 void htc_credit_record(enum htc_credit_exchange_type type, uint32_t tx_credit, 46 uint32_t htc_tx_queue_depth); 47 #ifdef WLAN_HANG_EVENT 48 /** 49 * htc_log_hang_credit_history() - Log the credit history into a buffer 50 * @block: Notifier block 51 * @data: Private data of the block. 52 * 53 * HTC hang event notifier callback inovked when the recovery is triggered 54 * to log the credit information to understand the reason for recovery. 55 * 56 * Return: None 57 */ 58 void htc_log_hang_credit_history(struct notifier_block *block, void *data); 59 #else 60 static inline 61 void htc_log_hang_credit_history(struct notifier_block *block, void *data) 62 { 63 } 64 #endif 65 #else /* FEATURE_HTC_CREDIT_HISTORY */ 66 67 static inline 68 void htc_credit_history_init(void) 69 { 70 } 71 72 static inline 73 void htc_credit_history_deinit(void) 74 { 75 } 76 77 static inline 78 void htc_credit_record(enum htc_credit_exchange_type type, uint32_t tx_credit, 79 uint32_t htc_tx_queue_depth) 80 { } 81 #endif /* FEATURE_HTC_CREDIT_HISTORY */ 82 #endif /* _HTC_CREDIT_HISTORY_H_ */ 83