nRF5 SDK for Mesh v5.0.0
generic_level_server.h
1 /* Copyright (c) 2010 - 2020, Nordic Semiconductor ASA
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without modification,
5  * are permitted provided that the following conditions are met:
6  *
7  * 1. Redistributions of source code must retain the above copyright notice, this
8  * list of conditions and the following disclaimer.
9  *
10  * 2. Redistributions in binary form, except as embedded into a Nordic
11  * Semiconductor ASA integrated circuit in a product or a software update for
12  * such product, must reproduce the above copyright notice, this list of
13  * conditions and the following disclaimer in the documentation and/or other
14  * materials provided with the distribution.
15  *
16  * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
17  * contributors may be used to endorse or promote products derived from this
18  * software without specific prior written permission.
19  *
20  * 4. This software, with or without modification, must only be used with a
21  * Nordic Semiconductor ASA integrated circuit.
22  *
23  * 5. Any software provided in binary form under this license must not be reverse
24  * engineered, decompiled, modified and/or disassembled.
25  *
26  * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
27  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
28  * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
29  * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
30  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
32  * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
35  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36  */
37 
38 #ifndef GENERIC_LEVEL_SERVER_H__
39 #define GENERIC_LEVEL_SERVER_H__
40 
41 #include <stdint.h>
42 #include "access.h"
43 #include "generic_level_common.h"
44 #include "model_common.h"
45 
53 #define GENERIC_LEVEL_SERVER_MODEL_ID 0x1002
54 
55 /* Forward declaration */
56 typedef struct __generic_level_server_t generic_level_server_t;
57 
70 typedef void (*generic_level_state_set_cb_t)(const generic_level_server_t * p_self,
71  const access_message_rx_meta_t * p_meta,
72  const generic_level_set_params_t * p_in,
73  const model_transition_t * p_in_transition,
75 
83 typedef void (*generic_level_state_get_cb_t)(const generic_level_server_t * p_self,
84  const access_message_rx_meta_t * p_meta,
86 
103 typedef void (*generic_level_state_delta_set_cb_t)(const generic_level_server_t * p_self,
104  const access_message_rx_meta_t * p_meta,
106  const model_transition_t * p_in_transition,
108 
109 
122 typedef void (*generic_level_state_move_set_cb_t)(const generic_level_server_t * p_self,
123  const access_message_rx_meta_t * p_meta,
124  const generic_level_move_set_params_t * p_in,
125  const model_transition_t * p_in_transition,
127 
128 
132 typedef struct
133 {
139 
143 typedef struct
144 {
148 
152 typedef struct
153 {
160 
164 
167 {
172 
175 
177  uint8_t state_handle;
178 };
179 
198 uint32_t generic_level_server_init(generic_level_server_t * p_server, uint8_t element_index);
199 
220 uint32_t generic_level_server_status_publish(generic_level_server_t * p_server, const generic_level_status_params_t * p_params);
221 
237 uint32_t generic_level_server_state_set(generic_level_server_t * p_server, int16_t level);
238 
240 #endif /* GENERIC_LEVEL_SERVER_H__ */
uint16_t access_model_handle_t
Access layer handle type.
Definition: access.h:162
bool force_segmented
If server should force outgoing messages as segmented messages.
Structure for tracking TID expiry for the models.
Definition: model_common.h:169
uint8_t state_handle
State handle for this instance.
void(* generic_level_state_set_cb_t)(const generic_level_server_t *p_self, const access_message_rx_meta_t *p_meta, const generic_level_set_params_t *p_in, const model_transition_t *p_in_transition, generic_level_status_params_t *p_out)
Callback type for Generic Level Set/Set Unacknowledged message.
void(* generic_level_state_get_cb_t)(const generic_level_server_t *p_self, const access_message_rx_meta_t *p_meta, generic_level_status_params_t *p_out)
Callback type for Generic Level Get message.
access_model_handle_t model_handle
Model handle assigned to this instance.
uint32_t generic_level_server_state_set(generic_level_server_t *p_server, int16_t level)
Function to trigger level value set as a Generic Level server callback.
const generic_level_server_callbacks_t * p_callbacks
Callback list.
Transaction callbacks for the Level state.
Message format for the generic_level Move Set message.
Parameters for the generic_level Status message.
User provided settings and callbacks for the model instance.
uint32_t generic_level_server_init(generic_level_server_t *p_server, uint8_t element_index)
Initializes Generic Level server.
nrf_mesh_transmic_size_t transmic_size
TransMIC size used by the outgoing server messages.
Metadata for received messages.
Definition: access.h:196
Message format for the generic_level Delta Set message.
generic_level_server_settings_t settings
Model settings and callbacks for this instance.
nrf_mesh_transmic_size_t
Message MIC size selection.
Definition: nrf_mesh.h:385
generic_level_server_state_cbs_t level_cbs
Callbacks for the level state.
tid_tracker_t tid_tracker
Tid tracker structure.
uint32_t generic_level_server_status_publish(generic_level_server_t *p_server, const generic_level_status_params_t *p_params)
Publishes unsolicited Status message.
Unpacked message structure typedefs are used for API interfaces and for implementing model code...
Level server callback list.
void(* generic_level_state_delta_set_cb_t)(const generic_level_server_t *p_self, const access_message_rx_meta_t *p_meta, const generic_level_delta_set_params_t *p_in, const model_transition_t *p_in_transition, generic_level_status_params_t *p_out)
Callback type for Generic Level Delta Set/Delta Set Unacknowledged message.
void(* generic_level_state_move_set_cb_t)(const generic_level_server_t *p_self, const access_message_rx_meta_t *p_meta, const generic_level_move_set_params_t *p_in, const model_transition_t *p_in_transition, generic_level_status_params_t *p_out)
Callback type for Generic Level Move Set/Move Set Unacknowledged message.
Generic Transition parameters for the model messages.
Definition: model_common.h:162

Documentation feedback | Developer Zone | Subscribe | Updated