1/*
2 * Copyright 2011, Siemens AG
3 * written by Alexander Smirnov <alex.bluesman.smirnov@gmail.com>
4 */
5
6/*
7 * Based on patches from Jon Smirl <jonsmirl@gmail.com>
8 * Copyright (c) 2011 Jon Smirl <jonsmirl@gmail.com>
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2
12 * as published by the Free Software Foundation.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 */
23
24/* Jon's code is based on 6lowpan implementation for Contiki which is:
25 * Copyright (c) 2008, Swedish Institute of Computer Science.
26 * All rights reserved.
27 *
28 * Redistribution and use in source and binary forms, with or without
29 * modification, are permitted provided that the following conditions
30 * are met:
31 * 1. Redistributions of source code must retain the above copyright
32 * notice, this list of conditions and the following disclaimer.
33 * 2. Redistributions in binary form must reproduce the above copyright
34 * notice, this list of conditions and the following disclaimer in the
35 * documentation and/or other materials provided with the distribution.
36 * 3. Neither the name of the Institute nor the names of its contributors
37 * may be used to endorse or promote products derived from this software
38 * without specific prior written permission.
39 *
40 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 */
52
53#ifndef __6LOWPAN_H__
54#define __6LOWPAN_H__
55
56#include <linux/debugfs.h>
57
58#include <net/ipv6.h>
59#include <net/net_namespace.h>
60
61/* special link-layer handling */
62#include <net/mac802154.h>
63
64#define EUI64_ADDR_LEN 8
65
66#define LOWPAN_NHC_MAX_ID_LEN 1
67/* Maximum next header compression length which we currently support inclusive
68 * possible inline data.
69 */
70#define LOWPAN_NHC_MAX_HDR_LEN (sizeof(struct udphdr))
71/* Max IPHC Header len without IPv6 hdr specific inline data.
72 * Useful for getting the "extra" bytes we need at worst case compression.
73 *
74 * LOWPAN_IPHC + CID + LOWPAN_NHC_MAX_ID_LEN
75 */
76#define LOWPAN_IPHC_MAX_HEADER_LEN (2 + 1 + LOWPAN_NHC_MAX_ID_LEN)
77/* Maximum worst case IPHC header buffer size */
78#define LOWPAN_IPHC_MAX_HC_BUF_LEN (sizeof(struct ipv6hdr) + \
79 LOWPAN_IPHC_MAX_HEADER_LEN + \
80 LOWPAN_NHC_MAX_HDR_LEN)
81/* SCI/DCI is 4 bit width, so we have maximum 16 entries */
82#define LOWPAN_IPHC_CTX_TABLE_SIZE (1 << 4)
83
84#define LOWPAN_DISPATCH_IPV6 0x41 /* 01000001 = 65 */
85#define LOWPAN_DISPATCH_IPHC 0x60 /* 011xxxxx = ... */
86#define LOWPAN_DISPATCH_IPHC_MASK 0xe0
87
88static inline bool lowpan_is_ipv6(u8 dispatch)
89{
90 return dispatch == LOWPAN_DISPATCH_IPV6;
91}
92
93static inline bool lowpan_is_iphc(u8 dispatch)
94{
95 return (dispatch & LOWPAN_DISPATCH_IPHC_MASK) == LOWPAN_DISPATCH_IPHC;
96}
97
98#define LOWPAN_PRIV_SIZE(llpriv_size) \
99 (sizeof(struct lowpan_dev) + llpriv_size)
100
101enum lowpan_lltypes {
102 LOWPAN_LLTYPE_BTLE,
103 LOWPAN_LLTYPE_IEEE802154,
104};
105
106enum lowpan_iphc_ctx_flags {
107 LOWPAN_IPHC_CTX_FLAG_ACTIVE,
108 LOWPAN_IPHC_CTX_FLAG_COMPRESSION,
109};
110
111struct lowpan_iphc_ctx {
112 u8 id;
113 struct in6_addr pfx;
114 u8 plen;
115 unsigned long flags;
116};
117
118struct lowpan_iphc_ctx_table {
119 spinlock_t lock;
120 const struct lowpan_iphc_ctx_ops *ops;
121 struct lowpan_iphc_ctx table[LOWPAN_IPHC_CTX_TABLE_SIZE];
122};
123
124static inline bool lowpan_iphc_ctx_is_active(const struct lowpan_iphc_ctx *ctx)
125{
126 return test_bit(LOWPAN_IPHC_CTX_FLAG_ACTIVE, &ctx->flags);
127}
128
129static inline bool
130lowpan_iphc_ctx_is_compression(const struct lowpan_iphc_ctx *ctx)
131{
132 return test_bit(LOWPAN_IPHC_CTX_FLAG_COMPRESSION, &ctx->flags);
133}
134
135struct lowpan_dev {
136 enum lowpan_lltypes lltype;
137 struct dentry *iface_debugfs;
138 struct lowpan_iphc_ctx_table ctx;
139
140 /* must be last */
141 u8 priv[] __aligned(sizeof(void *));
142};
143
144struct lowpan_802154_neigh {
145 __le16 short_addr;
146};
147
148static inline
149struct lowpan_802154_neigh *lowpan_802154_neigh(void *neigh_priv)
150{
151 return neigh_priv;
152}
153
154static inline
155struct lowpan_dev *lowpan_dev(const struct net_device *dev)
156{
157 return netdev_priv(dev);
158}
159
160/* private device info */
161struct lowpan_802154_dev {
162 struct net_device *wdev; /* wpan device ptr */
163 u16 fragment_tag;
164};
165
166static inline struct
167lowpan_802154_dev *lowpan_802154_dev(const struct net_device *dev)
168{
169 return (struct lowpan_802154_dev *)lowpan_dev(dev)->priv;
170}
171
172struct lowpan_802154_cb {
173 u16 d_tag;
174 unsigned int d_size;
175 u8 d_offset;
176};
177
178static inline
179struct lowpan_802154_cb *lowpan_802154_cb(const struct sk_buff *skb)
180{
181 BUILD_BUG_ON(sizeof(struct lowpan_802154_cb) > sizeof(skb->cb));
182 return (struct lowpan_802154_cb *)skb->cb;
183}
184
185static inline void lowpan_iphc_uncompress_eui64_lladdr(struct in6_addr *ipaddr,
186 const void *lladdr)
187{
188 /* fe:80::XXXX:XXXX:XXXX:XXXX
189 * \_________________/
190 * hwaddr
191 */
192 ipaddr->s6_addr[0] = 0xFE;
193 ipaddr->s6_addr[1] = 0x80;
194 memcpy(&ipaddr->s6_addr[8], lladdr, EUI64_ADDR_LEN);
195 /* second bit-flip (Universe/Local)
196 * is done according RFC2464
197 */
198 ipaddr->s6_addr[8] ^= 0x02;
199}
200
201static inline void lowpan_iphc_uncompress_eui48_lladdr(struct in6_addr *ipaddr,
202 const void *lladdr)
203{
204 /* fe:80::XXXX:XXff:feXX:XXXX
205 * \_________________/
206 * hwaddr
207 */
208 ipaddr->s6_addr[0] = 0xFE;
209 ipaddr->s6_addr[1] = 0x80;
210 memcpy(&ipaddr->s6_addr[8], lladdr, 3);
211 ipaddr->s6_addr[11] = 0xFF;
212 ipaddr->s6_addr[12] = 0xFE;
213 memcpy(&ipaddr->s6_addr[13], lladdr + 3, 3);
214}
215
216#ifdef DEBUG
217/* print data in line */
218static inline void raw_dump_inline(const char *caller, char *msg,
219 const unsigned char *buf, int len)
220{
221 if (msg)
222 pr_debug("%s():%s: ", caller, msg);
223
224 print_hex_dump_debug("", DUMP_PREFIX_NONE, 16, 1, buf, len, false);
225}
226
227/* print data in a table format:
228 *
229 * addr: xx xx xx xx xx xx
230 * addr: xx xx xx xx xx xx
231 * ...
232 */
233static inline void raw_dump_table(const char *caller, char *msg,
234 const unsigned char *buf, int len)
235{
236 if (msg)
237 pr_debug("%s():%s:\n", caller, msg);
238
239 print_hex_dump_debug("\t", DUMP_PREFIX_OFFSET, 16, 1, buf, len, false);
240}
241#else
242static inline void raw_dump_table(const char *caller, char *msg,
243 const unsigned char *buf, int len) { }
244static inline void raw_dump_inline(const char *caller, char *msg,
245 const unsigned char *buf, int len) { }
246#endif
247
248/**
249 * lowpan_fetch_skb - getting inline data from 6LoWPAN header
250 *
251 * This function will pull data from sk buffer and put it into data to
252 * remove the 6LoWPAN inline data. This function returns true if the
253 * sk buffer is too small to pull the amount of data which is specified
254 * by len.
255 *
256 * @skb: the buffer where the inline data should be pulled from.
257 * @data: destination buffer for the inline data.
258 * @len: amount of data which should be pulled in bytes.
259 */
260static inline bool lowpan_fetch_skb(struct sk_buff *skb, void *data,
261 unsigned int len)
262{
263 if (unlikely(!pskb_may_pull(skb, len)))
264 return true;
265
266 skb_copy_from_linear_data(skb, to: data, len);
267 skb_pull(skb, len);
268
269 return false;
270}
271
272static inline bool lowpan_802154_is_valid_src_short_addr(__le16 addr)
273{
274 /* First bit of addr is multicast, reserved or 802.15.4 specific */
275 return !(addr & cpu_to_le16(0x8000));
276}
277
278static inline void lowpan_push_hc_data(u8 **hc_ptr, const void *data,
279 const size_t len)
280{
281 memcpy(*hc_ptr, data, len);
282 *hc_ptr += len;
283}
284
285int lowpan_register_netdevice(struct net_device *dev,
286 enum lowpan_lltypes lltype);
287int lowpan_register_netdev(struct net_device *dev,
288 enum lowpan_lltypes lltype);
289void lowpan_unregister_netdevice(struct net_device *dev);
290void lowpan_unregister_netdev(struct net_device *dev);
291
292/**
293 * lowpan_header_decompress - replace 6LoWPAN header with IPv6 header
294 *
295 * This function replaces the IPHC 6LoWPAN header which should be pointed at
296 * skb->data and skb_network_header, with the IPv6 header.
297 * It would be nice that the caller have the necessary headroom of IPv6 header
298 * and greatest Transport layer header, this would reduce the overhead for
299 * reallocate headroom.
300 *
301 * @skb: the buffer which should be manipulate.
302 * @dev: the lowpan net device pointer.
303 * @daddr: destination lladdr of mac header which is used for compression
304 * methods.
305 * @saddr: source lladdr of mac header which is used for compression
306 * methods.
307 */
308int lowpan_header_decompress(struct sk_buff *skb, const struct net_device *dev,
309 const void *daddr, const void *saddr);
310
311/**
312 * lowpan_header_compress - replace IPv6 header with 6LoWPAN header
313 *
314 * This function replaces the IPv6 header which should be pointed at
315 * skb->data and skb_network_header, with the IPHC 6LoWPAN header.
316 * The caller need to be sure that the sk buffer is not shared and at have
317 * at least a headroom which is smaller or equal LOWPAN_IPHC_MAX_HEADER_LEN,
318 * which is the IPHC "more bytes than IPv6 header" at worst case.
319 *
320 * @skb: the buffer which should be manipulate.
321 * @dev: the lowpan net device pointer.
322 * @daddr: destination lladdr of mac header which is used for compression
323 * methods.
324 * @saddr: source lladdr of mac header which is used for compression
325 * methods.
326 */
327int lowpan_header_compress(struct sk_buff *skb, const struct net_device *dev,
328 const void *daddr, const void *saddr);
329
330#endif /* __6LOWPAN_H__ */
331

source code of linux/include/net/6lowpan.h