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
9 #include <linux/spinlock.h>
10 #include <linux/netdevice.h>
11 #include <net/caif/caif_layer.h>
12 #include <net/caif/cfctrl.h>
17 * enum cfcnfg_phy_type - Types of physical layers defined in CAIF Stack
19 * @CFPHYTYPE_FRAG: Fragmented frames physical interface.
20 * @CFPHYTYPE_CAIF: Generic CAIF physical interface
22 enum cfcnfg_phy_type
{
29 * enum cfcnfg_phy_preference - Physical preference HW Abstraction
31 * @CFPHYPREF_UNSPECIFIED: Default physical interface
33 * @CFPHYPREF_LOW_LAT: Default physical interface for low-latency
35 * @CFPHYPREF_HIGH_BW: Default physical interface for high-bandwidth
37 * @CFPHYPREF_LOOP: TEST only Loopback interface simulating modem
41 enum cfcnfg_phy_preference
{
42 CFPHYPREF_UNSPECIFIED
,
49 * cfcnfg_create() - Create the CAIF configuration object.
51 struct cfcnfg
*cfcnfg_create(void);
54 * cfcnfg_remove() - Remove the CFCNFG object
57 void cfcnfg_remove(struct cfcnfg
*cfg
);
60 * cfcnfg_add_phy_layer() - Adds a physical layer to the CAIF stack.
61 * @cnfg: Pointer to a CAIF configuration object, created by
63 * @phy_type: Specifies the type of physical interface, e.g.
65 * @dev: Pointer to link layer device
66 * @phy_layer: Specify the physical layer. The transmit function
67 * MUST be set in the structure.
68 * @phyid: The assigned physical ID for this layer, used in
69 * cfcnfg_add_adapt_layer to specify PHY for the link.
70 * @pref: The phy (link layer) preference.
71 * @fcs: Specify if checksum is used in CAIF Framing Layer.
72 * @stx: Specify if Start Of Frame eXtention is used.
76 cfcnfg_add_phy_layer(struct cfcnfg
*cnfg
, enum cfcnfg_phy_type phy_type
,
77 struct net_device
*dev
, struct cflayer
*phy_layer
,
78 u16
*phyid
, enum cfcnfg_phy_preference pref
,
82 * cfcnfg_del_phy_layer - Deletes an phy layer from the CAIF stack.
84 * @cnfg: Pointer to a CAIF configuration object, created by
86 * @phy_layer: Adaptation layer to be removed.
88 int cfcnfg_del_phy_layer(struct cfcnfg
*cnfg
, struct cflayer
*phy_layer
);
91 * cfcnfg_disconn_adapt_layer - Disconnects an adaptation layer.
93 * @cnfg: Pointer to a CAIF configuration object, created by
95 * @adap_layer: Adaptation layer to be removed.
97 int cfcnfg_disconn_adapt_layer(struct cfcnfg
*cnfg
,
98 struct cflayer
*adap_layer
);
101 * cfcnfg_release_adap_layer - Used by client to release the adaptation layer.
103 * @adap_layer: Adaptation layer.
105 void cfcnfg_release_adap_layer(struct cflayer
*adap_layer
);
108 * cfcnfg_add_adaptation_layer - Add an adaptation layer to the CAIF stack.
110 * The adaptation Layer is where the interface to application or higher-level
111 * driver functionality is implemented.
113 * @cnfg: Pointer to a CAIF configuration object, created by
115 * @param: Link setup parameters.
116 * @adap_layer: Specify the adaptation layer; the receive and
117 * flow-control functions MUST be set in the structure.
118 * @ifindex: Link layer interface index used for this connection.
119 * @proto_head: Protocol head-space needed by CAIF protocol,
120 * excluding link layer.
121 * @proto_tail: Protocol tail-space needed by CAIF protocol,
122 * excluding link layer.
124 int cfcnfg_add_adaptation_layer(struct cfcnfg
*cnfg
,
125 struct cfctrl_link_param
*param
,
126 struct cflayer
*adap_layer
,
132 * cfcnfg_get_phyid() - Get physical ID, given type.
133 * Returns one of the physical interfaces matching the given type.
134 * Zero if no match is found.
135 * @cnfg: Configuration object
136 * @phy_pref: Caif Link Layer preference
138 struct dev_info
*cfcnfg_get_phyid(struct cfcnfg
*cnfg
,
139 enum cfcnfg_phy_preference phy_pref
);
142 * cfcnfg_get_id_from_ifi() - Get the Physical Identifier of ifindex,
143 * it matches caif physical id with the kernel interface id.
144 * @cnfg: Configuration object
145 * @ifi: ifindex obtained from socket.c bindtodevice.
147 int cfcnfg_get_id_from_ifi(struct cfcnfg
*cnfg
, int ifi
);
148 #endif /* CFCNFG_H_ */