Espruino:Справочник по API/Класс BluetoothRemoteGATTServer/connect(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 7: Строка 7:
==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
BluetoothRemoteGATTServer.connect(options)
BluetoothRemoteGATTServer.connect(options)
</syntaxhighlight>
</syntaxhighlight>
Строка 27: Строка 27:
Объект ''options'' – это опциональный объект со следующим содержимым:
Объект ''options'' – это опциональный объект со следующим содержимым:


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
{
{
   minInterval // минимальный интервал соединения в миллисекундах
   minInterval // минимальный интервал соединения в миллисекундах
Строка 40: Строка 40:
Например, если задать...
Например, если задать...


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
NRF.requestDevice({ filters: [{ namePrefix: 'Pixl.js' }] }).then(function(device) {
NRF.requestDevice({ filters: [{ namePrefix: 'Pixl.js' }] }).then(function(device) {
   return device.gatt.connect({minInterval:7.5, maxInterval:7.5});
   return device.gatt.connect({minInterval:7.5, maxInterval:7.5});

Версия от 18:27, 14 мая 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция BluetoothRemoteGATTServer.connect()[1]

Синтаксис

BluetoothRemoteGATTServer.connect(options)

Параметры

  • options – объект (специфичный для Espruino) с настройками подключения (см. ниже)

Возвращаемое значение

  • Промис (Promise) с состоянием «выполнено успешно» (или «выполнено с ошибкой»).

Описание

Подключает к BLE-устройству. Возвращает промис, где аргументом будет объект BluetoothRemoteGATTServer.

Примеры использования смотрите в описании NRF.requestDevice.

Объект options – это опциональный объект со следующим содержимым:

{
   minInterval // минимальный интервал соединения в миллисекундах
               // от 7.5 мс до 4 с
   maxInterval // максимальный интервал соединения в миллисекундах 
               // от 7.5 мс до 4 с
}

По умолчанию интервал составляет 20-200 мс (или 500-1000 мс, если была вызвана NRF.setLowPowerConnection(true)). Во время подключения Espruino будет согласовывать с BLE-устройством интервал, который будет использован для соединения.

Например, если задать...

NRF.requestDevice({ filters: [{ namePrefix: 'Pixl.js' }] }).then(function(device) {
  return device.gatt.connect({minInterval:7.5, maxInterval:7.5});
}).then(function(g) {

...то будет принудительно использован быстрейший интервал (если BLE-устройство по ту сторону его поддерживает).

Примечание: Эта функция доступна только для NRF52-устройств (вроде Puck.js, Pixl.js, Bangle.js и MDBT42Q) и плат ESP32.

См.также

Внешние ссылки