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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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


Класс BLECharacteristic[1]

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

Синтаксис

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

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