xref: /btstack/src/mesh/mesh.h (revision 8caec89a372214e3cc77b845a321cf3304f2ad8b)
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
23f4854a5eSMatthias Ringwald  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24f4854a5eSMatthias Ringwald  * RINGWALD 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_H
39f4854a5eSMatthias Ringwald #define __MESH_H
40f4854a5eSMatthias Ringwald 
41f4854a5eSMatthias Ringwald #include "btstack_defines.h"
429d29a5e2SMatthias Ringwald #include "mesh/provisioning.h"
4366380807SMatthias Ringwald #include "mesh/mesh_keys.h"
44726dac53SMatthias Ringwald #include "mesh/mesh_access.h"
45380f8b85SMatthias Ringwald #include "mesh/mesh_virtual_addresses.h"
46f4854a5eSMatthias Ringwald 
47f4854a5eSMatthias Ringwald #if defined __cplusplus
48f4854a5eSMatthias Ringwald extern "C" {
49f4854a5eSMatthias Ringwald #endif
50f4854a5eSMatthias Ringwald 
51f4854a5eSMatthias Ringwald /**
52f4854a5eSMatthias Ringwald  * Init Mesh network stack
53f4854a5eSMatthias Ringwald  */
54f4854a5eSMatthias Ringwald void mesh_init(void);
55f4854a5eSMatthias Ringwald 
56f4854a5eSMatthias Ringwald /**
57f4854a5eSMatthias Ringwald  * Register for Mesh Provisioning Device events
58f4854a5eSMatthias Ringwald  * @param packet_handler
59f4854a5eSMatthias Ringwald  */
60f4854a5eSMatthias Ringwald void mesh_register_provisioning_device_packet_handler(btstack_packet_handler_t packet_handler);
61f4854a5eSMatthias Ringwald 
62380f8b85SMatthias Ringwald // Mesh Virtual Address Management
63380f8b85SMatthias Ringwald void mesh_load_virtual_addresses(void);
64380f8b85SMatthias Ringwald void mesh_delete_virtual_addresses(void);
65380f8b85SMatthias Ringwald void mesh_virtual_address_decrease_refcount(mesh_virtual_address_t * virtual_address);
66380f8b85SMatthias Ringwald void mesh_virtual_address_increase_refcount(mesh_virtual_address_t * virtual_address);
67380f8b85SMatthias Ringwald 
68a55e84a9SMatthias Ringwald // Foundation state
69a55e84a9SMatthias Ringwald void mesh_foundation_state_load(void);
70a55e84a9SMatthias Ringwald void mesh_foundation_state_store(void);
71a55e84a9SMatthias Ringwald 
72a0253209SMatthias Ringwald // Mesh IV Index and sequence number
73a0253209SMatthias Ringwald void mesh_store_iv_index_after_provisioning(uint32_t iv_index);
74a0253209SMatthias Ringwald void mesh_store_iv_index_and_sequence_number(void);
75a0253209SMatthias Ringwald int mesh_load_iv_index_and_sequence_number(uint32_t * iv_index, uint32_t * sequence_number);
76a0253209SMatthias Ringwald 
7741787a59SMatthias Ringwald // Mesh Model Subscriptions
7841787a59SMatthias Ringwald void mesh_load_subscriptions(void);
7941787a59SMatthias Ringwald void mesh_model_store_subscriptions(mesh_model_t * model);
8041787a59SMatthias Ringwald void mesh_delete_subscriptions(void);
8141787a59SMatthias Ringwald 
82d4c397cdSMatthias Ringwald // Mesh Model Publication
83d4c397cdSMatthias Ringwald void mesh_load_publications(void);
84d4c397cdSMatthias Ringwald void mesh_delete_publications(void);
85d4c397cdSMatthias Ringwald void mesh_model_store_publication(mesh_model_t * mesh_model);
86d4c397cdSMatthias Ringwald 
8766380807SMatthias Ringwald // Mesh NetKey List
8866380807SMatthias Ringwald void mesh_store_network_key(mesh_network_key_t * network_key);
8966380807SMatthias Ringwald void mesh_delete_network_key(uint16_t internal_index);
9066380807SMatthias Ringwald void mesh_delete_network_keys(void);
9166380807SMatthias Ringwald void mesh_load_network_keys(void);
9266380807SMatthias Ringwald 
9368d9ac23SMatthias Ringwald // Mesh Appkeys
9468d9ac23SMatthias Ringwald void mesh_store_app_key(mesh_transport_key_t * app_key);
9568d9ac23SMatthias Ringwald void mesh_delete_app_key(uint16_t internal_index);
9668d9ac23SMatthias Ringwald void mesh_delete_app_keys(void);
9768d9ac23SMatthias Ringwald void mesh_load_app_keys(void);
9868d9ac23SMatthias Ringwald 
99726dac53SMatthias Ringwald // Mesh Model to Appkey List
100726dac53SMatthias Ringwald void mesh_load_appkey_lists(void);
101726dac53SMatthias Ringwald void mesh_delete_appkey_lists(void);
102726dac53SMatthias Ringwald void mesh_model_reset_appkeys(mesh_model_t * mesh_model);
103726dac53SMatthias Ringwald uint8_t mesh_model_bind_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
104726dac53SMatthias Ringwald void mesh_model_unbind_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
105726dac53SMatthias Ringwald int mesh_model_contains_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
106726dac53SMatthias Ringwald 
107*8caec89aSMatthias Ringwald // Mesh Node Reset
108aa1e3c72SMatthias Ringwald void mesh_node_reset(void);
109aa1e3c72SMatthias Ringwald 
1109d29a5e2SMatthias Ringwald // temp
111a0253209SMatthias Ringwald void mesh_access_key_refresh_revoke_keys(mesh_subnet_t * subnet);
112a0253209SMatthias Ringwald void mesh_access_netkey_finalize(mesh_network_key_t * network_key);
113a0253209SMatthias Ringwald void mesh_access_appkey_finalize(mesh_transport_key_t * transport_key);
1149d29a5e2SMatthias Ringwald 
115f4854a5eSMatthias Ringwald #if defined __cplusplus
116f4854a5eSMatthias Ringwald }
117f4854a5eSMatthias Ringwald #endif
118f4854a5eSMatthias Ringwald 
119f4854a5eSMatthias Ringwald #endif //__MESH_H
120