xref: /btstack/src/ble/gatt-service/device_information_service_client.c (revision 3a82c685cdfb9fe1adf9c9cbd832c701889b28a1)

/*
 * Copyright (C) 2021 BlueKitchen GmbH
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the copyright holders nor the names of
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 * 4. Any redistribution, use, or modification is done solely for
 *    personal benefit and not for any commercial purpose or for
 *    monetary gain.
 *
 * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN
 * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * Please inquire about commercial licensing options at
 * [email protected]
 *
 */

#define BTSTACK_FILE__ "device_information_service_client.c"

#include "btstack_config.h"

#include <stdint.h>
#include <string.h>

#ifdef ENABLE_TESTING_SUPPORT
#include <stdio.h>
#endif

#include "ble/gatt-service/device_information_service_client.h"

#include "ble/core.h"
#include "ble/gatt_client.h"
#include "bluetooth_gatt.h"
#include "btstack_debug.h"
#include "btstack_event.h"
#include "gap.h"

#define DEVICE_INFORMATION_MAX_STRING_LEN 32


typedef enum {
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_IDLE,
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_SERVICE,
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_SERVICE_RESULT,
#ifdef ENABLE_TESTING_SUPPORT
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_CHARACTERISTICS,
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_RESULT,
#endif
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_READ_VALUE_OF_CHARACTERISTIC,
    DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_VALUE
} device_information_service_client_state_t;

typedef struct {
    hci_con_handle_t con_handle;
    device_information_service_client_state_t  state;
    btstack_packet_handler_t client_handler;

    // service
    uint16_t start_handle;
    uint16_t end_handle;
    uint8_t  num_instances;

    // index of next characteristic to query
    uint8_t characteristic_index;
} device_information_service_client_t;


static btstack_context_callback_registration_t device_information_service_handle_can_send_now;

static device_information_service_client_t device_information_service_client;

static void handle_gatt_client_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size);
static void device_information_service_emit_string_value(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);
static void device_information_service_emit_system_id(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);
static void device_information_service_emit_certification_data_list(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);
static void device_information_service_emit_pnp_id(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);
static void device_information_service_emit_udi_for_medical_devices(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);

// list of uuids and how they are reported as events
static const struct device_information_characteristic {
    uint16_t uuid;
    uint8_t  subevent;
    void (*handle_value)(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len);
} device_information_characteristics[] = {
    {ORG_BLUETOOTH_CHARACTERISTIC_MANUFACTURER_NAME_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_MANUFACTURER_NAME, device_information_service_emit_string_value},
    {ORG_BLUETOOTH_CHARACTERISTIC_MODEL_NUMBER_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_MODEL_NUMBER, device_information_service_emit_string_value},
    {ORG_BLUETOOTH_CHARACTERISTIC_SERIAL_NUMBER_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_SERIAL_NUMBER, device_information_service_emit_string_value},
    {ORG_BLUETOOTH_CHARACTERISTIC_HARDWARE_REVISION_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_HARDWARE_REVISION, device_information_service_emit_string_value},
    {ORG_BLUETOOTH_CHARACTERISTIC_FIRMWARE_REVISION_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_FIRMWARE_REVISION, device_information_service_emit_string_value},
    {ORG_BLUETOOTH_CHARACTERISTIC_SOFTWARE_REVISION_STRING, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_SOFTWARE_REVISION, device_information_service_emit_string_value},

    {ORG_BLUETOOTH_CHARACTERISTIC_SYSTEM_ID, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_SYSTEM_ID, device_information_service_emit_system_id},
    {ORG_BLUETOOTH_CHARACTERISTIC_IEEE_11073_20601_REGULATORY_CERTIFICATION_DATA_LIST, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_IEEE_REGULATORY_CERTIFICATION, device_information_service_emit_certification_data_list},
    {ORG_BLUETOOTH_CHARACTERISTIC_PNP_ID, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_PNP_ID, device_information_service_emit_pnp_id},
    {ORG_BLUETOOTH_CHARACTERISTIC_UDI_FOR_MEDICAL_DEVICES, GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_UDI_FOR_MEDICAL_DEVICES, device_information_service_emit_udi_for_medical_devices}
};

static uint8_t device_informatiom_client_request_send_gatt_query(device_information_service_client_t * client){
    uint8_t status = gatt_client_request_to_send_gatt_query(&device_information_service_handle_can_send_now, client->con_handle);
    if (status != ERROR_CODE_SUCCESS){
        if (client->state >= DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_SERVICE){
            client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_IDLE;
        }

    }
    return status;
}

#ifdef ENABLE_TESTING_SUPPORT
static struct device_information_characteristic_handles{
    uint16_t uuid;
    uint16_t value_handle;
} device_information_characteristic_handles[] = {
    {ORG_BLUETOOTH_CHARACTERISTIC_MANUFACTURER_NAME_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_MODEL_NUMBER_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_SERIAL_NUMBER_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_HARDWARE_REVISION_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_FIRMWARE_REVISION_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_SOFTWARE_REVISION_STRING, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_SYSTEM_ID, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_IEEE_11073_20601_REGULATORY_CERTIFICATION_DATA_LIST, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_PNP_ID, 0},
    {ORG_BLUETOOTH_CHARACTERISTIC_UDI_FOR_MEDICAL_DEVICES, 0}
};

static void device_information_service_update_handle_for_uuid(uint16_t uuid, uint16_t value_handle){
    uint8_t i;
    for (i = 0; i < 9; i++){
        if (device_information_characteristic_handles[i].uuid == uuid){
            device_information_characteristic_handles[i].value_handle = value_handle;
            return;
        }
    }
}
#endif


static const uint8_t num_information_fields = sizeof(device_information_characteristics)/sizeof(struct device_information_characteristic);

#ifdef ENABLE_TESTING_SUPPORT
static char * device_information_characteristic_name(uint16_t uuid){
    switch (uuid){
        case ORG_BLUETOOTH_CHARACTERISTIC_MANUFACTURER_NAME_STRING:
            return "MANUFACTURER_NAME_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_MODEL_NUMBER_STRING:
            return "MODEL_NUMBER_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_SERIAL_NUMBER_STRING:
            return "SERIAL_NUMBER_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_HARDWARE_REVISION_STRING:
            return "HARDWARE_REVISION_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_FIRMWARE_REVISION_STRING:
            return "FIRMWARE_REVISION_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_SOFTWARE_REVISION_STRING:
            return "SOFTWARE_REVISION_STRING";

        case ORG_BLUETOOTH_CHARACTERISTIC_SYSTEM_ID:
            return "SYSTEM_ID";

        case ORG_BLUETOOTH_CHARACTERISTIC_IEEE_11073_20601_REGULATORY_CERTIFICATION_DATA_LIST:
            return "IEEE_11073_20601_REGULATORY_CERTIFICATION_DATA_LIST";

        case ORG_BLUETOOTH_CHARACTERISTIC_PNP_ID:
            return "PNP_ID";

        case ORG_BLUETOOTH_CHARACTERISTIC_UDI_FOR_MEDICAL_DEVICES:
            return "ORG_BLUETOOTH_CHARACTERISTIC_UDI_FOR_MEDICAL_DEVICES";

        default:
            return "UKNOWN";
    }
}
#endif
static device_information_service_client_t * device_information_service_client_get_client(void){
    return &device_information_service_client;
}

static device_information_service_client_t * device_information_service_get_client_for_con_handle(hci_con_handle_t con_handle){
    if (device_information_service_client.con_handle == con_handle){
        return &device_information_service_client;
    }
    return NULL;
}

static void device_information_service_finalize_client(device_information_service_client_t * client){
    client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_IDLE;
    client->con_handle = HCI_CON_HANDLE_INVALID;
    client->client_handler = NULL;
    client->num_instances = 0;
    client->start_handle = 0;
    client->end_handle = 0;
}

static void device_information_service_emit_query_done_and_finalize_client(device_information_service_client_t * client, uint8_t status){
    hci_con_handle_t con_handle = client->con_handle;
    btstack_packet_handler_t callback = client->client_handler;

    device_information_service_finalize_client(client);

    uint8_t event[6];
    int pos = 0;
    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    event[pos++] = sizeof(event) - 2;
    event[pos++] = GATTSERVICE_SUBEVENT_DEVICE_INFORMATION_DONE;
    little_endian_store_16(event, pos, con_handle);
    pos += 2;
    event[pos++] = status;
    (*callback)(HCI_EVENT_PACKET, 0, event, pos);
}

static void device_information_service_emit_string_value(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len){
    uint8_t event[6 + DEVICE_INFORMATION_MAX_STRING_LEN + 1];
    int pos = 0;

    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    pos++;
    event[pos++] = subevent;
    little_endian_store_16(event, pos, client->con_handle);
    pos += 2;
    event[pos++] = att_status;

    uint16_t bytes_to_copy = btstack_min(value_len, DEVICE_INFORMATION_MAX_STRING_LEN);
    memcpy((char*)&event[pos], value, bytes_to_copy);
    pos += bytes_to_copy;
    event[pos++] = 0;

    event[1] = pos - 2;
    (*client->client_handler)(HCI_EVENT_PACKET, 0, event, pos);
}

static void device_information_service_emit_system_id(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len){
    if (value_len != 8) return;

    uint8_t event[14];
    uint16_t pos = 0;
    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    event[pos++] = sizeof(event) - 2;
    event[pos++] = subevent;
    little_endian_store_16(event, pos, client->con_handle);
    pos += 2;
    event[pos++] = att_status;
    memcpy(event+pos, value, 8);
    pos += 8;

    (*client->client_handler)(HCI_EVENT_PACKET, 0, event, pos);
}

static void device_information_service_emit_certification_data_list(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len){
    if (value_len != 4) return;

    uint8_t event[10];
    int pos = 0;
    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    event[pos++] = sizeof(event) - 2;
    event[pos++] = subevent;
    little_endian_store_16(event, pos, client->con_handle);
    pos += 2;
    event[pos++] = att_status;
    memcpy(event + pos, value, 4);
    pos += 4;

    (*client->client_handler)(HCI_EVENT_PACKET, 0, event, pos);
}

static void device_information_service_emit_pnp_id(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len){
    if (value_len != 7) return;

    uint8_t event[13];
    uint16_t pos = 0;
    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    event[pos++] = sizeof(event) - 2;
    event[pos++] = subevent;
    little_endian_store_16(event, pos, client->con_handle);
    pos += 2;
    event[pos++] = att_status;
    memcpy(event + pos, value, 7);
    pos += 7;

    (*client->client_handler)(HCI_EVENT_PACKET, 0, event, pos);
}

static void device_information_service_emit_udi_for_medical_devices(device_information_service_client_t * client, uint8_t subevent, uint8_t att_status, const uint8_t * value, uint16_t value_len){
    uint16_t max_udi_length = 1 + 4 * DEVICE_INFORMATION_MAX_STRING_LEN;

    if (value_len > max_udi_length) return;

    uint8_t event[6 + 1 + 4 * DEVICE_INFORMATION_MAX_STRING_LEN];
    uint16_t pos = 0;
    event[pos++] = HCI_EVENT_GATTSERVICE_META;
    event[pos++] = sizeof(event) - 2;
    event[pos++] = subevent;
    little_endian_store_16(event, pos, client->con_handle);
    pos += 2;
    event[pos++] = att_status;
    memcpy(event + pos, value, value_len);
    pos += value_len;

    (*client->client_handler)(HCI_EVENT_PACKET, 0, event, pos);
}


static void device_information_service_send_next_query(void * context){
    UNUSED(context);
    device_information_service_client_t * client = device_information_service_client_get_client();

    if (client == NULL){
        return;
    }

    uint8_t att_status;

    switch (client->state){
        case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_SERVICE:
            client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_SERVICE_RESULT;
            att_status = gatt_client_discover_primary_services_by_uuid16(handle_gatt_client_event, client->con_handle, ORG_BLUETOOTH_SERVICE_DEVICE_INFORMATION);
            // TODO handle status
            UNUSED(att_status);
            break;
#ifdef ENABLE_TESTING_SUPPORT
        case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_CHARACTERISTICS:
            client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_RESULT;
            gatt_client_discover_characteristics_for_handle_range_by_uuid16(
                &handle_gatt_client_event,
                client->con_handle, client->start_handle, client->end_handle,
                device_information_characteristics[client->characteristic_index].uuid);
            break;
#endif

        case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_READ_VALUE_OF_CHARACTERISTIC:
            client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_VALUE;

#ifdef ENABLE_TESTING_SUPPORT
            att_status = gatt_client_read_value_of_characteristic_using_value_handle(
                handle_gatt_client_event,
                client->con_handle,
                device_information_characteristic_handles[client->characteristic_index].value_handle);
#else
            att_status = gatt_client_read_value_of_characteristics_by_uuid16(
                handle_gatt_client_event,
                client->con_handle, client->start_handle, client->end_handle,
                device_information_characteristics[client->characteristic_index].uuid);
#endif
            // TODO handle status
            UNUSED(att_status);
            break;

        default:
            break;
    }
}

static void handle_gatt_client_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
    UNUSED(packet_type);
    UNUSED(channel);
    UNUSED(size);

    uint8_t att_status;
    device_information_service_client_t * client = NULL;
    gatt_client_service_t service;
    bool trigger_next_query = false;
#ifdef ENABLE_TESTING_SUPPORT
    gatt_client_characteristic_t characteristic;
#endif

    switch(hci_event_packet_get_type(packet)){

        case GATT_EVENT_SERVICE_QUERY_RESULT:
            client = device_information_service_get_client_for_con_handle(gatt_event_service_query_result_get_handle(packet));
            btstack_assert(client != NULL);

            gatt_event_service_query_result_get_service(packet, &service);
            client->start_handle = service.start_group_handle;
            client->end_handle = service.end_group_handle;

            client->characteristic_index = 0;
            if (client->start_handle < client->end_handle){
                client->num_instances++;
            }
#ifdef ENABLE_TESTING_SUPPORT
            printf("Device Information Service: start handle 0x%04X, end handle 0x%04X, num_instances %d\n", client->start_handle, client->end_handle, client->num_instances);
#endif
            break;

#ifdef ENABLE_TESTING_SUPPORT
        case GATT_EVENT_CHARACTERISTIC_QUERY_RESULT:
            client = device_information_service_get_client_for_con_handle(gatt_event_characteristic_query_result_get_handle(packet));
            btstack_assert(client != NULL);
            gatt_event_characteristic_query_result_get_characteristic(packet, &characteristic);

            device_information_service_update_handle_for_uuid(characteristic.uuid16, characteristic.value_handle);
            printf("Device Information Characteristic %s:  \n    Attribute Handle 0x%04X, Properties 0x%02X, Handle 0x%04X, UUID 0x%04X\n",
                device_information_characteristic_name(characteristic.uuid16),
                characteristic.start_handle,
                characteristic.properties,
                characteristic.value_handle, characteristic.uuid16);
            break;
#endif
        case GATT_EVENT_CHARACTERISTIC_VALUE_QUERY_RESULT:
            client = device_information_service_get_client_for_con_handle(gatt_event_characteristic_value_query_result_get_handle(packet));
            btstack_assert(client != NULL);


            (device_information_characteristics[client->characteristic_index].handle_value(
                client, device_information_characteristics[client->characteristic_index].subevent,
                ATT_ERROR_SUCCESS,
                gatt_event_characteristic_value_query_result_get_value(packet),
                gatt_event_characteristic_value_query_result_get_value_length(packet)));
            break;

        case GATT_EVENT_QUERY_COMPLETE:
            client = device_information_service_get_client_for_con_handle(gatt_event_query_complete_get_handle(packet));
            btstack_assert(client != NULL);

            att_status = gatt_event_query_complete_get_att_status(packet);
            switch (client->state){
                case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_SERVICE_RESULT:
                    if (att_status != ATT_ERROR_SUCCESS){
                        device_information_service_emit_query_done_and_finalize_client(client, att_status);
                        return;
                    }

                    if (client->num_instances != 1){
                        device_information_service_emit_query_done_and_finalize_client(client, ERROR_CODE_UNSUPPORTED_FEATURE_OR_PARAMETER_VALUE);
                        return;
                    }
                    client->characteristic_index = 0;

#ifdef ENABLE_TESTING_SUPPORT
                    client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_CHARACTERISTICS;
#else
                    client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_READ_VALUE_OF_CHARACTERISTIC;
#endif
                    trigger_next_query = true;
                    break;

#ifdef ENABLE_TESTING_SUPPORT
                    case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_RESULT:
                        // check if there is another characteristic to query
                        if ((client->characteristic_index + 1) < num_information_fields){
                            client->characteristic_index++;
                            client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_CHARACTERISTICS;
                            trigger_next_query = true;
                            break;
                        }
                        client->characteristic_index = 0;
                        client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_READ_VALUE_OF_CHARACTERISTIC;
                        trigger_next_query = true;
                        break;
#endif
                case DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W4_CHARACTERISTIC_VALUE:
                    // check if there is another characteristic to query
                    if ((client->characteristic_index + 1) < num_information_fields){
                        client->characteristic_index++;
                        client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_READ_VALUE_OF_CHARACTERISTIC;
                        trigger_next_query = true;
                        break;
                    }
                    // we are done with quering all characteristics
                    device_information_service_emit_query_done_and_finalize_client(client, ERROR_CODE_SUCCESS);
                    return;

                default:
                    break;
            }
            break;
        default:
            break;
    }

    if (trigger_next_query){
        device_informatiom_client_request_send_gatt_query(client);
    }
}

uint8_t device_information_service_client_query(hci_con_handle_t con_handle, btstack_packet_handler_t packet_handler){
    btstack_assert(packet_handler != NULL);
    device_information_service_client_t * client = device_information_service_get_client_for_con_handle(con_handle);

    if (client != NULL){
        return ERROR_CODE_COMMAND_DISALLOWED;
    }

    client = device_information_service_client_get_client();

    if (client->con_handle != HCI_CON_HANDLE_INVALID) {
        return ERROR_CODE_COMMAND_DISALLOWED;
    }

    client->con_handle = con_handle;
    client->client_handler = packet_handler;
    client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_W2_QUERY_SERVICE;

    device_informatiom_client_request_send_gatt_query(client);
    return ERROR_CODE_SUCCESS;
}


void device_information_service_client_init(void){
    device_information_service_client_t * client = device_information_service_client_get_client();
    device_information_service_finalize_client(client);
    device_information_service_handle_can_send_now.callback = &device_information_service_send_next_query;
}

void device_information_service_client_deinit(void){}

// unit test only
#if defined __cplusplus
extern "C"
#endif
void device_information_service_client_set_invalid_state(void);
void device_information_service_client_set_invalid_state(void){
    device_information_service_client_t * client =  device_information_service_client_get_client();
    client->state = DEVICE_INFORMATION_SERVICE_CLIENT_STATE_IDLE;
}