xref: /btstack/src/mesh/mesh_iv_index_seq_number.h (revision 2fca4dad957cd7b88f4657ed51e89c12615dda72)
1f4854a5eSMatthias Ringwald /*
2f4854a5eSMatthias Ringwald  * Copyright (C) 2019 BlueKitchen GmbH
3f4854a5eSMatthias Ringwald  *
4f4854a5eSMatthias Ringwald  * Redistribution and use in source and binary forms, with or without
5f4854a5eSMatthias Ringwald  * modification, are permitted provided that the following conditions
6f4854a5eSMatthias Ringwald  * are met:
7f4854a5eSMatthias Ringwald  *
8f4854a5eSMatthias Ringwald  * 1. Redistributions of source code must retain the above copyright
9f4854a5eSMatthias Ringwald  *    notice, this list of conditions and the following disclaimer.
10f4854a5eSMatthias Ringwald  * 2. Redistributions in binary form must reproduce the above copyright
11f4854a5eSMatthias Ringwald  *    notice, this list of conditions and the following disclaimer in the
12f4854a5eSMatthias Ringwald  *    documentation and/or other materials provided with the distribution.
13f4854a5eSMatthias Ringwald  * 3. Neither the name of the copyright holders nor the names of
14f4854a5eSMatthias Ringwald  *    contributors may be used to endorse or promote products derived
15f4854a5eSMatthias Ringwald  *    from this software without specific prior written permission.
16f4854a5eSMatthias Ringwald  * 4. Any redistribution, use, or modification is done solely for
17f4854a5eSMatthias Ringwald  *    personal benefit and not for any commercial purpose or for
18f4854a5eSMatthias Ringwald  *    monetary gain.
19f4854a5eSMatthias Ringwald  *
20f4854a5eSMatthias Ringwald  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21f4854a5eSMatthias Ringwald  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22f4854a5eSMatthias Ringwald  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23*2fca4dadSMilanka Ringwald  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN
24*2fca4dadSMilanka Ringwald  * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25f4854a5eSMatthias Ringwald  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26f4854a5eSMatthias Ringwald  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27f4854a5eSMatthias Ringwald  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28f4854a5eSMatthias Ringwald  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29f4854a5eSMatthias Ringwald  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30f4854a5eSMatthias Ringwald  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31f4854a5eSMatthias Ringwald  * SUCH DAMAGE.
32f4854a5eSMatthias Ringwald  *
33f4854a5eSMatthias Ringwald  * Please inquire about commercial licensing options at
34f4854a5eSMatthias Ringwald  * [email protected]
35f4854a5eSMatthias Ringwald  *
36f4854a5eSMatthias Ringwald  */
37f4854a5eSMatthias Ringwald 
38f4854a5eSMatthias Ringwald #ifndef __MESH_IV_INDEX_SEQ_NUMBER_H
39f4854a5eSMatthias Ringwald #define __MESH_IV_INDEX_SEQ_NUMBER_H
40f4854a5eSMatthias Ringwald 
41f4854a5eSMatthias Ringwald #include <stdint.h>
42f4854a5eSMatthias Ringwald 
43f4854a5eSMatthias Ringwald #ifdef __cplusplus
44f4854a5eSMatthias Ringwald extern "C"
45f4854a5eSMatthias Ringwald {
46f4854a5eSMatthias Ringwald #endif
47f4854a5eSMatthias Ringwald 
48f4854a5eSMatthias Ringwald /**
49f4854a5eSMatthias Ringwald  * IV Index
50f4854a5eSMatthias Ringwald  */
51f4854a5eSMatthias Ringwald 
52f4854a5eSMatthias Ringwald void     mesh_set_iv_index(uint32_t iv_index);
53f4854a5eSMatthias Ringwald uint32_t mesh_get_iv_index(void);
54f4854a5eSMatthias Ringwald 
55f4854a5eSMatthias Ringwald uint32_t mesh_get_iv_index_for_tx(void);
56f4854a5eSMatthias Ringwald 
57f4854a5eSMatthias Ringwald /**
58f4854a5eSMatthias Ringwald  * @brief Get IV Update state
59f4854a5eSMatthias Ringwald  */
60f4854a5eSMatthias Ringwald int mesh_iv_update_active(void);
61f4854a5eSMatthias Ringwald 
62f4854a5eSMatthias Ringwald /**
63f4854a5eSMatthias Ringwald  * @brief Trigger IV Update
64f4854a5eSMatthias Ringwald  */
65f4854a5eSMatthias Ringwald void mesh_trigger_iv_update(void);
66f4854a5eSMatthias Ringwald 
67f4854a5eSMatthias Ringwald /**
68f4854a5eSMatthias Ringwald  * @breif IV update was completed
69f4854a5eSMatthias Ringwald  */
70f4854a5eSMatthias Ringwald void mesh_iv_update_completed(void);
71f4854a5eSMatthias Ringwald 
72f4854a5eSMatthias Ringwald /**
73f4854a5eSMatthias Ringwald  * @brief IV Index was recovered
74f4854a5eSMatthias Ringwald  * @param iv_update_active
75f4854a5eSMatthias Ringwald  * @param iv_index
76f4854a5eSMatthias Ringwald  */
77f4854a5eSMatthias Ringwald void mesh_iv_index_recovered(uint8_t iv_update_active, uint32_t iv_index);
78f4854a5eSMatthias Ringwald 
79f4854a5eSMatthias Ringwald /**
80f4854a5eSMatthias Ringwald  * @brief Set callback for sequence number update
81f4854a5eSMatthias Ringwald  */
82f4854a5eSMatthias Ringwald void mesh_sequence_number_set_update_callback(void (*callback)(void));
83f4854a5eSMatthias Ringwald 
84f4854a5eSMatthias Ringwald /**
85f4854a5eSMatthias Ringwald  * Sequence Number
86f4854a5eSMatthias Ringwald  */
87f4854a5eSMatthias Ringwald void     mesh_sequence_number_set(uint32_t seq);
88f4854a5eSMatthias Ringwald uint32_t mesh_sequence_number_peek(void);
89f4854a5eSMatthias Ringwald uint32_t mesh_sequence_number_next(void);
90f4854a5eSMatthias Ringwald 
91f4854a5eSMatthias Ringwald 
92f4854a5eSMatthias Ringwald #ifdef __cplusplus
93f4854a5eSMatthias Ringwald } /* end of extern "C" */
94f4854a5eSMatthias Ringwald #endif
95f4854a5eSMatthias Ringwald 
96f4854a5eSMatthias Ringwald #endif
97