Improve documentation for 6LOWPAN BLE and ZEPIF

This commit is contained in:
Dirk Ziegelmeier 2018-03-03 11:00:04 +01:00
parent 282e1601ef
commit 08bf8b7121
2 changed files with 18 additions and 10 deletions

View File

@ -91,7 +91,9 @@ err_t tcpip_rfc7668_input(struct pbuf *p, struct netif *inp);
err_t rfc7668_set_context(u8_t index, const ip6_addr_t * context);
/** convert BT address to EUI64 addr
/**
* @ingroup rfc7668if
* convert BT address to EUI64 addr
*
* This method converts a Bluetooth MAC address to an EUI64 address,
* which is used within IPv6 communication
@ -121,7 +123,9 @@ void ble_addr_to_eui64(uint8_t *dst, uint8_t *src, uint8_t public_addr)
#endif
}
/** convert EUI64 address to Bluetooth MAC addr
/**
* @ingroup rfc7668if
* convert EUI64 address to Bluetooth MAC addr
*
* This method converts an EUI64 address to a Bluetooth MAC address,
*
@ -455,6 +459,7 @@ rfc7668_frag(struct netif *netif, struct pbuf *p, const ip6_addr_t * src, const
}
/**
* @ingroup rfc7668if
* Set context id IPv6 address
*
* Store one IPv6 address to a given context id.
@ -483,6 +488,7 @@ rfc7668_set_context(u8_t idx, const ip6_addr_t *context)
}
/**
* @ingroup rfc7668if
* Resolve and fill-in IEEE 802.15.4 address header for outgoing IPv6 packet.
*
* Perform Header Compression and fragment if necessary.
@ -875,6 +881,7 @@ rfc7668_decompress(struct pbuf * p, const ip6_addr_t * src, const ip6_addr_t * d
/**
* @ingroup rfc7668if
* Process a received raw payload from an L2CAP channel
*
* @param p the received packet, p->payload pointing to the
@ -938,6 +945,7 @@ rfc7668_input(struct pbuf * p, struct netif *netif, const ip6_addr_t *src)
}
/**
* @ingroup rfc7668if
* Initialize the netif
*
* No flags are used (broadcast not possible, not ethernet, ...)

View File

@ -1,14 +1,18 @@
/**
* @file
*
* A netif implementing the ZigBee Eencapsulation Protocol (ZEP).
* @defgroup zepif ZEP - ZigBee Encapsulation Protocol
* @ingroup netifs
* A netif implementing the ZigBee Encapsulation Protocol (ZEP).
* This is used to tunnel 6LowPAN over UDP.
*
* Usage (there must be a default netif before!):
* @code{.c}
* netif_add(&zep_netif, NULL, NULL, NULL, NULL, zepif_init, tcpip_6lowpan_input);
* netif_create_ip6_linklocal_address(&zep_netif, 1);
* netif_set_up(&zep_netif);
* netif_set_link_up(&zep_netif);
* @endcode
*/
/*
@ -43,12 +47,6 @@
*
*/
/**
* @defgroup sixlowpan 6LowPAN
* @ingroup netifs
* ZEP netif implementation
*/
#include "netif/zepif.h"
#if LWIP_IPV6 && LWIP_6LOWPAN
@ -215,7 +213,9 @@ zepif_linkoutput(struct netif *netif, struct pbuf *p)
return err;
}
/** Set up a raw 6LowPAN netif and surround it with input- and output
/**
* @ingroup zepif
* Set up a raw 6LowPAN netif and surround it with input- and output
* functions for ZEP
*/
err_t