Espruino:Примеры/Введение в Bluetooth Light Energy (BLE) - История изменений

Myagkij: /* Подключение (Puck.js в роли центрального устройства) */

2023-05-22T16:44:08Z

Подключение (Puck.js в роли центрального устройства)

← Предыдущая версия		Версия от 20:44, 22 мая 2023
Строка 114:		Строка 114:
	Чтобы подключиться к другому устройству с [[Puck.js]], вам понадобится его адрес. Он имеет формат '''aa:bb:cc:dd:ee''' – это похоже на [[MAC-адрес]], используемый при WiFi-коммуникации. Эти Bluetooth-адреса могут быть ''«публичными»'' (это означает, что двух одинаковых публичных адресов в мире попросту нет) и ''«случайными»'' (это означает, что они будут уникальными только в каком-то одном месте). У [[Puck.js]] случайные адреса.		Чтобы подключиться к другому устройству с [[Puck.js]], вам понадобится его адрес. Он имеет формат '''aa:bb:cc:dd:ee''' – это похоже на [[MAC-адрес]], используемый при WiFi-коммуникации. Эти Bluetooth-адреса могут быть ''«публичными»'' (это означает, что двух одинаковых публичных адресов в мире попросту нет) и ''«случайными»'' (это означает, что они будут уникальными только в каком-то одном месте). У [[Puck.js]] случайные адреса.

	~~'''Примечание:'''~~ Если [[Puck.js]] работает в роли центрального устройства, то почти все ваши действия будут занимать время – иногда 100 миллисекунд, иногда 2 секунды или больше, если вы выполняете подключение. Это значит, что функционал [[Puck.js]] работает при помощи функций обратного вызова и [https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Promise промисов]. То есть, если вы вызовите функцию, то она скорее всего вернёт результат сразу же и вызовет функцию, которую вы задали дальше.		{{Примечание1\|Если [[Puck.js]] работает в роли центрального устройства, то почти все ваши действия будут занимать время – иногда 100 миллисекунд, иногда 2 секунды или больше, если вы выполняете подключение. Это значит, что функционал [[Puck.js]] работает при помощи функций обратного вызова и [https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Promise промисов]. То есть, если вы вызовите функцию, то она скорее всего вернёт результат сразу же и вызовет функцию, которую вы задали дальше.}}

	Чтобы найти устройства поблизости, можно воспользоваться функцией [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/findDevices() NRF.findDevices()]:		Чтобы найти устройства поблизости, можно воспользоваться функцией [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/findDevices() NRF.findDevices()]:

Myagkij в 16:43, 22 мая 2023

2023-05-22T16:43:50Z

← Предыдущая версия		Версия от 20:43, 22 мая 2023
Строка 29:		Строка 29:
	Некоторые устройства (вроде [http://wikihandbk.com/wiki/Espruino:Примеры/Маяки_Eddystone маяков Eddystone]), как правило, своё название не рассылают, но отправляют [[URL]] (который можно прочесть на телефоне) и, возможно, уровень заряда батареи.		Некоторые устройства (вроде [http://wikihandbk.com/wiki/Espruino:Примеры/Маяки_Eddystone маяков Eddystone]), как правило, своё название не рассылают, но отправляют [[URL]] (который можно прочесть на телефоне) и, возможно, уровень заряда батареи.

	~~'''Примечание:'''~~ О том, как настроить на [[Puck.js]] рассылку BLE-объявлений, смотрите в описании функции NRF.setAdvertising(). Вы также можете воспользоваться функциями NRF.findDevices() и NRF.setScan() для сканирования пакетов BLE-объявлений, рассылаемых другими маяками.		{{Примечание1\|О том, как настроить на [[Puck.js]] рассылку BLE-объявлений, смотрите в описании функции NRF.setAdvertising(). Вы также можете воспользоваться функциями NRF.findDevices() и NRF.setScan() для сканирования пакетов BLE-объявлений, рассылаемых другими маяками.}}

	О том, как получать данные объявлений в своём приложении, читайте [http://wikihandbk.com/wiki/Espruino:Примеры/Рассылка_BLE-объявлений_при_помощи_Node.js/Python/C#.2FAndroid тут].		О том, как получать данные объявлений в своём приложении, читайте [http://wikihandbk.com/wiki/Espruino:Примеры/Рассылка_BLE-объявлений_при_помощи_Node.js/Python/C#.2FAndroid тут].
Строка 39:		Строка 39:
	Зато процедура привязки сохраняет эту информацию (к примеру, ключи шифрования), чтобы воспользоваться ею для последующих соединений. В [[Puck.js]] эта функция была реализована в версии 1v92.		Зато процедура привязки сохраняет эту информацию (к примеру, ключи шифрования), чтобы воспользоваться ею для последующих соединений. В [[Puck.js]] эта функция была реализована в версии 1v92.

	~~'''Примечание:'''~~ После подключения энергопотребление [[Puck.js]] вырастает ''с 20 до 200 мкА''. По этой причине не рекомендуется оставлять подключение [[Puck.js]] открытым, а подключаться, только когда нужно отправить или получить команды.		{{Примечание1\|После подключения энергопотребление [[Puck.js]] вырастает ''с 20 до 200 мкА''. По этой причине не рекомендуется оставлять подключение [[Puck.js]] открытым, а подключаться, только когда нужно отправить или получить команды.}}

	== UUID ==		== UUID ==
Строка 66:		Строка 66:
	В результате по [[Bluetooth]] потребуется отправить всего один [[UUID]], а все последующие [[UUID]] будут занимать столько же места, что и 16-битные [[UUID]].		В результате по [[Bluetooth]] потребуется отправить всего один [[UUID]], а все последующие [[UUID]] будут занимать столько же места, что и 16-битные [[UUID]].

	~~'''Примечание:'''~~ 16-битные UUID – это всё те же 128-битные UUID в формате '''0000xxxx-0000-1000-8000-00805F9B34FB''', где xxxx – это 16-битный [[UUID]].		{{Примечание1\|16-битные UUID – это всё те же 128-битные UUID в формате '''0000xxxx-0000-1000-8000-00805F9B34FB''', где xxxx – это 16-битный [[UUID]].}}

	== Сервисы и характеристики ==		== Сервисы и характеристики ==
Строка 79:		Строка 79:
	* '''NOTIFY / INDICATE (уведомление / индикатор)''' – центральное устройство может попросить, чтобы ему присылали уведомления. В результате, если значение характеристики на периферийном устройстве изменится, оно отправит это значение центральному устройству, избавляя его от необходимости проверять, изменилось ли что-нибудь. Это наилучший способ отправки данных. К примеру, вам может понадобиться отправить два идентичных значения – с помощью '''NOTIFY''' это делается просто, но с помощью двух идущих друг за другом '''READ''' сделать это будет затруднительно. Операции '''NOTIFY''' и '''INDICATE''' похожи, но не идентичны. О разнице между ними можно почитать, например, вот тут, но мы всё же советуем всегда использовать '''NOTIFY''', а не '''INDICATE'''.		* '''NOTIFY / INDICATE (уведомление / индикатор)''' – центральное устройство может попросить, чтобы ему присылали уведомления. В результате, если значение характеристики на периферийном устройстве изменится, оно отправит это значение центральному устройству, избавляя его от необходимости проверять, изменилось ли что-нибудь. Это наилучший способ отправки данных. К примеру, вам может понадобиться отправить два идентичных значения – с помощью '''NOTIFY''' это делается просто, но с помощью двух идущих друг за другом '''READ''' сделать это будет затруднительно. Операции '''NOTIFY''' и '''INDICATE''' похожи, но не идентичны. О разнице между ними можно почитать, например, вот тут, но мы всё же советуем всегда использовать '''NOTIFY''', а не '''INDICATE'''.

	~~Примечание:~~ Характеристика может допускать любую комбинацию трёх этих типов операций. Фактически часто бывает, что характеристика не позволяет проводить с ней операции '''READ''', но выполняет операции '''NOTIFY''', чтобы уведомлять центральное устройство об изменениях.		{{Примечание1\|Характеристика может допускать любую комбинацию трёх этих типов операций. Фактически часто бывает, что характеристика не позволяет проводить с ней операции '''READ''', но выполняет операции '''NOTIFY''', чтобы уведомлять центральное устройство об изменениях.}}

	К примеру, у вас может быть:		К примеру, у вас может быть:
Строка 88:		Строка 88:
	Очень рекомендуем поставить на телефон приложение [[nRF Connect]]. Оно позволит просматривать характеристики и сервисы на различных устройствах, чтобы понимать, что они из себя представляют.		Очень рекомендуем поставить на телефон приложение [[nRF Connect]]. Оно позволит просматривать характеристики и сервисы на различных устройствах, чтобы понимать, что они из себя представляют.

	~~'''Примечание:'''~~ Примеры того, как настраивать сервисы и характеристики на [[Puck.js]], читайте в описании функции [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/setServices() NRF.setServices()].		{{Примечание1\|Примеры того, как настраивать сервисы и характеристики на [[Puck.js]], читайте в описании функции [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/setServices() NRF.setServices()].}}

	== Сервисы Puck.js ==		== Сервисы Puck.js ==
Строка 98:		Строка 98:
	Если вы хотите включить светодиод на [[Puck.js]], то можете просто подключиться и выполнить запись с помощью LED.set() (не забудьте про символ новой строки) в характеристику TX, и команда будет выполнена! Это работает и для всех функций, заданных вами ранее.		Если вы хотите включить светодиод на [[Puck.js]], то можете просто подключиться и выполнить запись с помощью LED.set() (не забудьте про символ новой строки) в характеристику TX, и команда будет выполнена! Это работает и для всех функций, заданных вами ранее.

	~~'''Примечание:'''~~ Оставить [[Espruino]] и JS-интерпретатор без защиты – не самая лучшая идея. Его можно защитить при помощи пароля, заданного в E.setPassword(), или вообще убрать из BLE-объявлений при помощи NRF.setServices().		{{Примечание1\|Оставить [[Espruino]] и JS-интерпретатор без защиты – не самая лучшая идея. Его можно защитить при помощи пароля, заданного в E.setPassword(), или вообще убрать из BLE-объявлений при помощи NRF.setServices().}}

	== Что происходит внутри? ==		== Что происходит внутри? ==
Строка 186:		Строка 186:
	Но всё это можно сделать и более изящно – см. ниже.		Но всё это можно сделать и более изящно – см. ниже.

	~~'''Примечание:'''~~ Единственный способ отключиться от устройства – это вызвать disconnect() на объекте [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_BluetoothRemoteGATTServer BluetoothRemoteGATTServer], возвращаемом функцией NRF.connect().		{{Примечание1\|Единственный способ отключиться от устройства – это вызвать disconnect() на объекте [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_BluetoothRemoteGATTServer BluetoothRemoteGATTServer], возвращаемом функцией NRF.connect().}}

	== Другие методы подключения ==		== Другие методы подключения ==
Строка 195:		Строка 195:

	=См.также=		=См.также=



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

EducationBot в 11:06, 20 мая 2023

2023-05-20T11:06:10Z

← Предыдущая версия		Версия от 15:06, 20 мая 2023
Строка 196:		Строка 196:
	=См.также=		=См.также=

	~~{{ads}}~~

	=Внешние ссылки=		=Внешние ссылки=
Строка 202:		Строка 202:
	<references />		<references />

	{{Навигационная таблица/Espruino}}		{{Навигационная таблица/Портал/Espruino}}
	~~{{Навигационная таблица/Телепорт~~}}

EducationBot в 14:21, 14 мая 2023

2023-05-14T14:21:15Z

← Предыдущая версия		Версия от 18:21, 14 мая 2023
Строка 118:		Строка 118:
	Чтобы найти устройства поблизости, можно воспользоваться функцией [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/findDevices() NRF.findDevices()]:		Чтобы найти устройства поблизости, можно воспользоваться функцией [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_NRF/findDevices() NRF.findDevices()]:

	<syntaxhighlight lang="javascript~~" enclose="div~~">		<syntaxhighlight lang="javascript">
	var devices;		var devices;
	NRF.findDevices(function(d) {		NRF.findDevices(function(d) {
Строка 128:		Строка 128:
	Этот код выполнит 1-секундное (1000 мс) сканирование и напечатает список находящихся рядом устройств, каждое из которых будет представлено в виде объекта BluetoothDevice:		Этот код выполнит 1-секундное (1000 мс) сканирование и напечатает список находящихся рядом устройств, каждое из которых будет представлено в виде объекта BluetoothDevice:

	<syntaxhighlight lang="javascript~~" enclose="div~~">		<syntaxhighlight lang="javascript">
	[		[
	BluetoothDevice {		BluetoothDevice {
Строка 149:		Строка 149:
	Далее вы можете вызвать [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_BluetoothRemoteGATTServer/connect() BluetoothDevice.gatt.connect()] на каком-нибудь из этих BluetoothDevice, а затем при помощи промисов найти сервис, найти характеристику, выполнить запись в неё и, наконец, отключиться.		Далее вы можете вызвать [http://wikihandbk.com/wiki/Espruino:Справочник_по_API/Класс_BluetoothRemoteGATTServer/connect() BluetoothDevice.gatt.connect()] на каком-нибудь из этих BluetoothDevice, а затем при помощи промисов найти сервис, найти характеристику, выполнить запись в неё и, наконец, отключиться.

	<syntaxhighlight lang="javascript~~" enclose="div~~">		<syntaxhighlight lang="javascript">
	devices[0].gatt.connect().then(function(g) {		devices[0].gatt.connect().then(function(g) {
	gatt = g;		gatt = g;
Строка 167:		Строка 167:
	Чтобы собрать всё это вместе, нужно поместить в findDevices() функцию connect(). Примерно вот так:		Чтобы собрать всё это вместе, нужно поместить в findDevices() функцию connect(). Примерно вот так:

	<syntaxhighlight lang="javascript~~" enclose="div~~">		<syntaxhighlight lang="javascript">
	NRF.findDevices(function(devices) {		NRF.findDevices(function(devices) {
	if (devices.length<1) throw new Error("Ничего не найдено!");		if (devices.length<1) throw new Error("Ничего не найдено!");

Myagkij в 13:42, 16 марта 2021

2021-03-16T13:42:43Z

Внесённые изменения

Myagkij в 13:39, 16 марта 2021

2021-03-16T13:39:05Z

Внесённые изменения

Myagkij: Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =[ www.espruino.com - ]=
2021-03-16T13:20:40Z

Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= <syntaxhighlight...»

Новая страница
{{Espruino/Панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

=<ref>[ www.espruino.com - ]</ref>=

<syntaxhighlight lang="javascript" enclose="div">

=См.также=

{{ads}}

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

<references />

{{Навигационная таблица/Espruino}}
{{Навигационная таблица/Телепорт}}