1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

doc: add or move module description where missing

This commit is contained in:
Oleg Hahm 2014-12-06 14:29:28 +01:00
parent 73248cc05e
commit d4166faccc
7 changed files with 38 additions and 23 deletions

View File

@ -7,7 +7,7 @@
*/
/**
* @ingroupgroup netdev
* @addtogroup netdev
*
* @{
* @file

View File

@ -9,6 +9,9 @@
/**
* @defgroup drivers_nrf24l01p NRF24L01+ Driver Interface
* @ingroup drivers
*
* @brief Low-level driver for nrf24l01+ transceiver
*
* @{
* @file
*

View File

@ -8,9 +8,10 @@
/**
* @defgroup radio_driver IEEE 802.15.4 radio driver interface
* @brief API definitions for 802.15.4 radio transceivers' drivers
* @ingroup drivers
*
* @brief API definitions for 802.15.4 radio transceivers' drivers
*
* @{
* @file
* @author Kévin Roussel <Kevin.Roussel@inria.fr>

View File

@ -19,14 +19,16 @@
/**
* @defgroup sys_pipe Pipe IPC
* @ingroup sys
* @{
* @file
*
* @brief Generic pipe implementation.
* @details This pipe implementation is a tight wrapper around a ringbuffer.
* It sends the calling thread to sleep if the ringbuffer is full
* or empty, respectively. It can be used in ISRs, too.
*
*
* @{
* @file
*
* @author René Kijewski <rene.kijewski@fu-berlin.de>
*/

View File

@ -9,10 +9,13 @@
/**
* @defgroup sys_transceiver Transceiver
* @ingroup sys
*
* @brief The transceiver module implements a generic link abstraction to
* any radio interface.
*
* @{
*
* @file
* @brief Transceiver library
* @author Oliver Hahm <oliver.hahm@inria.fr>
*/
@ -143,7 +146,7 @@ extern "C" {
*/
/**
* @brief The maximum of threads to register
* @brief The maximum of threads to register
*/
#define TRANSCEIVER_MAX_REGISTERED (4)
@ -207,7 +210,7 @@ enum transceiver_msg_type_t {
SET_ADDRESS, /**< Set the radio address */
GET_LONG_ADDR, /**< Get the long radio address, if existing */
SET_LONG_ADDR, /**< Set the long radio address, if supported by hardware */
SET_MONITOR, /**< Set transceiver to monitor mode (disable address
SET_MONITOR, /**< Set transceiver to monitor mode (disable address
checking) */
GET_PAN, /**< Get current pan */
SET_PAN, /**< Set a new pan */
@ -230,7 +233,7 @@ enum transceiver_msg_type_t {
* @brief Manage registered threads per transceiver
*/
typedef struct {
transceiver_type_t transceivers; /**< the tranceivers the thread is
transceiver_type_t transceivers; /**< the tranceivers the thread is
registered for */
kernel_pid_t pid; /**< the thread's pid */
} registered_t;
@ -249,7 +252,7 @@ typedef struct {
extern volatile kernel_pid_t transceiver_pid;
/**
* @brief An array of ignored link layer addresses
* @brief An array of ignored link layer addresses
*/
extern radio_address_t transceiver_ignored_addr[TRANSCEIVER_MAX_IGNORED_ADDR];

View File

@ -1,7 +1,4 @@
/**
* socket_base.h - Wraps all API types, constants and functions of the transport
* layer implementation.
*
/*
* Copyright (C) 2013 INRIA.
*
* This file is subject to the terms and conditions of the GNU Lesser
@ -11,10 +8,15 @@
/**
* @defgroup socket_base Transport layer implementation
*
* @ingroup net
* @brief This module implements the transport layer. This includes
* 6LoWPAN UDP header compression and (experimental) 6LoWPAN TCP header
* compression.
* @brief This module implements basic transport layer socket functionality.
* This includes 6LoWPAN UDP header compression and (experimental)
* 6LoWPAN TCP header compression.
*
* It wraps all API types, constants and functions of the transport layer
* implementation.
*
* @see <a href="http://tools.ietf.org/html/rfc6282#section-4.3">
* RFC 6282 - Compression Format for IPv6 Datagrams over
* IEEE 802.15.4-Based Networks - UDP Header Compression

View File

@ -7,18 +7,22 @@
*/
/**
* @defgroup oneway_malloc Oneway malloc implementation
* @defgroup oneway_malloc Oneway malloc
* @ingroup sys
* @{
* @file malloc.h
* @brief A malloc implementation for MSP-430 boards without free.
*
* @details The toolchain of MSP-430 does not contain malloc() and friends.
* These functions provide the same interface as the stdlib functions,
* but the option to free memory.
* @brief A malloc implementation without free for boards where the
* toolchain does not implement dynamic memory allocation.
*
* The toolchain of MSP-430, for example, does not contain
* malloc() and friends. These functions provide the same
* interface as the stdlib functions, but the option to free
* memory.
*
* @note You should prefer statically allocated memory whenever possible.
*
* @{
* @file
*
* @author Kaspar Schleiser <kaspar@schleiser.de>
* @author René Kijewski <rene.kijewski@fu-berlin.de>
*/