summaryrefstree
path: root/kernel/include/linux/ipa_odu_bridge.h
blob: 688b964e043f4164957ee923f8ec90fb8ed3b62b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (c) 2012-2020, The Linux Foundation. All rights reserved.
 */

#ifndef _IPA_ODO_BRIDGE_H_
#define _IPA_ODO_BRIDGE_H_

#include <linux/ipa.h>

/**
 * struct odu_bridge_params - parameters for odu bridge initialization API
 *
 * @netdev_name: network interface name
 * @priv: private data that will be supplied to client's callback
 * @tx_dp_notify: callback for handling SKB. the following event are supported:
 *	IPA_WRITE_DONE:	will be called after client called to odu_bridge_tx_dp()
 *			Client is expected to free the skb.
 *	IPA_RECEIVE:	will be called for delivering skb to APPS.
 *			Client is expected to deliver the skb to network stack.
 * @send_dl_skb: callback for sending skb on downlink direction to adapter.
 *		Client is expected to free the skb.
 * @device_ethaddr: device Ethernet address in network order.
 * @ipa_desc_size: IPA Sys Pipe Desc Size
 */
struct odu_bridge_params {
	const char *netdev_name;
	void *priv;
	ipa_notify_cb tx_dp_notify;
	int (*send_dl_skb)(void *priv, struct sk_buff *skb);
	u8 device_ethaddr[ETH_ALEN];
	u32 ipa_desc_size;
};

/**
 * struct ipa_bridge_init_params - parameters for IPA bridge initialization API
 *
 * @info: structure contains initialization information
 * @wakeup_request: callback to client to indicate there is downlink data
 *	available. Client is expected to call ipa_bridge_resume() to start
 *	receiving data
 */
struct ipa_bridge_init_params {
	struct odu_bridge_params info;
	void (*wakeup_request)(void *cl_priv);
};

#if IS_ENABLED(CONFIG_IPA3)

int ipa_bridge_init(struct ipa_bridge_init_params *params, u32 *hdl);

int ipa_bridge_connect(u32 hdl);

int ipa_bridge_set_perf_profile(u32 hdl, u32 bandwidth);

int ipa_bridge_disconnect(u32 hdl);

int ipa_bridge_suspend(u32 hdl);

int ipa_bridge_resume(u32 hdl);

int ipa_bridge_tx_dp(u32 hdl, struct sk_buff *skb,
	struct ipa_tx_meta *metadata);

int ipa_bridge_cleanup(u32 hdl);

#else /* IS_ENABLED(CONFIG_IPA3) */

static inline int ipa_bridge_init(struct odu_bridge_params *params, u32 *hdl)
{
	return -EPERM;
}

static inline int ipa_bridge_connect(u32 hdl)
{
	return -EPERM;
}

static inline int ipa_bridge_set_perf_profile(u32 hdl, u32 bandwidth)
{
	return -EPERM;
}

static inline int ipa_bridge_disconnect(u32 hdl)
{
	return -EPERM;
}

static inline int ipa_bridge_suspend(u32 hdl)
{
	return -EPERM;
}

static inline int ipa_bridge_resume(u32 hdl)
{
	return -EPERM;
}

static inline int ipa_bridge_tx_dp(u32 hdl, struct sk_buff *skb,
struct ipa_tx_meta *metadata)
{
	return -EPERM;
}

static inline int ipa_bridge_cleanup(u32 hdl)
{
	return -EPERM;
}

#endif /* IS_ENABLED(CONFIG_IPA3) */

/* Below API is deprecated. Please use the API above */

static inline int odu_bridge_init(struct odu_bridge_params *params)
{
	return -EPERM;
}

static inline int odu_bridge_disconnect(void)
{
	return -EPERM;
}

static inline int odu_bridge_connect(void)
{
	return -EPERM;
}

static inline int odu_bridge_tx_dp(struct sk_buff *skb,
						struct ipa_tx_meta *metadata)
{
	return -EPERM;
}

static inline int odu_bridge_cleanup(void)
{
	return -EPERM;
}

#endif /* _IPA_ODO_BRIDGE_H */