summaryrefslogtreecommitdiffstats
path: root/pcilib/view.h
blob: 9d3d32d25581cf593ad638e47e6eeae031f79cf2 (plain)
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
#ifndef _PCILIB_VIEW_H
#define _PCILIB_VIEW_H

#include <uthash.h>

#include <pcilib.h>
#include <pcilib/unit.h>

#define PCILIB_VIEW_INVALID ((pcilib_view_t)-1)

typedef struct pcilib_view_context_s pcilib_view_context_t;
typedef struct pcilib_view_description_s pcilib_view_description_t;

typedef enum {
    PCILIB_VIEW_FLAG_PROPERTY = 1                                               /**< Indicates that view does not depend on a value and is independent property */
} pcilib_view_flags_t;

typedef struct {
    pcilib_version_t version;
    size_t description_size;
    pcilib_view_context_t *(*init)(pcilib_t *ctx);
    void (*free)(pcilib_t *ctx, pcilib_view_context_t *view);
    void (*free_description)(pcilib_t *ctx, pcilib_view_description_t *view);
    int (*read_from_reg)(pcilib_t *ctx, pcilib_view_context_t *view, pcilib_register_value_t regval, pcilib_value_t *val);
    int (*write_to_reg)(pcilib_t *ctx, pcilib_view_context_t *view, pcilib_register_value_t *regval, const pcilib_value_t *val);
} pcilib_view_api_description_t;

struct pcilib_view_description_s {
    const pcilib_view_api_description_t *api;
    pcilib_value_type_t type;			                                /**< The default data type returned by operation, PCILIB_VIEW_TYPE_STRING is supported by all operations */
    pcilib_view_flags_t flags;                                                  /**< Flags specifying type of the view */
    const char *unit;				                                /**< Returned unit (if any) */
    const char *name;				                                /**< Name of the view */
    const char *description;			                                /**< Short description */
};

struct pcilib_view_context_s {
    const char *name;
    pcilib_view_t view;
    UT_hash_handle hh;
};

#ifdef __cplusplus
extern "C" {
#endif

int pcilib_add_views(pcilib_t *ctx, size_t n, const pcilib_view_description_t *desc);
void pcilib_clean_views(pcilib_t *ctx);

pcilib_view_context_t *pcilib_find_view_context_by_name(pcilib_t *ctx, const char *view);
pcilib_view_context_t *pcilib_find_register_view_context_by_name(pcilib_t *ctx, pcilib_register_t reg, const char *name);
pcilib_view_context_t *pcilib_find_register_view_context(pcilib_t *ctx, pcilib_register_t reg, const char *name);

pcilib_view_t pcilib_find_view_by_name(pcilib_t *ctx, const char *name);

#ifdef __cplusplus
}
#endif

#endif /* PCILIB_VIEW_H */