mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
313 lines
9.0 KiB
C
313 lines
9.0 KiB
C
/*
|
|
* Copyright (C) 2013 - 2014 INRIA.
|
|
* Copyright (C) 2015 Cenk Gündoğan <cnkgndgn@gmail.com>
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU Lesser
|
|
* General Public License v2.1. See the file LICENSE in the top level
|
|
* directory for more details.
|
|
*/
|
|
|
|
/**
|
|
* @ingroup rpl
|
|
* @{
|
|
*
|
|
* @file rpl.h
|
|
* @brief RPL header. Declaration of global variables and functions needed for
|
|
* core functionality of RPL.
|
|
*
|
|
* Header which includes all core RPL-functions. Normally it shouldn't be necessary to
|
|
* modify this file.
|
|
*
|
|
* @author Eric Engel <eric.engel@fu-berlin.de>
|
|
* @author Fabian Brandt <fabianbr@zedat.fu-berlin.de>
|
|
* @author Cenk Gündoğan <cnkgndgn@gmail.com>
|
|
*/
|
|
|
|
#ifndef __RPL_H
|
|
#define __RPL_H
|
|
|
|
#include <string.h>
|
|
#include <stdint.h>
|
|
#include <vtimer.h>
|
|
#include <transceiver.h>
|
|
#include "ipv6.h"
|
|
#include "rpl/rpl_dodag.h"
|
|
#include "rpl/rpl_of_manager.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#undef CC1100_RADIO_MODE
|
|
#define CC1100_RADIO_MODE CC1100_MODE_WOR
|
|
|
|
#define RPL_PKT_RECV_BUF_SIZE 16
|
|
#define RPL_PROCESS_STACKSIZE KERNEL_CONF_STACKSIZE_MAIN
|
|
|
|
/* global variables */
|
|
extern kernel_pid_t rpl_process_pid;
|
|
extern uint8_t rpl_max_routing_entries;
|
|
extern ipv6_addr_t my_address;
|
|
extern msg_t rpl_msg_queue[RPL_PKT_RECV_BUF_SIZE];
|
|
extern char rpl_process_buf[RPL_PROCESS_STACKSIZE];
|
|
extern uint8_t rpl_buffer[BUFFER_SIZE - LL_HDR_LEN];
|
|
extern uint8_t rpl_if_id;
|
|
|
|
/**
|
|
* @brief Sends a RPL message to a given destination
|
|
*
|
|
* This function sends any RPL related messages to a given destination.
|
|
*
|
|
* @param[in] destination IPv6-address of the destination of the message.
|
|
* @param[in] payload Payload of the message.
|
|
* @param[in] p_len Length of the message
|
|
* @param[in] next_header Index to next header in message.
|
|
*
|
|
*/
|
|
void rpl_send(ipv6_addr_t *destination, uint8_t *payload, uint16_t p_len, uint8_t next_header);
|
|
|
|
/**
|
|
* @brief Initialization of RPL.
|
|
*
|
|
* This function initializes all basic RPL resources such as
|
|
* corresponding objective functions and sixlowpan (including own address).
|
|
*
|
|
* @param[in] if_id ID of the interface, which correspond to the network under RPL-control
|
|
*
|
|
* @return 1 if initialization was successful
|
|
* @return 0 if initialization was not successful
|
|
*
|
|
*/
|
|
uint8_t rpl_init(int if_id);
|
|
|
|
/**
|
|
* @brief Initialization of RPL-root.
|
|
*
|
|
* This function initializes all RPL resources to act as a root node.
|
|
*
|
|
* @param[in] rpl_opts RPL root node configurations
|
|
*
|
|
*/
|
|
void rpl_init_root(rpl_options_t *rpl_opts);
|
|
|
|
/**
|
|
* @brief Sends a DIO-message to a given destination in a given dodag
|
|
*
|
|
* This function sends a DIO message to a given destination in a given dodag.
|
|
*
|
|
* @param[in] dodag Dodag of the DIO-message.
|
|
* @param[in] destination IPv6-address of the destination of the DIO. Should be a direct neighbor.
|
|
*
|
|
*/
|
|
void rpl_send_DIO(rpl_dodag_t *dodag, ipv6_addr_t *destination);
|
|
|
|
/**
|
|
* @brief Sends a DAO-message to a given destination
|
|
*
|
|
* This function sends a DAO message to a given destination.
|
|
*
|
|
* @param[in] destination IPv6-address of the destination of the DAO. Should be the preferred parent.
|
|
* @param[in] lifetime Lifetime of the node. Reflect the estimated time of presence in the network.
|
|
* @param[in] default_lifetime If true, param lifetime is ignored and lifetime is dodag default-lifetime
|
|
* @param[in] start_index Describes whether a DAO must be split because of too many routing entries.
|
|
*
|
|
*/
|
|
void rpl_send_DAO(ipv6_addr_t *destination, uint8_t lifetime, bool default_lifetime, uint8_t start_index);
|
|
|
|
/**
|
|
* @brief Sends a DIS-message to a given destination
|
|
*
|
|
* This function sends a DIS message to a given destination or multicast-address.
|
|
*
|
|
* @param[in] destination IPv6-address of the destination of the DIS. Should be a direct neighbor or multicast-address.
|
|
*
|
|
*/
|
|
void rpl_send_DIS(ipv6_addr_t *destination);
|
|
|
|
#if RPL_DEFAULT_MOP != RPL_MOP_NON_STORING_MODE
|
|
/**
|
|
* @brief Sends a DAO acknowledgment-message to a given destination
|
|
*
|
|
* This function sends a DAO_ACK message to a given destination.
|
|
*
|
|
* @param[in] destination IPv6-address of the destination of the DAO_ACK. Should be a direct neighbor.
|
|
*
|
|
*/
|
|
void rpl_send_DAO_ACK(ipv6_addr_t *destination);
|
|
#endif
|
|
|
|
/**
|
|
* @brief Receives a DIO message
|
|
*
|
|
* This function handles receiving a DIO message.
|
|
*
|
|
*/
|
|
void rpl_recv_DIO(void);
|
|
|
|
/**
|
|
* @brief Receives a DAO message
|
|
*
|
|
* This function handles receiving a DAO message.
|
|
*
|
|
*/
|
|
void rpl_recv_DAO(void);
|
|
|
|
/**
|
|
* @brief Receives a DIS message
|
|
*
|
|
* This function handles receiving a DIS message.
|
|
*
|
|
*/
|
|
void rpl_recv_DIS(void);
|
|
|
|
/**
|
|
* @brief Receives a DAO acknowledgment message
|
|
*
|
|
* This function handles receiving a DAO_ACK message.
|
|
*
|
|
*/
|
|
void rpl_recv_DAO_ACK(void);
|
|
|
|
/**
|
|
* @brief Initialization of RPl-root.
|
|
*
|
|
* This function initializes all RPL resources especially for root purposes.
|
|
* corresponding objective functions and sixlowpan (including own address).
|
|
*
|
|
* @param arg ignored
|
|
* @returns nothing
|
|
*/
|
|
void *rpl_process(void *arg);
|
|
|
|
/**
|
|
* @brief Returns next hop from routing table.
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @param[in] addr Destination address
|
|
*
|
|
* @return Next hop address
|
|
*
|
|
* */
|
|
ipv6_addr_t *rpl_get_next_hop(ipv6_addr_t *addr);
|
|
|
|
/**
|
|
* @brief Adds routing entry to routing table
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @param[in] addr Destination address
|
|
* @param[in] next_hop Next hop address
|
|
* @param[in] lifetime Lifetime of the entry
|
|
*
|
|
* */
|
|
void rpl_add_routing_entry(ipv6_addr_t *addr, ipv6_addr_t *next_hop, uint16_t lifetime);
|
|
|
|
/**
|
|
* @brief Deletes routing entry to routing table
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @param[in] addr Destination address
|
|
*
|
|
* */
|
|
void rpl_del_routing_entry(ipv6_addr_t *addr);
|
|
|
|
/**
|
|
* @brief Finds routing entry for a given destination.
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @param[in] addr Destination address
|
|
*
|
|
* @return Routing entry address
|
|
*
|
|
* */
|
|
rpl_routing_entry_t *rpl_find_routing_entry(ipv6_addr_t *addr);
|
|
|
|
/**
|
|
* @brief Clears routing table.
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* */
|
|
void rpl_clear_routing_table(void);
|
|
|
|
/**
|
|
* @brief Returns routing table
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @return Routing table
|
|
*
|
|
* */
|
|
rpl_routing_entry_t *rpl_get_routing_table(void);
|
|
|
|
/**
|
|
* @brief Returns the network status of the actual node
|
|
*
|
|
* @return 1 if root, 0 otherwise
|
|
*
|
|
* */
|
|
uint8_t rpl_is_root(void);
|
|
|
|
#if RPL_DEFAULT_MOP == RPL_MOP_NON_STORING_MODE
|
|
|
|
/**
|
|
* @brief Adds one pair of child and its parent to the source routing table
|
|
*
|
|
* @deprecated This function is obsolete and will be removed shortly. This will be replaced with a
|
|
* common routing information base.
|
|
*
|
|
* @param[in] child Child IPv6-address
|
|
* @param[in] parent Parent IPv6-address
|
|
* @param[in] lifetime Lifetime of the relation
|
|
*
|
|
* */
|
|
void rpl_add_srh_entry(ipv6_addr_t *child, ipv6_addr_t *parent, uint16_t lifetime);
|
|
|
|
/**
|
|
* @brief Constructs a source routing header based on an original IPv6-header
|
|
*
|
|
* @param[in] act_ipv6_hdr Pointer to original IPv6-packet header
|
|
* @return Source routing header or NULL
|
|
*
|
|
* */
|
|
ipv6_srh_t *rpl_get_srh_header(ipv6_hdr_t *act_ipv6_hdr);
|
|
|
|
/**
|
|
* @brief Manages sending an SRH-header integrated in an original IPv6-package to the next hop.
|
|
*
|
|
* @param[in] buf Pointer to original payload
|
|
* @param[in] len Length of the original payload
|
|
* @param[in] src Original source address
|
|
* @param[in] dest Destination address
|
|
* @param[in] srh_header Pre-build source routing header
|
|
* @param[in] srh_length Length of the pre-built source routing header
|
|
* @return Status of sending progress
|
|
* */
|
|
int rpl_srh_sendto(const void *buf, uint16_t len, ipv6_addr_t *src, ipv6_addr_t *dest, ipv6_srh_t *srh_header, uint8_t srh_length);
|
|
|
|
/**
|
|
* @brief Sends IPC-message to the service, which is indicated by the next-header-field in the source routing header
|
|
*
|
|
* @param[in] ipv6_header Actual IPv6-header
|
|
* @return IPv6-address of the next-hop. Is NULL on error occurrence.
|
|
*
|
|
* */
|
|
void rpl_remove_srh_header(ipv6_hdr_t *ipv6_header, const void *buf, uint8_t nextheader);
|
|
|
|
#endif /* RPL_DEFAULT_MOP == RPL_MOP_NON_STORING_MODE */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
/** @} */
|
|
#endif /* __RPL_H */
|