Best-effort multihop forwarding

The multihop module implements a multihop forwarding mechanism.

Routes must have already been setup with the route_add() function. Setting up routes is done with another Rime module such as the route-discovery module.

The multihop sends a packet to an identified node in the network by using multi-hop forwarding at each node in the network. The application or protocol that uses the multihop primitive supplies a routing function for selecting the next-hop neighbor. If the multihop primitive is requested to send a packet for which no suitable next hop neighbor is found, the caller is immediately notified of this and may choose to initiate a route discovery process.

Channels

The multihop module uses 1 channel.

Data Structures
struct	multihop_callbacks
struct	multihop_conn

Files
file	multihop.h
	Multihop forwarding header file

Macros
#define	MULTIHOP_ATTRIBUTES

Functions
void	multihop_close (struct multihop_conn *c)
void	multihop_open (struct multihop_conn *c, uint16_t channel, const struct multihop_callbacks *u)
void	multihop_resend (struct multihop_conn *c, const linkaddr_t *nexthop)
int	multihop_send (struct multihop_conn *c, const linkaddr_t *to)

#define MULTIHOP_ATTRIBUTES

Value:

{ PACKETBUF_ADDR_ESENDER, PACKETBUF_ADDRSIZE }, \
                              { PACKETBUF_ADDR_ERECEIVER, PACKETBUF_ADDRSIZE }, \
                              { PACKETBUF_ATTR_HOPS, PACKETBUF_ATTR_BIT * 5 }, \
                                UNICAST_ATTRIBUTES

void multihop_close

(

struct multihop_conn *

c

)

void multihop_open	(	struct multihop_conn *	c,
		uint16_t	channel,
		const struct multihop_callbacks *	u
	)

void multihop_resend	(	struct multihop_conn *	c,
		const linkaddr_t *	nexthop
	)

int multihop_send	(	struct multihop_conn *	c,
		const linkaddr_t *	to
	)