2016-06-08 22:26:40 +02:00
|
|
|
/** The internal datastructure for a sample of simulation data.
|
|
|
|
*
|
|
|
|
* @file
|
|
|
|
* @author Steffen Vogel <stvogel@eonerc.rwth-aachen.de>
|
2017-03-03 20:20:13 -04:00
|
|
|
* @copyright 2017, Institute for Automation of Complex Power Systems, EONERC
|
2017-04-27 12:56:43 +02:00
|
|
|
* @license GNU General Public License (version 3)
|
|
|
|
*
|
|
|
|
* VILLASnode
|
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
|
|
* any later version.
|
2017-05-05 19:24:16 +00:00
|
|
|
*
|
2017-04-27 12:56:43 +02:00
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
2017-05-05 19:24:16 +00:00
|
|
|
*
|
2017-04-27 12:56:43 +02:00
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2017-03-03 20:20:13 -04:00
|
|
|
*********************************************************************************/
|
2016-06-08 22:26:40 +02:00
|
|
|
|
2017-02-16 09:04:12 -03:00
|
|
|
#pragma once
|
2016-06-08 22:26:40 +02:00
|
|
|
|
2018-06-29 09:06:04 +02:00
|
|
|
#include <villas/atomic.h>
|
2017-04-26 11:48:58 +02:00
|
|
|
|
2018-05-08 11:41:43 +02:00
|
|
|
#include <stddef.h>
|
2016-06-08 22:26:40 +02:00
|
|
|
#include <stdlib.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <time.h>
|
|
|
|
|
2018-06-28 13:42:50 +02:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C"{
|
|
|
|
#endif
|
|
|
|
|
2016-09-10 22:16:23 -04:00
|
|
|
/* Forward declarations */
|
|
|
|
struct pool;
|
|
|
|
|
2016-06-08 22:26:40 +02:00
|
|
|
/** The length of a sample datastructure with \p values values in bytes. */
|
2016-07-11 18:19:23 +02:00
|
|
|
#define SAMPLE_LEN(len) (sizeof(struct sample) + SAMPLE_DATA_LEN(len))
|
2016-06-08 22:26:40 +02:00
|
|
|
|
|
|
|
/** The length of a sample data portion of a sample datastructure with \p values values in bytes. */
|
2017-08-14 14:42:07 +02:00
|
|
|
#define SAMPLE_DATA_LEN(len) ((len) * sizeof(double))
|
2016-06-08 22:26:40 +02:00
|
|
|
|
|
|
|
/** The offset to the beginning of the data section. */
|
2016-07-11 18:19:23 +02:00
|
|
|
#define SAMPLE_DATA_OFFSET(smp) ((char *) (smp) + offsetof(struct sample, data))
|
2016-06-08 22:26:40 +02:00
|
|
|
|
2017-03-27 12:50:39 +02:00
|
|
|
enum sample_data_format {
|
2017-08-14 14:42:07 +02:00
|
|
|
SAMPLE_DATA_FORMAT_FLOAT = 0,
|
|
|
|
SAMPLE_DATA_FORMAT_INT = 1
|
2016-06-08 22:26:40 +02:00
|
|
|
};
|
|
|
|
|
2017-09-04 14:28:55 +02:00
|
|
|
/** Parts of a sample that can be serialized / de-serialized by the IO formats */
|
2017-09-16 15:04:59 +02:00
|
|
|
enum sample_flags {
|
|
|
|
SAMPLE_HAS_ORIGIN = (1 << 0), /**< Include origin timestamp in output. */
|
|
|
|
SAMPLE_HAS_RECEIVED = (1 << 1), /**< Include receive timestamp in output. */
|
|
|
|
SAMPLE_HAS_OFFSET = (1 << 2), /**< Include offset (received - origin timestamp) in output. */
|
|
|
|
SAMPLE_HAS_SOURCE = (1 << 3), /**< This sample has a valid sample::source field. */
|
|
|
|
SAMPLE_HAS_ID = (1 << 4), /**< This sample has a valid sample::id field. */
|
|
|
|
SAMPLE_HAS_SEQUENCE = (1 << 5), /**< Include sequence number in output. */
|
|
|
|
SAMPLE_HAS_VALUES = (1 << 6), /**< Include values in output. */
|
|
|
|
SAMPLE_HAS_FORMAT = (1 << 7), /**< This sample has a valid sample::format field. */
|
|
|
|
SAMPLE_HAS_ALL = (1 << 7) - 1, /**< Enable all output options. */
|
2017-09-16 15:33:57 +02:00
|
|
|
|
|
|
|
SAMPLE_IS_FIRST = (1 << 16), /**< This sample is the first of a new simulation case */
|
|
|
|
SAMPLE_IS_LAST = (1 << 17), /**< This sample is the last of a running simulation case */
|
|
|
|
SAMPLE_IS_REORDERED = (1 << 18), /**< This sample is reordered. */
|
|
|
|
|
|
|
|
// SAMPLE_DO_DROP = (1 << 19), /**< This sample should be dropped. */
|
|
|
|
// SAMPLE_DO_SKIP = (1 << 20) /**< This sample was skipped by a previous hook. */
|
2017-09-04 14:28:55 +02:00
|
|
|
};
|
|
|
|
|
2016-06-08 22:26:40 +02:00
|
|
|
struct sample {
|
2017-09-16 15:04:59 +02:00
|
|
|
int sequence; /**< The sequence number of this sample. */
|
|
|
|
int length; /**< The number of values in sample::values which are valid. */
|
|
|
|
int capacity; /**< The number of values in sample::values for which memory is reserved. */
|
|
|
|
int flags; /**< Flags are used to store binary properties of a sample. */
|
2017-09-04 14:28:55 +02:00
|
|
|
|
2017-09-16 15:04:59 +02:00
|
|
|
struct node *source; /**< The node from which this sample originates. */
|
2018-05-09 09:24:15 +02:00
|
|
|
struct node *destination; /**< The node to which this sample will be sent. */
|
2017-05-05 19:24:16 +00:00
|
|
|
|
2017-09-16 15:04:59 +02:00
|
|
|
atomic_int refcnt; /**< Reference counter. */
|
2018-05-08 11:41:43 +02:00
|
|
|
ptrdiff_t pool_off; /**< This sample belongs to this memory pool (relative pointer). See sample_pool(). */
|
2017-09-16 15:04:59 +02:00
|
|
|
|
|
|
|
/** A long bitfield indicating the number representation of the first 64 values in sample::data[].
|
|
|
|
*
|
|
|
|
* @see sample_data_format
|
|
|
|
*/
|
|
|
|
uint64_t format;
|
2016-06-08 22:26:40 +02:00
|
|
|
|
|
|
|
/** All timestamps are seconds / nano seconds after 1.1.1970 UTC */
|
|
|
|
struct {
|
|
|
|
struct timespec origin; /**< The point in time when this data was sampled. */
|
|
|
|
struct timespec received; /**< The point in time when this data was received. */
|
|
|
|
} ts;
|
2017-05-05 19:24:16 +00:00
|
|
|
|
2016-06-08 22:26:40 +02:00
|
|
|
/** The values. */
|
|
|
|
union {
|
2017-09-04 23:04:56 +02:00
|
|
|
double f; /**< Floating point values. */
|
|
|
|
int64_t i; /**< Integer values. */
|
2016-11-07 22:19:30 -05:00
|
|
|
} data[]; /**< Data is in host endianess! */
|
2016-06-08 22:26:40 +02:00
|
|
|
};
|
|
|
|
|
2018-05-08 11:43:53 +02:00
|
|
|
#define SAMPLE_NON_POOL PTRDIFF_MIN
|
|
|
|
|
2017-09-16 15:04:59 +02:00
|
|
|
/** Get the address of the pool to which the sample belongs. */
|
2018-05-08 11:43:53 +02:00
|
|
|
#define sample_pool(s) ((s)->pool_off == SAMPLE_NON_POOL ? NULL : (struct pool *) ((char *) (s) + (s)->pool_off))
|
2017-08-30 23:50:57 +02:00
|
|
|
|
2017-10-16 08:08:17 +02:00
|
|
|
struct sample * sample_alloc(struct pool *p);
|
|
|
|
|
2018-05-08 11:43:53 +02:00
|
|
|
struct sample * sample_alloc_mem(int capacity);
|
|
|
|
|
2017-10-16 08:08:17 +02:00
|
|
|
struct sample * sample_clone(struct sample *smp);
|
|
|
|
|
|
|
|
void sample_free(struct sample *s);
|
|
|
|
|
2016-10-22 20:47:36 -04:00
|
|
|
/** Request \p cnt samples from memory pool \p p and initialize them.
|
2017-05-12 11:35:21 +02:00
|
|
|
* The reference count will already be set to 1.
|
2016-10-22 20:47:36 -04:00
|
|
|
* Use the sample_get() function to increase it. */
|
2017-10-16 08:08:17 +02:00
|
|
|
int sample_alloc_many(struct pool *p, struct sample *smps[], int cnt);
|
2016-10-22 20:47:36 -04:00
|
|
|
|
|
|
|
/** Release an array of samples back to their pools */
|
2017-10-16 08:08:17 +02:00
|
|
|
void sample_free_many(struct sample *smps[], int cnt);
|
2016-09-10 22:16:23 -04:00
|
|
|
|
2016-08-28 23:57:11 -04:00
|
|
|
/** Increase reference count of sample */
|
|
|
|
int sample_get(struct sample *s);
|
|
|
|
|
|
|
|
/** Decrease reference count and release memory if last reference was held. */
|
|
|
|
int sample_put(struct sample *s);
|
|
|
|
|
2017-04-07 17:46:50 +02:00
|
|
|
int sample_copy(struct sample *dst, struct sample *src);
|
|
|
|
|
2017-10-16 08:08:17 +02:00
|
|
|
|
2017-09-04 16:19:43 +02:00
|
|
|
/** Compare two samples */
|
|
|
|
int sample_cmp(struct sample *a, struct sample *b, double epsilon, int flags);
|
|
|
|
|
2017-10-16 08:08:17 +02:00
|
|
|
int sample_clone_many(struct sample *clones[], struct sample *origs[], int cnt);
|
2017-04-07 17:46:50 +02:00
|
|
|
int sample_copy_many(struct sample *dsts[], struct sample *srcs[], int cnt);
|
|
|
|
int sample_get_many(struct sample *smps[], int cnt);
|
|
|
|
int sample_put_many(struct sample *smps[], int cnt);
|
|
|
|
|
2017-04-16 23:00:30 +02:00
|
|
|
/** Get number representation for a single value of a sample. */
|
2017-03-27 12:50:39 +02:00
|
|
|
int sample_get_data_format(struct sample *s, int idx);
|
|
|
|
|
2017-04-16 23:00:30 +02:00
|
|
|
/** Set number representation for a single value of a sample. */
|
2017-04-06 12:12:56 +02:00
|
|
|
int sample_set_data_format(struct sample *s, int idx, enum sample_data_format fmt);
|
2017-04-26 11:48:58 +02:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|