Библиотека iarduino_Bluetooth_HC05 для работы с Trema Bluetooth модулем HC-05

Описание библиотеки:

Библиотека позволяет работать с Trema Bluetooth модулем HC-05 по любой шине UART, подключаться к другим Bluetooth модулям в роли ведущего (Master) или ведомого (Slave), находить имена и адреса Bluetooth модулей в радиусе действия.

При использовании библиотеки для связи двух Trema Bluetooth модулей HC-05 можно передавать и получать данные любых типов с проверкой безошибочной доставки. Отсутствующие в библиотеке функции компенсируются возможностью общаться с модулем AT-командами.

Назначение функций и переменных:

Подробное описание работы с библиотекой, находится в разделе Wiki Trema-модуль bluetooth HC-05.

#include <iarduino_Bluetooth_HC05.h> // Подключаем библиотеку для работы с модулем
iarduino_Bluetooth_HC05 ОБЪЕКТ( ВЫВОД_K ); // Создаём объект указывая вывод Arduino подключённый к выводу K модуля

Функция begin( [ ОБЪЕКТ_UART ] ); // Инициализация работы с модулем по шине UART.

Функция createSlave( ИМЯ , PIN-КОД ); // Создание ведомого (Slave) ожидающего подключение.

Функция createMaster( ИМЯ , PIN-КОД ); // Создание ведущего (Master) с подключением к ведомому.

Функция find( ВРЕМЯ , [ ТИП_ПОИСКА ] ); // Поиск устройств Bluetooth в радиусе действия.

Функция end(); // Разрыв подключения к внешнему Bluetooth устройству.

Функция checkConnect(); // Проверка подключения к внешнему Bluetooth устройству.

Функция send( ДАННЫЕ ); // Отправка данных внешнему Bluetooth использующему эту библиотеку.

Функция read( ПЕРЕМЕННАЯ ); // Чтение данных от внешнего Bluetooth использующего эту библиотеку.

Функция available( [ &ЭЛЕМЕНТЫ [ ,& БАЙТЫ ] ); // Проверка наличия принятых данных.

Функция runAT( КОМАНДА [ , ВРЕМЯ [ , ВЫХОД ]] ); // Выполнение AT-команд и вывод результата.

Переменная flgResult // (int8_t) содержит результат AT-команды (-1: Error(*), 0: Неизвестно, 1: OK).

Массив findAddr // (char*) содержит пять строк с адресами найденных Bluetooth устройств.

Массив findName // (char*) содержит пять строк с именами найденных Bluetooth устройств. Если имя устройства не получено, то вместо имени будет указан его адрес.

Примечание:

Данная библиотека работает только с Trema Bluetooth модулями HC-05.

Если Вы используете Trema Bluetooth модуль HC-05 для соединения со сторонними Bluetooth устройствами (не использующими данную библиотеку), то можно вызывать любые функции, кроме функций передачи и приёма данных: available(), read() и send() данной библиотеки. Вместо них используйте функции available(), read() и print(), println(), или write() класса Serial, или объекта UART указанного при инициализации.

Дело в том что указанные функции данной библиотеки дополнительно передают / принимают 4 байта (информация о типе данных, типе переменной или размере массива и CRC16 для проверки целостности принятых данных). Также функция available(), при наличии успешно принятых данных, отправляет передатчику сигнал подтверждения приёма, благодаря чему функция send() возвращает true или false.