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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...»)
 
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[ www.espruino.com - ]</ref>=
=Функция NRF.setConnectionInterval()<ref>[https://www.espruino.com/Reference#t_l_NRF_setConnectionInterval www.espruino.com - NRF.setConnectionInterval]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
NRF.setConnectionInterval(interval)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''interval''' – интервал коммуникации, который надо задать (см. ниже)


==Возвращаемое значение==
==Возвращаемое значение==
Строка 21: Строка 21:
==Описание==
==Описание==


Подключившись друг к другу, BLE-устройства коммуницируют с заданным интервалом. Если уменьшить этот интервал (в результате станет отправляться больше пакетов в секунду), это уменьшит задержку в отправке данных, увеличит пропускную способность, но также увеличит энергопотребление.
По умолчанию, подключаясь как периферийное устройство, Espruino автоматически настраивает этот интервал коммуникации. Во время активности интервал уменьшается до минимума (7.5 мс), а во время простоя более минуты увеличивается до 200 мс. При непрерывной активности (>1 BLE-операции) интервал снова снижается до 7.5 мс.
В аргументе interval можно задать следующее:
* '''undefined/"auto"''' – интервал коммуникации будет настроен автоматически (по умолчанию)
* '''100''' – одно число, с помощью которого задается одновременно максимальный и минимальный интервал подключения (в диапазоне между 7.5 и 4000 мс)
* '''{minInterval:20, maxInterval:100}''' – объект, с помощью двух элементов которого максимальный и минимальный интервал подключения задаются по отдельности
Эти настройки не запоминаются при использовании [https://www.espruino.com/Reference#l__global_save save()]. Их нужно будет повторно задать с помощью onInit.
'''Примечание:''' При подключении к другому устройству (в роли центрального устройства) интервал коммуникации можно задать в дополнительном аргументе функций [https://www.espruino.com/Reference#l_NRF_connect NRF.connect()] и [https://www.espruino.com/Reference#l_BluetoothRemoteGATTServer_connect BluetoothRemoteGATTServer.connect()].
'''Примечание:''' Эта функция перезаписывает все изменения, заданные устаревшей функцией [https://www.espruino.com/Reference#l_NRF_setLowPowerConnection NRF.setLowPowerConnection()].


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


== Примеры ==
== Примеры ==

Версия от 17:22, 7 февраля 2021

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


Функция NRF.setConnectionInterval()[1]

Синтаксис

NRF.setConnectionInterval(interval)

Параметры

  • interval – интервал коммуникации, который надо задать (см. ниже)

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

Описание

Подключившись друг к другу, BLE-устройства коммуницируют с заданным интервалом. Если уменьшить этот интервал (в результате станет отправляться больше пакетов в секунду), это уменьшит задержку в отправке данных, увеличит пропускную способность, но также увеличит энергопотребление.

По умолчанию, подключаясь как периферийное устройство, Espruino автоматически настраивает этот интервал коммуникации. Во время активности интервал уменьшается до минимума (7.5 мс), а во время простоя более минуты увеличивается до 200 мс. При непрерывной активности (>1 BLE-операции) интервал снова снижается до 7.5 мс.

В аргументе interval можно задать следующее:

  • undefined/"auto" – интервал коммуникации будет настроен автоматически (по умолчанию)
  • 100 – одно число, с помощью которого задается одновременно максимальный и минимальный интервал подключения (в диапазоне между 7.5 и 4000 мс)
  • {minInterval:20, maxInterval:100} – объект, с помощью двух элементов которого максимальный и минимальный интервал подключения задаются по отдельности

Эти настройки не запоминаются при использовании save(). Их нужно будет повторно задать с помощью onInit.

Примечание: При подключении к другому устройству (в роли центрального устройства) интервал коммуникации можно задать в дополнительном аргументе функций NRF.connect() и BluetoothRemoteGATTServer.connect().

Примечание: Эта функция перезаписывает все изменения, заданные устаревшей функцией NRF.setLowPowerConnection().

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

Примеры

См.также

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