mirror of
https://git.rwth-aachen.de/acs/public/villas/node/
synced 2025-03-30 00:00:11 +01:00
Steffen Vogel
f1119f5633
git-svn-id: https://zerberus.eonerc.rwth-aachen.de:8443/svn/s2ss/trunk@28 8ec27952-4edc-4aab-86aa-e87bb2611832
113 lines
2.3 KiB
C
113 lines
2.3 KiB
C
/**
|
|
* Nodes
|
|
*
|
|
* The S2SS server connects multiple nodes.
|
|
* There are multiple types of nodes:
|
|
* - simulators
|
|
* - servers
|
|
* - workstations
|
|
*
|
|
* @author Steffen Vogel <stvogel@eonerc.rwth-aachen.de>
|
|
* @copyright 2014, Institute for Automation of Complex Power Systems, EONERC
|
|
*/
|
|
|
|
#ifndef _NODE_H_
|
|
#define _NODE_H_
|
|
|
|
#include <sys/socket.h>
|
|
#include <netinet/in.h>
|
|
|
|
enum node_type
|
|
{
|
|
NODE_INVALID,
|
|
NODE_SERVER,
|
|
NODE_WORKSTATION,
|
|
NODE_SIM_OPAL,
|
|
NODE_SIM_RTDS,
|
|
NODE_SIM_DSP
|
|
};
|
|
|
|
struct node
|
|
{
|
|
/// The socket descriptor
|
|
int sd;
|
|
|
|
/// Reference counter
|
|
int ref_cnt;
|
|
|
|
// Local address of the socket
|
|
struct sockaddr_in local;
|
|
|
|
// Remote address of the socket
|
|
struct sockaddr_in remote;
|
|
|
|
/// The type of this node
|
|
enum node_type type;
|
|
|
|
/// A short identifier of the node
|
|
const char *name;
|
|
};
|
|
|
|
struct msg; /* forward decl */
|
|
|
|
/**
|
|
* @brief Create a new node
|
|
*
|
|
* Memory is allocated dynamically and has to be freed by node_destroy()
|
|
*
|
|
* @param n A pointer to the node structure
|
|
* @param name An acroynm, describing the node
|
|
* @param type The type of a node (server, simulator, workstation)
|
|
* @return
|
|
* - 0 on success
|
|
* - otherwise on error occured
|
|
*/
|
|
int node_create(struct node *n, const char *name, enum node_type type,
|
|
struct sockaddr_in local, struct sockaddr_in remote);
|
|
|
|
/**
|
|
* @brief Delete a node created by node_create()
|
|
*
|
|
* @param p A pointer to the node struct
|
|
*/
|
|
void node_destroy(struct node *n);
|
|
|
|
/**
|
|
* @brief Connect and bind the UDP socket of this node
|
|
*
|
|
* @param n A pointer to the node structure
|
|
* @return
|
|
* - 0 on success
|
|
* - otherwise on error occured
|
|
*/
|
|
int node_connect(struct node *n);
|
|
|
|
/**
|
|
* @brief Disconnect the UDP socket of this node
|
|
*
|
|
* @param n A pointer to the node structure
|
|
* @return
|
|
* - 0 on success
|
|
* - otherwise on error occured
|
|
*/
|
|
int node_disconnect(struct node *n);
|
|
|
|
/**
|
|
* @brief Lookup node type from string
|
|
*
|
|
* @param str The string containing the node type
|
|
* @return The node type enumeration value
|
|
*/
|
|
enum node_type node_lookup_type(const char *str);
|
|
|
|
/**
|
|
* @brief Search list of nodes for a name
|
|
*
|
|
* @param str The name of the wanted node
|
|
* @param nodes A pointer to the first list element
|
|
* @param len Length of the node list
|
|
* @return A pointer to the node or NULL if not found
|
|
*/
|
|
struct node* node_lookup_name(const char *str, struct node *nodes, int len);
|
|
|
|
#endif /* _NODE_H_ */
|