/* -*- Mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 40 -*- */ /* vim: set ts=2 et sw=2 tw=80: */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this file, * You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_dom_bluetooth_bluetoothcommon_h__ #define mozilla_dom_bluetooth_bluetoothcommon_h__ #include "mozilla/Observer.h" #include "nsPrintfCString.h" #include "nsString.h" #include "nsTArray.h" extern bool gBluetoothDebugFlag; #define SWITCH_BT_DEBUG(V) (gBluetoothDebugFlag = V) #if MOZ_IS_GCC /* use designated array initializers if supported */ #define INIT_ARRAY_AT(in_, out_) \ [in_] = out_ #else /* otherwise init array element by position */ #define INIT_ARRAY_AT(in_, out_) \ out_ #endif #define CONVERT(in_, out_) \ INIT_ARRAY_AT(in_, out_) #undef BT_LOG #if defined(MOZ_WIDGET_GONK) #include /** * Prints 'D'EBUG build logs, which show in DEBUG build only when * developer setting 'Bluetooth output in adb' is enabled. */ #define BT_LOGD(msg, ...) \ do { \ if (gBluetoothDebugFlag) { \ __android_log_print(ANDROID_LOG_INFO, "GoannaBluetooth", \ "%s: " msg, __FUNCTION__, ##__VA_ARGS__); \ } \ } while(0) /** * Prints 'R'ELEASE build logs, which show in both RELEASE and DEBUG builds. */ #define BT_LOGR(msg, ...) \ __android_log_print(ANDROID_LOG_INFO, "GoannaBluetooth", \ "%s: " msg, __FUNCTION__, ##__VA_ARGS__) \ /** * Prints DEBUG build warnings, which show in DEBUG build only. */ #define BT_WARNING(args...) \ NS_WARNING(nsPrintfCString(args).get()) \ #else #define BT_LOGD(msg, ...) \ do { \ if (gBluetoothDebugFlag) { \ printf("%s: " msg, __FUNCTION__, ##__VA_ARGS__); \ } \ } while(0) #define BT_LOGR(msg, ...) printf("%s: " msg, __FUNCTION__, ##__VA_ARGS__) #define BT_WARNING(msg, ...) printf("%s: " msg, __FUNCTION__, ##__VA_ARGS__) #endif /** * Prints 'R'ELEASE build logs for WebBluetooth API v2. */ #define BT_API2_LOGR(msg, ...) \ BT_LOGR("[WEBBT-API2] " msg, ##__VA_ARGS__) /** * Wrap literal name and value into a BluetoothNamedValue * and append it to the array. */ #define BT_APPEND_NAMED_VALUE(array, name, value) \ array.AppendElement(BluetoothNamedValue(NS_LITERAL_STRING(name), \ BluetoothValue(value))) /** * Ensure success of system message broadcast with void return. */ #define BT_ENSURE_TRUE_VOID_BROADCAST_SYSMSG(type, parameters) \ do { \ if (!BroadcastSystemMessage(type, parameters)) { \ BT_WARNING("Failed to broadcast [%s]", \ NS_ConvertUTF16toUTF8(type).get()); \ return; \ } \ } while(0) /** * Convert an enum value to string then append it to an array. */ #define BT_APPEND_ENUM_STRING(array, enumType, enumValue) \ do { \ uint32_t index = uint32_t(enumValue); \ nsAutoString name; \ name.AssignASCII(enumType##Values::strings[index].value, \ enumType##Values::strings[index].length); \ array.AppendElement(name); \ } while(0) \ /** * Resolve promise with |ret| if |x| is false. */ #define BT_ENSURE_TRUE_RESOLVE(x, ret) \ do { \ if (MOZ_UNLIKELY(!(x))) { \ BT_API2_LOGR("BT_ENSURE_TRUE_RESOLVE(" #x ") failed"); \ promise->MaybeResolve(ret); \ return promise.forget(); \ } \ } while(0) /** * Reject promise with |ret| if |x| is false. */ #define BT_ENSURE_TRUE_REJECT(x, ret) \ do { \ if (MOZ_UNLIKELY(!(x))) { \ BT_API2_LOGR("BT_ENSURE_TRUE_REJECT(" #x ") failed"); \ promise->MaybeReject(ret); \ return promise.forget(); \ } \ } while(0) #define BEGIN_BLUETOOTH_NAMESPACE \ namespace mozilla { namespace dom { namespace bluetooth { #define END_BLUETOOTH_NAMESPACE \ } /* namespace bluetooth */ } /* namespace dom */ } /* namespace mozilla */ #define USING_BLUETOOTH_NAMESPACE \ using namespace mozilla::dom::bluetooth; #define KEY_LOCAL_AGENT "/B2G/bluetooth/agent" #define KEY_REMOTE_AGENT "/B2G/bluetooth/remote_device_agent" #define KEY_MANAGER "/B2G/bluetooth/manager" #define KEY_ADAPTER "/B2G/bluetooth/adapter" #define KEY_PAIRING_LISTENER "/B2G/bluetooth/pairing_listener" /** * When the connection status of a Bluetooth profile is changed, we'll notify * observers which register the following topics. */ #define BLUETOOTH_A2DP_STATUS_CHANGED_ID "bluetooth-a2dp-status-changed" #define BLUETOOTH_HFP_STATUS_CHANGED_ID "bluetooth-hfp-status-changed" #define BLUETOOTH_HID_STATUS_CHANGED_ID "bluetooth-hid-status-changed" #define BLUETOOTH_SCO_STATUS_CHANGED_ID "bluetooth-sco-status-changed" /** * When the connection status of a Bluetooth profile is changed, we'll * dispatch one of the following events. */ #define A2DP_STATUS_CHANGED_ID "a2dpstatuschanged" #define HFP_STATUS_CHANGED_ID "hfpstatuschanged" #define SCO_STATUS_CHANGED_ID "scostatuschanged" /** * Types of pairing requests for constructing BluetoothPairingEvent and * BluetoothPairingHandle. */ #define PAIRING_REQ_TYPE_DISPLAYPASSKEY "displaypasskeyreq" #define PAIRING_REQ_TYPE_ENTERPINCODE "enterpincodereq" #define PAIRING_REQ_TYPE_CONFIRMATION "pairingconfirmationreq" #define PAIRING_REQ_TYPE_CONSENT "pairingconsentreq" /** * System message to launch bluetooth app if no pairing listener is ready to * receive pairing requests. */ #define SYS_MSG_BT_PAIRING_REQ "bluetooth-pairing-request" /** * The app origin of bluetooth app, which is responsible for listening pairing * requests. */ #define BLUETOOTH_APP_ORIGIN "app://bluetooth.gaiamobile.org" /** * When a remote device gets paired / unpaired with local bluetooth adapter, * we'll dispatch an event. */ #define DEVICE_PAIRED_ID "devicepaired" #define DEVICE_UNPAIRED_ID "deviceunpaired" /** * When receiving a query about current play status from remote device, we'll * dispatch an event. */ #define REQUEST_MEDIA_PLAYSTATUS_ID "requestmediaplaystatus" /** * When a remote BLE device gets connected / disconnected, we'll dispatch an * event */ #define GATT_CONNECTION_STATE_CHANGED_ID "connectionstatechanged" // Bluetooth address format: xx:xx:xx:xx:xx:xx (or xx_xx_xx_xx_xx_xx) #define BLUETOOTH_ADDRESS_LENGTH 17 #define BLUETOOTH_ADDRESS_NONE "00:00:00:00:00:00" #define BLUETOOTH_ADDRESS_BYTES 6 // Bluetooth stack internal error, such as I/O error #define ERR_INTERNAL_ERROR "InternalError" /** * BT specification v4.1 defines the maximum attribute length as 512 octets. * Currently use 600 here to conform to bluedroid's BTGATT_MAX_ATTR_LEN. */ #define BLUETOOTH_GATT_MAX_ATTR_LEN 600 BEGIN_BLUETOOTH_NAMESPACE enum BluetoothStatus { STATUS_SUCCESS, STATUS_FAIL, STATUS_NOT_READY, STATUS_NOMEM, STATUS_BUSY, STATUS_DONE, STATUS_UNSUPPORTED, STATUS_PARM_INVALID, STATUS_UNHANDLED, STATUS_AUTH_FAILURE, STATUS_RMT_DEV_DOWN }; enum BluetoothBondState { BOND_STATE_NONE, BOND_STATE_BONDING, BOND_STATE_BONDED }; enum BluetoothTypeOfDevice { TYPE_OF_DEVICE_BREDR, TYPE_OF_DEVICE_BLE, TYPE_OF_DEVICE_DUAL }; enum BluetoothPropertyType { PROPERTY_UNKNOWN, PROPERTY_BDNAME, PROPERTY_BDADDR, PROPERTY_UUIDS, PROPERTY_CLASS_OF_DEVICE, PROPERTY_TYPE_OF_DEVICE, PROPERTY_SERVICE_RECORD, PROPERTY_ADAPTER_SCAN_MODE, PROPERTY_ADAPTER_BONDED_DEVICES, PROPERTY_ADAPTER_DISCOVERY_TIMEOUT, PROPERTY_REMOTE_FRIENDLY_NAME, PROPERTY_REMOTE_RSSI, PROPERTY_REMOTE_VERSION_INFO, PROPERTY_REMOTE_DEVICE_TIMESTAMP }; enum BluetoothScanMode { SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE }; enum BluetoothSspVariant { SSP_VARIANT_PASSKEY_CONFIRMATION, SSP_VARIANT_PASSKEY_ENTRY, SSP_VARIANT_CONSENT, SSP_VARIANT_PASSKEY_NOTIFICATION }; struct BluetoothUuid { uint8_t mUuid[16]; }; struct BluetoothServiceRecord { BluetoothUuid mUuid; uint16_t mChannel; char mName[256]; }; struct BluetoothRemoteInfo { int mVerMajor; int mVerMinor; int mManufacturer; }; struct BluetoothProperty { /* Type */ BluetoothPropertyType mType; /* Value */ /* PROPERTY_BDNAME PROPERTY_BDADDR PROPERTY_REMOTE_FRIENDLY_NAME */ nsString mString; /* PROPERTY_UUIDS */ nsTArray mUuidArray; /* PROPERTY_ADAPTER_BONDED_DEVICES */ nsTArray mStringArray; /* PROPERTY_CLASS_OF_DEVICE PROPERTY_ADAPTER_DISCOVERY_TIMEOUT */ uint32_t mUint32; /* PROPERTY_RSSI_VALUE */ int32_t mInt32; /* PROPERTY_TYPE_OF_DEVICE */ BluetoothTypeOfDevice mTypeOfDevice; /* PROPERTY_SERVICE_RECORD */ BluetoothServiceRecord mServiceRecord; /* PROPERTY_SCAN_MODE */ BluetoothScanMode mScanMode; /* PROPERTY_REMOTE_VERSION_INFO */ BluetoothRemoteInfo mRemoteInfo; }; enum BluetoothSocketType { RFCOMM = 1, SCO = 2, L2CAP = 3, EL2CAP = 4 }; enum BluetoothHandsfreeAtResponse { HFP_AT_RESPONSE_ERROR, HFP_AT_RESPONSE_OK }; enum BluetoothHandsfreeAudioState { HFP_AUDIO_STATE_DISCONNECTED, HFP_AUDIO_STATE_CONNECTING, HFP_AUDIO_STATE_CONNECTED, HFP_AUDIO_STATE_DISCONNECTING, }; enum BluetoothHandsfreeCallAddressType { HFP_CALL_ADDRESS_TYPE_UNKNOWN, HFP_CALL_ADDRESS_TYPE_INTERNATIONAL }; enum BluetoothHandsfreeCallDirection { HFP_CALL_DIRECTION_OUTGOING, HFP_CALL_DIRECTION_INCOMING }; enum BluetoothHandsfreeCallHoldType { HFP_CALL_HOLD_RELEASEHELD, HFP_CALL_HOLD_RELEASEACTIVE_ACCEPTHELD, HFP_CALL_HOLD_HOLDACTIVE_ACCEPTHELD, HFP_CALL_HOLD_ADDHELDTOCONF }; enum BluetoothHandsfreeCallMode { HFP_CALL_MODE_VOICE, HFP_CALL_MODE_DATA, HFP_CALL_MODE_FAX }; enum BluetoothHandsfreeCallMptyType { HFP_CALL_MPTY_TYPE_SINGLE, HFP_CALL_MPTY_TYPE_MULTI }; enum BluetoothHandsfreeCallState { HFP_CALL_STATE_ACTIVE, HFP_CALL_STATE_HELD, HFP_CALL_STATE_DIALING, HFP_CALL_STATE_ALERTING, HFP_CALL_STATE_INCOMING, HFP_CALL_STATE_WAITING, HFP_CALL_STATE_IDLE }; enum BluetoothHandsfreeConnectionState { HFP_CONNECTION_STATE_DISCONNECTED, HFP_CONNECTION_STATE_CONNECTING, HFP_CONNECTION_STATE_CONNECTED, HFP_CONNECTION_STATE_SLC_CONNECTED, HFP_CONNECTION_STATE_DISCONNECTING }; enum BluetoothHandsfreeNetworkState { HFP_NETWORK_STATE_NOT_AVAILABLE, HFP_NETWORK_STATE_AVAILABLE }; enum BluetoothHandsfreeNRECState { HFP_NREC_STOPPED, HFP_NREC_STARTED }; enum BluetoothHandsfreeServiceType { HFP_SERVICE_TYPE_HOME, HFP_SERVICE_TYPE_ROAMING }; enum BluetoothHandsfreeVoiceRecognitionState { HFP_VOICE_RECOGNITION_STOPPED, HFP_VOICE_RECOGNITION_STARTED }; enum BluetoothHandsfreeVolumeType { HFP_VOLUME_TYPE_SPEAKER, HFP_VOLUME_TYPE_MICROPHONE }; class BluetoothSignal; typedef mozilla::Observer BluetoothSignalObserver; // Enums for object types, currently used for shared function lookups // (get/setproperty, etc...). Possibly discernable via dbus paths, but this // method is future-proofed for platform independence. enum BluetoothObjectType { TYPE_MANAGER = 0, TYPE_ADAPTER = 1, TYPE_DEVICE = 2, TYPE_INVALID }; enum BluetoothA2dpAudioState { A2DP_AUDIO_STATE_REMOTE_SUSPEND, A2DP_AUDIO_STATE_STOPPED, A2DP_AUDIO_STATE_STARTED, }; enum BluetoothA2dpConnectionState { A2DP_CONNECTION_STATE_DISCONNECTED, A2DP_CONNECTION_STATE_CONNECTING, A2DP_CONNECTION_STATE_CONNECTED, A2DP_CONNECTION_STATE_DISCONNECTING }; enum ControlPlayStatus { PLAYSTATUS_STOPPED = 0x00, PLAYSTATUS_PLAYING = 0x01, PLAYSTATUS_PAUSED = 0x02, PLAYSTATUS_FWD_SEEK = 0x03, PLAYSTATUS_REV_SEEK = 0x04, PLAYSTATUS_UNKNOWN, PLAYSTATUS_ERROR = 0xFF, }; enum { AVRCP_UID_SIZE = 8 }; enum BluetoothAvrcpMediaAttribute { AVRCP_MEDIA_ATTRIBUTE_TITLE, AVRCP_MEDIA_ATTRIBUTE_ARTIST, AVRCP_MEDIA_ATTRIBUTE_ALBUM, AVRCP_MEDIA_ATTRIBUTE_TRACK_NUM, AVRCP_MEDIA_ATTRIBUTE_NUM_TRACKS, AVRCP_MEDIA_ATTRIBUTE_GENRE, AVRCP_MEDIA_ATTRIBUTE_PLAYING_TIME }; enum BluetoothAvrcpPlayerAttribute { AVRCP_PLAYER_ATTRIBUTE_EQUALIZER, AVRCP_PLAYER_ATTRIBUTE_REPEAT, AVRCP_PLAYER_ATTRIBUTE_SHUFFLE, AVRCP_PLAYER_ATTRIBUTE_SCAN }; enum BluetoothAvrcpStatus { AVRCP_STATUS_BAD_COMMAND, AVRCP_STATUS_BAD_PARAMETER, AVRCP_STATUS_NOT_FOUND, AVRCP_STATUS_INTERNAL_ERROR, AVRCP_STATUS_SUCCESS }; enum BluetoothAvrcpEvent { AVRCP_EVENT_PLAY_STATUS_CHANGED, AVRCP_EVENT_TRACK_CHANGE, AVRCP_EVENT_TRACK_REACHED_END, AVRCP_EVENT_TRACK_REACHED_START, AVRCP_EVENT_PLAY_POS_CHANGED, AVRCP_EVENT_APP_SETTINGS_CHANGED }; enum BluetoothAvrcpNotification { AVRCP_NTF_INTERIM, AVRCP_NTF_CHANGED }; enum BluetoothAvrcpRemoteFeature { AVRCP_REMOTE_FEATURE_NONE, AVRCP_REMOTE_FEATURE_METADATA, AVRCP_REMOTE_FEATURE_ABSOLUTE_VOLUME, AVRCP_REMOTE_FEATURE_BROWSE }; struct BluetoothAvrcpElementAttribute { uint32_t mId; nsString mValue; }; struct BluetoothAvrcpNotificationParam { ControlPlayStatus mPlayStatus; uint8_t mTrack[8]; uint32_t mSongPos; uint8_t mNumAttr; uint8_t mIds[256]; uint8_t mValues[256]; }; struct BluetoothAvrcpPlayerSettings { uint8_t mNumAttr; uint8_t mIds[256]; uint8_t mValues[256]; }; struct BluetoothGattAdvData { uint8_t mAdvData[62]; }; struct BluetoothGattId { BluetoothUuid mUuid; uint8_t mInstanceId; }; struct BluetoothGattServiceId { BluetoothGattId mId; uint8_t mIsPrimary; }; struct BluetoothGattReadParam { BluetoothGattServiceId mServiceId; BluetoothGattId mCharId; BluetoothGattId mDescriptorId; uint8_t mValue[BLUETOOTH_GATT_MAX_ATTR_LEN]; uint16_t mValueLength; uint16_t mValueType; uint8_t mStatus; }; struct BluetoothGattWriteParam { BluetoothGattServiceId mServiceId; BluetoothGattId mCharId; BluetoothGattId mDescriptorId; uint8_t mStatus; }; struct BluetoothGattNotifyParam { uint8_t mValue[BLUETOOTH_GATT_MAX_ATTR_LEN]; nsString mBdAddr; BluetoothGattServiceId mServiceId; BluetoothGattId mCharId; uint16_t mLength; uint8_t mIsNotify; }; END_BLUETOOTH_NAMESPACE #endif // mozilla_dom_bluetooth_bluetoothcommon_h__