nRF5 SDK for Mesh v5.0.0
light_lc_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_LC_CLIENT_H__
39 #define LIGHT_LC_CLIENT_H__
40 
41 #include <stdint.h>
42 #include "access.h"
43 #include "access_reliable.h"
44 #include "light_lc_common.h"
45 #include "light_lc_messages.h"
46 
55 #define LIGHT_LC_CLIENT_MODEL_ID 0x1311
56 
57 /* Forward declaration */
58 typedef struct __light_lc_client_t light_lc_client_t;
59 
67 typedef void (*light_lc_mode_state_status_cb_t)(const light_lc_client_t * p_self,
68  const access_message_rx_meta_t * p_meta,
69  const light_lc_mode_status_params_t * p_in);
70 
78 typedef void (*light_lc_occupancy_mode_state_status_cb_t)(const light_lc_client_t * p_self,
79  const access_message_rx_meta_t * p_meta,
81 
89 typedef void (*light_lc_light_onoff_state_status_cb_t)(const light_lc_client_t * p_self,
90  const access_message_rx_meta_t * p_meta,
92 
100 typedef void (*light_lc_property_state_status_cb_t)(const light_lc_client_t * p_self,
101  const access_message_rx_meta_t * p_meta,
102  const light_lc_property_status_params_t * p_in);
103 
104 
105 typedef struct
106 {
118 
122 typedef struct
123 {
127  uint32_t timeout;
134 
138 
139 typedef union
140 {
147 
149 {
154  /* Acknowledged message context variable */
155  access_reliable_t access_message;
156 
159 };
160 
180 uint32_t light_lc_client_init(light_lc_client_t * p_client, uint8_t element_index);
181 
200 uint32_t light_lc_client_mode_set(light_lc_client_t * p_client,
201  const light_lc_mode_set_params_t * p_params);
202 
223 uint32_t light_lc_client_mode_set_unack(light_lc_client_t * p_client,
224  const light_lc_mode_set_params_t * p_params,
225  uint8_t repeats);
226 
245 uint32_t light_lc_client_occupancy_mode_set(light_lc_client_t * p_client,
246  const light_lc_occupancy_mode_set_params_t * p_params);
247 
268 uint32_t light_lc_client_occupancy_mode_set_unack(light_lc_client_t * p_client,
269  const light_lc_occupancy_mode_set_params_t * p_params,
270  uint8_t repeats);
271 
291 uint32_t light_lc_client_light_onoff_set(light_lc_client_t * p_client,
292  const light_lc_light_onoff_set_params_t * p_params,
293  const model_transition_t * p_transition);
294 
316 uint32_t light_lc_client_light_onoff_set_unack(light_lc_client_t * p_client,
317  const light_lc_light_onoff_set_params_t * p_params,
318  const model_transition_t * p_transition, uint8_t repeats);
319 
339 uint32_t light_lc_client_property_set(light_lc_client_t * p_client,
340  const light_lc_property_set_params_t * p_params);
341 
363 uint32_t light_lc_client_property_set_unack(light_lc_client_t * p_client,
364  const light_lc_property_set_params_t * p_params,
365  uint8_t repeats);
366 
383 uint32_t light_lc_client_mode_get(light_lc_client_t * p_client);
384 
401 uint32_t light_lc_client_occupancy_mode_get(light_lc_client_t * p_client);
402 
419 uint32_t light_lc_client_light_onoff_get(light_lc_client_t * p_client);
420 
438 uint32_t light_lc_client_property_get(light_lc_client_t * p_client, const light_lc_property_get_params_t * p_params);
439 
441 #endif /* LIGHT_LC_CLIENT_H__ */
uint32_t light_lc_client_mode_set_unack(light_lc_client_t *p_client, const light_lc_mode_set_params_t *p_params, uint8_t repeats)
Sends a Mode Set Unacknowledged message to the server.
uint32_t light_lc_client_occupancy_mode_get(light_lc_client_t *p_client)
Sends a Occupancy Mode Get message to the server.
Packed message structure typedefs are used for packing and unpacking byte stream. ...
uint16_t access_model_handle_t
Access layer handle type.
Definition: access.h:162
const light_lc_client_callbacks_t * p_callbacks
Callback list.
access_model_handle_t model_handle
Model handle assigned to this instance.
uint32_t timeout
Reliable message timeout in microseconds.
light_lc_property_set_msg_pkt_t property_set
Storage for the Light LC Property Set message.
uint32_t light_lc_client_occupancy_mode_set(light_lc_client_t *p_client, const light_lc_occupancy_mode_set_params_t *p_params)
Sends a Occupancy Mode Set message to the server.
uint32_t light_lc_client_mode_get(light_lc_client_t *p_client)
Sends a Mode Get message to the server.
void(* light_lc_mode_state_status_cb_t)(const light_lc_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lc_mode_status_params_t *p_in)
Callback type for mode state related transactions.
light_lc_property_state_status_cb_t lc_property_status_cb
Callback for the Light LC Property Status message.
Parameters for the Light LC Property Status message.
User provided settings and callbacks for the model instance.
Message format for the Light LC Occupancy Mode set message.
uint32_t light_lc_client_property_set_unack(light_lc_client_t *p_client, const light_lc_property_set_params_t *p_params, uint8_t repeats)
Sends a Property Set Unacknowledged message to the server.
Parameters for the Light LC Light OnOff Status message.
light_lc_light_onoff_set_msg_pkt_t light_onoff_set
Storage for the Light LC Light OnOff Set message.
void(* access_publish_timeout_cb_t)(access_model_handle_t handle, void *p_args)
Access layer publish timeout event callback.
Definition: access.h:170
Parameters for the Light LC Occupancy Mode Status message.
Message format for the Light LC Occupancy Mode set message.
access_reliable_cb_t ack_transaction_status_cb
Callback to call after the acknowledged transaction has ended.
light_lc_property_get_msg_pkt_t property_get
Storage for the Light LC Property Get message.
light_lc_light_onoff_state_status_cb_t lc_light_onoff_status_cb
Callback for the Light LC Light OnOff Status message.
Message format for the Light LC Light OnOff set message.
Parameters for the Light LC Mode Status message.
uint32_t light_lc_client_light_onoff_set(light_lc_client_t *p_client, const light_lc_light_onoff_set_params_t *p_params, const model_transition_t *p_transition)
Sends a Light OnOff Set message to the server.
void(* light_lc_occupancy_mode_state_status_cb_t)(const light_lc_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lc_occupancy_mode_status_params_t *p_in)
Callback type for occupancy mode state related transactions.
Message format for the Light LC Property set message.
void(* light_lc_light_onoff_state_status_cb_t)(const light_lc_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lc_light_onoff_status_params_t *p_in)
Callback type for light onoff state related transactions.
uint32_t light_lc_client_light_onoff_set_unack(light_lc_client_t *p_client, const light_lc_light_onoff_set_params_t *p_params, const model_transition_t *p_transition, uint8_t repeats)
Sends a Light OnOff Set Unacknowledged message to the server.
Message format for the Light LC Property set message.
light_lc_occupancy_mode_set_msg_pkt_t occupancy_mode_set
Storage for the Light LC Occupancy Mode Set message.
uint32_t light_lc_client_init(light_lc_client_t *p_client, uint8_t element_index)
Initializes Light LC client.
light_lc_client_msg_data_t msg_pkt
Holds the raw message packet data for transactions.
light_lc_client_settings_t settings
Model settings and callbacks for this instance.
Unpacked message structure typedefs are used for API interfaces and for implementing model code...
Message format for the Light LC Property get message.
Message format for the Light LC Property get message.
uint32_t light_lc_client_light_onoff_get(light_lc_client_t *p_client)
Sends a Light OnOff Get message to the server.
Metadata for received messages.
Definition: access.h:196
light_lc_mode_set_msg_pkt_t mode_set
Storage for the Light LC Mode Set message.
Access layer acknowledged publish parameter structure.
nrf_mesh_transmic_size_t
Message MIC size selection.
Definition: nrf_mesh.h:385
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.
light_lc_mode_state_status_cb_t lc_mode_status_cb
Client model response message callback.
access_publish_timeout_cb_t periodic_publish_cb
callback called at the end of the each period for the publishing
nrf_mesh_transmic_size_t transmic_size
TransMIC size used by the outgoing server messages.
uint32_t light_lc_client_mode_set(light_lc_client_t *p_client, const light_lc_mode_set_params_t *p_params)
Sends a Mode Set message to the server.
uint32_t light_lc_client_occupancy_mode_set_unack(light_lc_client_t *p_client, const light_lc_occupancy_mode_set_params_t *p_params, uint8_t repeats)
Sends a Occupancy Mode Set Unacknowledged message to the server.
uint32_t light_lc_client_property_set(light_lc_client_t *p_client, const light_lc_property_set_params_t *p_params)
Sends a Property Set message to the server.
bool force_segmented
If server should force outgoing messages as segmented messages.
Generic Transition parameters for the model messages.
Definition: model_common.h:162
uint32_t light_lc_client_property_get(light_lc_client_t *p_client, const light_lc_property_get_params_t *p_params)
Sends a Property Get message to the server.
Message format for the Light LC Light OnOff set message.
void(* light_lc_property_state_status_cb_t)(const light_lc_client_t *p_self, const access_message_rx_meta_t *p_meta, const light_lc_property_status_params_t *p_in)
Callback type for property state related transactions.
light_lc_occupancy_mode_state_status_cb_t lc_occupancy_mode_status_cb
Callback for the Light LC Occupancy Mode Status message.

Documentation feedback | Developer Zone | Subscribe | Updated