]>
Commit | Line | Data |
---|---|---|
2721c5b9 SB |
1 | /* |
2 | * Copyright (C) ST-Ericsson AB 2010 | |
3 | * Author: Sjur Brendeland/ sjur.brandeland@stericsson.com | |
4 | * License terms: GNU General Public License (GPL) version 2 | |
5 | */ | |
6 | ||
7 | #ifndef CAIF_DEV_H_ | |
8 | #define CAIF_DEV_H_ | |
9 | ||
10 | #include <net/caif/caif_layer.h> | |
11 | #include <net/caif/cfcnfg.h> | |
12 | #include <linux/caif/caif_socket.h> | |
13 | #include <linux/if.h> | |
14 | ||
15 | /** | |
16 | * struct caif_param - CAIF parameters. | |
17 | * @size: Length of data | |
18 | * @data: Binary Data Blob | |
19 | */ | |
20 | struct caif_param { | |
21 | u16 size; | |
22 | u8 data[256]; | |
23 | }; | |
24 | ||
25 | /** | |
e539d83c SB |
26 | * struct caif_connect_request - Request data for CAIF channel setup. |
27 | * @protocol: Type of CAIF protocol to use (at, datagram etc) | |
2721c5b9 SB |
28 | * @sockaddr: Socket address to connect. |
29 | * @priority: Priority of the connection. | |
30 | * @link_selector: Link selector (high bandwidth or low latency) | |
f2527ec4 | 31 | * @ifindex: kernel index of the interface. |
e539d83c | 32 | * @param: Connect Request parameters (CAIF_SO_REQ_PARAM). |
2721c5b9 SB |
33 | * |
34 | * This struct is used when connecting a CAIF channel. | |
35 | * It contains all CAIF channel configuration options. | |
36 | */ | |
37 | struct caif_connect_request { | |
e539d83c | 38 | enum caif_protocol_type protocol; |
2721c5b9 SB |
39 | struct sockaddr_caif sockaddr; |
40 | enum caif_channel_priority priority; | |
41 | enum caif_link_selector link_selector; | |
f2527ec4 | 42 | int ifindex; |
2721c5b9 SB |
43 | struct caif_param param; |
44 | }; | |
45 | ||
46 | /** | |
47 | * caif_connect_client - Connect a client to CAIF Core Stack. | |
48 | * @config: Channel setup parameters, specifying what address | |
49 | * to connect on the Modem. | |
50 | * @client_layer: User implementation of client layer. This layer | |
51 | * MUST have receive and control callback functions | |
52 | * implemented. | |
2aa40aef SB |
53 | * @ifindex: Link layer interface index used for this connection. |
54 | * @headroom: Head room needed by CAIF protocol. | |
55 | * @tailroom: Tail room needed by CAIF protocol. | |
2721c5b9 SB |
56 | * |
57 | * This function connects a CAIF channel. The Client must implement | |
58 | * the struct cflayer. This layer represents the Client layer and holds | |
59 | * receive functions and control callback functions. Control callback | |
60 | * function will receive information about connect/disconnect responses, | |
61 | * flow control etc (see enum caif_control). | |
62 | * E.g. CAIF Socket will call this function for each socket it connects | |
63 | * and have one client_layer instance for each socket. | |
64 | */ | |
2aa40aef SB |
65 | int caif_connect_client(struct caif_connect_request *conn_req, |
66 | struct cflayer *client_layer, int *ifindex, | |
67 | int *headroom, int *tailroom); | |
2721c5b9 SB |
68 | |
69 | /** | |
70 | * caif_disconnect_client - Disconnects a client from the CAIF stack. | |
71 | * | |
72 | * @client_layer: Client layer to be removed. | |
73 | */ | |
74 | int caif_disconnect_client(struct cflayer *client_layer); | |
75 | ||
5b208656 SB |
76 | /** |
77 | * caif_release_client - Release adaptation layer reference to client. | |
78 | * | |
79 | * @client_layer: Client layer. | |
80 | * | |
81 | * Releases a client/adaptation layer use of the caif stack. | |
82 | * This function must be used after caif_disconnect_client to | |
83 | * decrease the reference count of the service layer. | |
84 | */ | |
85 | void caif_release_client(struct cflayer *client_layer); | |
86 | ||
2721c5b9 SB |
87 | /** |
88 | * connect_req_to_link_param - Translate configuration parameters | |
89 | * from socket format to internal format. | |
90 | * @cnfg: Pointer to configuration handler | |
91 | * @con_req: Configuration parameters supplied in function | |
92 | * caif_connect_client | |
93 | * @channel_setup_param: Parameters supplied to the CAIF Core stack for | |
94 | * setting up channels. | |
95 | * | |
96 | */ | |
97 | int connect_req_to_link_param(struct cfcnfg *cnfg, | |
98 | struct caif_connect_request *con_req, | |
99 | struct cfctrl_link_param *channel_setup_param); | |
100 | ||
101 | /** | |
102 | * get_caif_conf() - Get the configuration handler. | |
103 | */ | |
104 | struct cfcnfg *get_caif_conf(void); | |
105 | ||
106 | ||
107 | #endif /* CAIF_DEV_H_ */ |