nRF5 SDK for Mesh v5.0.0
light_lightness_client.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 LIGHT_LIGHTNESS_CLIENT_H__
39 #define LIGHT_LIGHTNESS_CLIENT_H__
40 
41 
42 #include <stdint.h>
43 #include "access.h"
44 #include "access_reliable.h"
45 #include "light_lightness_common.h"
46 #include "light_lightness_messages.h"
47 
48 
56 #define LIGHT_LIGHTNESS_CLIENT_MODEL_ID 0x1302
57 
58 /* Forward declaration */
59 typedef struct __light_lightness_client_t light_lightness_client_t;
60 
68 typedef void (*light_lightness_state_status_cb_t)(const light_lightness_client_t * p_self,
69  const access_message_rx_meta_t * p_meta,
70  const light_lightness_status_params_t * p_in);
71 
79 typedef void (*light_lightness_linear_state_status_cb_t)(const light_lightness_client_t * p_self,
80  const access_message_rx_meta_t * p_meta,
82 
90 typedef void (*light_lightness_last_state_status_cb_t)(const light_lightness_client_t * p_self,
91  const access_message_rx_meta_t * p_meta,
93 
94 
102 typedef void (*light_lightness_default_state_status_cb_t)(const light_lightness_client_t * p_self,
103  const access_message_rx_meta_t * p_meta,
105 
113 typedef void (*light_lightness_range_state_status_cb_t)(const light_lightness_client_t * p_self,
114  const access_message_rx_meta_t * p_meta,
116 
117 typedef struct
118 {
131 
135 typedef struct
136 {
140  uint32_t timeout;
147 
151 
153 typedef union
154 {
160 
163 {
168  /* Acknowledged message context variable */
169  access_reliable_t access_message;
170 
173 };
174 
194 uint32_t light_lightness_client_init(light_lightness_client_t * p_client, uint8_t element_index);
195 
215 uint32_t light_lightness_client_set(light_lightness_client_t * p_client,
216  const light_lightness_set_params_t * p_params,
217  const model_transition_t * p_transition);
218 
242 uint32_t light_lightness_client_set_unack(light_lightness_client_t * p_client,
243  const light_lightness_set_params_t * p_params,
244  const model_transition_t * p_transition, uint8_t repeats);
264 uint32_t light_lightness_client_linear_set(light_lightness_client_t * p_client,
265  const light_lightness_linear_set_params_t * p_params,
266  const model_transition_t * p_transition);
267 
291 uint32_t light_lightness_client_linear_set_unack(light_lightness_client_t * p_client,
292  const light_lightness_linear_set_params_t * p_params,
293  const model_transition_t * p_transition, uint8_t repeats);
294 
312 uint32_t light_lightness_client_default_set(light_lightness_client_t * p_client,
313  const light_lightness_default_set_params_t * p_params);
314 
336 uint32_t light_lightness_client_default_set_unack(light_lightness_client_t * p_client,
337  const light_lightness_default_set_params_t * p_params,
338  uint8_t repeats);
357 uint32_t light_lightness_client_range_set(light_lightness_client_t * p_client,
358  const light_lightness_range_set_params_t * p_params);
359 
382 uint32_t light_lightness_client_range_set_unack(light_lightness_client_t * p_client,
383  const light_lightness_range_set_params_t * p_params,
384  uint8_t repeats);
385 
402 uint32_t light_lightness_client_get(light_lightness_client_t * p_client);
403 
420 uint32_t light_lightness_client_linear_get(light_lightness_client_t * p_client);
421 
438 uint32_t light_lightness_client_last_get(light_lightness_client_t * p_client);
439 
456 uint32_t light_lightness_client_default_get(light_lightness_client_t * p_client);
457 
474 uint32_t light_lightness_client_range_get(light_lightness_client_t * p_client);
475 
476 
478 #endif /* LIGHT_LIGHTNESS_CLIENT_H__ */
uint32_t light_lightness_client_linear_set(light_lightness_client_t *p_client, const light_lightness_linear_set_params_t *p_params, const model_transition_t *p_transition)
Sends a Linear Set message to the server.
uint32_t light_lightness_client_default_get(light_lightness_client_t *p_client)
Sends a Default Get message to the server.
Message format for the light_lightness Linear set message.
const light_lightness_client_callbacks_t * p_callbacks
Callback list.
uint16_t access_model_handle_t
Access layer handle type.
Definition: access.h:162
uint32_t light_lightness_client_set_unack(light_lightness_client_t *p_client, const light_lightness_set_params_t *p_params, const model_transition_t *p_transition, uint8_t repeats)
Sends a Set Unacknowledged message to the server.
light_lightness_linear_set_msg_pkt_t linear_set
Storage for the Light Lightness Linear Set message.
light_lightness_last_state_status_cb_t lightness_last_status_cb
Callback for the Light Lightness Last Status message.
uint32_t light_lightness_client_range_set(light_lightness_client_t *p_client, const light_lightness_range_set_params_t *p_params)
Sends a Range Set message to the server.
Parameters for the light_lightness Linear Status message.
light_lightness_state_status_cb_t lightness_status_cb
Client model response message callback.
nrf_mesh_transmic_size_t transmic_size
TransMIC size used by the outgoing server messages.
void(* light_lightness_linear_state_status_cb_t)(const light_lightness_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lightness_linear_status_params_t *p_in)
Callback type for linear lightness state related transactions.
Message format for the light_lightness Default set message.
Parameters for the light_lightness Last Status message.
light_lightness_client_msg_data_t msg_pkt
Holds the raw message packet data for transactions.
access_model_handle_t model_handle
Model handle assigned to this instance.
void(* access_publish_timeout_cb_t)(access_model_handle_t handle, void *p_args)
Access layer publish timeout event callback.
Definition: access.h:170
uint32_t light_lightness_client_range_set_unack(light_lightness_client_t *p_client, const light_lightness_range_set_params_t *p_params, uint8_t repeats)
Sends a Range Set Unacknowledged message to the server.
light_lightness_range_state_status_cb_t lightness_range_status_cb
Callback for the Light Lightness Range Status message.
Unpacked message structure typedefs are used for API interfaces and for implementing model code...
uint32_t light_lightness_client_default_set_unack(light_lightness_client_t *p_client, const light_lightness_default_set_params_t *p_params, uint8_t repeats)
Sends a Default Set Unacknowledged message to the server.
Message format for the Light Lightness Default Set message.
light_lightness_range_set_msg_pkt_t range_set
Storage for the Light Lightness Range Set message.
uint32_t light_lightness_client_init(light_lightness_client_t *p_client, uint8_t element_index)
Initializes Light Lightness client.
void(* light_lightness_state_status_cb_t)(const light_lightness_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lightness_status_params_t *p_in)
Callback type for lightness state related transactions.
uint32_t light_lightness_client_set(light_lightness_client_t *p_client, const light_lightness_set_params_t *p_params, const model_transition_t *p_transition)
Sends a Set message to the server.
access_reliable_cb_t ack_transaction_status_cb
Callback to call after the acknowledged transaction has ended.
uint32_t light_lightness_client_linear_set_unack(light_lightness_client_t *p_client, const light_lightness_linear_set_params_t *p_params, const model_transition_t *p_transition, uint8_t repeats)
Sends a Linear Set Unacknowledged message to the server.
uint32_t light_lightness_client_linear_get(light_lightness_client_t *p_client)
Sends a Linear Get message to the server.
Packed message structure typedefs are used for packing and unpacking byte stream. ...
void(* light_lightness_last_state_status_cb_t)(const light_lightness_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lightness_last_status_params_t *p_in)
Callback type for last state related transactions.
Metadata for received messages.
Definition: access.h:196
light_lightness_linear_state_status_cb_t lightness_linear_status_cb
Callback for the Light Lightness Linear Status message.
Parameters for the light_lightness Default Status message.
Union for holding current message packet.
Message format for the Light Lightness Linear Set message.
Access layer acknowledged publish parameter structure.
bool force_segmented
If server should force outgoing messages as segmented messages.
light_lightness_default_set_msg_pkt_t default_set
Storage for the Light Lightness Default Set message.
nrf_mesh_transmic_size_t
Message MIC size selection.
Definition: nrf_mesh.h:385
light_lightness_default_state_status_cb_t lightness_default_status_cb
Callback for the Light Lightness Default Status message.
light_lightness_client_settings_t settings
Model settings and callbacks for this instance.
access_publish_timeout_cb_t periodic_publish_cb
callback called at the end of the each period for the publishing
uint32_t timeout
Reliable message timeout in microseconds.
uint32_t light_lightness_client_last_get(light_lightness_client_t *p_client)
Sends a Last Get message to the server.
void(* access_reliable_cb_t)(access_model_handle_t model_handle, void *p_args, access_reliable_status_t status)
Access layer acknowledged message callback type.
uint32_t light_lightness_client_default_set(light_lightness_client_t *p_client, const light_lightness_default_set_params_t *p_params)
Sends a Default Set message to the server.
Message format for the light_lightness Range set message.
Parameters for the light_lightness Status message.
Message format for the Light Lightness Range Set message.
Parameters for the light_lightness Range Status message.
void(* light_lightness_range_state_status_cb_t)(const light_lightness_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lightness_range_status_params_t *p_in)
Callback type for range state related transactions.
Generic Transition parameters for the model messages.
Definition: model_common.h:162
uint32_t light_lightness_client_range_get(light_lightness_client_t *p_client)
Sends a Range Get message to the server.
User provided settings and callbacks for the model instance.
void(* light_lightness_default_state_status_cb_t)(const light_lightness_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lightness_default_status_params_t *p_in)
Callback type for default state related transactions.
uint32_t light_lightness_client_get(light_lightness_client_t *p_client)
Sends a Get message to the server.

Documentation feedback | Developer Zone | Subscribe | Updated