1746ccb7eSMatthias Ringwald /* 2746ccb7eSMatthias Ringwald * Copyright (C) 2014 BlueKitchen GmbH 3746ccb7eSMatthias Ringwald * 4746ccb7eSMatthias Ringwald * Redistribution and use in source and binary forms, with or without 5746ccb7eSMatthias Ringwald * modification, are permitted provided that the following conditions 6746ccb7eSMatthias Ringwald * are met: 7746ccb7eSMatthias Ringwald * 8746ccb7eSMatthias Ringwald * 1. Redistributions of source code must retain the above copyright 9746ccb7eSMatthias Ringwald * notice, this list of conditions and the following disclaimer. 10746ccb7eSMatthias Ringwald * 2. Redistributions in binary form must reproduce the above copyright 11746ccb7eSMatthias Ringwald * notice, this list of conditions and the following disclaimer in the 12746ccb7eSMatthias Ringwald * documentation and/or other materials provided with the distribution. 13746ccb7eSMatthias Ringwald * 3. Neither the name of the copyright holders nor the names of 14746ccb7eSMatthias Ringwald * contributors may be used to endorse or promote products derived 15746ccb7eSMatthias Ringwald * from this software without specific prior written permission. 16746ccb7eSMatthias Ringwald * 4. Any redistribution, use, or modification is done solely for 17746ccb7eSMatthias Ringwald * personal benefit and not for any commercial purpose or for 18746ccb7eSMatthias Ringwald * monetary gain. 19746ccb7eSMatthias Ringwald * 20746ccb7eSMatthias Ringwald * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS 21746ccb7eSMatthias Ringwald * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22746ccb7eSMatthias Ringwald * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 232fca4dadSMilanka Ringwald * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN 242fca4dadSMilanka Ringwald * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25746ccb7eSMatthias Ringwald * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26746ccb7eSMatthias Ringwald * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 27746ccb7eSMatthias Ringwald * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28746ccb7eSMatthias Ringwald * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29746ccb7eSMatthias Ringwald * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 30746ccb7eSMatthias Ringwald * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31746ccb7eSMatthias Ringwald * SUCH DAMAGE. 32746ccb7eSMatthias Ringwald * 33746ccb7eSMatthias Ringwald * Please inquire about commercial licensing options at 34746ccb7eSMatthias Ringwald * [email protected] 35746ccb7eSMatthias Ringwald * 36746ccb7eSMatthias Ringwald */ 37746ccb7eSMatthias Ringwald 38e501bae0SMatthias Ringwald #define BTSTACK_FILE__ "sdp_server.c" 39ab2c6ae4SMatthias Ringwald 40746ccb7eSMatthias Ringwald /* 41746ccb7eSMatthias Ringwald * Implementation of the Service Discovery Protocol Server 42746ccb7eSMatthias Ringwald */ 43746ccb7eSMatthias Ringwald 44746ccb7eSMatthias Ringwald #include <string.h> 45746ccb7eSMatthias Ringwald 4603751aa7SMatthias Ringwald #include "bluetooth.h" 4784e3541eSMilanka Ringwald #include "bluetooth_psm.h" 48235946f1SMatthias Ringwald #include "bluetooth_sdp.h" 49746ccb7eSMatthias Ringwald #include "btstack_debug.h" 500e2df43fSMatthias Ringwald #include "btstack_event.h" 5159c6af15SMatthias Ringwald #include "btstack_memory.h" 5259c6af15SMatthias Ringwald #include "classic/core.h" 53746ccb7eSMatthias Ringwald #include "classic/sdp_server.h" 54746ccb7eSMatthias Ringwald #include "classic/sdp_util.h" 5503751aa7SMatthias Ringwald #include "hci.h" 5684e3541eSMilanka Ringwald #include "hci_dump.h" 5759c6af15SMatthias Ringwald #include "l2cap.h" 58746ccb7eSMatthias Ringwald 597616f654SMatthias Ringwald // max number of incoming l2cap connections that can be queued instead of getting rejected 607616f654SMatthias Ringwald #ifndef SDP_WAITING_LIST_MAX_COUNT 617616f654SMatthias Ringwald #define SDP_WAITING_LIST_MAX_COUNT 8 627616f654SMatthias Ringwald #endif 637616f654SMatthias Ringwald 64746ccb7eSMatthias Ringwald // max reserved ServiceRecordHandle 65f20b4214SMatthias Ringwald #define MAX_RESERVED_SERVICE_RECORD_HANDLE 0xffff 66746ccb7eSMatthias Ringwald 67746ccb7eSMatthias Ringwald // max SDP response matches L2CAP PDU -- allow to use smaller buffer 68746ccb7eSMatthias Ringwald #ifndef SDP_RESPONSE_BUFFER_SIZE 6903751aa7SMatthias Ringwald #define SDP_RESPONSE_BUFFER_SIZE (HCI_ACL_PAYLOAD_SIZE-L2CAP_HEADER_SIZE) 70746ccb7eSMatthias Ringwald #endif 71746ccb7eSMatthias Ringwald 72746ccb7eSMatthias Ringwald static void sdp_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size); 73746ccb7eSMatthias Ringwald 74746ccb7eSMatthias Ringwald // registered service records 75f20b4214SMatthias Ringwald static btstack_linked_list_t sdp_server_service_records; 76746ccb7eSMatthias Ringwald 77746ccb7eSMatthias Ringwald // our handles start after the reserved range 78f20b4214SMatthias Ringwald static uint32_t sdp_server_next_service_record_handle; 79746ccb7eSMatthias Ringwald 80746ccb7eSMatthias Ringwald static uint8_t sdp_response_buffer[SDP_RESPONSE_BUFFER_SIZE]; 81746ccb7eSMatthias Ringwald 82f20b4214SMatthias Ringwald static uint16_t sdp_server_l2cap_cid; 83f20b4214SMatthias Ringwald static uint16_t sdp_server_response_size; 84f20b4214SMatthias Ringwald static uint16_t sdp_server_l2cap_waiting_list_cids[SDP_WAITING_LIST_MAX_COUNT]; 85f20b4214SMatthias Ringwald static int sdp_server_l2cap_waiting_list_count; 86746ccb7eSMatthias Ringwald 87746ccb7eSMatthias Ringwald void sdp_init(void){ 88f20b4214SMatthias Ringwald sdp_server_next_service_record_handle = ((uint32_t) MAX_RESERVED_SERVICE_RECORD_HANDLE) + 2; 89746ccb7eSMatthias Ringwald // register with l2cap psm sevices - max MTU 9084e3541eSMilanka Ringwald l2cap_register_service(sdp_packet_handler, BLUETOOTH_PSM_SDP, 0xffff, LEVEL_0); 910396d6ccSMatthias Ringwald } 920396d6ccSMatthias Ringwald 930396d6ccSMatthias Ringwald void sdp_deinit(void){ 94f20b4214SMatthias Ringwald sdp_server_service_records = NULL; 95f20b4214SMatthias Ringwald sdp_server_l2cap_cid = 0; 96f20b4214SMatthias Ringwald sdp_server_response_size = 0; 97f20b4214SMatthias Ringwald sdp_server_l2cap_waiting_list_count = 0; 98746ccb7eSMatthias Ringwald } 99746ccb7eSMatthias Ringwald 100746ccb7eSMatthias Ringwald uint32_t sdp_get_service_record_handle(const uint8_t * record){ 101746ccb7eSMatthias Ringwald // TODO: make sdp_get_attribute_value_for_attribute_id accept const data to remove cast 102235946f1SMatthias Ringwald uint8_t * serviceRecordHandleAttribute = sdp_get_attribute_value_for_attribute_id((uint8_t *)record, BLUETOOTH_ATTRIBUTE_SERVICE_RECORD_HANDLE); 103746ccb7eSMatthias Ringwald if (!serviceRecordHandleAttribute) return 0; 104746ccb7eSMatthias Ringwald if (de_get_element_type(serviceRecordHandleAttribute) != DE_UINT) return 0; 105746ccb7eSMatthias Ringwald if (de_get_size_type(serviceRecordHandleAttribute) != DE_SIZE_32) return 0; 106c9b8fdd9SMatthias Ringwald return big_endian_read_32(serviceRecordHandleAttribute, 1); 107746ccb7eSMatthias Ringwald } 108746ccb7eSMatthias Ringwald 109746ccb7eSMatthias Ringwald static service_record_item_t * sdp_get_record_item_for_handle(uint32_t handle){ 110746ccb7eSMatthias Ringwald btstack_linked_item_t *it; 111f20b4214SMatthias Ringwald for (it = (btstack_linked_item_t *) sdp_server_service_records; it ; it = it->next){ 112746ccb7eSMatthias Ringwald service_record_item_t * item = (service_record_item_t *) it; 113746ccb7eSMatthias Ringwald if (item->service_record_handle == handle){ 114746ccb7eSMatthias Ringwald return item; 115746ccb7eSMatthias Ringwald } 116746ccb7eSMatthias Ringwald } 117746ccb7eSMatthias Ringwald return NULL; 118746ccb7eSMatthias Ringwald } 119746ccb7eSMatthias Ringwald 120746ccb7eSMatthias Ringwald uint8_t * sdp_get_record_for_handle(uint32_t handle){ 121746ccb7eSMatthias Ringwald service_record_item_t * record_item = sdp_get_record_item_for_handle(handle); 1226e791780SMatthias Ringwald if (!record_item) return NULL; 123746ccb7eSMatthias Ringwald return record_item->service_record; 124746ccb7eSMatthias Ringwald } 125746ccb7eSMatthias Ringwald 126746ccb7eSMatthias Ringwald // get next free, unregistered service record handle 127746ccb7eSMatthias Ringwald uint32_t sdp_create_service_record_handle(void){ 128746ccb7eSMatthias Ringwald uint32_t handle = 0; 129746ccb7eSMatthias Ringwald do { 130f20b4214SMatthias Ringwald handle = sdp_server_next_service_record_handle++; 131746ccb7eSMatthias Ringwald if (sdp_get_record_item_for_handle(handle)) handle = 0; 132746ccb7eSMatthias Ringwald } while (handle == 0); 133746ccb7eSMatthias Ringwald return handle; 134746ccb7eSMatthias Ringwald } 135746ccb7eSMatthias Ringwald 136746ccb7eSMatthias Ringwald /** 137746ccb7eSMatthias Ringwald * @brief Register Service Record with database using ServiceRecordHandle stored in record 138746ccb7eSMatthias Ringwald * @pre AttributeIDs are in ascending order 139746ccb7eSMatthias Ringwald * @pre ServiceRecordHandle is first attribute and valid 140746ccb7eSMatthias Ringwald * @param record is not copied! 141746ccb7eSMatthias Ringwald * @result status 142746ccb7eSMatthias Ringwald */ 143746ccb7eSMatthias Ringwald uint8_t sdp_register_service(const uint8_t * record){ 144746ccb7eSMatthias Ringwald 145746ccb7eSMatthias Ringwald // validate service record handle. it must: exist, be in valid range, not have been already used 146746ccb7eSMatthias Ringwald uint32_t record_handle = sdp_get_service_record_handle(record); 147746ccb7eSMatthias Ringwald if (!record_handle) return SDP_HANDLE_INVALID; 148f20b4214SMatthias Ringwald if (record_handle <= MAX_RESERVED_SERVICE_RECORD_HANDLE) return SDP_HANDLE_INVALID; 149746ccb7eSMatthias Ringwald if (sdp_get_record_item_for_handle(record_handle)) return SDP_HANDLE_ALREADY_REGISTERED; 150746ccb7eSMatthias Ringwald 151746ccb7eSMatthias Ringwald // alloc memory for new service_record_item 152746ccb7eSMatthias Ringwald service_record_item_t * newRecordItem = btstack_memory_service_record_item_get(); 153746ccb7eSMatthias Ringwald if (!newRecordItem) return BTSTACK_MEMORY_ALLOC_FAILED; 154746ccb7eSMatthias Ringwald 155746ccb7eSMatthias Ringwald // set handle and record 156746ccb7eSMatthias Ringwald newRecordItem->service_record_handle = record_handle; 157746ccb7eSMatthias Ringwald newRecordItem->service_record = (uint8_t*) record; 158746ccb7eSMatthias Ringwald 159746ccb7eSMatthias Ringwald // add to linked list 160f20b4214SMatthias Ringwald btstack_linked_list_add(&sdp_server_service_records, (btstack_linked_item_t *) newRecordItem); 161746ccb7eSMatthias Ringwald 162746ccb7eSMatthias Ringwald return 0; 163746ccb7eSMatthias Ringwald } 164746ccb7eSMatthias Ringwald 165746ccb7eSMatthias Ringwald // 166746ccb7eSMatthias Ringwald // unregister service record 167746ccb7eSMatthias Ringwald // 168746ccb7eSMatthias Ringwald void sdp_unregister_service(uint32_t service_record_handle){ 169746ccb7eSMatthias Ringwald service_record_item_t * record_item = sdp_get_record_item_for_handle(service_record_handle); 170746ccb7eSMatthias Ringwald if (!record_item) return; 171f20b4214SMatthias Ringwald btstack_linked_list_remove(&sdp_server_service_records, (btstack_linked_item_t *) record_item); 172c0a6fc5dSMatthias Ringwald btstack_memory_service_record_item_free(record_item); 173746ccb7eSMatthias Ringwald } 174746ccb7eSMatthias Ringwald 175746ccb7eSMatthias Ringwald // PDU 176746ccb7eSMatthias Ringwald // PDU ID (1), Transaction ID (2), Param Length (2), Param 1, Param 2, .. 177746ccb7eSMatthias Ringwald 178746ccb7eSMatthias Ringwald static int sdp_create_error_response(uint16_t transaction_id, uint16_t error_code){ 179746ccb7eSMatthias Ringwald sdp_response_buffer[0] = SDP_ErrorResponse; 180746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 1, transaction_id); 181746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 3, 2); 182746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 5, error_code); // invalid syntax 183746ccb7eSMatthias Ringwald return 7; 184746ccb7eSMatthias Ringwald } 185746ccb7eSMatthias Ringwald 186746ccb7eSMatthias Ringwald int sdp_handle_service_search_request(uint8_t * packet, uint16_t remote_mtu){ 187746ccb7eSMatthias Ringwald 188746ccb7eSMatthias Ringwald // get request details 189746ccb7eSMatthias Ringwald uint16_t transaction_id = big_endian_read_16(packet, 1); 1904443af49SMatthias Ringwald uint16_t param_len = big_endian_read_16(packet, 3); 191746ccb7eSMatthias Ringwald uint8_t * serviceSearchPattern = &packet[5]; 1924443af49SMatthias Ringwald uint16_t serviceSearchPatternLen = de_get_len_safe(serviceSearchPattern, param_len); 1934443af49SMatthias Ringwald // assert service search pattern is contained 1944443af49SMatthias Ringwald if (!serviceSearchPatternLen) return 0; 1954443af49SMatthias Ringwald param_len -= serviceSearchPatternLen; 1964443af49SMatthias Ringwald // assert max record count is contained 1974443af49SMatthias Ringwald if (param_len < 2) return 0; 198746ccb7eSMatthias Ringwald uint16_t maximumServiceRecordCount = big_endian_read_16(packet, 5 + serviceSearchPatternLen); 1994443af49SMatthias Ringwald param_len -= 2; 2004443af49SMatthias Ringwald // assert continuation state len is contained in param_len 2014443af49SMatthias Ringwald if (param_len < 1) return 0; 202746ccb7eSMatthias Ringwald uint8_t * continuationState = &packet[5+serviceSearchPatternLen+2]; 2034443af49SMatthias Ringwald // assert continuation state is contained in param_len 204c1ab6cc1SMatthias Ringwald if ((1 + continuationState[0]) > param_len) return 0; 205746ccb7eSMatthias Ringwald 2064443af49SMatthias Ringwald // calc maximumServiceRecordCount based on remote MTU 207746ccb7eSMatthias Ringwald uint16_t maxNrServiceRecordsPerResponse = (remote_mtu - (9+3))/4; 208746ccb7eSMatthias Ringwald 209746ccb7eSMatthias Ringwald // continuation state contains index of next service record to examine 210746ccb7eSMatthias Ringwald int continuation = 0; 211746ccb7eSMatthias Ringwald uint16_t continuation_index = 0; 212746ccb7eSMatthias Ringwald if (continuationState[0] == 2){ 213746ccb7eSMatthias Ringwald continuation_index = big_endian_read_16(continuationState, 1); 214746ccb7eSMatthias Ringwald } 215746ccb7eSMatthias Ringwald 216746ccb7eSMatthias Ringwald // get and limit total count 217746ccb7eSMatthias Ringwald btstack_linked_item_t *it; 218746ccb7eSMatthias Ringwald uint16_t total_service_count = 0; 219f20b4214SMatthias Ringwald for (it = (btstack_linked_item_t *) sdp_server_service_records; it ; it = it->next){ 220746ccb7eSMatthias Ringwald service_record_item_t * item = (service_record_item_t *) it; 221746ccb7eSMatthias Ringwald if (!sdp_record_matches_service_search_pattern(item->service_record, serviceSearchPattern)) continue; 222746ccb7eSMatthias Ringwald total_service_count++; 223746ccb7eSMatthias Ringwald } 224746ccb7eSMatthias Ringwald if (total_service_count > maximumServiceRecordCount){ 225746ccb7eSMatthias Ringwald total_service_count = maximumServiceRecordCount; 226746ccb7eSMatthias Ringwald } 227746ccb7eSMatthias Ringwald 228746ccb7eSMatthias Ringwald // ServiceRecordHandleList at 9 229746ccb7eSMatthias Ringwald uint16_t pos = 9; 230746ccb7eSMatthias Ringwald uint16_t current_service_count = 0; 231746ccb7eSMatthias Ringwald uint16_t current_service_index = 0; 232746ccb7eSMatthias Ringwald uint16_t matching_service_count = 0; 233f20b4214SMatthias Ringwald for (it = (btstack_linked_item_t *) sdp_server_service_records; it ; it = it->next, ++current_service_index){ 234746ccb7eSMatthias Ringwald service_record_item_t * item = (service_record_item_t *) it; 235746ccb7eSMatthias Ringwald 236746ccb7eSMatthias Ringwald if (!sdp_record_matches_service_search_pattern(item->service_record, serviceSearchPattern)) continue; 237746ccb7eSMatthias Ringwald matching_service_count++; 238746ccb7eSMatthias Ringwald 239746ccb7eSMatthias Ringwald if (current_service_index < continuation_index) continue; 240746ccb7eSMatthias Ringwald 241746ccb7eSMatthias Ringwald big_endian_store_32(sdp_response_buffer, pos, item->service_record_handle); 242746ccb7eSMatthias Ringwald pos += 4; 243746ccb7eSMatthias Ringwald current_service_count++; 244746ccb7eSMatthias Ringwald 245746ccb7eSMatthias Ringwald if (matching_service_count >= total_service_count) break; 246746ccb7eSMatthias Ringwald 247746ccb7eSMatthias Ringwald if (current_service_count >= maxNrServiceRecordsPerResponse){ 248746ccb7eSMatthias Ringwald continuation = 1; 249746ccb7eSMatthias Ringwald continuation_index = current_service_index + 1; 250746ccb7eSMatthias Ringwald break; 251746ccb7eSMatthias Ringwald } 252746ccb7eSMatthias Ringwald } 253746ccb7eSMatthias Ringwald 254746ccb7eSMatthias Ringwald // Store continuation state 255746ccb7eSMatthias Ringwald if (continuation) { 256746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 2; 257746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, pos, continuation_index); 258746ccb7eSMatthias Ringwald pos += 2; 259746ccb7eSMatthias Ringwald } else { 260746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 0; 261746ccb7eSMatthias Ringwald } 262746ccb7eSMatthias Ringwald 263746ccb7eSMatthias Ringwald // header 264746ccb7eSMatthias Ringwald sdp_response_buffer[0] = SDP_ServiceSearchResponse; 265746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 1, transaction_id); 266746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 3, pos - 5); // size of variable payload 267746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 5, total_service_count); 268746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 7, current_service_count); 269746ccb7eSMatthias Ringwald 270746ccb7eSMatthias Ringwald return pos; 271746ccb7eSMatthias Ringwald } 272746ccb7eSMatthias Ringwald 273746ccb7eSMatthias Ringwald int sdp_handle_service_attribute_request(uint8_t * packet, uint16_t remote_mtu){ 274746ccb7eSMatthias Ringwald 275746ccb7eSMatthias Ringwald // get request details 276746ccb7eSMatthias Ringwald uint16_t transaction_id = big_endian_read_16(packet, 1); 2774443af49SMatthias Ringwald uint16_t param_len = big_endian_read_16(packet, 3); 2784443af49SMatthias Ringwald // assert serviceRecordHandle and maximumAttributeByteCount are in param_len 2794443af49SMatthias Ringwald if (param_len < 6) return 0; 280c9b8fdd9SMatthias Ringwald uint32_t serviceRecordHandle = big_endian_read_32(packet, 5); 281746ccb7eSMatthias Ringwald uint16_t maximumAttributeByteCount = big_endian_read_16(packet, 9); 2824443af49SMatthias Ringwald param_len -= 6; 283746ccb7eSMatthias Ringwald uint8_t * attributeIDList = &packet[11]; 2844443af49SMatthias Ringwald uint16_t attributeIDListLen = de_get_len_safe(attributeIDList, param_len); 2854443af49SMatthias Ringwald // assert attributeIDList are in param_len 2864443af49SMatthias Ringwald if (!attributeIDListLen) return 0; 2874443af49SMatthias Ringwald param_len -= attributeIDListLen; 2884443af49SMatthias Ringwald // assert continuation state len is contained in param_len 2894443af49SMatthias Ringwald if (param_len < 1) return 0; 290746ccb7eSMatthias Ringwald uint8_t * continuationState = &packet[11+attributeIDListLen]; 2914443af49SMatthias Ringwald // assert continuation state is contained in param_len 292c1ab6cc1SMatthias Ringwald if ((1 + continuationState[0]) > param_len) return 0; 293746ccb7eSMatthias Ringwald 294746ccb7eSMatthias Ringwald // calc maximumAttributeByteCount based on remote MTU 295746ccb7eSMatthias Ringwald uint16_t maximumAttributeByteCount2 = remote_mtu - (7+3); 296746ccb7eSMatthias Ringwald if (maximumAttributeByteCount2 < maximumAttributeByteCount) { 297746ccb7eSMatthias Ringwald maximumAttributeByteCount = maximumAttributeByteCount2; 298746ccb7eSMatthias Ringwald } 299746ccb7eSMatthias Ringwald 300746ccb7eSMatthias Ringwald // continuation state contains the offset into the complete response 301746ccb7eSMatthias Ringwald uint16_t continuation_offset = 0; 302746ccb7eSMatthias Ringwald if (continuationState[0] == 2){ 303746ccb7eSMatthias Ringwald continuation_offset = big_endian_read_16(continuationState, 1); 304746ccb7eSMatthias Ringwald } 305746ccb7eSMatthias Ringwald 306746ccb7eSMatthias Ringwald // get service record 307746ccb7eSMatthias Ringwald service_record_item_t * item = sdp_get_record_item_for_handle(serviceRecordHandle); 308746ccb7eSMatthias Ringwald if (!item){ 309746ccb7eSMatthias Ringwald // service record handle doesn't exist 310746ccb7eSMatthias Ringwald return sdp_create_error_response(transaction_id, 0x0002); /// invalid Service Record Handle 311746ccb7eSMatthias Ringwald } 312746ccb7eSMatthias Ringwald 313746ccb7eSMatthias Ringwald 314746ccb7eSMatthias Ringwald // AttributeList - starts at offset 7 315746ccb7eSMatthias Ringwald uint16_t pos = 7; 316746ccb7eSMatthias Ringwald 317746ccb7eSMatthias Ringwald if (continuation_offset == 0){ 318746ccb7eSMatthias Ringwald 319746ccb7eSMatthias Ringwald // get size of this record 320*839ee6d9SMatthias Ringwald uint16_t filtered_attributes_size = sdp_get_filtered_size(item->service_record, attributeIDList); 321746ccb7eSMatthias Ringwald 322746ccb7eSMatthias Ringwald // store DES 323746ccb7eSMatthias Ringwald de_store_descriptor_with_len(&sdp_response_buffer[pos], DE_DES, DE_SIZE_VAR_16, filtered_attributes_size); 324746ccb7eSMatthias Ringwald maximumAttributeByteCount -= 3; 325746ccb7eSMatthias Ringwald pos += 3; 326746ccb7eSMatthias Ringwald } 327746ccb7eSMatthias Ringwald 328746ccb7eSMatthias Ringwald // copy maximumAttributeByteCount from record 329746ccb7eSMatthias Ringwald uint16_t bytes_used; 330746ccb7eSMatthias Ringwald int complete = sdp_filter_attributes_in_attributeIDList(item->service_record, attributeIDList, continuation_offset, maximumAttributeByteCount, &bytes_used, &sdp_response_buffer[pos]); 331746ccb7eSMatthias Ringwald pos += bytes_used; 332746ccb7eSMatthias Ringwald 333746ccb7eSMatthias Ringwald uint16_t attributeListByteCount = pos - 7; 334746ccb7eSMatthias Ringwald 335746ccb7eSMatthias Ringwald if (complete) { 336746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 0; 337746ccb7eSMatthias Ringwald } else { 338746ccb7eSMatthias Ringwald continuation_offset += bytes_used; 339746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 2; 340746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, pos, continuation_offset); 341746ccb7eSMatthias Ringwald pos += 2; 342746ccb7eSMatthias Ringwald } 343746ccb7eSMatthias Ringwald 344746ccb7eSMatthias Ringwald // header 345746ccb7eSMatthias Ringwald sdp_response_buffer[0] = SDP_ServiceAttributeResponse; 346746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 1, transaction_id); 347746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 3, pos - 5); // size of variable payload 348746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 5, attributeListByteCount); 349746ccb7eSMatthias Ringwald 350746ccb7eSMatthias Ringwald return pos; 351746ccb7eSMatthias Ringwald } 352746ccb7eSMatthias Ringwald 353746ccb7eSMatthias Ringwald static uint16_t sdp_get_size_for_service_search_attribute_response(uint8_t * serviceSearchPattern, uint8_t * attributeIDList){ 354746ccb7eSMatthias Ringwald uint16_t total_response_size = 0; 355746ccb7eSMatthias Ringwald btstack_linked_item_t *it; 356f20b4214SMatthias Ringwald for (it = (btstack_linked_item_t *) sdp_server_service_records; it ; it = it->next){ 357746ccb7eSMatthias Ringwald service_record_item_t * item = (service_record_item_t *) it; 358746ccb7eSMatthias Ringwald 359746ccb7eSMatthias Ringwald if (!sdp_record_matches_service_search_pattern(item->service_record, serviceSearchPattern)) continue; 360746ccb7eSMatthias Ringwald 361746ccb7eSMatthias Ringwald // for all service records that match 362*839ee6d9SMatthias Ringwald total_response_size += 3 + sdp_get_filtered_size(item->service_record, attributeIDList); 363746ccb7eSMatthias Ringwald } 364746ccb7eSMatthias Ringwald return total_response_size; 365746ccb7eSMatthias Ringwald } 366746ccb7eSMatthias Ringwald 367746ccb7eSMatthias Ringwald int sdp_handle_service_search_attribute_request(uint8_t * packet, uint16_t remote_mtu){ 368746ccb7eSMatthias Ringwald 369746ccb7eSMatthias Ringwald // SDP header before attribute sevice list: 7 370746ccb7eSMatthias Ringwald // Continuation, worst case: 5 371746ccb7eSMatthias Ringwald 372746ccb7eSMatthias Ringwald // get request details 373746ccb7eSMatthias Ringwald uint16_t transaction_id = big_endian_read_16(packet, 1); 3744443af49SMatthias Ringwald uint16_t param_len = big_endian_read_16(packet, 3); 375746ccb7eSMatthias Ringwald uint8_t * serviceSearchPattern = &packet[5]; 3764443af49SMatthias Ringwald uint16_t serviceSearchPatternLen = de_get_len_safe(serviceSearchPattern, param_len); 3774443af49SMatthias Ringwald // assert serviceSearchPattern header is contained in param_len 3784443af49SMatthias Ringwald if (!serviceSearchPatternLen) return 0; 3794443af49SMatthias Ringwald param_len -= serviceSearchPatternLen; 3804443af49SMatthias Ringwald // assert maximumAttributeByteCount contained in param_len 3814443af49SMatthias Ringwald if (param_len < 2) return 0; 382746ccb7eSMatthias Ringwald uint16_t maximumAttributeByteCount = big_endian_read_16(packet, 5 + serviceSearchPatternLen); 3834443af49SMatthias Ringwald param_len -= 2; 384746ccb7eSMatthias Ringwald uint8_t * attributeIDList = &packet[5+serviceSearchPatternLen+2]; 3854443af49SMatthias Ringwald uint16_t attributeIDListLen = de_get_len_safe(attributeIDList, param_len); 3864443af49SMatthias Ringwald // assert attributeIDList is contained in param_len 3874443af49SMatthias Ringwald if (!attributeIDListLen) return 0; 3884443af49SMatthias Ringwald // assert continuation state len is contained in param_len 3894443af49SMatthias Ringwald if (param_len < 1) return 0; 390746ccb7eSMatthias Ringwald uint8_t * continuationState = &packet[5+serviceSearchPatternLen+2+attributeIDListLen]; 3914443af49SMatthias Ringwald // assert continuation state is contained in param_len 392c1ab6cc1SMatthias Ringwald if ((1 + continuationState[0]) > param_len) return 0; 393746ccb7eSMatthias Ringwald 394746ccb7eSMatthias Ringwald // calc maximumAttributeByteCount based on remote MTU, SDP header and reserved Continuation block 395746ccb7eSMatthias Ringwald uint16_t maximumAttributeByteCount2 = remote_mtu - 12; 396746ccb7eSMatthias Ringwald if (maximumAttributeByteCount2 < maximumAttributeByteCount) { 397746ccb7eSMatthias Ringwald maximumAttributeByteCount = maximumAttributeByteCount2; 398746ccb7eSMatthias Ringwald } 399746ccb7eSMatthias Ringwald 400746ccb7eSMatthias Ringwald // continuation state contains: index of next service record to examine 401746ccb7eSMatthias Ringwald // continuation state contains: byte offset into this service record 402746ccb7eSMatthias Ringwald uint16_t continuation_service_index = 0; 403746ccb7eSMatthias Ringwald uint16_t continuation_offset = 0; 404746ccb7eSMatthias Ringwald if (continuationState[0] == 4){ 405746ccb7eSMatthias Ringwald continuation_service_index = big_endian_read_16(continuationState, 1); 406746ccb7eSMatthias Ringwald continuation_offset = big_endian_read_16(continuationState, 3); 407746ccb7eSMatthias Ringwald } 408746ccb7eSMatthias Ringwald 409746ccb7eSMatthias Ringwald // log_info("--> sdp_handle_service_search_attribute_request, cont %u/%u, max %u", continuation_service_index, continuation_offset, maximumAttributeByteCount); 410746ccb7eSMatthias Ringwald 411746ccb7eSMatthias Ringwald // AttributeLists - starts at offset 7 412746ccb7eSMatthias Ringwald uint16_t pos = 7; 413746ccb7eSMatthias Ringwald 414746ccb7eSMatthias Ringwald // add DES with total size for first request 415c1ab6cc1SMatthias Ringwald if ((continuation_service_index == 0) && (continuation_offset == 0)){ 416746ccb7eSMatthias Ringwald uint16_t total_response_size = sdp_get_size_for_service_search_attribute_response(serviceSearchPattern, attributeIDList); 417746ccb7eSMatthias Ringwald de_store_descriptor_with_len(&sdp_response_buffer[pos], DE_DES, DE_SIZE_VAR_16, total_response_size); 418746ccb7eSMatthias Ringwald // log_info("total response size %u", total_response_size); 419746ccb7eSMatthias Ringwald pos += 3; 420746ccb7eSMatthias Ringwald maximumAttributeByteCount -= 3; 421746ccb7eSMatthias Ringwald } 422746ccb7eSMatthias Ringwald 423746ccb7eSMatthias Ringwald // create attribute list 424746ccb7eSMatthias Ringwald int first_answer = 1; 425746ccb7eSMatthias Ringwald int continuation = 0; 426746ccb7eSMatthias Ringwald uint16_t current_service_index = 0; 427f20b4214SMatthias Ringwald btstack_linked_item_t *it = (btstack_linked_item_t *) sdp_server_service_records; 428746ccb7eSMatthias Ringwald for ( ; it ; it = it->next, ++current_service_index){ 429746ccb7eSMatthias Ringwald service_record_item_t * item = (service_record_item_t *) it; 430746ccb7eSMatthias Ringwald 431746ccb7eSMatthias Ringwald if (current_service_index < continuation_service_index ) continue; 432746ccb7eSMatthias Ringwald if (!sdp_record_matches_service_search_pattern(item->service_record, serviceSearchPattern)) continue; 433746ccb7eSMatthias Ringwald 434746ccb7eSMatthias Ringwald if (continuation_offset == 0){ 435746ccb7eSMatthias Ringwald 436746ccb7eSMatthias Ringwald // get size of this record 437*839ee6d9SMatthias Ringwald uint16_t filtered_attributes_size = sdp_get_filtered_size(item->service_record, attributeIDList); 438746ccb7eSMatthias Ringwald 439746ccb7eSMatthias Ringwald // stop if complete record doesn't fits into response but we already have a partial response 440c1ab6cc1SMatthias Ringwald if (((filtered_attributes_size + 3) > maximumAttributeByteCount) && !first_answer) { 441746ccb7eSMatthias Ringwald continuation = 1; 442746ccb7eSMatthias Ringwald break; 443746ccb7eSMatthias Ringwald } 444746ccb7eSMatthias Ringwald 445746ccb7eSMatthias Ringwald // store DES 446746ccb7eSMatthias Ringwald de_store_descriptor_with_len(&sdp_response_buffer[pos], DE_DES, DE_SIZE_VAR_16, filtered_attributes_size); 447746ccb7eSMatthias Ringwald pos += 3; 448746ccb7eSMatthias Ringwald maximumAttributeByteCount -= 3; 449746ccb7eSMatthias Ringwald } 450746ccb7eSMatthias Ringwald 451746ccb7eSMatthias Ringwald first_answer = 0; 452746ccb7eSMatthias Ringwald 453746ccb7eSMatthias Ringwald // copy maximumAttributeByteCount from record 454746ccb7eSMatthias Ringwald uint16_t bytes_used; 455746ccb7eSMatthias Ringwald int complete = sdp_filter_attributes_in_attributeIDList(item->service_record, attributeIDList, continuation_offset, maximumAttributeByteCount, &bytes_used, &sdp_response_buffer[pos]); 456746ccb7eSMatthias Ringwald pos += bytes_used; 457746ccb7eSMatthias Ringwald maximumAttributeByteCount -= bytes_used; 458746ccb7eSMatthias Ringwald 459746ccb7eSMatthias Ringwald if (complete) { 460746ccb7eSMatthias Ringwald continuation_offset = 0; 461746ccb7eSMatthias Ringwald continue; 462746ccb7eSMatthias Ringwald } 463746ccb7eSMatthias Ringwald 464746ccb7eSMatthias Ringwald continuation = 1; 465746ccb7eSMatthias Ringwald continuation_offset += bytes_used; 466746ccb7eSMatthias Ringwald break; 467746ccb7eSMatthias Ringwald } 468746ccb7eSMatthias Ringwald 469746ccb7eSMatthias Ringwald uint16_t attributeListsByteCount = pos - 7; 470746ccb7eSMatthias Ringwald 471746ccb7eSMatthias Ringwald // Continuation State 472746ccb7eSMatthias Ringwald if (continuation){ 473746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 4; 474746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, pos, (uint16_t) current_service_index); 475746ccb7eSMatthias Ringwald pos += 2; 476746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, pos, continuation_offset); 477746ccb7eSMatthias Ringwald pos += 2; 478746ccb7eSMatthias Ringwald } else { 479746ccb7eSMatthias Ringwald // complete 480746ccb7eSMatthias Ringwald sdp_response_buffer[pos++] = 0; 481746ccb7eSMatthias Ringwald } 482746ccb7eSMatthias Ringwald 483746ccb7eSMatthias Ringwald // create SDP header 484746ccb7eSMatthias Ringwald sdp_response_buffer[0] = SDP_ServiceSearchAttributeResponse; 485746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 1, transaction_id); 486746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 3, pos - 5); // size of variable payload 487746ccb7eSMatthias Ringwald big_endian_store_16(sdp_response_buffer, 5, attributeListsByteCount); 488746ccb7eSMatthias Ringwald 489746ccb7eSMatthias Ringwald return pos; 490746ccb7eSMatthias Ringwald } 491746ccb7eSMatthias Ringwald 492aed68c56SMatthias Ringwald static void sdp_respond(void){ 493f20b4214SMatthias Ringwald if (!sdp_server_response_size ) return; 494f20b4214SMatthias Ringwald if (!sdp_server_l2cap_cid) return; 495746ccb7eSMatthias Ringwald 496746ccb7eSMatthias Ringwald // update state before sending packet (avoid getting called when new l2cap credit gets emitted) 497f20b4214SMatthias Ringwald uint16_t size = sdp_server_response_size; 498f20b4214SMatthias Ringwald sdp_server_response_size = 0; 499f20b4214SMatthias Ringwald l2cap_send(sdp_server_l2cap_cid, sdp_response_buffer, size); 500746ccb7eSMatthias Ringwald } 501746ccb7eSMatthias Ringwald 5027616f654SMatthias Ringwald // @pre space in list 5037616f654SMatthias Ringwald static void sdp_waiting_list_add(uint16_t cid){ 504f20b4214SMatthias Ringwald sdp_server_l2cap_waiting_list_cids[sdp_server_l2cap_waiting_list_count++] = cid; 5057616f654SMatthias Ringwald } 5067616f654SMatthias Ringwald 5077616f654SMatthias Ringwald // @pre at least one item in list 5087616f654SMatthias Ringwald static uint16_t sdp_waiting_list_get(void){ 509f20b4214SMatthias Ringwald uint16_t cid = sdp_server_l2cap_waiting_list_cids[0]; 510f20b4214SMatthias Ringwald sdp_server_l2cap_waiting_list_count--; 511f20b4214SMatthias Ringwald if (sdp_server_l2cap_waiting_list_count){ 512f20b4214SMatthias Ringwald memmove(&sdp_server_l2cap_waiting_list_cids[0], &sdp_server_l2cap_waiting_list_cids[1], sdp_server_l2cap_waiting_list_count * sizeof(uint16_t)); 5137616f654SMatthias Ringwald } 5147616f654SMatthias Ringwald return cid; 5157616f654SMatthias Ringwald } 5167616f654SMatthias Ringwald 517746ccb7eSMatthias Ringwald // we assume that we don't get two requests in a row 518746ccb7eSMatthias Ringwald static void sdp_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){ 519746ccb7eSMatthias Ringwald uint16_t transaction_id; 520f20b4214SMatthias Ringwald sdp_pdu_id_t pdu_id; 521746ccb7eSMatthias Ringwald uint16_t remote_mtu; 5224443af49SMatthias Ringwald uint16_t param_len; 523746ccb7eSMatthias Ringwald 524746ccb7eSMatthias Ringwald switch (packet_type) { 525746ccb7eSMatthias Ringwald 526746ccb7eSMatthias Ringwald case L2CAP_DATA_PACKET: 527f20b4214SMatthias Ringwald pdu_id = (sdp_pdu_id_t) packet[0]; 528746ccb7eSMatthias Ringwald transaction_id = big_endian_read_16(packet, 1); 5294443af49SMatthias Ringwald param_len = big_endian_read_16(packet, 3); 530746ccb7eSMatthias Ringwald remote_mtu = l2cap_get_remote_mtu_for_local_cid(channel); 531746ccb7eSMatthias Ringwald // account for our buffer 532746ccb7eSMatthias Ringwald if (remote_mtu > SDP_RESPONSE_BUFFER_SIZE){ 533746ccb7eSMatthias Ringwald remote_mtu = SDP_RESPONSE_BUFFER_SIZE; 534746ccb7eSMatthias Ringwald } 5354443af49SMatthias Ringwald // validate parm_len against packet size 536c1ab6cc1SMatthias Ringwald if ((param_len + 5) > size) { 5374443af49SMatthias Ringwald // just clear pdu_id 5384443af49SMatthias Ringwald pdu_id = SDP_ErrorResponse; 5394443af49SMatthias Ringwald } 540746ccb7eSMatthias Ringwald 541746ccb7eSMatthias Ringwald // log_info("SDP Request: type %u, transaction id %u, len %u, mtu %u", pdu_id, transaction_id, param_len, remote_mtu); 542746ccb7eSMatthias Ringwald switch (pdu_id){ 543746ccb7eSMatthias Ringwald 544746ccb7eSMatthias Ringwald case SDP_ServiceSearchRequest: 545f20b4214SMatthias Ringwald sdp_server_response_size = sdp_handle_service_search_request(packet, remote_mtu); 546746ccb7eSMatthias Ringwald break; 547746ccb7eSMatthias Ringwald 548746ccb7eSMatthias Ringwald case SDP_ServiceAttributeRequest: 549f20b4214SMatthias Ringwald sdp_server_response_size = sdp_handle_service_attribute_request(packet, remote_mtu); 550746ccb7eSMatthias Ringwald break; 551746ccb7eSMatthias Ringwald 552746ccb7eSMatthias Ringwald case SDP_ServiceSearchAttributeRequest: 553f20b4214SMatthias Ringwald sdp_server_response_size = sdp_handle_service_search_attribute_request(packet, remote_mtu); 554746ccb7eSMatthias Ringwald break; 555746ccb7eSMatthias Ringwald 556746ccb7eSMatthias Ringwald default: 557f20b4214SMatthias Ringwald sdp_server_response_size = sdp_create_error_response(transaction_id, 0x0003); // invalid syntax 558746ccb7eSMatthias Ringwald break; 559746ccb7eSMatthias Ringwald } 560f20b4214SMatthias Ringwald if (!sdp_server_response_size) break; 561f20b4214SMatthias Ringwald l2cap_request_can_send_now_event(sdp_server_l2cap_cid); 562746ccb7eSMatthias Ringwald break; 563746ccb7eSMatthias Ringwald 564746ccb7eSMatthias Ringwald case HCI_EVENT_PACKET: 565746ccb7eSMatthias Ringwald 5660e2df43fSMatthias Ringwald switch (hci_event_packet_get_type(packet)) { 567746ccb7eSMatthias Ringwald 568746ccb7eSMatthias Ringwald case L2CAP_EVENT_INCOMING_CONNECTION: 569f20b4214SMatthias Ringwald if (sdp_server_l2cap_cid) { 5707616f654SMatthias Ringwald // try to queue up 571f20b4214SMatthias Ringwald if (sdp_server_l2cap_waiting_list_count < SDP_WAITING_LIST_MAX_COUNT){ 5727616f654SMatthias Ringwald sdp_waiting_list_add(channel); 573f20b4214SMatthias Ringwald log_info("busy, queing incoming cid 0x%04x, now %u waiting", channel, sdp_server_l2cap_waiting_list_count); 5747616f654SMatthias Ringwald break; 5757616f654SMatthias Ringwald } 5767616f654SMatthias Ringwald 577746ccb7eSMatthias Ringwald // CONNECTION REJECTED DUE TO LIMITED RESOURCES 5787ef6a7bbSMatthias Ringwald l2cap_decline_connection(channel); 579746ccb7eSMatthias Ringwald break; 580746ccb7eSMatthias Ringwald } 581746ccb7eSMatthias Ringwald // accept 582f20b4214SMatthias Ringwald sdp_server_l2cap_cid = channel; 583f20b4214SMatthias Ringwald sdp_server_response_size = 0; 584f20b4214SMatthias Ringwald l2cap_accept_connection(sdp_server_l2cap_cid); 585746ccb7eSMatthias Ringwald break; 586746ccb7eSMatthias Ringwald 587746ccb7eSMatthias Ringwald case L2CAP_EVENT_CHANNEL_OPENED: 588746ccb7eSMatthias Ringwald if (packet[2]) { 589746ccb7eSMatthias Ringwald // open failed -> reset 590f20b4214SMatthias Ringwald sdp_server_l2cap_cid = 0; 591746ccb7eSMatthias Ringwald } 592746ccb7eSMatthias Ringwald break; 593746ccb7eSMatthias Ringwald 594746ccb7eSMatthias Ringwald case L2CAP_EVENT_CAN_SEND_NOW: 595aed68c56SMatthias Ringwald sdp_respond(); 596746ccb7eSMatthias Ringwald break; 597746ccb7eSMatthias Ringwald 598746ccb7eSMatthias Ringwald case L2CAP_EVENT_CHANNEL_CLOSED: 599f20b4214SMatthias Ringwald if (channel == sdp_server_l2cap_cid){ 600746ccb7eSMatthias Ringwald // reset 601f20b4214SMatthias Ringwald sdp_server_l2cap_cid = 0; 6027616f654SMatthias Ringwald 6037616f654SMatthias Ringwald // other request queued? 604f20b4214SMatthias Ringwald if (!sdp_server_l2cap_waiting_list_count) break; 6057616f654SMatthias Ringwald 6067616f654SMatthias Ringwald // get first item 607f20b4214SMatthias Ringwald sdp_server_l2cap_cid = sdp_waiting_list_get(); 6087616f654SMatthias Ringwald 609f20b4214SMatthias Ringwald log_info("disconnect, accept queued cid 0x%04x, now %u waiting", sdp_server_l2cap_cid, sdp_server_l2cap_waiting_list_count); 6107616f654SMatthias Ringwald 6117616f654SMatthias Ringwald // accept connection 612f20b4214SMatthias Ringwald sdp_server_response_size = 0; 613f20b4214SMatthias Ringwald l2cap_accept_connection(sdp_server_l2cap_cid); 614746ccb7eSMatthias Ringwald } 615746ccb7eSMatthias Ringwald break; 616746ccb7eSMatthias Ringwald 617746ccb7eSMatthias Ringwald default: 618746ccb7eSMatthias Ringwald // other event 619746ccb7eSMatthias Ringwald break; 620746ccb7eSMatthias Ringwald } 621746ccb7eSMatthias Ringwald break; 622746ccb7eSMatthias Ringwald 623746ccb7eSMatthias Ringwald default: 624746ccb7eSMatthias Ringwald // other packet type 625746ccb7eSMatthias Ringwald break; 626746ccb7eSMatthias Ringwald } 627746ccb7eSMatthias Ringwald } 628746ccb7eSMatthias Ringwald 629