include/net/6lowpan.h

   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
  88 static inline bool lowpan_is_ipv6(u8 dispatch)
  89 {
  90         return dispatch == LOWPAN_DISPATCH_IPV6;
  91 }
  92
  93 static 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
 101 enum lowpan_lltypes {
 102         LOWPAN_LLTYPE_BTLE,
 103         LOWPAN_LLTYPE_IEEE802154,
 104 };
 105
 106 enum lowpan_iphc_ctx_flags {
 107         LOWPAN_IPHC_CTX_FLAG_ACTIVE,
 108         LOWPAN_IPHC_CTX_FLAG_COMPRESSION,
 109 };
 110
 111 struct lowpan_iphc_ctx {
 112         u8 id;
 113         struct in6_addr pfx;
 114         u8 plen;
 115         unsigned long flags;
 116 };
 117
 118 struct 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
 124 static 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
 129 static inline bool
 130 lowpan_iphc_ctx_is_compression(const struct lowpan_iphc_ctx *ctx)
 131 {
 132         return test_bit(LOWPAN_IPHC_CTX_FLAG_COMPRESSION, &ctx->flags);
 133 }
 134
 135 struct 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[0] __aligned(sizeof(void *));
 142 };
 143
 144 struct lowpan_802154_neigh {
 145         __le16 short_addr;
 146 };
 147
 148 static inline
 149 struct lowpan_802154_neigh *lowpan_802154_neigh(void *neigh_priv)
 150 {
 151         return neigh_priv;
 152 }
 153
 154 static inline
 155 struct lowpan_dev *lowpan_dev(const struct net_device *dev)
 156 {
 157         return netdev_priv(dev);
 158 }
 159
 160 /* private device info */
 161 struct lowpan_802154_dev {
 162         struct net_device       *wdev; /* wpan device ptr */
 163         u16                     fragment_tag;
 164 };
 165
 166 static inline struct
 167 lowpan_802154_dev *lowpan_802154_dev(const struct net_device *dev)
 168 {
 169         return (struct lowpan_802154_dev *)lowpan_dev(dev)->priv;
 170 }
 171
 172 struct lowpan_802154_cb {
 173         u16 d_tag;
 174         unsigned int d_size;
 175         u8 d_offset;
 176 };
 177
 178 static inline
 179 struct 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
 185 static 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
 201 static 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 */
 218 static 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  */
 233 static 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
 242 static inline void raw_dump_table(const char *caller, char *msg,
 243                                   const unsigned char *buf, int len) { }
 244 static 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  */
 260 static 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, data, len);
 267         skb_pull(skb, len);
 268
 269         return false;
 270 }
 271
 272 static 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
 278 static 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
 285 int lowpan_register_netdevice(struct net_device *dev,
 286                               enum lowpan_lltypes lltype);
 287 int lowpan_register_netdev(struct net_device *dev,
 288                            enum lowpan_lltypes lltype);
 289 void lowpan_unregister_netdevice(struct net_device *dev);
 290 void 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  */
 308 int 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  */
 327 int lowpan_header_compress(struct sk_buff *skb, const struct net_device *dev,
 328                            const void *daddr, const void *saddr);
 329
 330 #endif /* __6LOWPAN_H__ */