mirror of
https://github.com/oliverschmidt/contiki.git
synced 2024-09-06 19:54:33 +00:00
sicslowpan tags TCP packets with the PACKETBUF_ATTR_PACKET_TYPE_STREAM flag, which makes the underlying power-saving MAC layer keep the radio on for some time after transmitting the packet. This allows reply packets to be processed directly, significantly increasing TCP latency and throughput.
424 lines
14 KiB
C
424 lines
14 KiB
C
/**
|
|
* \addtogroup rime
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* \defgroup packetbuf Rime buffer management
|
|
* @{
|
|
*
|
|
* The packetbuf module does Rime's buffer management.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2006, Swedish Institute of Computer Science.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. Neither the name of the Institute nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* This file is part of the Contiki operating system.
|
|
*
|
|
* $Id: packetbuf.h,v 1.4 2009/11/02 11:58:56 adamdunkels Exp $
|
|
*/
|
|
|
|
/**
|
|
* \file
|
|
* Header file for the Rime buffer (packetbuf) management
|
|
* \author
|
|
* Adam Dunkels <adam@sics.se>
|
|
*/
|
|
|
|
#ifndef __PACKETBUF_H__
|
|
#define __PACKETBUF_H__
|
|
|
|
#include "contiki-conf.h"
|
|
#include "net/rime/rimeaddr.h"
|
|
|
|
/**
|
|
* \brief The size of the packetbuf, in bytes
|
|
*/
|
|
#ifdef PACKETBUF_CONF_SIZE
|
|
#define PACKETBUF_SIZE PACKETBUF_CONF_SIZE
|
|
#else
|
|
#define PACKETBUF_SIZE 128
|
|
#endif
|
|
|
|
/**
|
|
* \brief The size of the packetbuf header, in bytes
|
|
*/
|
|
#ifdef PACKETBUF_CONF_HDR_SIZE
|
|
#define PACKETBUF_HDR_SIZE PACKETBUF_CONF_HDR_SIZE
|
|
#else
|
|
#define PACKETBUF_HDR_SIZE 48
|
|
#endif
|
|
|
|
/**
|
|
* \brief Clear and reset the packetbuf
|
|
*
|
|
* This function clears the packetbuf and resets all
|
|
* internal state pointers (header size, header pointer,
|
|
* external data pointer). It is used before preparing a
|
|
* packet in the packetbuf.
|
|
*
|
|
*/
|
|
void packetbuf_clear(void);
|
|
|
|
/**
|
|
* \brief Get a pointer to the data in the packetbuf
|
|
* \return Pointer to the packetbuf data
|
|
*
|
|
* This function is used to get a pointer to the data in
|
|
* the packetbuf. The data is either stored in the packetbuf,
|
|
* or referenced to an external location.
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. The header is accessed with the
|
|
* packetbuf_hdrptr() function.
|
|
*
|
|
* For incoming packets, both the packet header and the
|
|
* packet data is stored in the data portion of the
|
|
* packetbuf. Thus this function is used to get a pointer to
|
|
* the header for incoming packets.
|
|
*
|
|
*/
|
|
void *packetbuf_dataptr(void);
|
|
|
|
/**
|
|
* \brief Get a pointer to the header in the packetbuf, for outbound packets
|
|
* \return Pointer to the packetbuf header
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to get a
|
|
* pointer to the header in the packetbuf. The header is
|
|
* stored in the packetbuf.
|
|
*
|
|
*/
|
|
void *packetbuf_hdrptr(void);
|
|
|
|
/**
|
|
* \brief Get the length of the header in the packetbuf, for outbound packets
|
|
* \return Length of the header in the packetbuf
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to get
|
|
* the length of the header in the packetbuf. The header is
|
|
* stored in the packetbuf and accessed via the
|
|
* packetbuf_hdrptr() function.
|
|
*
|
|
*/
|
|
uint8_t packetbuf_hdrlen(void);
|
|
|
|
|
|
/**
|
|
* \brief Get the length of the data in the packetbuf
|
|
* \return Length of the data in the packetbuf
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to get
|
|
* the length of the data in the packetbuf. The data is
|
|
* stored in the packetbuf and accessed via the
|
|
* packetbuf_dataptr() function.
|
|
*
|
|
* For incoming packets, both the packet header and the
|
|
* packet data is stored in the data portion of the
|
|
* packetbuf. This function is then used to get the total
|
|
* length of the packet - both header and data.
|
|
*
|
|
*/
|
|
uint16_t packetbuf_datalen(void);
|
|
|
|
/**
|
|
* \brief Get the total length of the header and data in the packetbuf
|
|
* \return Length of data and header in the packetbuf
|
|
*
|
|
*/
|
|
uint16_t packetbuf_totlen(void);
|
|
|
|
/**
|
|
* \brief Set the length of the data in the packetbuf
|
|
* \param len The length of the data
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to set
|
|
* the length of the data in the packetbuf.
|
|
*/
|
|
void packetbuf_set_datalen(uint16_t len);
|
|
|
|
/**
|
|
* \brief Point the packetbuf to external data
|
|
* \param ptr A pointer to the external data
|
|
* \param len The length of the external data
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to make
|
|
* the packetbuf point to external data. The function also
|
|
* specifies the length of the external data that the
|
|
* packetbuf references.
|
|
*/
|
|
void packetbuf_reference(void *ptr, uint16_t len);
|
|
|
|
/**
|
|
* \brief Check if the packetbuf references external data
|
|
* \retval Non-zero if the packetbuf references external data, zero otherwise.
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. This function is used to check
|
|
* if the packetbuf points to external data that has
|
|
* previously been referenced with packetbuf_reference().
|
|
*
|
|
*/
|
|
int packetbuf_is_reference(void);
|
|
|
|
/**
|
|
* \brief Get a pointer to external data referenced by the packetbuf
|
|
* \retval A pointer to the external data
|
|
*
|
|
* For outbound packets, the packetbuf consists of two
|
|
* parts: header and data. The data may point to external
|
|
* data that has previously been referenced with
|
|
* packetbuf_reference(). This function is used to get a
|
|
* pointer to the external data.
|
|
*
|
|
*/
|
|
void *packetbuf_reference_ptr(void);
|
|
|
|
/**
|
|
* \brief Compact the packetbuf
|
|
*
|
|
* This function compacts the packetbuf by copying the data
|
|
* portion of the packetbuf so that becomes consecutive to
|
|
* the header. It also copies external data that has
|
|
* previously been referenced with packetbuf_reference()
|
|
* into the packetbuf.
|
|
*
|
|
* This function is called by the Rime code before a
|
|
* packet is to be sent by a device driver. This assures
|
|
* that the entire packet is consecutive in memory.
|
|
*
|
|
*/
|
|
void packetbuf_compact(void);
|
|
|
|
/**
|
|
* \brief Copy from external data into the packetbuf
|
|
* \param from A pointer to the data from which to copy
|
|
* \param len The size of the data to copy
|
|
* \retval The number of bytes that was copied into the packetbuf
|
|
*
|
|
* This function copies data from a pointer into the
|
|
* packetbuf. If the data that is to be copied is larger
|
|
* than the packetbuf, only the data that fits in the
|
|
* packetbuf is copied. The number of bytes that could be
|
|
* copied into the rimbuf is returned.
|
|
*
|
|
*/
|
|
int packetbuf_copyfrom(const void *from, uint16_t len);
|
|
|
|
/**
|
|
* \brief Copy the entire packetbuf to an external buffer
|
|
* \param to A pointer to the buffer to which the data is to be copied
|
|
* \retval The number of bytes that was copied to the external buffer
|
|
*
|
|
* This function copies the packetbuf to an external
|
|
* buffer. Both the data portion and the header portion of
|
|
* the packetbuf is copied. If the packetbuf referenced
|
|
* external data (referenced with packetbuf_reference()) the
|
|
* external data is copied.
|
|
*
|
|
* The external buffer to which the packetbuf is to be
|
|
* copied must be able to accomodate at least
|
|
* (PACKETBUF_SIZE + PACKETBUF_HDR_SIZE) bytes. The number of
|
|
* bytes that was copied to the external buffer is
|
|
* returned.
|
|
*
|
|
*/
|
|
int packetbuf_copyto(void *to);
|
|
|
|
/**
|
|
* \brief Copy the header portion of the packetbuf to an external buffer
|
|
* \param to A pointer to the buffer to which the data is to be copied
|
|
* \retval The number of bytes that was copied to the external buffer
|
|
*
|
|
* This function copies the header portion of the packetbuf
|
|
* to an external buffer.
|
|
*
|
|
* The external buffer to which the packetbuf is to be
|
|
* copied must be able to accomodate at least
|
|
* PACKETBUF_HDR_SIZE bytes. The number of bytes that was
|
|
* copied to the external buffer is returned.
|
|
*
|
|
*/
|
|
int packetbuf_copyto_hdr(uint8_t *to);
|
|
|
|
/**
|
|
* \brief Extend the header of the packetbuf, for outbound packets
|
|
* \param size The number of bytes the header should be extended
|
|
* \retval Non-zero if the header could be extended, zero otherwise
|
|
*
|
|
* This function is used to allocate extra space in the
|
|
* header portion in the packetbuf, when preparing outbound
|
|
* packets for transmission. If the function is unable to
|
|
* allocate sufficient header space, the function returns
|
|
* zero and does not allocate anything.
|
|
*
|
|
*/
|
|
int packetbuf_hdralloc(int size);
|
|
|
|
/**
|
|
* \brief Reduce the header in the packetbuf, for incoming packets
|
|
* \param size The number of bytes the header should be reduced
|
|
* \retval Non-zero if the header could be reduced, zero otherwise
|
|
*
|
|
* This function is used to remove the first part of the
|
|
* header in the packetbuf, when processing incoming
|
|
* packets. If the function is unable to remove the
|
|
* requested amount of header space, the function returns
|
|
* zero and does not allocate anything.
|
|
*
|
|
*/
|
|
int packetbuf_hdrreduce(int size);
|
|
|
|
/* Packet attributes stuff below: */
|
|
|
|
typedef uint16_t packetbuf_attr_t;
|
|
|
|
struct packetbuf_attr {
|
|
/* uint8_t type; */
|
|
packetbuf_attr_t val;
|
|
};
|
|
struct packetbuf_addr {
|
|
/* uint8_t type; */
|
|
rimeaddr_t addr;
|
|
};
|
|
|
|
extern const char *packetbuf_attr_strings[];
|
|
|
|
#define PACKETBUF_ATTR_PACKET_TYPE_DATA 0
|
|
#define PACKETBUF_ATTR_PACKET_TYPE_ACK 1
|
|
#define PACKETBUF_ATTR_PACKET_TYPE_STREAM 2
|
|
|
|
enum {
|
|
PACKETBUF_ATTR_NONE,
|
|
PACKETBUF_ATTR_CHANNEL,
|
|
PACKETBUF_ATTR_PACKET_ID,
|
|
PACKETBUF_ATTR_PACKET_TYPE,
|
|
PACKETBUF_ATTR_EPACKET_ID,
|
|
PACKETBUF_ATTR_EPACKET_TYPE,
|
|
PACKETBUF_ATTR_HOPS,
|
|
PACKETBUF_ATTR_TTL,
|
|
PACKETBUF_ATTR_REXMIT,
|
|
PACKETBUF_ATTR_MAX_REXMIT,
|
|
PACKETBUF_ATTR_NUM_REXMIT,
|
|
PACKETBUF_ATTR_LINK_QUALITY,
|
|
PACKETBUF_ATTR_RSSI,
|
|
PACKETBUF_ATTR_TIMESTAMP,
|
|
PACKETBUF_ATTR_RADIO_TXPOWER,
|
|
|
|
PACKETBUF_ATTR_LISTEN_TIME,
|
|
PACKETBUF_ATTR_TRANSMIT_TIME,
|
|
|
|
PACKETBUF_ATTR_NETWORK_ID,
|
|
|
|
PACKETBUF_ATTR_RELIABLE,
|
|
PACKETBUF_ATTR_ERELIABLE,
|
|
|
|
PACKETBUF_ADDR_SENDER,
|
|
PACKETBUF_ADDR_RECEIVER,
|
|
PACKETBUF_ADDR_ESENDER,
|
|
PACKETBUF_ADDR_ERECEIVER,
|
|
|
|
PACKETBUF_ATTR_MAX
|
|
};
|
|
|
|
#define PACKETBUF_NUM_ADDRS 4
|
|
#define PACKETBUF_NUM_ATTRS (PACKETBUF_ATTR_MAX - PACKETBUF_NUM_ADDRS)
|
|
#define PACKETBUF_ADDR_FIRST PACKETBUF_ADDR_SENDER
|
|
|
|
|
|
#if PACKETBUF_CONF_ATTRS_INLINE
|
|
|
|
extern struct packetbuf_attr packetbuf_attrs[];
|
|
extern struct packetbuf_addr packetbuf_addrs[];
|
|
|
|
static int packetbuf_set_attr(uint8_t type, const packetbuf_attr_t val);
|
|
static packetbuf_attr_t packetbuf_attr(uint8_t type);
|
|
static int packetbuf_set_addr(uint8_t type, const rimeaddr_t *addr);
|
|
static const rimeaddr_t *packetbuf_addr(uint8_t type);
|
|
|
|
static inline int
|
|
packetbuf_set_attr(uint8_t type, const packetbuf_attr_t val)
|
|
{
|
|
/* packetbuf_attrs[type].type = type; */
|
|
packetbuf_attrs[type].val = val;
|
|
return 1;
|
|
}
|
|
static inline packetbuf_attr_t
|
|
packetbuf_attr(uint8_t type)
|
|
{
|
|
return packetbuf_attrs[type].val;
|
|
}
|
|
|
|
static inline int
|
|
packetbuf_set_addr(uint8_t type, const rimeaddr_t *addr)
|
|
{
|
|
/* packetbuf_addrs[type - PACKETBUF_ADDR_FIRST].type = type; */
|
|
rimeaddr_copy(&packetbuf_addrs[type - PACKETBUF_ADDR_FIRST].addr, addr);
|
|
return 1;
|
|
}
|
|
|
|
static inline const rimeaddr_t *
|
|
packetbuf_addr(uint8_t type)
|
|
{
|
|
return &packetbuf_addrs[type - PACKETBUF_ADDR_FIRST].addr;
|
|
}
|
|
#else /* PACKETBUF_CONF_ATTRS_INLINE */
|
|
int packetbuf_set_attr(uint8_t type, const packetbuf_attr_t val);
|
|
packetbuf_attr_t packetbuf_attr(uint8_t type);
|
|
int packetbuf_set_addr(uint8_t type, const rimeaddr_t *addr);
|
|
const rimeaddr_t *packetbuf_addr(uint8_t type);
|
|
#endif /* PACKETBUF_CONF_ATTRS_INLINE */
|
|
|
|
void packetbuf_attr_clear(void);
|
|
|
|
void packetbuf_attr_copyto(struct packetbuf_attr *attrs,
|
|
struct packetbuf_addr *addrs);
|
|
void packetbuf_attr_copyfrom(struct packetbuf_attr *attrs,
|
|
struct packetbuf_addr *addrs);
|
|
|
|
#define PACKETBUF_ATTRIBUTES(...) { __VA_ARGS__ PACKETBUF_ATTR_LAST }
|
|
#define PACKETBUF_ATTR_LAST { PACKETBUF_ATTR_NONE, 0 }
|
|
|
|
#define PACKETBUF_ATTR_BIT 1
|
|
#define PACKETBUF_ATTR_BYTE 8
|
|
#define PACKETBUF_ADDRSIZE (sizeof(rimeaddr_t) * PACKETBUF_ATTR_BYTE)
|
|
|
|
struct packetbuf_attrlist {
|
|
uint8_t type;
|
|
uint8_t len;
|
|
};
|
|
|
|
#endif /* __PACKETBUF_H__ */
|
|
/** @} */
|
|
/** @} */
|