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 CFCNFG_H_
  8#define CFCNFG_H_
  9#include <linux/spinlock.h>
 10#include <linux/netdevice.h>
 11#include <net/caif/caif_layer.h>
 12#include <net/caif/cfctrl.h>
 13
 14struct cfcnfg;
 15
 16/**
 17 * enum cfcnfg_phy_type -  Types of physical layers defined in CAIF Stack
 18 *
 19 * @CFPHYTYPE_FRAG:	Fragmented frames physical interface.
 20 * @CFPHYTYPE_CAIF:	Generic CAIF physical interface
 21 */
 22enum cfcnfg_phy_type {
 23	CFPHYTYPE_FRAG = 1,
 24	CFPHYTYPE_CAIF,
 25	CFPHYTYPE_MAX
 26};
 27
 28/**
 29 * enum cfcnfg_phy_preference - Physical preference HW Abstraction
 30 *
 31 * @CFPHYPREF_UNSPECIFIED:	Default physical interface
 32 *
 33 * @CFPHYPREF_LOW_LAT:		Default physical interface for low-latency
 34 *				traffic
 35 * @CFPHYPREF_HIGH_BW:		Default physical interface for high-bandwidth
 36 *				traffic
 37 * @CFPHYPREF_LOOP:		TEST only Loopback interface simulating modem
 38 *				responses.
 39 *
 40 */
 41enum cfcnfg_phy_preference {
 42	CFPHYPREF_UNSPECIFIED,
 43	CFPHYPREF_LOW_LAT,
 44	CFPHYPREF_HIGH_BW,
 45	CFPHYPREF_LOOP
 46};
 47
 48/**
 49 * cfcnfg_create() - Get the CAIF configuration object given network.
 50 * @net:	Network for the CAIF configuration object.
 51 */
 52struct cfcnfg *get_cfcnfg(struct net *net);
 53
 54/**
 55 * cfcnfg_create() - Create the CAIF configuration object.
 56 */
 57struct cfcnfg *cfcnfg_create(void);
 58
 59/**
 60 * cfcnfg_remove() -  Remove the CFCNFG object
 61 * @cfg: config object
 62 */
 63void cfcnfg_remove(struct cfcnfg *cfg);
 64
 65/**
 66 * cfcnfg_add_phy_layer() - Adds a physical layer to the CAIF stack.
 67 * @cnfg:	Pointer to a CAIF configuration object, created by
 68 *		cfcnfg_create().
 69 * @phy_type:	Specifies the type of physical interface, e.g.
 70 *			CFPHYTYPE_FRAG.
 71 * @dev:	Pointer to link layer device
 72 * @phy_layer:	Specify the physical layer. The transmit function
 73 *		MUST be set in the structure.
 74 * @pref:	The phy (link layer) preference.
 
 75 * @fcs:	Specify if checksum is used in CAIF Framing Layer.
 76 * @stx:	Specify if Start Of Frame eXtention is used.
 77 */
 78
 79void
 80cfcnfg_add_phy_layer(struct cfcnfg *cnfg, enum cfcnfg_phy_type phy_type,
 81		     struct net_device *dev, struct cflayer *phy_layer,
 82		     enum cfcnfg_phy_preference pref,
 83		     bool fcs, bool stx);
 
 84
 85/**
 86 * cfcnfg_del_phy_layer - Deletes an phy layer from the CAIF stack.
 87 *
 88 * @cnfg:	Pointer to a CAIF configuration object, created by
 89 *		cfcnfg_create().
 90 * @phy_layer:	Adaptation layer to be removed.
 91 */
 92int cfcnfg_del_phy_layer(struct cfcnfg *cnfg, struct cflayer *phy_layer);
 93
 94/**
 95 * cfcnfg_set_phy_state() - Set the state of the physical interface device.
 96 * @cnfg:	Configuration object
 97 * @phy_layer:	Physical Layer representation
 98 * @up:	State of device
 99 */
100int cfcnfg_set_phy_state(struct cfcnfg *cnfg, struct cflayer *phy_layer,
101				bool up);
102
103#endif				/* CFCNFG_H_ */

 1/* SPDX-License-Identifier: GPL-2.0-only */
 2/*
 3 * Copyright (C) ST-Ericsson AB 2010
 4 * Author:	Sjur Brendeland
 
 5 */
 6
 7#ifndef CFCNFG_H_
 8#define CFCNFG_H_
 9#include <linux/spinlock.h>
10#include <linux/netdevice.h>
11#include <net/caif/caif_layer.h>
12#include <net/caif/cfctrl.h>
13
14struct cfcnfg;
15
16/**
 
 
 
 
 
 
 
 
 
 
 
 
17 * enum cfcnfg_phy_preference - Physical preference HW Abstraction
18 *
19 * @CFPHYPREF_UNSPECIFIED:	Default physical interface
20 *
21 * @CFPHYPREF_LOW_LAT:		Default physical interface for low-latency
22 *				traffic
23 * @CFPHYPREF_HIGH_BW:		Default physical interface for high-bandwidth
24 *				traffic
25 * @CFPHYPREF_LOOP:		TEST only Loopback interface simulating modem
26 *				responses.
27 *
28 */
29enum cfcnfg_phy_preference {
30	CFPHYPREF_UNSPECIFIED,
31	CFPHYPREF_LOW_LAT,
32	CFPHYPREF_HIGH_BW,
33	CFPHYPREF_LOOP
34};
35
36/**
37 * cfcnfg_create() - Get the CAIF configuration object given network.
38 * @net:	Network for the CAIF configuration object.
39 */
40struct cfcnfg *get_cfcnfg(struct net *net);
41
42/**
43 * cfcnfg_create() - Create the CAIF configuration object.
44 */
45struct cfcnfg *cfcnfg_create(void);
46
47/**
48 * cfcnfg_remove() -  Remove the CFCNFG object
49 * @cfg: config object
50 */
51void cfcnfg_remove(struct cfcnfg *cfg);
52
53/**
54 * cfcnfg_add_phy_layer() - Adds a physical layer to the CAIF stack.
55 * @cnfg:	Pointer to a CAIF configuration object, created by
56 *		cfcnfg_create().
 
 
57 * @dev:	Pointer to link layer device
58 * @phy_layer:	Specify the physical layer. The transmit function
59 *		MUST be set in the structure.
60 * @pref:	The phy (link layer) preference.
61 * @link_support: Protocol implementation for link layer specific protocol.
62 * @fcs:	Specify if checksum is used in CAIF Framing Layer.
63 * @head_room:	Head space needed by link specific protocol.
64 */
65int
66cfcnfg_add_phy_layer(struct cfcnfg *cnfg,
 
67		     struct net_device *dev, struct cflayer *phy_layer,
68		     enum cfcnfg_phy_preference pref,
69		     struct cflayer *link_support,
70		     bool fcs, int head_room);
71
72/**
73 * cfcnfg_del_phy_layer - Deletes an phy layer from the CAIF stack.
74 *
75 * @cnfg:	Pointer to a CAIF configuration object, created by
76 *		cfcnfg_create().
77 * @phy_layer:	Adaptation layer to be removed.
78 */
79int cfcnfg_del_phy_layer(struct cfcnfg *cnfg, struct cflayer *phy_layer);
80
81/**
82 * cfcnfg_set_phy_state() - Set the state of the physical interface device.
83 * @cnfg:	Configuration object
84 * @phy_layer:	Physical Layer representation
85 * @up:	State of device
86 */
87int cfcnfg_set_phy_state(struct cfcnfg *cnfg, struct cflayer *phy_layer,
88				bool up);
89
90#endif				/* CFCNFG_H_ */