Colony

/** @file colonet.h

 * @brief Colonet library for colony robots

 * @author Eugene Marinelli

 * @date 10/26/06

 */

#ifndef COLONET_DRAGONFLY_H_

#define COLONET_DRAGONFLYH_

#include <colonet_defs.h>

/** @brief Handles colonet packets.  Should be called by parse_buffer 

 * when it is determined that a colonet message has been received.

 *

 * @param robot_id The robot id

 * @param pkt_buf The packet buffer (e.g. wl_buf)

 * 

 * @return -1 on error (invalid msgId), 0 on success

 */

int colonet_handle_message(char* packet);

/** @brief Registers a new colonet message handler function.  If a message

 * with msgId is received, then handler will be called.

 * 

 * @param msgId The message id of the handler to be registered.  Must be

 * between USER_DEFINED_MSG_ID_START and USER_DEFINED_MSG_ID_END

 * @param handler The function to be called if a colonet packet with message

 * id msgId is received

 * 

 * @return -1 on error (invalid msgId), 0 on success

 */

int colonet_add_message(unsigned char msgId, void (*handler)(void));

void colonet_set_id(int id);

#endif