Arduino:Примеры/Genuino101CurieBLELED - История изменений

EducationBot в 08:35, 8 июля 2023

2023-07-08T08:35:13Z

← Предыдущая версия		Версия от 12:35, 8 июля 2023
Строка 177:		Строка 177:

	<references />		<references />
			{{Навигационная таблица/Портал/Arduino}}
	[[Категория:Пример]]		[[Категория:Пример]]
	[[Категория:Примеры]]		[[Категория:Примеры]]
	[[Категория:Пример программирования Arduino]]		[[Категория:Пример программирования Arduino]]
	[[Категория:Примеры программирования Arduino]]		[[Категория:Примеры программирования Arduino]]

EducationBot в 14:19, 14 мая 2023

2023-05-14T14:19:02Z

← Предыдущая версия		Версия от 18:19, 14 мая 2023
Строка 50:		Строка 50:
	В этом скетче блок [[Arduino:Справочник языка Arduino/setup()\|setup()]] используется для того, чтобы инициализировать и настроить периферийное '''BLE'''-устройство. Начнем с того, что присваиваем устройству название '''«LED»''' и указываем '''UUID''' сервиса:		В этом скетче блок [[Arduino:Справочник языка Arduino/setup()\|setup()]] используется для того, чтобы инициализировать и настроить периферийное '''BLE'''-устройство. Начнем с того, что присваиваем устройству название '''«LED»''' и указываем '''UUID''' сервиса:

	<syntaxhighlight lang="c~~" enclose="div~~">		<syntaxhighlight lang="c">
	blePeripheral.setLocalName("LED");		blePeripheral.setLocalName("LED");
	blePeripheral.setAdvertisedServiceUuid(ledService.uuid());		blePeripheral.setAdvertisedServiceUuid(ledService.uuid());
Строка 57:		Строка 57:
	Затем настраиваем '''BLE'''-сервис и добавляем характеристику переключения (она будет использоваться для управления светодиодом):		Затем настраиваем '''BLE'''-сервис и добавляем характеристику переключения (она будет использоваться для управления светодиодом):

	<syntaxhighlight lang="c~~" enclose="div~~">		<syntaxhighlight lang="c">
	blePeripheral.addAttribute(ledService);		blePeripheral.addAttribute(ledService);
	blePeripheral.addAttribute(switchCharacteristic);		blePeripheral.addAttribute(switchCharacteristic);
Строка 64:		Строка 64:
	Выставляем значение этой характеристики на '''«0»''' (т.е. по умолчанию светодиод будет выключен):		Выставляем значение этой характеристики на '''«0»''' (т.е. по умолчанию светодиод будет выключен):

	<syntaxhighlight lang="c~~" enclose="div~~">		<syntaxhighlight lang="c">
	switchCharacteristic.setValue(0);		switchCharacteristic.setValue(0);
	</syntaxhighlight>		</syntaxhighlight>
Строка 70:		Строка 70:
	И, наконец, запускаем рассылку пакетов-объявлений '''BLE'''-сервиса, который мы настроили выше:		И, наконец, запускаем рассылку пакетов-объявлений '''BLE'''-сервиса, который мы настроили выше:

	<syntaxhighlight lang="c~~" enclose="div~~">		<syntaxhighlight lang="c">
	blePeripheral.begin();		blePeripheral.begin();
	</syntaxhighlight>		</syntaxhighlight>
Строка 76:		Строка 76:
	В блоке [[Arduino:Справочник языка Arduino/loop()\|loop()]] проверяем соединение с центральным '''BLE'''-устройством, и если соединение есть, проверяем, была ли перезаписана характеристика, и если была, считываем это значение и соответствующим образом меняем состояние светодиода.		В блоке [[Arduino:Справочник языка Arduino/loop()\|loop()]] проверяем соединение с центральным '''BLE'''-устройством, и если соединение есть, проверяем, была ли перезаписана характеристика, и если была, считываем это значение и соответствующим образом меняем состояние светодиода.

	<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS~~" enclose="div~~">		<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS">
	/*		/*
	Правообладатель – Intel Corporation (2015). Все права защищены.		Правообладатель – Intel Corporation (2015). Все права защищены.

Myagkij: Замена текста — «» на «»

2016-12-13T19:55:01Z

Замена текста — «<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">» на «<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">»

Новая страница

{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

=Включение/выключение светодиода<ref>[https://www.arduino.cc/en/Tutorial/Genuino101CurieBLELED Arduino.cc - Genuino101CurieBLELED]</ref>=

Этот пример показывает, как, используя смартфон/планшет, а также встроенные '''BLE'''-возможности платы '''Arduino/Genuino 101''', включать/выключать светодиод, подключенный к '''13-ому''' контакту. Мы создадим сервис для светодиода и будем постоянно следить за центральным '''BLE'''-устройством, ожидая, когда оно перезапишет значение в характеристике, связанной со светодиодом, которым мы хотим управлять. Этот пример схож с [[Arduino:Примеры/Genuino101CurieBLELED|этим примером]], где управление светодиодом осуществляется при помощи опроса и функций внешнего вызова. Значения будут отсылаться через приложение '''nRF Master Control Panel (BLE)''', которое доступно и для '''Android''', и для '''iOS'''.

==Необходимое оборудование==

* '''Arduino''' или '''Genuino 101'''
* Смартфон или планшет на '''Android''' или '''iOS'''

==Необходимое ПО==

* Приложение '''nRF Master Control Panel (BLE)''' для [https://play.google.com/store/apps/details?id=no.nordicsemi.android.mcp&hl=en Android] или [https://itunes.apple.com/us/app/nrf-master-control-panel-ble/id1054362403?mt=8 iOS]

==Цепь==

[[Файл:Genuino101fzz.jpg|center]]

==Наиболее важные части скетча==

'''CurieBLE.h''' – библиотека, дающая доступ ко всем параметрам, возможностям и функциям '''BLE'''-модуля платы '''Arduino/Genuino 101'''. При помощи '''BLE''' вы можете подключаться и коммуницировать со смартфонами, планшетами и прочими устройствами, поддерживающими этот стандарт. В данном руководстве '''BLE''' используется для установления соединения с управляющим приложением на смартфоне и передачи значения для включения/выключения светодиода.

==На смартфоне==

Чтобы управлять светодиодом на '''Arduino/Genuino 101''', вам понадобится приложение '''nRF Master Control Panel (BLE)''', которое доступно и для '''Android''', и для '''iOS'''. Запустите его и нажмите '''SCAN'''. В итоге поиск должен выдать запись '''LED''' с кнопкой '''CONNECT'''.

[[File:BleLED_1.png|center]]

Нажмите на '''CONNECT''', и вам откроется экран с описанием сервиса '''Unknown Service''', предлагаемого платой '''101'''. Этот сервис будет иметь '''UUID «19B10000-E8F2-537E-4F6C-D104768A1214»''', и он задан строчкой '''BLEService ledService("19B10000-E8F2-537E-4F6C-D104768A1214")''', стоящей в самом начале скетча.

[[File:BleLED_2.png|center]]

Нажмите на запись '''Unknown Service''', чтобы открыть характеристики этого сервиса, как показано на картинке ниже. В нем будет характеристика '''Unknown Characteristic''', в свойствах которой указано, что ее значение можно перезаписать через '''«Write Request»''' (т.е. через запрос на запись). Кроме того, справа от нее будет две иконки: стрелочка вниз означает считывание, стрелочка вверх – запись.

[[File:BleLED_3.png|center]]

Нажмите на стрелочку вверх, чтобы открыть окно '''Write value''', а затем выставьте тип данных на '''UINT 8'''.

[[File:BleLED_4.png|center]]

Теперь нажмите на поле ввода, чтобы вписать нужное значение ('''«0»''' или '''«1»'''). Затем нажмите на '''SEND''' – это отправит указанное значение на плату, тем самым поменяв состояние светодиода (т.е. включив или выключив его).

[[File:BleLED_5.png|center]]

==Код==

В этом скетче блок [[Arduino:Справочник языка Arduino/setup()|setup()]] используется для того, чтобы инициализировать и настроить периферийное '''BLE'''-устройство. Начнем с того, что присваиваем устройству название '''«LED»''' и указываем '''UUID''' сервиса:

<syntaxhighlight lang="c" enclose="div">
blePeripheral.setLocalName("LED");
blePeripheral.setAdvertisedServiceUuid(ledService.uuid());
</syntaxhighlight>

Затем настраиваем '''BLE'''-сервис и добавляем характеристику переключения (она будет использоваться для управления светодиодом):

<syntaxhighlight lang="c" enclose="div">
blePeripheral.addAttribute(ledService);
blePeripheral.addAttribute(switchCharacteristic);
</syntaxhighlight>

Выставляем значение этой характеристики на '''«0»''' (т.е. по умолчанию светодиод будет выключен):

<syntaxhighlight lang="c" enclose="div">
switchCharacteristic.setValue(0);
</syntaxhighlight>

И, наконец, запускаем рассылку пакетов-объявлений '''BLE'''-сервиса, который мы настроили выше:

<syntaxhighlight lang="c" enclose="div">
blePeripheral.begin();
</syntaxhighlight>

В блоке [[Arduino:Справочник языка Arduino/loop()|loop()]] проверяем соединение с центральным '''BLE'''-устройством, и если соединение есть, проверяем, была ли перезаписана характеристика, и если была, считываем это значение и соответствующим образом меняем состояние светодиода.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
/*
Правообладатель – Intel Corporation (2015). Все права защищены.

Эта библиотека является бесплатной; ее можно распространять
и/или модифицировать согласно условиям Стандартной общественной
лицензии ограниченного применения GNU (т.к. она выпущена Фондом
свободного ПО) – либо версии 2.1 этой лицензии, либо более поздней
версии (на ваш выбор).

Эта библиотека распространяется в надежде на то, что будет
полезна кому-либо, но БЕЗО ВСЯКИХ ГАРАНТИЙ – даже без гарантий на
коммерческое качество и пригодность применения для конкретных
целей. Более подробно читайте в Стандартной общественной лицензии
ограниченного применения GNU.

Вы должны получить копию Стандартной общественной лицензии
ограниченного применения вместе с этой библиотекой. Если не
получили, напишите в Фонд бесплатного ПО на адрес: Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301 USA
*/

#include <CurieBLE.h>

BLEPeripheral blePeripheral; // периферийное BLE-устройство (плата, которую вы программируете)
BLEService ledService("19B10000-E8F2-537E-4F6C-D104768A1214"); // BLE-сервис для светодиода

// BLE-характеристика для переключения светодиода: указываем
// пользовательский 128-битный UUID, а также разрешаем центральному
// устройству проводить операции считывания и записи:
BLEUnsignedCharCharacteristic switchCharacteristic("19B10001-E8F2-537E-4F6C-D104768A1214", BLERead |BLEWrite);

const int ledPin = 13; // контакт для светодиода

void setup() {
Serial.begin(9600);

// выставляем светодиодный контакт в режим OUTPUT:
pinMode(ledPin, OUTPUT);

// задаем локальное имя и UUID сервиса, которые
// будут указаны в пакетах-объявлениях:
blePeripheral.setLocalName("LED");
blePeripheral.setAdvertisedServiceUuid(ledService.uuid());

// добавляем сервис и характеристику:
blePeripheral.addAttribute(ledService);
blePeripheral.addAttribute(switchCharacteristic);

// задаем начальное значение для характеристики:
switchCharacteristic.setValue(0);

// запускаем рассылку пакетов-объявлений:
blePeripheral.begin();

Serial.println("BLE LED Peripheral"); // "Включение/выключение светодиода на периферийном устройстве"
}

void loop() {
// запускаем прослушку периферийных устройств, к которым можно подключиться:
BLECentral central = blePeripheral.central();

// если центральное устройство подключилось к периферийному:
if (central) {
Serial.print("Connected to central: "); // "Подключились к центральному устройству: "
// показываем MAC-адрес центрального устройства:
Serial.println(central.address());

// если центральное устройство еще подключено к периферийному...
while (central.connected()) {
// ...и если центральное устройство перезаписало характеристику,
// используем это значение для управления светодиодом:
if (switchCharacteristic.written()) {
if (switchCharacteristic.value()) { // любое значение, которое больше «0»...
Serial.println("LED on"); // "Светодиод включен"
digitalWrite(ledPin, HIGH); // ...включит светодиод...
} else { // ...а значение «0»...
Serial.println(F("LED off")); // "Светодиод выключен"
digitalWrite(ledPin, LOW); // ...выключит его
}
}
}

// если центральное устройство отключилось, сообщаем об этом:
Serial.print(F("Disconnected from central: ")); // "Отключились от центрального устройства: "
Serial.println(central.address());
}
}
</syntaxhighlight>

= См.также=

# Heart Rate Monitor
# Battery Monitor
# Button LED
# Callback LED

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

<references />
[[Категория:Пример]]
[[Категория:Примеры]]
[[Категория:Пример программирования Arduino]]
[[Категория:Примеры программирования Arduino]]