6lowpan.h 10 KB

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