Arduino:Библиотеки/CurieBLE/Класс BLECharacteristic

Содержание

Знакомство с Arduino

Продукты

Основы

Справочник языка Arduino

Примеры

Библиотеки

Хакинг

Изменения

Сравнение языков Arduino и Processing

Перевод: Максим Кузьмин

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

Класс BLECharacteristic

Класс, с помощью которого создается объект для характеристики. Созданный объект содержит как минимум два атрибута: объявление характеристики (метаданные о данных) и значение характеристики (собственно, сами данные). Для создания характеристик используются разные конструкторы – в зависимости от типа данных, который вы планируете использовать.

Синтаксис

BLEBoolCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLECharCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEUnsignedCharCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEShortCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEUnsignedShortCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEIntCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEUnsignedIntCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLELongCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEUnsignedLongCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEFloatCharacteristic yourCharacteristicName(UUID, properties, maxLen)
BLEDoubleCharacteristic yourCharacteristicName(UUID, properties, maxLen)

Параметры

uuid – стандартный 16-битный UUID характеристики
properties – операции, которые можно использовать для взаимодействия с этой характеристикой; тут могут быть следующие значения: BLERead, BLEWrite, BLENotify

Пример

/*
   Правообладатель – 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"); // LED-сервис BLE

// характеристика для LED-переключателя; 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);

  // начинаем «рекламировать» BLE-сервис:
  blePeripheral.begin();

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

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());
  }
}

См.также

1. BLECharacteristic
2. BLECentral
3. BLEPeripheral