/*

 * Copyright (C) 2012 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */

#ifndef ANDROID_INCLUDE_BLUETOOTH_H

#define ANDROID_INCLUDE_BLUETOOTH_H

#include <stdbool.h>

#include <stdint.h>

#include <sys/cdefs.h>

#include <sys/types.h>

#include <hardware/hardware.h>

__BEGIN_DECLS

/**

 * The Bluetooth Hardware Module ID

 */

#define BT_HARDWARE_MODULE_ID "bluetooth"

#define BT_STACK_MODULE_ID "bluetooth"

#define BT_STACK_TEST_MODULE_ID "bluetooth_test"

/* Bluetooth profile interface IDs */

#define BT_PROFILE_HANDSFREE_ID "handsfree"

#define BT_PROFILE_HANDSFREE_CLIENT_ID "handsfree_client"

#define BT_PROFILE_ADVANCED_AUDIO_ID "a2dp"

#define BT_PROFILE_ADVANCED_AUDIO_SINK_ID "a2dp_sink"

#define BT_PROFILE_HEALTH_ID "health"

#define BT_PROFILE_SOCKETS_ID "socket"

#define BT_PROFILE_HIDHOST_ID "hidhost"

#define BT_PROFILE_PAN_ID "pan"

#define BT_PROFILE_MAP_CLIENT_ID "map_client"

#define BT_PROFILE_GATT_ID "gatt"

#define BT_PROFILE_AV_RC_ID "avrcp"

#define BT_PROFILE_AV_RC_CTRL_ID "avrcp_ctrl"

/** Bluetooth Address */

typedef struct {

    uint8_t address[6];

} __attribute__((packed))bt_bdaddr_t;

/** Bluetooth Device Name */

typedef struct {

    uint8_t name[249];

} __attribute__((packed))bt_bdname_t;

/** Bluetooth Adapter Visibility Modes*/

typedef enum {

    BT_SCAN_MODE_NONE,

    BT_SCAN_MODE_CONNECTABLE,

    BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE

} bt_scan_mode_t;

/** Bluetooth Adapter State */

typedef enum {

    BT_STATE_OFF,

    BT_STATE_ON

}   bt_state_t;

/** Bluetooth Error Status */

/** We need to build on this */

typedef enum {

    BT_STATUS_SUCCESS,

    BT_STATUS_FAIL,

    BT_STATUS_NOT_READY,

    BT_STATUS_NOMEM,

    BT_STATUS_BUSY,

    BT_STATUS_DONE,        /* request already completed */

    BT_STATUS_UNSUPPORTED,

    BT_STATUS_PARM_INVALID,

    BT_STATUS_UNHANDLED,

    BT_STATUS_AUTH_FAILURE,

    BT_STATUS_RMT_DEV_DOWN,

    BT_STATUS_AUTH_REJECTED

} bt_status_t;

/** Bluetooth PinKey Code */

typedef struct {

    uint8_t pin[16];

} __attribute__((packed))bt_pin_code_t;

typedef struct {

    uint8_t status;

    uint8_t ctrl_state;     /* stack reported state */

    uint64_t tx_time;       /* in ms */

    uint64_t rx_time;       /* in ms */

    uint64_t idle_time;     /* in ms */

    uint64_t energy_used;   /* a product of mA, V and ms */

} __attribute__((packed))bt_activity_energy_info;

/** Bluetooth Adapter Discovery state */

typedef enum {

    BT_DISCOVERY_STOPPED,

    BT_DISCOVERY_STARTED

} bt_discovery_state_t;

/** Bluetooth ACL connection state */

typedef enum {

    BT_ACL_STATE_CONNECTED,

    BT_ACL_STATE_DISCONNECTED

} bt_acl_state_t;

/** Bluetooth 128-bit UUID */

typedef struct {

   uint8_t uu[16];

} bt_uuid_t;

/** Bluetooth SDP service record */

typedef struct

{

   bt_uuid_t uuid;

   uint16_t channel;

   char name[256]; // what's the maximum length

} bt_service_record_t;

/** Bluetooth Remote Version info */

typedef struct

{

   int version;

   int sub_ver;

   int manufacturer;

} bt_remote_version_t;

typedef struct

{

    uint8_t local_privacy_enabled;

    uint8_t max_adv_instance;

    uint8_t rpa_offload_supported;

    uint8_t max_irk_list_size;

    uint8_t max_adv_filter_supported;

    uint8_t scan_result_storage_size_lobyte;

    uint8_t scan_result_storage_size_hibyte;

    uint8_t activity_energy_info_supported;

}bt_local_le_features_t;

/* Bluetooth Adapter and Remote Device property types */

typedef enum {

    /* Properties common to both adapter and remote device */

    /**

     * Description - Bluetooth Device Name

     * Access mode - Adapter name can be GET/SET. Remote device can be GET

     * Data type   - bt_bdname_t

     */

    BT_PROPERTY_BDNAME = 0x1,

    /**

     * Description - Bluetooth Device Address

     * Access mode - Only GET.

     * Data type   - bt_bdaddr_t

     */

    BT_PROPERTY_BDADDR,

    /**

     * Description - Bluetooth Service 128-bit UUIDs

     * Access mode - Only GET.

     * Data type   - Array of bt_uuid_t (Array size inferred from property length).

     */

    BT_PROPERTY_UUIDS,

    /**

     * Description - Bluetooth Class of Device as found in Assigned Numbers

     * Access mode - Only GET.

     * Data type   - uint32_t.

     */

    BT_PROPERTY_CLASS_OF_DEVICE,

    /**

     * Description - Device Type - BREDR, BLE or DUAL Mode

     * Access mode - Only GET.

     * Data type   - bt_device_type_t

     */

    BT_PROPERTY_TYPE_OF_DEVICE,

    /**

     * Description - Bluetooth Service Record

     * Access mode - Only GET.

     * Data type   - bt_service_record_t

     */

    BT_PROPERTY_SERVICE_RECORD,

    /* Properties unique to adapter */

    /**

     * Description - Bluetooth Adapter scan mode

     * Access mode - GET and SET

     * Data type   - bt_scan_mode_t.

     */

    BT_PROPERTY_ADAPTER_SCAN_MODE,

    /**

     * Description - List of bonded devices

     * Access mode - Only GET.

     * Data type   - Array of bt_bdaddr_t of the bonded remote devices

     *               (Array size inferred from property length).

     */

    BT_PROPERTY_ADAPTER_BONDED_DEVICES,

    /**

     * Description - Bluetooth Adapter Discovery timeout (in seconds)

     * Access mode - GET and SET

     * Data type   - uint32_t

     */

    BT_PROPERTY_ADAPTER_DISCOVERY_TIMEOUT,

    /* Properties unique to remote device */

    /**

     * Description - User defined friendly name of the remote device

     * Access mode - GET and SET

     * Data type   - bt_bdname_t.

     */

    BT_PROPERTY_REMOTE_FRIENDLY_NAME,

    /**

     * Description - RSSI value of the inquired remote device

     * Access mode - Only GET.

     * Data type   - int32_t.

     */

    BT_PROPERTY_REMOTE_RSSI,

    /**

     * Description - Remote version info

     * Access mode - SET/GET.

     * Data type   - bt_remote_version_t.

     */

    BT_PROPERTY_REMOTE_VERSION_INFO,

    /**

     * Description - Local LE features

     * Access mode - GET.

     * Data type   - bt_local_le_features_t.

     */

    BT_PROPERTY_LOCAL_LE_FEATURES,

    BT_PROPERTY_REMOTE_DEVICE_TIMESTAMP = 0xFF,

} bt_property_type_t;

/** Bluetooth Adapter Property data structure */

typedef struct

{

    bt_property_type_t type;

    int len;

    void *val;

} bt_property_t;

/** Bluetooth Device Type */

typedef enum {

    BT_DEVICE_DEVTYPE_BREDR = 0x1,

    BT_DEVICE_DEVTYPE_BLE,

    BT_DEVICE_DEVTYPE_DUAL

} bt_device_type_t;

/** Bluetooth Bond state */

typedef enum {

    BT_BOND_STATE_NONE,

    BT_BOND_STATE_BONDING,

    BT_BOND_STATE_BONDED

} bt_bond_state_t;

/** Bluetooth SSP Bonding Variant */

typedef enum {

    BT_SSP_VARIANT_PASSKEY_CONFIRMATION,

    BT_SSP_VARIANT_PASSKEY_ENTRY,

    BT_SSP_VARIANT_CONSENT,

    BT_SSP_VARIANT_PASSKEY_NOTIFICATION

} bt_ssp_variant_t;

#define BT_MAX_NUM_UUIDS 32

/** Bluetooth Interface callbacks */

/** Bluetooth Enable/Disable Callback. */

typedef void (*adapter_state_changed_callback)(bt_state_t state);

/** GET/SET Adapter Properties callback */

/* TODO: For the GET/SET property APIs/callbacks, we may need a session

 * identifier to associate the call with the callback. This would be needed

 * whenever more than one simultaneous instance of the same adapter_type

 * is get/set.

 *

 * If this is going to be handled in the Java framework, then we do not need

 * to manage sessions here.

 */

typedef void (*adapter_properties_callback)(bt_status_t status,

                                               int num_properties,

                                               bt_property_t *properties);

/** GET/SET Remote Device Properties callback */

/** TODO: For remote device properties, do not see a need to get/set

 * multiple properties - num_properties shall be 1

 */

typedef void (*remote_device_properties_callback)(bt_status_t status,

                                                       bt_bdaddr_t *bd_addr,

                                                       int num_properties,

                                                       bt_property_t *properties);

/** New device discovered callback */

/** If EIR data is not present, then BD_NAME and RSSI shall be NULL and -1

 * respectively */

typedef void (*device_found_callback)(int num_properties,

                                         bt_property_t *properties);

/** Discovery state changed callback */

typedef void (*discovery_state_changed_callback)(bt_discovery_state_t state);

/** Bluetooth Legacy PinKey Request callback */

typedef void (*pin_request_callback)(bt_bdaddr_t *remote_bd_addr,

                                        bt_bdname_t *bd_name, uint32_t cod);

/** Bluetooth SSP Request callback - Just Works & Numeric Comparison*/

/** pass_key - Shall be 0 for BT_SSP_PAIRING_VARIANT_CONSENT &

 *  BT_SSP_PAIRING_PASSKEY_ENTRY */

/* TODO: Passkey request callback shall not be needed for devices with display

 * capability. We still need support this in the stack for completeness */

typedef void (*ssp_request_callback)(bt_bdaddr_t *remote_bd_addr,

                                        bt_bdname_t *bd_name,

                                        uint32_t cod,

                                        bt_ssp_variant_t pairing_variant,

                                     uint32_t pass_key);

/** Bluetooth Bond state changed callback */

/* Invoked in response to create_bond, cancel_bond or remove_bond */

typedef void (*bond_state_changed_callback)(bt_status_t status,

                                               bt_bdaddr_t *remote_bd_addr,

                                               bt_bond_state_t state);

/** Bluetooth ACL connection state changed callback */

typedef void (*acl_state_changed_callback)(bt_status_t status, bt_bdaddr_t *remote_bd_addr,

                                            bt_acl_state_t state);

typedef enum {

    ASSOCIATE_JVM,

    DISASSOCIATE_JVM

} bt_cb_thread_evt;

/** Thread Associate/Disassociate JVM Callback */

/* Callback that is invoked by the callback thread to allow upper layer to attach/detach to/from

 * the JVM */

typedef void (*callback_thread_event)(bt_cb_thread_evt evt);

/** Bluetooth Test Mode Callback */

/* Receive any HCI event from controller. Must be in DUT Mode for this callback to be received */

typedef void (*dut_mode_recv_callback)(uint16_t opcode, uint8_t *buf, uint8_t len);

/* LE Test mode callbacks

* This callback shall be invoked whenever the le_tx_test, le_rx_test or le_test_end is invoked

* The num_packets is valid only for le_test_end command */

typedef void (*le_test_mode_callback)(bt_status_t status, uint16_t num_packets);

/** Callback invoked when energy details are obtained */

/* Ctrl_state-Current controller state-Active-1,scan-2,or idle-3 state as defined by HCI spec.

 * If the ctrl_state value is 0, it means the API call failed

 * Time values-In milliseconds as returned by the controller

 * Energy used-Value as returned by the controller

 * Status-Provides the status of the read_energy_info API call */

typedef void (*energy_info_callback)(bt_activity_energy_info *energy_info);

/** TODO: Add callbacks for Link Up/Down and other generic

  *  notifications/callbacks */

/** Bluetooth DM callback structure. */

typedef struct {

    /** set to sizeof(bt_callbacks_t) */

    size_t size;

    adapter_state_changed_callback adapter_state_changed_cb;

    adapter_properties_callback adapter_properties_cb;

    remote_device_properties_callback remote_device_properties_cb;

    device_found_callback device_found_cb;

    discovery_state_changed_callback discovery_state_changed_cb;

    pin_request_callback pin_request_cb;

    ssp_request_callback ssp_request_cb;

    bond_state_changed_callback bond_state_changed_cb;

    acl_state_changed_callback acl_state_changed_cb;

    callback_thread_event thread_evt_cb;

    dut_mode_recv_callback dut_mode_recv_cb;

    le_test_mode_callback le_test_mode_cb;

    energy_info_callback energy_info_cb;

} bt_callbacks_t;

typedef void (*alarm_cb)(void *data);

typedef bool (*set_wake_alarm_callout)(uint64_t delay_millis, bool should_wake, alarm_cb cb, void *data);

typedef int (*acquire_wake_lock_callout)(const char *lock_name);

typedef int (*release_wake_lock_callout)(const char *lock_name);

/** The set of functions required by bluedroid to set wake alarms and

  * grab wake locks. This struct is passed into the stack through the

  * |set_os_callouts| function on |bt_interface_t|.

  */

typedef struct {

  /* set to sizeof(bt_os_callouts_t) */

  size_t size;

  set_wake_alarm_callout set_wake_alarm;

  acquire_wake_lock_callout acquire_wake_lock;

  release_wake_lock_callout release_wake_lock;

} bt_os_callouts_t;

/** NOTE: By default, no profiles are initialized at the time of init/enable.

 *  Whenever the application invokes the 'init' API of a profile, then one of

 *  the following shall occur:

 *

 *    1.) If Bluetooth is not enabled, then the Bluetooth core shall mark the

 *        profile as enabled. Subsequently, when the application invokes the

 *        Bluetooth 'enable', as part of the enable sequence the profile that were

 *        marked shall be enabled by calling appropriate stack APIs. The

 *        'adapter_properties_cb' shall return the list of UUIDs of the

 *        enabled profiles.

 *

 *    2.) If Bluetooth is enabled, then the Bluetooth core shall invoke the stack

 *        profile API to initialize the profile and trigger a

 *        'adapter_properties_cb' with the current list of UUIDs including the

 *        newly added profile's UUID.

 *

 *   The reverse shall occur whenever the profile 'cleanup' APIs are invoked

 */

/** Represents the standard Bluetooth DM interface. */

typedef struct {

    /** set to sizeof(bt_interface_t) */

    size_t size;

    /**

     * Opens the interface and provides the callback routines

     * to the implemenation of this interface.

     */

    int (*init)(bt_callbacks_t* callbacks );

    /** Enable Bluetooth. */

    int (*enable)(void);

    /** Disable Bluetooth. */

    int (*disable)(void);

    /** Closes the interface. */

    void (*cleanup)(void);

    /** Get all Bluetooth Adapter properties at init */

    int (*get_adapter_properties)(void);

    /** Get Bluetooth Adapter property of 'type' */

    int (*get_adapter_property)(bt_property_type_t type);

    /** Set Bluetooth Adapter property of 'type' */

    /* Based on the type, val shall be one of

     * bt_bdaddr_t or bt_bdname_t or bt_scanmode_t etc

     */

    int (*set_adapter_property)(const bt_property_t *property);

    /** Get all Remote Device properties */

    int (*get_remote_device_properties)(bt_bdaddr_t *remote_addr);

    /** Get Remote Device property of 'type' */

    int (*get_remote_device_property)(bt_bdaddr_t *remote_addr,

                                      bt_property_type_t type);

    /** Set Remote Device property of 'type' */

    int (*set_remote_device_property)(bt_bdaddr_t *remote_addr,

                                      const bt_property_t *property);

    /** Get Remote Device's service record  for the given UUID */

    int (*get_remote_service_record)(bt_bdaddr_t *remote_addr,

                                     bt_uuid_t *uuid);

    /** Start SDP to get remote services */

    int (*get_remote_services)(bt_bdaddr_t *remote_addr);

    /** Start Discovery */

    int (*start_discovery)(void);

    /** Cancel Discovery */

    int (*cancel_discovery)(void);

    /** Create Bluetooth Bonding */

    int (*create_bond)(const bt_bdaddr_t *bd_addr, int transport);

    /** Remove Bond */

    int (*remove_bond)(const bt_bdaddr_t *bd_addr);

    /** Cancel Bond */

    int (*cancel_bond)(const bt_bdaddr_t *bd_addr);

    /**

     * Get the connection status for a given remote device.

     * return value of 0 means the device is not connected,

     * non-zero return status indicates an active connection.

     */

    int (*get_connection_state)(const bt_bdaddr_t *bd_addr);

    /** BT Legacy PinKey Reply */

    /** If accept==FALSE, then pin_len and pin_code shall be 0x0 */

    int (*pin_reply)(const bt_bdaddr_t *bd_addr, uint8_t accept,

                     uint8_t pin_len, bt_pin_code_t *pin_code);

    /** BT SSP Reply - Just Works, Numeric Comparison and Passkey

     * passkey shall be zero for BT_SSP_VARIANT_PASSKEY_COMPARISON &

     * BT_SSP_VARIANT_CONSENT

     * For BT_SSP_VARIANT_PASSKEY_ENTRY, if accept==FALSE, then passkey

     * shall be zero */

    int (*ssp_reply)(const bt_bdaddr_t *bd_addr, bt_ssp_variant_t variant,

                     uint8_t accept, uint32_t passkey);

    /** Get Bluetooth profile interface */

    const void* (*get_profile_interface) (const char *profile_id);

    /** Bluetooth Test Mode APIs - Bluetooth must be enabled for these APIs */

    /* Configure DUT Mode - Use this mode to enter/exit DUT mode */

    int (*dut_mode_configure)(uint8_t enable);

    /* Send any test HCI (vendor-specific) command to the controller. Must be in DUT Mode */

    int (*dut_mode_send)(uint16_t opcode, uint8_t *buf, uint8_t len);

    /** BLE Test Mode APIs */

    /* opcode MUST be one of: LE_Receiver_Test, LE_Transmitter_Test, LE_Test_End */

    int (*le_test_mode)(uint16_t opcode, uint8_t *buf, uint8_t len);

    /* enable or disable bluetooth HCI snoop log */

    int (*config_hci_snoop_log)(uint8_t enable);

    /** Sets the OS call-out functions that bluedroid needs for alarms and wake locks.

      * This should be called immediately after a successful |init|.

      */

    int (*set_os_callouts)(bt_os_callouts_t *callouts);

    /** Read Energy info details - return value indicates BT_STATUS_SUCCESS or BT_STATUS_NOT_READY

      * Success indicates that the VSC command was sent to controller

      */

    int (*read_energy_info)();

} bt_interface_t;

/** TODO: Need to add APIs for Service Discovery, Service authorization and

  *       connection management. Also need to add APIs for configuring

  *       properties of remote bonded devices such as name, UUID etc. */

typedef struct {

    struct hw_device_t common;

    const bt_interface_t* (*get_bluetooth_interface)();

} bluetooth_device_t;

typedef bluetooth_device_t bluetooth_module_t;

__END_DECLS

#endif /* ANDROID_INCLUDE_BLUETOOTH_H */