xref: /openbmc/linux/drivers/net/ipa/ipa_endpoint.h (revision 74be2d3b)
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 
16 struct net_device;
17 struct sk_buff;
18 
19 struct ipa;
20 struct 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 
27 enum ipa_endpoint_name {
28 	IPA_ENDPOINT_AP_MODEM_TX	= 0,
29 	IPA_ENDPOINT_MODEM_LAN_TX,
30 	IPA_ENDPOINT_MODEM_COMMAND_TX,
31 	IPA_ENDPOINT_AP_COMMAND_TX,
32 	IPA_ENDPOINT_MODEM_AP_TX,
33 	IPA_ENDPOINT_AP_LAN_RX,
34 	IPA_ENDPOINT_AP_MODEM_RX,
35 	IPA_ENDPOINT_MODEM_AP_RX,
36 	IPA_ENDPOINT_MODEM_LAN_RX,
37 	IPA_ENDPOINT_COUNT,	/* Number of names (not an index) */
38 };
39 
40 #define IPA_ENDPOINT_MAX		32	/* Max supported by driver */
41 
42 /**
43  * struct ipa_endpoint - IPA endpoint information
44  * @channel_id:	EP's GSI channel
45  * @evt_ring_id: EP's GSI channel event ring
46  */
47 struct ipa_endpoint {
48 	struct ipa *ipa;
49 	enum ipa_seq_type seq_type;
50 	enum gsi_ee_id ee_id;
51 	u32 channel_id;
52 	u32 endpoint_id;
53 	bool toward_ipa;
54 	const struct ipa_endpoint_config_data *data;
55 
56 	u32 trans_tre_max;	/* maximum descriptors per transaction */
57 	u32 evt_ring_id;
58 
59 	/* Net device this endpoint is associated with, if any */
60 	struct net_device *netdev;
61 
62 	/* Receive buffer replenishing for RX endpoints */
63 	bool replenish_enabled;
64 	u32 replenish_ready;
65 	atomic_t replenish_saved;
66 	atomic_t replenish_backlog;
67 	struct delayed_work replenish_work;		/* global wq */
68 };
69 
70 void ipa_endpoint_modem_hol_block_clear_all(struct ipa *ipa);
71 
72 void ipa_endpoint_modem_pause_all(struct ipa *ipa, bool enable);
73 
74 int ipa_endpoint_modem_exception_reset_all(struct ipa *ipa);
75 
76 int ipa_endpoint_skb_tx(struct ipa_endpoint *endpoint, struct sk_buff *skb);
77 
78 void ipa_endpoint_exit_one(struct ipa_endpoint *endpoint);
79 
80 int ipa_endpoint_enable_one(struct ipa_endpoint *endpoint);
81 void ipa_endpoint_disable_one(struct ipa_endpoint *endpoint);
82 
83 void ipa_endpoint_suspend_one(struct ipa_endpoint *endpoint);
84 void ipa_endpoint_resume_one(struct ipa_endpoint *endpoint);
85 
86 void ipa_endpoint_suspend(struct ipa *ipa);
87 void ipa_endpoint_resume(struct ipa *ipa);
88 
89 void ipa_endpoint_setup(struct ipa *ipa);
90 void ipa_endpoint_teardown(struct ipa *ipa);
91 
92 int ipa_endpoint_config(struct ipa *ipa);
93 void ipa_endpoint_deconfig(struct ipa *ipa);
94 
95 void ipa_endpoint_default_route_set(struct ipa *ipa, u32 endpoint_id);
96 void ipa_endpoint_default_route_clear(struct ipa *ipa);
97 
98 u32 ipa_endpoint_init(struct ipa *ipa, u32 count,
99 		      const struct ipa_gsi_endpoint_data *data);
100 void ipa_endpoint_exit(struct ipa *ipa);
101 
102 void ipa_endpoint_trans_complete(struct ipa_endpoint *ipa,
103 				 struct gsi_trans *trans);
104 void ipa_endpoint_trans_release(struct ipa_endpoint *ipa,
105 				struct gsi_trans *trans);
106 
107 #endif /* _IPA_ENDPOINT_H_ */
108