1 /* SPDX-License-Identifier: GPL-2.0 */ 2 3 /* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved. 4 * Copyright (C) 2019-2020 Linaro Ltd. 5 */ 6 #ifndef _IPA_GSI_TRANS_H_ 7 #define _IPA_GSI_TRANS_H_ 8 9 #include <linux/types.h> 10 11 struct gsi; 12 struct gsi_trans; 13 struct ipa_gsi_endpoint_data; 14 15 /** 16 * ipa_gsi_trans_complete() - GSI transaction completion callback 17 * @trans: Transaction that has completed 18 * 19 * This called from the GSI layer to notify the IPA layer that a 20 * transaction has completed. 21 */ 22 void ipa_gsi_trans_complete(struct gsi_trans *trans); 23 24 /** 25 * ipa_gsi_trans_release() - GSI transaction release callback 26 * @trans: Transaction whose resources should be freed 27 * 28 * This called from the GSI layer to notify the IPA layer that a 29 * transaction is about to be freed, so any resources associated 30 * with it should be released. 31 */ 32 void ipa_gsi_trans_release(struct gsi_trans *trans); 33 34 /** 35 * ipa_gsi_channel_tx_queued() - GSI queued to hardware notification 36 * @gsi: GSI pointer 37 * @channel_id: Channel number 38 * @count: Number of transactions queued 39 * @byte_count: Number of bytes to transfer represented by transactions 40 * 41 * This called from the GSI layer to notify the IPA layer that some 42 * number of transactions have been queued to hardware for execution. 43 */ 44 void ipa_gsi_channel_tx_queued(struct gsi *gsi, u32 channel_id, u32 count, 45 u32 byte_count); 46 47 /** 48 * ipa_gsi_channel_tx_completed() - GSI transaction completion callback 49 * @gsi: GSI pointer 50 * @channel_id: Channel number 51 * @count: Number of transactions completed since last report 52 * @byte_count: Number of bytes transferred represented by transactions 53 * 54 * This called from the GSI layer to notify the IPA layer that the hardware 55 * has reported the completion of some number of transactions. 56 */ 57 void ipa_gsi_channel_tx_completed(struct gsi *gsi, u32 channel_id, u32 count, 58 u32 byte_count); 59 60 /* ipa_gsi_endpoint_data_empty() - Empty endpoint config data test 61 * @data: endpoint configuration data 62 * 63 * Determines whether an endpoint configuration data entry is empty, 64 * meaning it contains no valid configuration information and should 65 * be ignored. 66 * 67 * Return: true if empty; false otherwise 68 */ 69 bool ipa_gsi_endpoint_data_empty(const struct ipa_gsi_endpoint_data *data); 70 71 #endif /* _IPA_GSI_TRANS_H_ */ 72