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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
#ifndef DISCOVERY_NODES_CONFIG_H
#define DISCOVERY_NODES_CONFIG_H
/**
* @file nodes_config.h
* @brief Dot-indexed node configuration parser and server-side node creator.
*
* Reads a config file containing node.N.field entries, parses them into
* an array of node descriptors, and creates corresponding OPC UA variable
* nodes in the server address space. Each node gets a string NodeId in
* namespace 1 (ns=1;s=<name>). Nodes are created with zero-initialized
* values; call nodes_config_randomize() to assign random values.
*
* Supported types (scalar and 1D array via "type[]" suffix):
* bool, sbyte, byte, int16, uint16, int32, uint32, int64, uint64,
* float, double, string, datetime, guid, bytestring
*
* Access levels: read, readwrite.
*/
#include <open62541/server.h>
#include <stddef.h>
/* ========================================================================
* Types
* ======================================================================== */
/**
* @brief OPC UA data types supported by the nodes config parser.
*/
typedef enum
{
NODE_TYPE_BOOL,
NODE_TYPE_INT16,
NODE_TYPE_UINT16,
NODE_TYPE_INT32,
NODE_TYPE_UINT32,
NODE_TYPE_INT64,
NODE_TYPE_UINT64,
NODE_TYPE_FLOAT,
NODE_TYPE_DOUBLE,
NODE_TYPE_STRING,
NODE_TYPE_SBYTE,
NODE_TYPE_BYTE,
NODE_TYPE_DATETIME,
NODE_TYPE_GUID,
NODE_TYPE_BYTESTRING
} node_type;
/**
* @brief Access level flags for a variable node.
*/
typedef enum
{
NODE_ACCESS_READ,
NODE_ACCESS_READWRITE
} node_access_level;
/**
* @brief Describes a single variable node to be created on the server.
*
* All string pointers are heap-allocated copies owned by this struct.
* Call nodes_config_free() to release them.
*/
typedef struct
{
char *name; /**< DisplayName, browseName, and string NodeId. */
char *description; /**< Optional description text (NULL when absent). */
node_type type; /**< OPC UA data type. */
UA_Boolean is_array; /**< true when the type name ended with "[]". */
node_access_level access; /**< Read or read-write. */
} node_config;
/**
* @brief A parsed set of variable node definitions.
*/
typedef struct
{
node_config *nodes;
size_t count;
} nodes_config;
/* ========================================================================
* Public API
* ======================================================================== */
/**
* @brief Parses a nodes configuration file.
*
* Reads dot-indexed keys (node.N.name, node.N.type, etc.) from the
* file at @p path, groups them by index, validates required fields,
* and populates a nodes_config struct. The caller must free the
* result with nodes_config_free().
*
* When the file contains no node.* keys the function succeeds with
* out->count == 0 and out->nodes == NULL.
*
* @param path Path to the nodes configuration file.
* @param out Output: parsed nodes configuration.
* @return 0 on success, -1 on error (logged via UA_LOG_ERROR/FATAL).
*/
int nodes_config_load (const char *path, nodes_config *out);
/**
* @brief Adds all configured variable nodes to a server.
*
* For each node_config entry, parses the value string into the
* appropriate UA type, constructs a UA_VariableAttributes, and calls
* UA_Server_addVariableNode with a string NodeId in namespace 1
* under the Objects folder.
*
* Individual node failures are logged but do not stop processing of
* remaining nodes.
*
* @param server The UA_Server to add nodes to.
* @param nc The parsed nodes configuration.
* @return 0 when all nodes were added, -1 if any node failed.
*/
int nodes_config_add (UA_Server *server, const nodes_config *nc);
/**
* @brief Writes random values to all configured variable nodes.
*
* Generates a random value appropriate for each node's type and writes
* it to the server using UA_Server_writeValue. For array nodes, each
* element is randomized independently. Call srand() before the first
* invocation to seed the random number generator.
*
* @param server The UA_Server containing the nodes.
* @param nc The parsed nodes configuration.
* @return 0 when all nodes were updated, -1 if any write failed.
*/
int nodes_config_randomize (UA_Server *server, const nodes_config *nc);
/**
* @brief Frees all memory owned by a nodes_config structure.
*
* After this call the structure is zeroed and must not be used
* unless nodes_config_load() is called again.
*
* @param nc The nodes configuration to free.
*/
void nodes_config_free (nodes_config *nc);
#endif /* DISCOVERY_NODES_CONFIG_H */
|
