/** Node type: OPAL (libOpalAsync API)
 *
 * This file implements the opal subtype for nodes.
 *
 * @author Steffen Vogel <stvogel@eonerc.rwth-aachen.de>
 * @copyright 2014, Institute for Automation of Complex Power Systems, EONERC
 */

#ifndef _OPAL_H_
#define _OPAL_H_

#include <pthread.h>

#include "node.h"
#include "msg.h"

/* Define RTLAB before including OpalPrint.h for messages to be sent
 * to the OpalDisplay. Otherwise stdout will be used. */
#define RTLAB
#include "OpalPrint.h"
#include "AsyncApi.h"
#include "OpalGenAsyncParamCtrl.h"

/** This global structure holds libOpalAsync related information.
 *  It's only used once in the code. */
struct opal_global {
	/** Shared Memory identifiers and size, provided via argv. */
	char *async_shmem_name, *print_shmem_name;
	int async_shmem_size;
	
	/** Number of send blocks used in the running OPAL model. */
	int send_icons, recv_icons;
	/** A dynamically allocated array of SendIDs. */
	int *send_ids, *recv_ids;
	
	/** String and Float parameters, provided by the OPAL AsyncProcess block. */
	Opal_GenAsyncParam_Ctrl params;
	
	/** Big Global Lock for libOpalAsync API */
	pthread_mutex_t lock;
};

struct opal {
	int reply;
	int mode;

	int send_id;
	int recv_id;

	int seq_no;
		
	struct opal_global *global;
	
	Opal_SendAsyncParam send_params;
	Opal_RecvAsyncParam recv_params;
};

/** Initialize global OPAL settings and maps shared memory regions.
 *
 * @param argc The number of CLI arguments, provided to main().
 * @param argv The CLI argument list, provided to main().
 * @retval 0 On success.
 * @retval <0 On failure.
 */
int opal_init(int argc, char *argv[]);

/** Free global OPAL settings and unmaps shared memory regions.
 *
 * @retval 0 On success.
 * @retval <0 On failure.
 */
int opal_deinit();

int opal_print(struct node *n, char *buf, int len);

int opal_print_global(struct opal_global *g);

int opal_open(struct node *n);

int opal_close(struct node *n);

int opal_read(struct node *n, struct msg *m);

int opal_write(struct node *n, struct msg *m);

#endif /* _OPAL_H_ */