xref: /btstack/src/mesh/mesh.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_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 
7241787a59SMatthias Ringwald // Mesh Model Subscriptions
7341787a59SMatthias Ringwald void mesh_load_subscriptions(void);
7441787a59SMatthias Ringwald void mesh_model_store_subscriptions(mesh_model_t * model);
7541787a59SMatthias Ringwald void mesh_delete_subscriptions(void);
7641787a59SMatthias Ringwald 
77d4c397cdSMatthias Ringwald // Mesh Model Publication
78d4c397cdSMatthias Ringwald void mesh_load_publications(void);
79d4c397cdSMatthias Ringwald void mesh_delete_publications(void);
80d4c397cdSMatthias Ringwald void mesh_model_store_publication(mesh_model_t * mesh_model);
81d4c397cdSMatthias Ringwald 
8266380807SMatthias Ringwald // Mesh NetKey List
8366380807SMatthias Ringwald void mesh_store_network_key(mesh_network_key_t * network_key);
8466380807SMatthias Ringwald void mesh_delete_network_key(uint16_t internal_index);
8566380807SMatthias Ringwald void mesh_delete_network_keys(void);
8666380807SMatthias Ringwald void mesh_load_network_keys(void);
8766380807SMatthias Ringwald 
8868d9ac23SMatthias Ringwald // Mesh Appkeys
8968d9ac23SMatthias Ringwald void mesh_store_app_key(mesh_transport_key_t * app_key);
9068d9ac23SMatthias Ringwald void mesh_delete_app_key(uint16_t internal_index);
9168d9ac23SMatthias Ringwald void mesh_delete_app_keys(void);
9268d9ac23SMatthias Ringwald void mesh_load_app_keys(void);
9368d9ac23SMatthias Ringwald 
94726dac53SMatthias Ringwald // Mesh Model to Appkey List
95726dac53SMatthias Ringwald void mesh_load_appkey_lists(void);
96726dac53SMatthias Ringwald void mesh_delete_appkey_lists(void);
97726dac53SMatthias Ringwald uint8_t mesh_model_bind_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
98726dac53SMatthias Ringwald void mesh_model_unbind_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
99726dac53SMatthias Ringwald int mesh_model_contains_appkey(mesh_model_t * mesh_model, uint16_t appkey_index);
100726dac53SMatthias Ringwald 
1018caec89aSMatthias Ringwald // Mesh Node Reset
102aa1e3c72SMatthias Ringwald void mesh_node_reset(void);
103aa1e3c72SMatthias Ringwald 
1040728b042SMatthias Ringwald // Attention Timer
1050728b042SMatthias Ringwald void    mesh_attention_timer_set(uint8_t timer_s);
1060728b042SMatthias Ringwald uint8_t mesh_attention_timer_get(void);
1070728b042SMatthias Ringwald 
1089d29a5e2SMatthias Ringwald // temp
109a0253209SMatthias Ringwald void mesh_access_key_refresh_revoke_keys(mesh_subnet_t * subnet);
110a0253209SMatthias Ringwald void mesh_access_netkey_finalize(mesh_network_key_t * network_key);
111a0253209SMatthias Ringwald void mesh_access_appkey_finalize(mesh_transport_key_t * transport_key);
1129d29a5e2SMatthias Ringwald 
113f4854a5eSMatthias Ringwald #if defined __cplusplus
114f4854a5eSMatthias Ringwald }
115f4854a5eSMatthias Ringwald #endif
116f4854a5eSMatthias Ringwald 
117f4854a5eSMatthias Ringwald #endif //__MESH_H
118