/* * Copyright (C) 2014 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 * contact@bluekitchen-gmbh.com * */ #define BTSTACK_FILE__ "hids_device.c" /** * Implementation of the GATT HIDS Device * To use with your application, add '#import ' to your .gatt file */ #include "hids_device.h" #include "ble/att_db.h" #include "ble/att_server.h" #include "bluetooth_gatt.h" #include "btstack_util.h" #include "btstack_debug.h" #define HIDS_DEVICE_ERROR_CODE_INAPPROPRIATE_CONNECTION_PARAMETERS 0x80 // storage for 'generic' HID Device with single Input, Output, and Feature Report static hids_device_report_t hid_reports_generic_storage[3]; typedef struct{ uint16_t con_handle; uint8_t hid_country_code; const uint8_t * hid_descriptor; uint16_t hid_descriptor_size; uint16_t hid_report_map_handle; uint8_t hid_protocol_mode; uint16_t hid_protocol_mode_value_handle; uint16_t hid_boot_mouse_input_value_handle; uint16_t hid_boot_mouse_input_client_configuration_handle; uint16_t hid_boot_mouse_input_client_configuration_value; uint16_t hid_boot_keyboard_input_value_handle; uint16_t hid_boot_keyboard_input_client_configuration_handle; uint16_t hid_boot_keyboard_input_client_configuration_value; hids_device_report_t * hid_reports; uint8_t hid_input_reports_num; uint8_t hid_output_reports_num; uint8_t hid_feature_reports_num; uint16_t hid_control_point_value_handle; uint8_t hid_control_point_suspend; btstack_context_callback_registration_t battery_callback; } hids_device_t; static hids_device_t hids_device; static btstack_packet_handler_t packet_handler; static att_service_handler_t hid_service; // TODO: store hids device connection into list static hids_device_t * hids_device_get_instance_for_con_handle(uint16_t con_handle){ UNUSED(con_handle); return &hids_device; } static hids_device_t * hids_device_create_instance(void){ memset(&hids_device, 0, sizeof(hids_device_t)); return &hids_device; } static hids_device_report_t * hids_device_get_report_for_client_configuration_handle(hids_device_t * device, uint16_t client_configuration_handle){ uint8_t pos; uint8_t total_reports = device->hid_input_reports_num + device->hid_output_reports_num + device->hid_feature_reports_num; for (pos = 0 ; pos < total_reports ; pos++){ if (device->hid_reports[pos].client_configuration_handle == client_configuration_handle){ return &device->hid_reports[pos]; } } return NULL; } static hids_device_report_t * hids_device_get_report_for_type_and_id(hids_device_t * device, hid_report_type_t type, uint16_t report_id){ uint8_t pos; uint8_t total_reports = device->hid_input_reports_num + device->hid_output_reports_num + device->hid_feature_reports_num; for (pos = 0 ; pos < total_reports ; pos++){ if ((device->hid_reports[pos].type == type) && (device->hid_reports[pos].id == report_id)){ return &device->hid_reports[pos]; } } return NULL; } static hids_device_report_t * hids_device_get_report_for_id(hids_device_t * device, uint16_t report_id){ uint8_t pos; uint8_t total_reports = device->hid_input_reports_num + device->hid_output_reports_num + device->hid_feature_reports_num; for (pos = 0 ; pos < total_reports ; pos++){ if (device->hid_reports[pos].id == report_id){ return &device->hid_reports[pos]; } } return NULL; } static void hids_device_emit_event_with_uint8(uint8_t event, hci_con_handle_t con_handle, uint8_t value){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return; } if (!packet_handler) return; uint8_t buffer[6]; buffer[0] = HCI_EVENT_HIDS_META; buffer[1] = 4; buffer[2] = event; little_endian_store_16(buffer, 3, (uint16_t) con_handle); buffer[5] = value; (*packet_handler)(HCI_EVENT_PACKET, 0, buffer, sizeof(buffer)); } static void hids_device_emit_event(uint8_t event, hci_con_handle_t con_handle){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return; } if (!packet_handler) return; uint8_t buffer[5]; buffer[0] = HCI_EVENT_HIDS_META; buffer[1] = 4; buffer[2] = event; little_endian_store_16(buffer, 3, (uint16_t) con_handle); (*packet_handler)(HCI_EVENT_PACKET, 0, buffer, sizeof(buffer)); } static void hids_device_can_send_now(void * context){ hci_con_handle_t con_handle = (hci_con_handle_t) (uintptr_t) context; // notify client hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return; } if (!packet_handler) return; uint8_t buffer[5]; buffer[0] = HCI_EVENT_HIDS_META; buffer[1] = 3; buffer[2] = HIDS_SUBEVENT_CAN_SEND_NOW; little_endian_store_16(buffer, 3, (uint16_t) con_handle); (*packet_handler)(HCI_EVENT_PACKET, 0, buffer, sizeof(buffer)); } // ATT Client Read Callback for Dynamic Data // - if buffer == NULL, don't copy data, just return size of value // - if buffer != NULL, copy data and return number bytes copied static uint16_t att_read_callback(hci_con_handle_t con_handle, uint16_t att_handle, uint16_t offset, uint8_t * buffer, uint16_t buffer_size){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return HIDS_DEVICE_ERROR_CODE_INAPPROPRIATE_CONNECTION_PARAMETERS; } if (att_handle == instance->hid_protocol_mode_value_handle){ log_info("Read protocol mode"); return att_read_callback_handle_byte(instance->hid_protocol_mode, offset, buffer, buffer_size); } if (att_handle == instance->hid_report_map_handle){ log_info("Read report map"); return att_read_callback_handle_blob(instance->hid_descriptor, instance->hid_descriptor_size, offset, buffer, buffer_size); } if (att_handle == instance->hid_boot_mouse_input_client_configuration_handle){ return att_read_callback_handle_little_endian_16(instance->hid_boot_mouse_input_client_configuration_value, offset, buffer, buffer_size); } if (att_handle == instance->hid_boot_keyboard_input_client_configuration_handle){ return att_read_callback_handle_little_endian_16(instance->hid_boot_keyboard_input_client_configuration_value, offset, buffer, buffer_size); } if (att_handle == instance->hid_control_point_value_handle){ if (buffer && (buffer_size >= 1u)){ buffer[0] = instance->hid_control_point_suspend; } return 1; } hids_device_report_t * report = hids_device_get_report_for_client_configuration_handle(instance, att_handle); if (report != NULL){ return att_read_callback_handle_little_endian_16(report->client_configuration_value, offset, buffer, buffer_size); } return 0; } static int att_write_callback(hci_con_handle_t con_handle, uint16_t att_handle, uint16_t transaction_mode, uint16_t offset, uint8_t *buffer, uint16_t buffer_size){ UNUSED(transaction_mode); UNUSED(buffer_size); UNUSED(offset); hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return HIDS_DEVICE_ERROR_CODE_INAPPROPRIATE_CONNECTION_PARAMETERS; } if (att_handle == instance->hid_boot_mouse_input_client_configuration_handle){ uint16_t new_value = little_endian_read_16(buffer, 0); instance->hid_boot_mouse_input_client_configuration_value = new_value; hids_device_emit_event_with_uint8(HIDS_SUBEVENT_BOOT_MOUSE_INPUT_REPORT_ENABLE, con_handle, (uint8_t) new_value); } if (att_handle == instance->hid_boot_keyboard_input_client_configuration_handle){ uint16_t new_value = little_endian_read_16(buffer, 0); instance->hid_boot_keyboard_input_client_configuration_value = new_value; hids_device_emit_event_with_uint8(HIDS_SUBEVENT_BOOT_KEYBOARD_INPUT_REPORT_ENABLE, con_handle, (uint8_t) new_value); } if (att_handle == instance->hid_protocol_mode_value_handle){ instance->hid_protocol_mode = buffer[0]; log_info("Set protocol mode: %u", instance->hid_protocol_mode); hids_device_emit_event_with_uint8(HIDS_SUBEVENT_PROTOCOL_MODE, con_handle, instance->hid_protocol_mode); } if (att_handle == instance->hid_control_point_value_handle){ if (buffer_size < 1u){ return ATT_ERROR_INVALID_OFFSET; } instance->hid_control_point_suspend = buffer[0]; instance->con_handle = con_handle; log_info("Set suspend tp: %u", instance->hid_control_point_suspend ); if (instance->hid_control_point_suspend == 0u){ hids_device_emit_event(HIDS_SUBEVENT_SUSPEND, con_handle); } else if (instance->hid_control_point_suspend == 1u){ hids_device_emit_event(HIDS_SUBEVENT_EXIT_SUSPEND, con_handle); } } hids_device_report_t * report = hids_device_get_report_for_client_configuration_handle(instance, att_handle); if (report != NULL){ uint16_t new_value = little_endian_read_16(buffer, 0); report->client_configuration_value = new_value; log_info("Enable Report (type %u) notifications: %x", (uint8_t) report->type, new_value); switch (report->type){ case HID_REPORT_TYPE_INPUT: hids_device_emit_event_with_uint8(HIDS_SUBEVENT_INPUT_REPORT_ENABLE, con_handle, (uint8_t) new_value); break; case HID_REPORT_TYPE_OUTPUT: hids_device_emit_event_with_uint8(HIDS_SUBEVENT_OUTPUT_REPORT_ENABLE, con_handle, (uint8_t) new_value); break; case HID_REPORT_TYPE_FEATURE: hids_device_emit_event_with_uint8(HIDS_SUBEVENT_FEATURE_REPORT_ENABLE, con_handle, (uint8_t) new_value); break; default: btstack_unreachable(); break; } } return 0; } void hids_device_init_with_storage(uint8_t hid_country_code, const uint8_t * hid_descriptor, uint16_t hid_descriptor_size, uint16_t num_reports, hids_device_report_t * report_storage){ hids_device_t * instance = hids_device_create_instance(); btstack_assert(num_reports > 0); btstack_assert(report_storage != NULL); instance->hid_country_code = hid_country_code; instance->hid_descriptor = hid_descriptor; instance->hid_descriptor_size = hid_descriptor_size; // default instance->hid_protocol_mode = 1; // get service handle range uint16_t start_handle = 0; uint16_t end_handle = 0xffff; int service_found = gatt_server_get_handle_range_for_service_with_uuid16(ORG_BLUETOOTH_SERVICE_HUMAN_INTERFACE_DEVICE, &start_handle, &end_handle); btstack_assert(service_found != 0); UNUSED(service_found); // get report map handle instance->hid_report_map_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_REPORT_MAP); // get report map handle instance->hid_protocol_mode_value_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_PROTOCOL_MODE); // get value and client configuration handles for boot mouse input, boot keyboard input and report input instance->hid_boot_mouse_input_value_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_BOOT_MOUSE_INPUT_REPORT); instance->hid_boot_mouse_input_client_configuration_handle = gatt_server_get_client_configuration_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_BOOT_MOUSE_INPUT_REPORT); instance->hid_boot_keyboard_input_value_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_BOOT_KEYBOARD_INPUT_REPORT); instance->hid_boot_keyboard_input_client_configuration_handle = gatt_server_get_client_configuration_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_BOOT_KEYBOARD_INPUT_REPORT); instance->hid_control_point_value_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_HID_CONTROL_POINT); log_info("hid_report_map_handle 0x%02x", instance->hid_report_map_handle); log_info("hid_protocol_mode_value_handle 0x%02x", instance->hid_protocol_mode_value_handle); log_info("hid_boot_mouse_input_value_handle 0x%02x", instance->hid_boot_mouse_input_value_handle); log_info("hid_boot_mouse_input_client_configuration_handle 0x%02x", instance->hid_boot_mouse_input_client_configuration_handle); log_info("hid_boot_keyboard_input_value_handle 0x%02x", instance->hid_boot_keyboard_input_value_handle); log_info("hid_boot_keyboard_input_client_configuration_handle 0x%02x", instance->hid_boot_keyboard_input_client_configuration_handle); log_info("hid_control_point_value_handle 0x%02x", instance->hid_control_point_value_handle); instance->hid_reports = report_storage; uint16_t hid_reports_num = num_reports; uint16_t assigned_reports_num = 0; uint16_t start_chr_handle = start_handle; while ( (start_chr_handle < end_handle) && (assigned_reports_num < hid_reports_num)) { uint16_t chr_value_handle = gatt_server_get_value_handle_for_characteristic_with_uuid16(start_chr_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_REPORT); if (chr_value_handle == 0){ break; } uint16_t chr_client_configuration_handle = gatt_server_get_client_configuration_handle_for_characteristic_with_uuid16(start_chr_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_REPORT); uint16_t report_reference_handle = gatt_server_get_descriptor_handle_for_characteristic_with_uuid16(start_chr_handle, end_handle, ORG_BLUETOOTH_CHARACTERISTIC_REPORT, ORG_BLUETOOTH_DESCRIPTOR_REPORT_REFERENCE); uint16_t report_reference_value_len; const uint8_t * report_reference_value = gatt_server_get_const_value_for_handle(report_reference_handle, &report_reference_value_len); if (report_reference_value == NULL){ break; } if (report_reference_value_len != 2){ break; } hids_device_report_t * report = &report_storage[assigned_reports_num]; report->value_handle = chr_value_handle; report->client_configuration_handle = chr_client_configuration_handle; report->client_configuration_value = 0; report->id = report_reference_value[0]; report->type = (hid_report_type_t)report_reference_value[1]; switch (report->type){ case HID_REPORT_TYPE_INPUT: instance->hid_input_reports_num++; break; case HID_REPORT_TYPE_OUTPUT: instance->hid_output_reports_num++; break; case HID_REPORT_TYPE_FEATURE: instance->hid_feature_reports_num++; break; default: btstack_unreachable(); return; } log_info("hid_report_value_handle 0x%02x, id %u, type %u", report->value_handle, report->id, (uint8_t)report->type); log_info("hid_report_client_configuration_handle 0x%02x", report->client_configuration_handle); assigned_reports_num++; start_chr_handle = chr_client_configuration_handle + 1; } // register service with ATT Server hid_service.start_handle = start_handle; hid_service.end_handle = end_handle; hid_service.read_callback = &att_read_callback; hid_service.write_callback = &att_write_callback; att_server_register_service_handler(&hid_service); } /** * @brief Set up HIDS Device */ void hids_device_init(uint8_t country_code, const uint8_t * descriptor, uint16_t descriptor_size){ uint16_t hid_reports_num = sizeof(hid_reports_generic_storage) / sizeof(hids_device_report_t); hids_device_init_with_storage(country_code, descriptor, descriptor_size, hid_reports_num, hid_reports_generic_storage); } /** * @brief Register callback for the HIDS Device client. * @param callback */ void hids_device_register_packet_handler(btstack_packet_handler_t callback){ packet_handler = callback; } /** * @brief Request can send now event to send HID Report * Generates an HIDS_SUBEVENT_CAN_SEND_NOW subevent * @param hid_cid */ void hids_device_request_can_send_now_event(hci_con_handle_t con_handle){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return; } instance->battery_callback.callback = &hids_device_can_send_now; instance->battery_callback.context = (void*) (uintptr_t) con_handle; att_server_register_can_send_now_callback(&instance->battery_callback, con_handle); } uint8_t hids_device_send_input_report_for_id(hci_con_handle_t con_handle, uint16_t report_id, const uint8_t * report, uint16_t report_len){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; } hids_device_report_t * report_storage = hids_device_get_report_for_type_and_id(instance, HID_REPORT_TYPE_INPUT, report_id); if (report_storage == NULL){ return ERROR_CODE_UNSUPPORTED_FEATURE_OR_PARAMETER_VALUE; } return att_server_notify(con_handle, report_storage->value_handle, report, report_len); } uint8_t hids_device_send_input_report(hci_con_handle_t con_handle, const uint8_t * report, uint16_t report_len){ hids_device_t * device = hids_device_get_instance_for_con_handle(con_handle); if (!device){ log_error("no instance for handle 0x%02x", con_handle); return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; } uint8_t pos; uint8_t total_reports = device->hid_input_reports_num + device->hid_output_reports_num + device->hid_feature_reports_num; for (pos = 0 ; pos < total_reports ; pos++){ hids_device_report_t * report_storage = &device->hid_reports[pos]; if (report_storage->type == HID_REPORT_TYPE_INPUT){ return att_server_notify(con_handle, report_storage->value_handle, report, report_len); } } return ERROR_CODE_UNSUPPORTED_FEATURE_OR_PARAMETER_VALUE; } /** * @brief Send HID Boot Mouse Input Report */ uint8_t hids_device_send_boot_mouse_input_report(hci_con_handle_t con_handle, const uint8_t * report, uint16_t report_len){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; } return att_server_notify(con_handle, instance->hid_boot_mouse_input_value_handle, report, report_len); } /** * @brief Send HID Boot Mouse Input Report */ uint8_t hids_device_send_boot_keyboard_input_report(hci_con_handle_t con_handle, const uint8_t * report, uint16_t report_len){ hids_device_t * instance = hids_device_get_instance_for_con_handle(con_handle); if (!instance){ log_error("no instance for handle 0x%02x", con_handle); return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; } return att_server_notify(con_handle, instance->hid_boot_keyboard_input_value_handle, report, report_len); }