tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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_ENDPOINT_H_
7#define _IPA_ENDPOINT_H_
8
9#include <linux/types.h>
10#include <linux/workqueue.h>
11#include <linux/if_ether.h>
12
13#include "gsi.h"
14#include "ipa_reg.h"
15
16struct net_device;
17struct sk_buff;
18
19struct ipa;
20struct ipa_gsi_endpoint_data;
21
22/* Non-zero granularity of counter used to implement aggregation timeout */
23#define IPA_AGGR_GRANULARITY 500 /* microseconds */
24
25#define IPA_MTU ETH_DATA_LEN
26
27enum ipa_endpoint_name {
28 IPA_ENDPOINT_AP_COMMAND_TX,
29 IPA_ENDPOINT_AP_LAN_RX,
30 IPA_ENDPOINT_AP_MODEM_TX,
31 IPA_ENDPOINT_AP_MODEM_RX,
32 IPA_ENDPOINT_MODEM_COMMAND_TX,
33 IPA_ENDPOINT_MODEM_LAN_TX,
34 IPA_ENDPOINT_MODEM_LAN_RX,
35 IPA_ENDPOINT_MODEM_AP_TX,
36 IPA_ENDPOINT_MODEM_AP_RX,
37 IPA_ENDPOINT_MODEM_DL_NLO_TX,
38 IPA_ENDPOINT_COUNT, /* Number of names (not an index) */
39};
40
41#define IPA_ENDPOINT_MAX 32 /* Max supported by driver */
42
43/**
44 * struct ipa_endpoint - IPA endpoint information
45 * @ipa: IPA pointer
46 * @ee_id: Execution environmnent endpoint is associated with
47 * @channel_id: GSI channel used by the endpoint
48 * @endpoint_id: IPA endpoint number
49 * @toward_ipa: Endpoint direction (true = TX, false = RX)
50 * @data: Endpoint configuration data
51 * @trans_tre_max: Maximum number of TRE descriptors per transaction
52 * @evt_ring_id: GSI event ring used by the endpoint
53 * @netdev: Network device pointer, if endpoint uses one
54 * @replenish_enabled: Whether receive buffer replenishing is enabled
55 * @replenish_ready: Number of replenish transactions without doorbell
56 * @replenish_saved: Replenish requests held while disabled
57 * @replenish_backlog: Number of buffers needed to fill hardware queue
58 * @replenish_work: Work item used for repeated replenish failures
59 */
60struct ipa_endpoint {
61 struct ipa *ipa;
62 enum gsi_ee_id ee_id;
63 u32 channel_id;
64 u32 endpoint_id;
65 bool toward_ipa;
66 const struct ipa_endpoint_config_data *data;
67
68 u32 trans_tre_max;
69 u32 evt_ring_id;
70
71 /* Net device this endpoint is associated with, if any */
72 struct net_device *netdev;
73
74 /* Receive buffer replenishing for RX endpoints */
75 bool replenish_enabled;
76 u32 replenish_ready;
77 atomic_t replenish_saved;
78 atomic_t replenish_backlog;
79 struct delayed_work replenish_work; /* global wq */
80};
81
82void ipa_endpoint_modem_hol_block_clear_all(struct ipa *ipa);
83
84void ipa_endpoint_modem_pause_all(struct ipa *ipa, bool enable);
85
86int ipa_endpoint_modem_exception_reset_all(struct ipa *ipa);
87
88int ipa_endpoint_skb_tx(struct ipa_endpoint *endpoint, struct sk_buff *skb);
89
90int ipa_endpoint_enable_one(struct ipa_endpoint *endpoint);
91void ipa_endpoint_disable_one(struct ipa_endpoint *endpoint);
92
93void ipa_endpoint_suspend_one(struct ipa_endpoint *endpoint);
94void ipa_endpoint_resume_one(struct ipa_endpoint *endpoint);
95
96void ipa_endpoint_suspend(struct ipa *ipa);
97void ipa_endpoint_resume(struct ipa *ipa);
98
99void ipa_endpoint_setup(struct ipa *ipa);
100void ipa_endpoint_teardown(struct ipa *ipa);
101
102int ipa_endpoint_config(struct ipa *ipa);
103void ipa_endpoint_deconfig(struct ipa *ipa);
104
105void ipa_endpoint_default_route_set(struct ipa *ipa, u32 endpoint_id);
106void ipa_endpoint_default_route_clear(struct ipa *ipa);
107
108u32 ipa_endpoint_init(struct ipa *ipa, u32 count,
109 const struct ipa_gsi_endpoint_data *data);
110void ipa_endpoint_exit(struct ipa *ipa);
111
112void ipa_endpoint_trans_complete(struct ipa_endpoint *ipa,
113 struct gsi_trans *trans);
114void ipa_endpoint_trans_release(struct ipa_endpoint *ipa,
115 struct gsi_trans *trans);
116
117#endif /* _IPA_ENDPOINT_H_ */