412facb831
architecture for the Rime stack for Contiki. The Chameleon architecture separates the header processing from the Rime protocol logic. Instead of having each protocol create its own part of the packet header, protocols use packet attributes. Before sending a packet, a special Chameleon header processing module creates a packet header from the packet attributes. The same Chameleon module parses incoming packets and creates packet attributes from the header. The details are in our SenSys 2007 paper: Adam Dunkels, Fredrik Osterlind, Zhitao He. An Adaptive Communication Architecture for Wireless Sensor Networks. In Proceedings of the Fifth ACM Conference on Networked Embedded Sensor Systems (SenSys 2007), Sydney, Australia, November 2007. http://www.sics.se/~adam/dunkels07adaptive.pdf This is a rewrite of the code that was developed for the paper.
123 lines
3.6 KiB
C
123 lines
3.6 KiB
C
/**
|
|
* \addtogroup rime
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* \defgroup rudolph0 Single-hop reliable bulk data transfer
|
|
* @{
|
|
*
|
|
* The rudolph0 module implements a single-hop reliable bulk data
|
|
* transfer mechanism.
|
|
*
|
|
* \section channels Channels
|
|
*
|
|
* The rudolph0 module uses 2 channels; one for data packets and one
|
|
* for NACK and repair packets.
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2007, 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: rudolph0.h,v 1.9 2008/02/25 02:14:35 adamdunkels Exp $
|
|
*/
|
|
|
|
/**
|
|
* \file
|
|
* Header file for the single-hop reliable bulk data transfer module
|
|
* \author
|
|
* Adam Dunkels <adam@sics.se>
|
|
*/
|
|
|
|
#ifndef __RUDOLPH0_H__
|
|
#define __RUDOLPH0_H__
|
|
|
|
#include "net/rime/sabc.h"
|
|
#include "net/rime/polite.h"
|
|
|
|
struct rudolph0_conn;
|
|
|
|
enum {
|
|
RUDOLPH0_FLAG_NONE,
|
|
RUDOLPH0_FLAG_NEWFILE,
|
|
RUDOLPH0_FLAG_LASTCHUNK,
|
|
};
|
|
|
|
struct rudolph0_callbacks {
|
|
void (* write_chunk)(struct rudolph0_conn *c, int offset, int flag,
|
|
uint8_t *data, int len);
|
|
int (* read_chunk)(struct rudolph0_conn *c, int offset, uint8_t *to,
|
|
int maxsize);
|
|
};
|
|
|
|
#ifdef RUDOLPH0_CONF_DATASIZE
|
|
#define RUDOLPH0_DATASIZE RUDOLPH0_CONF_DATASIZE
|
|
#else
|
|
#define RUDOLPH0_DATASIZE 64
|
|
#endif
|
|
|
|
struct rudolph0_hdr {
|
|
uint8_t type;
|
|
uint8_t version;
|
|
uint16_t chunk;
|
|
};
|
|
|
|
struct rudolph0_datapacket {
|
|
struct rudolph0_hdr h;
|
|
uint8_t datalen;
|
|
uint8_t data[RUDOLPH0_DATASIZE];
|
|
};
|
|
|
|
struct rudolph0_conn {
|
|
struct sabc_conn c;
|
|
struct polite_conn nackc;
|
|
const struct rudolph0_callbacks *cb;
|
|
clock_time_t send_interval;
|
|
uint8_t state;
|
|
struct rudolph0_datapacket current;
|
|
};
|
|
|
|
void rudolph0_open(struct rudolph0_conn *c, uint16_t channel,
|
|
const struct rudolph0_callbacks *cb);
|
|
void rudolph0_close(struct rudolph0_conn *c);
|
|
void rudolph0_send(struct rudolph0_conn *c, clock_time_t interval);
|
|
void rudolph0_stop(struct rudolph0_conn *c);
|
|
|
|
/* Force the sender to restart sending the file from the start. */
|
|
void rudolph0_force_restart(struct rudolph0_conn *c);
|
|
|
|
void rudolph0_set_version(struct rudolph0_conn *c, int version);
|
|
int rudolph0_version(struct rudolph0_conn *c);
|
|
|
|
#endif /* __RUDOLPH0_H__ */
|
|
/** @} */
|
|
/** @} */
|
|
|