unleashed-firmware/firmware/targets/f7/ble_glue/services/hid_service.c

#include "hid_service.h"
#include "app_common.h"
#include <ble/ble.h>
#include "gatt_char.h"

#include <furi.h>

#define TAG "BtHid"

typedef enum {
    HidSvcGattCharacteristicProtocolMode = 0,
    HidSvcGattCharacteristicReportMap,
    HidSvcGattCharacteristicInfo,
    HidSvcGattCharacteristicCtrlPoint,
    HidSvcGattCharacteristicLed,
    HidSvcGattCharacteristicCount,
} HidSvcGattCharacteristicId;

typedef struct {
    uint8_t report_idx;
    uint8_t report_type;
} HidSvcReportId;

static_assert(sizeof(HidSvcReportId) == sizeof(uint16_t), "HidSvcReportId must be 2 bytes");

static bool
    hid_svc_char_desc_data_callback(const void* context, const uint8_t** data, uint16_t* data_len) {
    const HidSvcReportId* report_id = context;
    *data_len = sizeof(HidSvcReportId);
    if(data) {
        *data = (const uint8_t*)report_id;
    }
    return false;
}

typedef struct {
    const void* data_ptr;
    uint16_t data_len;
} HidSvcDataWrapper;

static bool
    hid_svc_report_data_callback(const void* context, const uint8_t** data, uint16_t* data_len) {
    const HidSvcDataWrapper* report_data = context;
    if(data) {
        *data = report_data->data_ptr;
        *data_len = report_data->data_len;
    } else {
        *data_len = HID_SVC_REPORT_MAP_MAX_LEN;
    }
    return false;
}

static FlipperGattCharacteristicDescriptorParams hid_svc_char_descr_led = {
    .uuid_type = UUID_TYPE_16,
    .uuid.Char_UUID_16 = REPORT_REFERENCE_DESCRIPTOR_UUID,
    .max_length = HID_SVC_REPORT_REF_LEN,
    .data_callback.fn = hid_svc_char_desc_data_callback,
    .security_permissions = ATTR_PERMISSION_NONE,
    .access_permissions = ATTR_ACCESS_READ_WRITE,
    .gatt_evt_mask = GATT_DONT_NOTIFY_EVENTS,
    .is_variable = CHAR_VALUE_LEN_CONSTANT,
};

static const FlipperGattCharacteristicParams hid_svc_chars[HidSvcGattCharacteristicCount] = {
    [HidSvcGattCharacteristicProtocolMode] =
        {.name = "Protocol Mode",
         .data_prop_type = FlipperGattCharacteristicDataFixed,
         .data.fixed.length = 1,
         .uuid.Char_UUID_16 = PROTOCOL_MODE_CHAR_UUID,
         .uuid_type = UUID_TYPE_16,
         .char_properties = CHAR_PROP_READ | CHAR_PROP_WRITE_WITHOUT_RESP,
         .security_permissions = ATTR_PERMISSION_NONE,
         .gatt_evt_mask = GATT_NOTIFY_ATTRIBUTE_WRITE,
         .is_variable = CHAR_VALUE_LEN_CONSTANT},
    [HidSvcGattCharacteristicReportMap] =
        {.name = "Report Map",
         .data_prop_type = FlipperGattCharacteristicDataCallback,
         .data.callback.fn = hid_svc_report_data_callback,
         .data.callback.context = NULL,
         .uuid.Char_UUID_16 = REPORT_MAP_CHAR_UUID,
         .uuid_type = UUID_TYPE_16,
         .char_properties = CHAR_PROP_READ,
         .security_permissions = ATTR_PERMISSION_NONE,
         .gatt_evt_mask = GATT_DONT_NOTIFY_EVENTS,
         .is_variable = CHAR_VALUE_LEN_VARIABLE},
    [HidSvcGattCharacteristicInfo] =
        {.name = "HID Information",
         .data_prop_type = FlipperGattCharacteristicDataFixed,
         .data.fixed.length = HID_SVC_INFO_LEN,
         .data.fixed.ptr = NULL,
         .uuid.Char_UUID_16 = HID_INFORMATION_CHAR_UUID,
         .uuid_type = UUID_TYPE_16,
         .char_properties = CHAR_PROP_READ,
         .security_permissions = ATTR_PERMISSION_NONE,
         .gatt_evt_mask = GATT_DONT_NOTIFY_EVENTS,
         .is_variable = CHAR_VALUE_LEN_CONSTANT},
    [HidSvcGattCharacteristicCtrlPoint] =
        {.name = "HID Control Point",
         .data_prop_type = FlipperGattCharacteristicDataFixed,
         .data.fixed.length = HID_SVC_CONTROL_POINT_LEN,
         .uuid.Char_UUID_16 = HID_CONTROL_POINT_CHAR_UUID,
         .uuid_type = UUID_TYPE_16,
         .char_properties = CHAR_PROP_WRITE_WITHOUT_RESP,
         .security_permissions = ATTR_PERMISSION_NONE,
         .gatt_evt_mask = GATT_NOTIFY_ATTRIBUTE_WRITE,
         .is_variable = CHAR_VALUE_LEN_CONSTANT},
    [HidSvcGattCharacteristicLed] =
        {
            .name = "HID LED State",
            .data_prop_type = FlipperGattCharacteristicDataFixed,
            .data.fixed.length = 1,
            .uuid.Char_UUID_16 = REPORT_CHAR_UUID,
            .uuid_type = UUID_TYPE_16,
            .char_properties = CHAR_PROP_READ | CHAR_PROP_WRITE_WITHOUT_RESP | CHAR_PROP_WRITE,
            .security_permissions = ATTR_PERMISSION_NONE,
            .gatt_evt_mask = GATT_NOTIFY_ATTRIBUTE_WRITE |
                             GATT_NOTIFY_WRITE_REQ_AND_WAIT_FOR_APPL_RESP,
            .is_variable = CHAR_VALUE_LEN_CONSTANT,
            .descriptor_params = &hid_svc_char_descr_led,
        },
};

static const FlipperGattCharacteristicDescriptorParams hid_svc_char_descr_template = {
    .uuid_type = UUID_TYPE_16,
    .uuid.Char_UUID_16 = REPORT_REFERENCE_DESCRIPTOR_UUID,
    .max_length = HID_SVC_REPORT_REF_LEN,
    .data_callback.fn = hid_svc_char_desc_data_callback,
    .security_permissions = ATTR_PERMISSION_NONE,
    .access_permissions = ATTR_ACCESS_READ_WRITE,
    .gatt_evt_mask = GATT_DONT_NOTIFY_EVENTS,
    .is_variable = CHAR_VALUE_LEN_CONSTANT,
};

static const FlipperGattCharacteristicParams hid_svc_report_template = {
    .name = "Report",
    .data_prop_type = FlipperGattCharacteristicDataCallback,
    .data.callback.fn = hid_svc_report_data_callback,
    .data.callback.context = NULL,
    .uuid.Char_UUID_16 = REPORT_CHAR_UUID,
    .uuid_type = UUID_TYPE_16,
    .char_properties = CHAR_PROP_READ | CHAR_PROP_NOTIFY,
    .security_permissions = ATTR_PERMISSION_NONE,
    .gatt_evt_mask = GATT_DONT_NOTIFY_EVENTS,
    .is_variable = CHAR_VALUE_LEN_VARIABLE,
};

typedef struct {
    uint16_t svc_handle;
    FlipperGattCharacteristicInstance chars[HidSvcGattCharacteristicCount];
    FlipperGattCharacteristicInstance input_report_chars[HID_SVC_INPUT_REPORT_COUNT];
    FlipperGattCharacteristicInstance output_report_chars[HID_SVC_OUTPUT_REPORT_COUNT];
    FlipperGattCharacteristicInstance feature_report_chars[HID_SVC_FEATURE_REPORT_COUNT];
    // led state
    HidLedStateEventCallback led_state_event_callback;
    void* led_state_ctx;
} HIDSvc;

static HIDSvc* hid_svc = NULL;

static SVCCTL_EvtAckStatus_t hid_svc_event_handler(void* event) {
    SVCCTL_EvtAckStatus_t ret = SVCCTL_EvtNotAck;
    hci_event_pckt* event_pckt = (hci_event_pckt*)(((hci_uart_pckt*)event)->data);
    evt_blecore_aci* blecore_evt = (evt_blecore_aci*)event_pckt->data;
    // aci_gatt_attribute_modified_event_rp0* attribute_modified;
    if(event_pckt->evt == HCI_VENDOR_SPECIFIC_DEBUG_EVT_CODE) {
        if(blecore_evt->ecode == ACI_GATT_ATTRIBUTE_MODIFIED_VSEVT_CODE) {
            // Process modification events
            ret = SVCCTL_EvtAckFlowEnable;
        } else if(blecore_evt->ecode == ACI_GATT_SERVER_CONFIRMATION_VSEVT_CODE) {
            // Process notification confirmation
            ret = SVCCTL_EvtAckFlowEnable;
        } else if(blecore_evt->ecode == ACI_GATT_WRITE_PERMIT_REQ_VSEVT_CODE) {
            // Process write request
            aci_gatt_write_permit_req_event_rp0* req =
                (aci_gatt_write_permit_req_event_rp0*)blecore_evt->data;

            furi_check(hid_svc->led_state_event_callback && hid_svc->led_state_ctx);

            // this check is likely to be incorrect, it will actually work in our case
            // but we need to investigate gatt api to see what is the rules
            // that specify attibute handle value from char handle (or the reverse)
            if(req->Attribute_Handle == (hid_svc->chars[HidSvcGattCharacteristicLed].handle + 1)) {
                hid_svc->led_state_event_callback(req->Data[0], hid_svc->led_state_ctx);
                aci_gatt_write_resp(
                    req->Connection_Handle,
                    req->Attribute_Handle,
                    0x00, /* write_status = 0 (no error))*/
                    0x00, /* err_code */
                    req->Data_Length,
                    req->Data);
                aci_gatt_write_char_value(
                    req->Connection_Handle,
                    hid_svc->chars[HidSvcGattCharacteristicLed].handle,
                    req->Data_Length,
                    req->Data);
                ret = SVCCTL_EvtAckFlowEnable;
            }
        }
    }
    return ret;
}

void hid_svc_start() {
    tBleStatus status;
    hid_svc = malloc(sizeof(HIDSvc));
    Service_UUID_t svc_uuid = {};

    // Register event handler
    SVCCTL_RegisterSvcHandler(hid_svc_event_handler);
    // Add service
    svc_uuid.Service_UUID_16 = HUMAN_INTERFACE_DEVICE_SERVICE_UUID;
    /**
     *  Add Human Interface Device Service
     */
    status = aci_gatt_add_service(
        UUID_TYPE_16,
        &svc_uuid,
        PRIMARY_SERVICE,
        2 + /* protocol mode */
            (4 * HID_SVC_INPUT_REPORT_COUNT) + (3 * HID_SVC_OUTPUT_REPORT_COUNT) +
            (3 * HID_SVC_FEATURE_REPORT_COUNT) + 1 + 2 + 2 + 2 +
            4, /* Service + Report Map + HID Information + HID Control Point + LED state */
        &hid_svc->svc_handle);
    if(status) {
        FURI_LOG_E(TAG, "Failed to add HID service: %d", status);
    }

    for(size_t i = 0; i < HidSvcGattCharacteristicCount; i++) {
        flipper_gatt_characteristic_init(
            hid_svc->svc_handle, &hid_svc_chars[i], &hid_svc->chars[i]);
    }
    uint8_t protocol_mode = 1;
    flipper_gatt_characteristic_update(
        hid_svc->svc_handle,
        &hid_svc->chars[HidSvcGattCharacteristicProtocolMode],
        &protocol_mode);

    // reports
    FlipperGattCharacteristicDescriptorParams hid_svc_char_descr;
    FlipperGattCharacteristicParams report_char;
    HidSvcReportId report_id;

    memcpy(&hid_svc_char_descr, &hid_svc_char_descr_template, sizeof(hid_svc_char_descr));
    memcpy(&report_char, &hid_svc_report_template, sizeof(report_char));

    hid_svc_char_descr.data_callback.context = &report_id;
    report_char.descriptor_params = &hid_svc_char_descr;

    typedef struct {
        uint8_t report_type;
        uint8_t report_count;
        FlipperGattCharacteristicInstance* chars;
    } HidSvcReportCharProps;

    HidSvcReportCharProps hid_report_chars[] = {
        {0x01, HID_SVC_INPUT_REPORT_COUNT, hid_svc->input_report_chars},
        {0x02, HID_SVC_OUTPUT_REPORT_COUNT, hid_svc->output_report_chars},
        {0x03, HID_SVC_FEATURE_REPORT_COUNT, hid_svc->feature_report_chars},
    };

    for(size_t report_type_idx = 0; report_type_idx < COUNT_OF(hid_report_chars);
        report_type_idx++) {
        report_id.report_type = hid_report_chars[report_type_idx].report_type;
        for(size_t report_idx = 0; report_idx < hid_report_chars[report_type_idx].report_count;
            report_idx++) {
            report_id.report_idx = report_idx + 1;
            flipper_gatt_characteristic_init(
                hid_svc->svc_handle,
                &report_char,
                &hid_report_chars[report_type_idx].chars[report_idx]);
        }
    }
}

bool hid_svc_update_report_map(const uint8_t* data, uint16_t len) {
    furi_assert(data);
    furi_assert(hid_svc);

    HidSvcDataWrapper report_data = {
        .data_ptr = data,
        .data_len = len,
    };
    return flipper_gatt_characteristic_update(
        hid_svc->svc_handle, &hid_svc->chars[HidSvcGattCharacteristicReportMap], &report_data);
}

bool hid_svc_update_input_report(uint8_t input_report_num, uint8_t* data, uint16_t len) {
    furi_assert(data);
    furi_assert(hid_svc);
    furi_assert(input_report_num < HID_SVC_INPUT_REPORT_COUNT);

    HidSvcDataWrapper report_data = {
        .data_ptr = data,
        .data_len = len,
    };
    return flipper_gatt_characteristic_update(
        hid_svc->svc_handle, &hid_svc->input_report_chars[input_report_num], &report_data);
}

bool hid_svc_update_info(uint8_t* data) {
    furi_assert(data);
    furi_assert(hid_svc);

    return flipper_gatt_characteristic_update(
        hid_svc->svc_handle, &hid_svc->chars[HidSvcGattCharacteristicInfo], &data);
}

void hid_svc_register_led_state_callback(HidLedStateEventCallback callback, void* context) {
    furi_assert(hid_svc);
    furi_assert(callback);
    furi_assert(context);

    hid_svc->led_state_event_callback = callback;
    hid_svc->led_state_ctx = context;
}

bool hid_svc_is_started() {
    return hid_svc != NULL;
}

void hid_svc_stop() {
    tBleStatus status;
    if(hid_svc) {
        // Delete characteristics
        for(size_t i = 0; i < HidSvcGattCharacteristicCount; i++) {
            flipper_gatt_characteristic_delete(hid_svc->svc_handle, &hid_svc->chars[i]);
        }

        typedef struct {
            uint8_t report_count;
            FlipperGattCharacteristicInstance* chars;
        } HidSvcReportCharProps;

        HidSvcReportCharProps hid_report_chars[] = {
            {HID_SVC_INPUT_REPORT_COUNT, hid_svc->input_report_chars},
            {HID_SVC_OUTPUT_REPORT_COUNT, hid_svc->output_report_chars},
            {HID_SVC_FEATURE_REPORT_COUNT, hid_svc->feature_report_chars},
        };

        for(size_t report_type_idx = 0; report_type_idx < COUNT_OF(hid_report_chars);
            report_type_idx++) {
            for(size_t report_idx = 0; report_idx < hid_report_chars[report_type_idx].report_count;
                report_idx++) {
                flipper_gatt_characteristic_delete(
                    hid_svc->svc_handle, &hid_report_chars[report_type_idx].chars[report_idx]);
            }
        }

        // Delete service
        status = aci_gatt_del_service(hid_svc->svc_handle);
        if(status) {
            FURI_LOG_E(TAG, "Failed to delete HID service: %d", status);
        }
        free(hid_svc);
        hid_svc = NULL;
    }
}