libamxd  6.4.1
Data Model Manager
test_amxd_parameter_action.c
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** SPDX-License-Identifier: BSD-2-Clause-Patent
4 **
5 ** SPDX-FileCopyrightText: Copyright (c) 2023 SoftAtHome
6 **
7 ** Redistribution and use in source and binary forms, with or without modification,
8 ** are permitted provided that the following conditions are met:
9 **
10 ** 1. Redistributions of source code must retain the above copyright notice,
11 ** this list of conditions and the following disclaimer.
12 **
13 ** 2. Redistributions in binary form must reproduce the above copyright notice,
14 ** this list of conditions and the following disclaimer in the documentation
15 ** and/or other materials provided with the distribution.
16 **
17 ** Subject to the terms and conditions of this license, each copyright holder
18 ** and contributor hereby grants to those receiving rights under this license
19 ** a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
20 ** (except for failure to satisfy the conditions of this license) patent license
21 ** to make, have made, use, offer to sell, sell, import, and otherwise transfer
22 ** this software, where such license applies only to those patent claims, already
23 ** acquired or hereafter acquired, licensable by such copyright holder or contributor
24 ** that are necessarily infringed by:
25 **
26 ** (a) their Contribution(s) (the licensed copyrights of copyright holders and
27 ** non-copyrightable additions of contributors, in source or binary form) alone;
28 ** or
29 **
30 ** (b) combination of their Contribution(s) with the work of authorship to which
31 ** such Contribution(s) was added by such copyright holder or contributor, if,
32 ** at the time the Contribution is added, such addition causes such combination
33 ** to be necessarily infringed. The patent license shall not apply to any other
34 ** combinations which include the Contribution.
35 **
36 ** Except as expressly stated above, no rights or licenses from any copyright
37 ** holder or contributor is granted under this license, whether expressly, by
38 ** implication, estoppel or otherwise.
39 **
40 ** DISCLAIMER
41 **
42 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
43 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
46 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 ** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
48 ** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
49 ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
51 ** USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
52 **
53 ****************************************************************************/
54 
55 #include <stdlib.h>
56 #include <stdarg.h>
57 #include <stddef.h>
58 #include <setjmp.h>
59 #include <fcntl.h>
60 #include <unistd.h>
61 #include <signal.h>
62 #include <cmocka.h>
63 
64 #include <amxc/amxc.h>
65 #include <amxp/amxp_signal.h>
66 #include <amxp/amxp_slot.h>
67 
68 #include <amxd/amxd_common.h>
69 #include <amxd/amxd_dm.h>
70 #include <amxd/amxd_object.h>
71 #include <amxd/amxd_parameter.h>
72 #include <amxd/amxd_function.h>
73 #include <amxd/amxd_action.h>
74 
76 
77 #include <amxc/amxc_macros.h>
78 static amxd_dm_t dm;
79 
81 static void* expected_priv;
85 
86 static uint32_t called = 0;
87 
89  amxd_param_t* const param,
90  amxd_action_t reason,
91  UNUSED const amxc_var_t* const args,
92  amxc_var_t* const retval,
93  void* priv) {
94  assert_ptr_equal(object, expected_obj);
95  assert_ptr_equal(param, expected_param);
96  assert_int_equal(reason, expected_reason);
97  assert_ptr_equal(priv, expected_priv);
98 
99  if(status == amxd_status_ok) {
100  amxc_var_set(cstring_t, retval, "Test Data");
101  } else {
102  amxc_var_clean(retval);
103  }
104 
105  called++;
106  return status;
107 }
108 
110  amxd_object_t* object = NULL;
111  amxd_object_t* template = NULL;
112  amxd_param_t* param = NULL;
113 
114  assert_int_equal(amxd_dm_init(&dm), 0);
115 
116  assert_int_equal(amxd_object_new(&template, amxd_object_template, "parent"), 0);
117  assert_int_equal(amxd_dm_add_root_object(&dm, template), 0);
118  assert_int_equal(amxd_object_new(&object, amxd_object_singleton, "child"), 0);
119  assert_int_equal(amxd_object_add_object(template, object), 0);
120 
121  assert_int_equal(amxd_param_new(&param, "templ_param", AMXC_VAR_ID_CSTRING), 0);
123  assert_int_equal(amxd_object_add_param(template, param), 0);
124  assert_int_equal(amxd_param_new(&param, "inst_param", AMXC_VAR_ID_BOOL), 0);
125  assert_int_equal(amxd_object_add_param(template, param), 0);
126  assert_int_equal(amxd_param_new(&param, "param", AMXC_VAR_ID_UINT32), 0);
129  assert_int_equal(amxd_object_add_param(template, param), 0);
130 
131  assert_int_equal(amxd_param_new(&param, "child_param", AMXC_VAR_ID_CSTRING), 0);
133  assert_int_equal(amxd_object_add_param(object, param), 0);
134  assert_int_equal(amxd_param_new(&param, "child_param2", AMXC_VAR_ID_BOOL), 0);
135  assert_int_equal(amxd_object_add_param(object, param), 0);
136  assert_int_equal(amxd_param_new(&param, "child_param3", AMXC_VAR_ID_UINT64), 0);
137  assert_int_equal(amxd_object_add_param(object, param), 0);
138 
139  return template;
140 }
141 
142 void test_amxd_param_add_action_cb(UNUSED void** state) {
143  amxd_object_t* template = NULL;
144  amxd_object_t* object = NULL;
145  amxd_object_t* instance = NULL;
146  amxd_param_t* param = NULL;
147  amxc_var_t value;
148 
149  amxc_var_init(&value);
150  template = test_build_dm();
151  object = amxd_object_get_child(template, "child");
152  param = amxd_object_get_param_def(object, "child_param2");
153  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 0, NULL), 0);
154  assert_int_equal(amxd_param_add_action_cb(param, action_param_read, amxd_action_param_test_cb, NULL), 0);
155  assert_int_not_equal(amxd_param_add_action_cb(param, action_param_read, amxd_action_param_test_cb, NULL), 0);
156  assert_int_equal(amxd_param_add_action_cb(param, action_param_write, amxd_action_param_test_cb, NULL), 0);
157 
159  expected_priv = NULL;
161  called = 0;
162 
163  expected_obj = object;
164  expected_param = param;
165  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), status);
166  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_CSTRING);
167  assert_string_equal(amxc_var_constcast(cstring_t, &value), "Test Data");
168 
169  expected_obj = object;
170  expected_param = param;
171  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), status);
172  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_CSTRING);
173  assert_string_equal(amxc_var_constcast(cstring_t, &value), "Test Data");
174 
175  assert_int_equal(called, 2);
176 
177  assert_int_not_equal(amxd_param_add_action_cb(NULL, action_param_read, amxd_action_param_test_cb, NULL), 0);
178  assert_int_not_equal(amxd_param_add_action_cb(param, action_param_read, NULL, NULL), 0);
179 
180  amxc_var_clean(&value);
181  amxd_dm_clean(&dm);
182 }
183 
184 void test_amxd_param_remove_action_cb(UNUSED void** state) {
185  amxd_object_t* template = NULL;
186  amxd_object_t* object = NULL;
187  amxd_object_t* instance = NULL;
188  amxd_param_t* param = NULL;
189  amxc_var_t value;
190 
191  amxc_var_init(&value);
192  template = test_build_dm();
193  object = amxd_object_get_child(template, "child");
194  param = amxd_object_get_param_def(object, "child_param2");
195  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 0, NULL), 0);
196  assert_int_equal(amxd_param_add_action_cb(param, action_param_read, amxd_action_param_test_cb, NULL), 0);
197  assert_int_equal(amxd_param_add_action_cb(param, action_param_write, amxd_action_param_test_cb, NULL), 0);
198 
200  expected_priv = NULL;
202  called = 0;
203 
204  expected_obj = object;
205  expected_param = param;
206  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), status);
207  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_CSTRING);
208  assert_string_equal(amxc_var_constcast(cstring_t, &value), "Test Data");
209 
212 
213  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), 0);
214  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_BOOL);
215  assert_true(amxc_var_constcast(bool, &value) == false);
216 
217  assert_int_equal(called, 1);
218 
220  assert_int_not_equal(amxd_param_remove_action_cb(param, action_param_write, NULL), 0);
222 
223  amxc_var_clean(&value);
224  amxd_dm_clean(&dm);
225 }
226 
227 void test_amxd_param_disable_action_cb(UNUSED void** state) {
228  amxd_object_t* template = NULL;
229  amxd_object_t* object = NULL;
230  amxd_object_t* instance = NULL;
231  amxd_param_t* param = NULL;
232  amxc_var_t value;
233 
234  amxc_var_init(&value);
235  template = test_build_dm();
236  object = amxd_object_get_child(template, "child");
237  param = amxd_object_get_param_def(object, "child_param2");
238  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 0, NULL), 0);
239  assert_int_equal(amxd_param_add_action_cb(param, action_param_read, amxd_action_param_test_cb, NULL), 0);
240  assert_int_equal(amxd_param_add_action_cb(param, action_param_write, amxd_action_param_test_cb, NULL), 0);
241 
243  expected_priv = NULL;
245  called = 0;
246 
247  expected_obj = object;
248  expected_param = param;
249  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), status);
250  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_CSTRING);
251  assert_string_equal(amxc_var_constcast(cstring_t, &value), "Test Data");
252 
255 
256  assert_int_equal(amxd_object_get_param(object, "child_param2", &value), 0);
257  assert_int_equal(amxc_var_type_of(&value), AMXC_VAR_ID_BOOL);
258  assert_true(amxc_var_constcast(bool, &value) == false);
259 
260  assert_int_equal(called, 1);
261 
263  amxd_param_enable_action_cb(param, action_param_write, NULL, false);
266 
267  amxc_var_clean(&value);
268  amxd_dm_clean(&dm);
269 }
270 
271 void test_amxd_param_action_data(UNUSED void** state) {
272  amxd_object_t* template = NULL;
273  amxd_object_t* object = NULL;
274  amxd_object_t* instance = NULL;
275  amxd_param_t* param = NULL;
276  amxc_var_t* data = NULL;
277  amxc_var_t value;
278 
279  amxc_var_init(&value);
280  amxc_var_new(&data);
281 
282  template = test_build_dm();
283  object = amxd_object_get_child(template, "child");
284  param = amxd_object_get_param_def(object, "child_param2");
285  assert_int_equal(amxd_object_new_instance(&instance, template, NULL, 0, NULL), 0);
286  assert_int_equal(amxd_param_add_action_cb(param, action_param_read, amxd_action_param_test_cb, NULL), 0);
287 
291 
295 
296  amxc_var_clean(&value);
297  amxc_var_delete(&data);
298  amxd_dm_clean(&dm);
299 }
Ambiorix Data Model Default actions header file.
Ambiorix Data Model API header file.
Ambiorix Data Model RPC methods API header file.
Ambiorix Data Model API header file.
amxd_status_t amxd_param_new(amxd_param_t **param, const char *name, const uint32_t type)
amxd_status_t amxd_param_set_attr(amxd_param_t *param, const amxd_pattr_id_t attr, const bool enable)
void amxd_param_enable_action_cb(const amxd_param_t *const param, const amxd_action_t reason, amxd_action_fn_t fn, bool enable)
void amxd_param_set_action_cb_data(amxd_param_t *const param, const amxd_action_t reason, amxd_action_fn_t fn, void *data)
void * amxd_param_get_action_cb_data(amxd_param_t *const param, const amxd_action_t reason, amxd_action_fn_t fn)
amxd_status_t amxd_param_add_action_cb(amxd_param_t *const param, const amxd_action_t reason, amxd_action_fn_t fn, void *priv)
amxd_status_t amxd_param_remove_action_cb(amxd_param_t *const param, const amxd_action_t reason, amxd_action_fn_t fn)
@ amxd_pattr_template
Definition: amxd_types.h:355
@ amxd_pattr_private
Definition: amxd_types.h:357
@ amxd_pattr_instance
Definition: amxd_types.h:356
@ action_param_write
Definition: amxd_types.h:113
@ action_param_read
Definition: amxd_types.h:112
@ action_param_validate
Definition: amxd_types.h:114
enum _amxd_action amxd_action_t
enum _amxd_status amxd_status_t
@ amxd_status_ok
Definition: amxd_types.h:78
@ amxd_object_template
Definition: amxd_types.h:183
@ amxd_object_singleton
Definition: amxd_types.h:181
amxd_status_t amxd_dm_add_root_object(amxd_dm_t *const dm, amxd_object_t *const object)
Adds an object to the root of the data model.
Definition: amxd_dm.c:418
amxd_status_t amxd_dm_init(amxd_dm_t *dm)
Initializes a data model structure.
Definition: amxd_dm.c:334
void amxd_dm_clean(amxd_dm_t *dm)
Cleans a data model structure.
Definition: amxd_dm.c:365
amxd_object_t * amxd_object_get_child(const amxd_object_t *object, const char *name)
Get a child of the object.
amxd_status_t amxd_object_add_object(amxd_object_t *const parent, amxd_object_t *const child)
Adds an object in the data model tree.
Definition: amxd_object.c:207
amxd_param_t * amxd_object_get_param_def(const amxd_object_t *const object, const char *name)
Gets a parameter definition from an object.
amxd_status_t amxd_object_get_param(amxd_object_t *const object, const char *name, amxc_var_t *const value)
Gets a single parameter value.
amxd_status_t amxd_object_add_param(amxd_object_t *const object, amxd_param_t *const param)
Adds a parameter definition to an object.
amxd_status_t amxd_object_new_instance(amxd_object_t **object, amxd_object_t *templ, const char *name, uint32_t index, amxc_var_t *values)
Data model object constructor function.
amxd_status_t amxd_object_new(amxd_object_t **object, const amxd_object_type_t type, const char *name)
Data model object constructor function.
Definition: amxd_object.c:185
void test_amxd_param_remove_action_cb(UNUSED void **state)
void test_amxd_param_action_data(UNUSED void **state)
static amxd_dm_t dm
void test_amxd_param_add_action_cb(UNUSED void **state)
static amxd_status_t status
static amxd_param_t * expected_param
static amxd_status_t amxd_action_param_test_cb(amxd_object_t *const object, amxd_param_t *const param, amxd_action_t reason, UNUSED const amxc_var_t *const args, amxc_var_t *const retval, void *priv)
static uint32_t called
static void * expected_priv
static amxd_action_t expected_reason
void test_amxd_param_disable_action_cb(UNUSED void **state)
static amxd_object_t * expected_obj
static amxd_object_t * test_build_dm(void)