LXR linux/drivers/net/ipa/ipa

   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
  11struct gsi;
  12struct gsi_trans;
  13struct 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 */
  22void 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 */
  32void 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 */
  44void 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 */
  57void 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 */
  69bool ipa_gsi_endpoint_data_empty(const struct ipa_gsi_endpoint_data *data);
  70
  71#endif /* _IPA_GSI_TRANS_H_ */
  72