Commit | Line | Data |
---|---|---|
2bfb1070 DES |
1 | /* |
2 | * Copyright (C) 2007, 2008, 2009 Siemens AG | |
3 | * | |
4 | * This program is free software; you can redistribute it and/or modify | |
5 | * it under the terms of the GNU General Public License version 2 | |
6 | * as published by the Free Software Foundation. | |
7 | * | |
8 | * This program is distributed in the hope that it will be useful, | |
9 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
10 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
11 | * GNU General Public License for more details. | |
12 | * | |
2bfb1070 DES |
13 | * Written by: |
14 | * Dmitry Eremin-Solenikov <dbaryshkov@gmail.com> | |
15 | */ | |
16 | ||
5ad60d36 AA |
17 | #ifndef __NET_CFG802154_H |
18 | #define __NET_CFG802154_H | |
2bfb1070 | 19 | |
cb41c8dd | 20 | #include <linux/ieee802154.h> |
2bfb1070 DES |
21 | #include <linux/netdevice.h> |
22 | #include <linux/mutex.h> | |
187f1882 | 23 | #include <linux/bug.h> |
2bfb1070 | 24 | |
f3ea5e44 AA |
25 | #include <net/nl802154.h> |
26 | ||
a5dd1d72 | 27 | struct wpan_phy; |
ba2a9506 | 28 | struct wpan_phy_cca; |
a5dd1d72 AA |
29 | |
30 | struct cfg802154_ops { | |
4a9a816a AA |
31 | struct net_device * (*add_virtual_intf_deprecated)(struct wpan_phy *wpan_phy, |
32 | const char *name, | |
5b4a1039 | 33 | unsigned char name_assign_type, |
4a9a816a | 34 | int type); |
9d30a8cf AA |
35 | void (*del_virtual_intf_deprecated)(struct wpan_phy *wpan_phy, |
36 | struct net_device *dev); | |
f3ea5e44 AA |
37 | int (*add_virtual_intf)(struct wpan_phy *wpan_phy, |
38 | const char *name, | |
5b4a1039 | 39 | unsigned char name_assign_type, |
0e57547e AA |
40 | enum nl802154_iftype type, |
41 | __le64 extended_addr); | |
b821ecd4 AA |
42 | int (*del_virtual_intf)(struct wpan_phy *wpan_phy, |
43 | struct wpan_dev *wpan_dev); | |
ab0bd561 | 44 | int (*set_channel)(struct wpan_phy *wpan_phy, u8 page, u8 channel); |
ba2a9506 AA |
45 | int (*set_cca_mode)(struct wpan_phy *wpan_phy, |
46 | const struct wpan_phy_cca *cca); | |
702bf371 | 47 | int (*set_pan_id)(struct wpan_phy *wpan_phy, |
ee7b9053 | 48 | struct wpan_dev *wpan_dev, __le16 pan_id); |
9830c62a | 49 | int (*set_short_addr)(struct wpan_phy *wpan_phy, |
ee7b9053 | 50 | struct wpan_dev *wpan_dev, __le16 short_addr); |
656a999e AA |
51 | int (*set_backoff_exponent)(struct wpan_phy *wpan_phy, |
52 | struct wpan_dev *wpan_dev, u8 min_be, | |
53 | u8 max_be); | |
a01ba765 AA |
54 | int (*set_max_csma_backoffs)(struct wpan_phy *wpan_phy, |
55 | struct wpan_dev *wpan_dev, | |
56 | u8 max_csma_backoffs); | |
17a3a46b AA |
57 | int (*set_max_frame_retries)(struct wpan_phy *wpan_phy, |
58 | struct wpan_dev *wpan_dev, | |
59 | s8 max_frame_retries); | |
c8937a1d AA |
60 | int (*set_lbt_mode)(struct wpan_phy *wpan_phy, |
61 | struct wpan_dev *wpan_dev, bool mode); | |
a5dd1d72 AA |
62 | }; |
63 | ||
fea3318d AA |
64 | static inline bool |
65 | wpan_phy_supported_bool(bool b, enum nl802154_supported_bool_states st) | |
66 | { | |
67 | switch (st) { | |
68 | case NL802154_SUPPORTED_BOOL_TRUE: | |
69 | return b; | |
70 | case NL802154_SUPPORTED_BOOL_FALSE: | |
71 | return !b; | |
72 | case NL802154_SUPPORTED_BOOL_BOTH: | |
73 | return true; | |
74 | default: | |
75 | WARN_ON(1); | |
76 | } | |
77 | ||
78 | return false; | |
79 | } | |
80 | ||
72f655e4 | 81 | struct wpan_phy_supported { |
fea3318d AA |
82 | u32 channels[IEEE802154_MAX_PAGE + 1], |
83 | cca_modes, cca_opts; | |
84 | enum nl802154_supported_bool_states lbt; | |
85 | u8 min_minbe, max_minbe, min_maxbe, max_maxbe, | |
86 | min_csma_backoffs, max_csma_backoffs; | |
87 | s8 min_frame_retries, max_frame_retries; | |
88 | size_t tx_powers_size, cca_ed_levels_size; | |
89 | const s32 *tx_powers, *cca_ed_levels; | |
72f655e4 AA |
90 | }; |
91 | ||
7fe9a388 AA |
92 | struct wpan_phy_cca { |
93 | enum nl802154_cca_modes mode; | |
94 | enum nl802154_cca_opts opt; | |
95 | }; | |
96 | ||
791021bf AA |
97 | static inline bool |
98 | wpan_phy_cca_cmp(const struct wpan_phy_cca *a, const struct wpan_phy_cca *b) | |
99 | { | |
100 | if (a->mode != b->mode) | |
101 | return false; | |
102 | ||
103 | if (a->mode == NL802154_CCA_ENERGY_CARRIER) | |
104 | return a->opt == b->opt; | |
105 | ||
106 | return true; | |
107 | } | |
108 | ||
2bfb1070 DES |
109 | struct wpan_phy { |
110 | struct mutex pib_lock; | |
111 | ||
6322d50d AA |
112 | /* If multiple wpan_phys are registered and you're handed e.g. |
113 | * a regular netdev with assigned ieee802154_ptr, you won't | |
114 | * know whether it points to a wpan_phy your driver has registered | |
115 | * or not. Assign this to something global to your driver to | |
116 | * help determine whether you own this wpan_phy or not. | |
117 | */ | |
118 | const void *privid; | |
119 | ||
2bfb1070 | 120 | /* |
9b2777d6 | 121 | * This is a PIB according to 802.15.4-2011. |
2bfb1070 DES |
122 | * We do not provide timing-related variables, as they |
123 | * aren't used outside of driver | |
124 | */ | |
125 | u8 current_channel; | |
126 | u8 current_page; | |
72f655e4 | 127 | struct wpan_phy_supported supported; |
e2eb173a | 128 | /* current transmit_power in mBm */ |
1a19cb68 | 129 | s32 transmit_power; |
7fe9a388 | 130 | struct wpan_phy_cca cca; |
dee56d14 AA |
131 | |
132 | __le64 perm_extended_addr; | |
2bfb1070 | 133 | |
32b23550 | 134 | /* current cca ed threshold in mBm */ |
6ca00197 | 135 | s32 cca_ed_level; |
84dda3c6 | 136 | |
61f2dcba AA |
137 | /* PHY depended MAC PIB values */ |
138 | ||
139 | /* 802.15.4 acronym: Tdsym in usec */ | |
140 | u8 symbol_duration; | |
141 | /* lifs and sifs periods timing */ | |
142 | u16 lifs_period; | |
143 | u16 sifs_period; | |
144 | ||
2bfb1070 | 145 | struct device dev; |
2bfb1070 | 146 | |
4896167d | 147 | char priv[0] __aligned(NETDEV_ALIGN); |
2bfb1070 DES |
148 | }; |
149 | ||
d5ae67ba AA |
150 | struct wpan_dev { |
151 | struct wpan_phy *wpan_phy; | |
190ac1ca | 152 | int iftype; |
863e88f2 | 153 | |
fcf39e6e AA |
154 | /* the remainder of this struct should be private to cfg802154 */ |
155 | struct list_head list; | |
156 | struct net_device *netdev; | |
157 | ||
158 | u32 identifier; | |
159 | ||
863e88f2 AA |
160 | /* MAC PIB */ |
161 | __le16 pan_id; | |
162 | __le16 short_addr; | |
163 | __le64 extended_addr; | |
164 | ||
165 | /* MAC BSN field */ | |
166 | u8 bsn; | |
167 | /* MAC DSN field */ | |
168 | u8 dsn; | |
169 | ||
170 | u8 min_be; | |
171 | u8 max_be; | |
172 | u8 csma_retries; | |
173 | s8 frame_retries; | |
174 | ||
175 | bool lbt; | |
176 | ||
177 | bool promiscuous_mode; | |
d5ae67ba AA |
178 | }; |
179 | ||
42723448 DES |
180 | #define to_phy(_dev) container_of(_dev, struct wpan_phy, dev) |
181 | ||
a5dd1d72 | 182 | struct wpan_phy * |
f601379f | 183 | wpan_phy_new(const struct cfg802154_ops *ops, size_t priv_size); |
e9cf356c DES |
184 | static inline void wpan_phy_set_dev(struct wpan_phy *phy, struct device *dev) |
185 | { | |
186 | phy->dev.parent = dev; | |
187 | } | |
e72740d0 | 188 | |
e9cf356c | 189 | int wpan_phy_register(struct wpan_phy *phy); |
2bfb1070 DES |
190 | void wpan_phy_unregister(struct wpan_phy *phy); |
191 | void wpan_phy_free(struct wpan_phy *phy); | |
1c889f4d DES |
192 | /* Same semantics as for class_for_each_device */ |
193 | int wpan_phy_for_each(int (*fn)(struct wpan_phy *phy, void *data), void *data); | |
2bfb1070 DES |
194 | |
195 | static inline void *wpan_phy_priv(struct wpan_phy *phy) | |
196 | { | |
197 | BUG_ON(!phy); | |
198 | return &phy->priv; | |
199 | } | |
200 | ||
201 | struct wpan_phy *wpan_phy_find(const char *str); | |
69d9ab96 DES |
202 | |
203 | static inline void wpan_phy_put(struct wpan_phy *phy) | |
204 | { | |
205 | put_device(&phy->dev); | |
206 | } | |
207 | ||
2bfb1070 DES |
208 | static inline const char *wpan_phy_name(struct wpan_phy *phy) |
209 | { | |
210 | return dev_name(&phy->dev); | |
211 | } | |
5ad60d36 AA |
212 | |
213 | #endif /* __NET_CFG802154_H */ |