58 lines
2.1 KiB
Plaintext
58 lines
2.1 KiB
Plaintext
/* -*- 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/. */
|
|
|
|
[CheckAnyPermissions="bluetooth"]
|
|
interface BluetoothGatt : EventTarget
|
|
{
|
|
[Cached, Pure]
|
|
readonly attribute sequence<BluetoothGattService> services;
|
|
readonly attribute BluetoothConnectionState connectionState;
|
|
|
|
// Fired when the value of any characteristic changed
|
|
attribute EventHandler oncharacteristicchanged;
|
|
// Fired when attribute connectionState changed
|
|
attribute EventHandler onconnectionstatechanged;
|
|
|
|
/**
|
|
* Connect/Disconnect to the remote BLE device if the connectionState is
|
|
* disconnected/connected. Otherwise, the Promise will be rejected directly.
|
|
*
|
|
* If current connectionState is disconnected/connected,
|
|
* 1) connectionState change to connecting/disconnecting along with a
|
|
* connectionstatechanged event.
|
|
* 2) connectionState change to connected/disconnected if the operation
|
|
* succeeds. Otherwise, change to disconnected/connected.
|
|
* 3) Promise is resolved or rejected according to the operation result.
|
|
*/
|
|
[NewObject]
|
|
Promise<void> connect();
|
|
[NewObject]
|
|
Promise<void> disconnect();
|
|
|
|
/**
|
|
* Discover services, characteristics, descriptors offered by the remote GATT
|
|
* server. The promise will be rejected if the connState is not connected or
|
|
* operation fails.
|
|
*/
|
|
[NewObject]
|
|
Promise<void> discoverServices();
|
|
|
|
/**
|
|
* Read RSSI for the remote BLE device if the connectState is connected.
|
|
* Otherwise, the Promise will be rejected directly.
|
|
*/
|
|
[NewObject]
|
|
Promise<short> readRemoteRssi();
|
|
};
|
|
|
|
enum BluetoothConnectionState
|
|
{
|
|
"disconnected",
|
|
"disconnecting",
|
|
"connected",
|
|
"connecting"
|
|
};
|