1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
#ifndef _PCILIB_EVENT_H
#define _PCILIB_EVENT_H
#include <pcilib.h>
#include <pcilib/version.h>
#include <pcilib/dma.h>
#define PCILIB_EVENT_INTERFACE_VERSION PCILIB_VERSION
typedef struct {
size_t max_events;
pcilib_timeout_t duration;
} pcilib_autostop_parameters_t;
typedef struct {
pcilib_event_rawdata_callback_t callback;
void *user;
} pcilib_rawdata_parameters_t;
typedef struct {
size_t max_threads;
} pcilib_parallel_parameters_t;
typedef struct {
pcilib_autostop_parameters_t autostop;
pcilib_rawdata_parameters_t rawdata;
pcilib_parallel_parameters_t parallel;
} pcilib_event_parameters_t;
struct pcilib_event_context_s {
pcilib_event_parameters_t params;
pcilib_t *pcilib;
};
typedef struct {
pcilib_event_t evid;
const char *name;
const char *description;
} pcilib_event_description_t;
typedef struct {
pcilib_event_data_type_t data_type;
pcilib_event_t evid;
const char *name;
const char *description;
} pcilib_event_data_type_description_t;
/*
* get_data: This call is used by get_data and copy_data functions of public
* interface. When copy_data is the caller, the data parameter will be passed.
* Therefore, depending on data the parameter, the function should behave
* diferently. If get get_data function is used (buf == NULL), the caller is
* expected to call return_data afterwards. Otherwise, if buf != NULL and
* copy_data is used, the return call will not be executed.
* Still, the get_data function is not obliged to return the data in the
* passed buf, but a reference to the staticaly allocated memory may be
* returned instead. The copy can be managed by the envelope function.
*/
typedef struct {
pcilib_version_t version;
pcilib_context_t *(*init)(pcilib_t *ctx);
void (*free)(pcilib_context_t *ctx);
pcilib_dma_context_t *(*init_dma)(pcilib_context_t *ctx);
int (*reset)(pcilib_context_t *ctx);
int (*start)(pcilib_context_t *ctx, pcilib_event_t event_mask, pcilib_event_flags_t flags);
int (*stop)(pcilib_context_t *ctx, pcilib_event_flags_t flags);
int (*trigger)(pcilib_context_t *ctx, pcilib_event_t event, size_t trigger_size, void *trigger_data);
int (*stream)(pcilib_context_t *ctx, pcilib_event_callback_t callback, void *user);
int (*next_event)(pcilib_context_t *ctx, pcilib_timeout_t timeout, pcilib_event_id_t *evid, size_t info_size, pcilib_event_info_t *info);
int (*get_data)(pcilib_context_t *ctx, pcilib_event_id_t event_id, pcilib_event_data_type_t data_type, size_t arg_size, void *arg, size_t *size, void **data);
int (*return_data)(pcilib_context_t *ctx, pcilib_event_id_t event_id, pcilib_event_data_type_t data_type, void *data);
} pcilib_event_api_description_t;
#ifdef __cplusplus
extern "C" {
#endif
int pcilib_init_event_engine(pcilib_t *ctx);
/*
* Configures maximal number of preprocessing threads. Actual amount of threads
* may be bigger. For instance, additionaly a real-time reader thread will be
* executed for most of hardware
*/
int pcilib_configure_preprocessing_threads(pcilib_t *ctx, size_t max_threads);
#ifdef __cplusplus
}
#endif
#endif /* _PCILIB_EVENT_H */
|