Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Модуль BLE обеспечивает сбор данных с BLE-биконов.

с версии 3.0.0 модуль BLE также обеспечивает доступ к метке через BLE (см. ниже)

Сканирование биконов

В настоящее время опознаются биконы Eddystone, iBeacon, AltBeacon.

Производится периодическое сканирование BLE-биконов. Обнаруженные биконы сортируются по уровню сигнала (RSSI) и отправляются в сенсорах на Сервер; отправляются не все биконы, а только первые N. N зависит от транспорта и задается в /ble/brate#UwbSend, /ble/brate#LoraSend.

При сканировании возможна фильтрация биконов по UID, чтобы передавать на Сервер только известные биконы. Они должны быть предварительно сконфигурированы – задан этот UID.

CAS Docked по BLE-бикону

с версии 3.3.0

Возможно отключение функционала CAS (см. CASTAG модуль | /castag/castag#BleDock) при обнаружении биконов с заданным UID (и достаточным уровнем сигнала). Для этого нужно настроить следующие параметры:

  • /node/mode#Scan=on – включить сканирование BLE-биконов
  • /ble/brate#Window_s=3 Period_s=5 – задать достаточно частое сканирование BLE-биконов (? Window_s=4: если бикон блинкует 1 раз в секунду – может не обнаружиться за 3с)
  • /ble/bdock#Att_dB=40 In=1 Out=1 UID=<> Type=<> – задать тип и UID бикона и параметры его обнаружения (см. ниже)
  • /castag/castag#BleDock=on – разрешить режим Docked по BLE

BLE-биконы также должны быть правильно настроены. В них должен быть указан UID, соответствующий настроенному в /ble/bdock#UID, и правильно указана мощность сигнала, передаваемая биконом: она должна соответствовать реальной мощности передачи. Эта мощность учитывается в расчете затухания сигнала от бикона, и именно на это затухание устанавливается порог /ble/bdock#Att_dB. 

При настройке и отладке системы CAS нужно правильно подобрать порог /ble/bdock#Att_dB. Для этого можно смотреть реальное затухание сигнала от биконов при различных положениях метки:

  • Подключиться кабелем к метке и использовать консольную команду beacons
  • Использовать анкер и CoBench для просмотра сенсоров с метки, вкладка Beacons (см. Сенсоры метки – Декодирование сенсоров)

Доступ к метке через BLE

с версии 3.0.0

Доступ к метке через BLE организован аналогично доступу по UWB – по протоколу CoAP. Использовать программу CoBench (см. Режим BLE)

Чтобы подключиться к метке по BLE, нужно включить на метке обнаружение BLE (Advertizing) и затем запускать поиск и соединение в CoBench. 

Обнаружение включается нажатием кнопки (или сбросом) и активно некоторое время (в текущей версии 10 мин). Активность продлевается следующими нажатиями кнопки, а также подключениями.

Включенное обнаружение и активное соединение индицируется редкими световыми вспышками длинная+короткая (см. LED индикация, выходы TG8).

Конфигурация модуля:

/ble/brate

Парсет, настраивает параметры сбора BLE-биконов:

Параметр

Значения

Описание

Window_s

0..10

Длительность одного сканирования BLE-биконов. 0 – сканирование не производится. Рекомендуется задавать не меньше 3, иначе обнаружение биконов ненадежно.

Period_s

0..1000

Период

Минимальный период сканирований. Если задан не больше Window_s, то

сканирования идут с интервалом 1с

принимается равным Window_s+1

Filter

on, off

Включает фильтрацию биконов

UwbSend

uint

Максимальное количество биконов, передаваемых по каналу UWB.

LoraSend

uint

Максимальное количество биконов, передаваемых по каналу LoRa

MacReverse

on, off

Инвертирует порядок байтов MAC-адресов биконов при отправке в сенсорах. Отладочный параметр, не включать

В персональных метках (TGX) сканирование биконов производится один раз перед блинком (LoRa или Uwb) и длится Window_s. Параметр Period_s задает время удержания результата – если блинки идут чаще, чем Period_s, то они будут передавать замер повторно.

В других метках сканирование может идти непрерывно с периодом Period_s, но в настоящее время таких меток не производится.

/ble/bfilter

Парсет-массив, настраивает фильтрацию BLE-биконов. Содержит 4 записи. При сканировании регистрируются только биконы с UID, совпадающим с одной из записей (при /ble/brate#Filter=on).

Параметр

Значения

Описание

UID

eui128

UID BLE-бикона, MSB-first. При фильтрации учитываются:

  • все 16 байт для iBeacon (сравниваются с Proximity UUID) 
  • все 16 байт для AltBeacon (сравниваются с первыми 16 байтами BEACON ID)
  • только первые 10 байт для Eddystone (сравниваются с Namespace ID)

Type

Eddystone, iBeacon, AltBeacon

Тип BLE-бикона.

Параметр Параметр UID вводится в виде 12-34-56-AB-1-3-… , можно вводить только первые байты, тогда остальные будут 0.

...

  • PUT /ble/bfilter 0#UID=50-45-54-52-4F-46-41-43-20-20 Type=Eddystone - добавление/изменение записи 0

  • PUT /ble/bfilter 1#UID=EB-EF-D0-83-70-A2-47-C8-98-37-E7-B5-63-4D-F5-24 Type=iBeacon - и записи 1

  • GET /ble/bfilter 2 - просмотр текущих значений записи 2

  • PUT /ble/bfilter 2 del - удаление записи 2

  • PUT /ble/bfilter clear - удаление всех записей

/ble/bdock

Парсет, настраивает параметры BLE-бикона для отключения CAS. При обнаружении такого бикона включается режим CAS Docked, если он разрешен параметром /castag/castag#BleDock (см. CASTAG модуль - Режим Метки «Docked»)

Параметр

Значения

Описание

Att_dB

uint8

Порог затухания сигнала от бикона. Если затухание меньше, то бикон обнаружен

In

uint8

Количество циклов сканирования с биконом для включения Docked

Out

uint8

Количество циклов сканирования без бикона для выключения Docked

UID

eui128

UID BLE-биконов, MSB-first. При сравнении учитываются:

  • все 16 байт для iBeacon (сравниваются с Proximity UUID) 
  • все 16 байт для AltBeacon (сравниваются с первыми 16 байтами BEACON ID)
  • только первые 10 байт для Eddystone (сравниваются с Namespace ID)

Type

Eddystone, iBeacon, AltBeacon

Тип BLE-бикона.

Параметр UID вводится в виде 12-34-56-AB-1-3-… , можно вводить только первые байты, тогда остальные будут 0.

/ble/bsens (экспериментальный)

Парсет, настраивает соединение с BLE устройством, транслирующим данные с собственных датчиков:

Параметр

Значения

Описание

Use

on, off

Разрешение соединения с BLE устройством

Pub

on, off

Тип MAC-адреса BLE устройства - Public (on) или Random (off)

Adr

eui48

MAC-адрес BLE устройства

После разрешения соединения с BLE устройством (/ble/bsens#Use=On) само соединение производится при обнаружении BLE устройства в ходе периодического сканирования BLE-биконов. Поэтому сканирование должно быть включено, и поиск устройства будет производиться с соответствующими паузами. При разрыве соединения поиск BLE устройства возобновляется.

...