1 /* 2 * Copyright (C) 2018 BlueKitchen GmbH 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. Neither the name of the copyright holders nor the names of 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 4. Any redistribution, use, or modification is done solely for 17 * personal benefit and not for any commercial purpose or for 18 * monetary gain. 19 * 20 * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 23 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS 24 * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 27 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 30 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 * 33 * Please inquire about commercial licensing options at 34 * [email protected] 35 * 36 */ 37 38 #ifndef __MESH_TRANSPORT_H 39 #define __MESH_TRANSPORT_H 40 41 #include <stdint.h> 42 43 #include "mesh/mesh_network.h" 44 #include "mesh/mesh_lower_transport.h" 45 46 #ifdef __cplusplus 47 extern "C" 48 { 49 #endif 50 51 // upper transport message builder 52 typedef struct { 53 mesh_upper_transport_pdu_t * pdu; 54 mesh_network_pdu_t * segment; 55 } mesh_upper_transport_builder_t; 56 57 /* 58 * @brief reserve 1 x mesh_upper_transport_pdu_t and 14 x mesh_network_pdu_t to allow composition of max access/control message 59 * @returns true if enough buffer allocated 60 */ 61 bool mesh_upper_transport_message_reserve(void); 62 63 /* 64 * @brief init message builder for unsegmented access, segmented access, and segmented control messages 65 * @note uses buffers reserved by mesh_upper_transport_message_reserve 66 */ 67 void mesh_upper_transport_message_init(mesh_upper_transport_builder_t * builder, mesh_pdu_type_t pdu_type); 68 69 /** 70 * @brief append data to message 71 * @param builder 72 * @param data 73 * @param data_len 74 */ 75 void mesh_upper_transport_message_add_data(mesh_upper_transport_builder_t * builder, const uint8_t * data, uint16_t data_len); 76 77 /** 78 * @brief append single byte 79 * @param builder 80 * @param value 81 */ 82 void mesh_upper_transport_message_add_uint8(mesh_upper_transport_builder_t * builder, uint8_t value); 83 /** 84 * @brief append uint16 85 * @param builder 86 * @param value 87 */ 88 void mesh_upper_transport_message_add_uint16(mesh_upper_transport_builder_t * builder, uint16_t value); 89 /** 90 * @brief append uint24 91 * @param builder 92 * @param value 93 */ 94 void mesh_upper_transport_message_add_uint24(mesh_upper_transport_builder_t * builder, uint16_t value); 95 /** 96 * @brief append uint32 97 * @param builder 98 * @param value 99 */ 100 void mesh_upper_transport_message_add_uint32(mesh_upper_transport_builder_t * builder, uint16_t value); 101 /** 102 * @brief finalize message 103 * @param builder 104 * @returns upper_transport_pdu if message was successfully constructed 105 */ 106 mesh_upper_transport_pdu_t * mesh_upper_transport_message_finalize(mesh_upper_transport_builder_t * builder); 107 108 /** 109 * @brief Initialize Upper Transport Layer 110 */ 111 void mesh_upper_transport_init(void); 112 113 /** 114 * @brief Register for control messages and events 115 * @param callback 116 */ 117 void mesh_upper_transport_register_control_message_handler(void (*callback)(mesh_transport_callback_type_t callback_type, mesh_transport_status_t status, mesh_pdu_t * pdu)); 118 119 /** 120 * @brief Register for access messages and events 121 * @param callback 122 */ 123 void mesh_upper_transport_register_access_message_handler(void (*callback)(mesh_transport_callback_type_t callback_type, mesh_transport_status_t status, mesh_pdu_t * pdu)); 124 125 /** 126 * @brief Report received PDU as processed 127 * @param pdu 128 * @note pdu cannot be accessed after call 129 */ 130 void mesh_upper_transport_message_processed_by_higher_layer(mesh_pdu_t * pdu); 131 132 /** 133 * @brief Free any PDU type 134 * @param pdu 135 */ 136 void mesh_upper_transport_pdu_free(mesh_pdu_t * pdu); 137 138 // Control PDUs: setup and send 139 140 /** 141 * @brief Setup Unsegmented Control Pdu provided by network_pdu param 142 * @param network_pdu 143 * @param netkey_index 144 * @param ttl 145 * @param src 146 * @param dest 147 * @param opcode 148 * @param control_pdu_data 149 * @param control_pdu_len 150 * @return 0 on success 151 */ 152 uint8_t mesh_upper_transport_setup_unsegmented_control_pdu(mesh_network_pdu_t * network_pdu, uint16_t netkey_index, uint8_t ttl, uint16_t src, uint16_t dest, uint8_t opcode, 153 const uint8_t * control_pdu_data, uint16_t control_pdu_len); 154 155 /** 156 * @brief Setup header of Segmented Control PDU created with mesh_upper_transport_message_finalize 157 * @param upper_pdu 158 * @param netkey_index 159 * @param ttl 160 * @param src 161 * @param dest 162 * @param opcode 163 * @return 0 on success 164 */ 165 uint8_t mesh_upper_transport_setup_segmented_control_pdu_header(mesh_upper_transport_pdu_t * upper_pdu, uint16_t netkey_index, uint8_t ttl, uint16_t src, uint16_t dest, uint8_t opcode); 166 167 /** 168 * @brief Send Control PDU 169 * @param pdu 170 */ 171 void mesh_upper_transport_send_control_pdu(mesh_pdu_t * pdu); 172 173 // Access PDUs: setup and send 174 /** 175 * @brief Setup header of Access PDU created with mesh_upper_transport_message_finalize 176 * @param pdu 177 * @param netkey_index 178 * @param appkey_index 179 * @param ttl 180 * @param src 181 * @param dest 182 * @param szmic 183 * @return 184 */ 185 uint8_t mesh_upper_transport_setup_access_pdu_header(mesh_pdu_t * pdu, uint16_t netkey_index, uint16_t appkey_index, 186 uint8_t ttl, uint16_t src, uint16_t dest, uint8_t szmic); 187 188 /** 189 * @brief Send Access PDU 190 * @param pdu 191 */ 192 void mesh_upper_transport_send_access_pdu(mesh_pdu_t * pdu); 193 194 195 // test 196 void mesh_upper_transport_dump(void); 197 void mesh_upper_transport_reset(void); 198 199 #ifdef __cplusplus 200 } /* end of extern "C" */ 201 #endif 202 203 #endif 204