BLE Connector

• Overview
• General Settings
• Connection Settings
  • Adapter Configuration
  • Device Discovery
• Data Mapping
  • Device Configuration
  • Service and Characteristic Mapping
  • Data Types
  • Value Conversion
• Standard Profiles
  • Battery Service
  • Environmental Sensing
  • Heart Rate
• Beacon Support
  • iBeacon
  • Eddystone
• Requests Mapping
  • Write Characteristics
  • RPC Methods
• Advanced Features
  • Connection Management
  • Bonding and Pairing
• System Requirements
  • Linux
  • Permissions
• Next Steps

Overview

The BLE (Bluetooth Low Energy) connector enables the IndustryOS IoT Gateway to communicate with Bluetooth Low Energy devices. This is ideal for collecting data from sensors, beacons, wearables, and other battery-powered IoT devices.

General Settings

• Name - connector name
• Logs configuration - logging settings
• Report strategy - data sending strategy

Connection Settings

Adapter Configuration

• Adapter - Bluetooth adapter (hci0, hci1)
• Scan interval - device discovery interval
• Scan window - active scan duration
• Connection timeout - timeout for connections

Device Discovery

• Discovery mode - passive or active scanning
• Filter by MAC - whitelist MAC addresses
• Filter by name - filter by device name
• RSSI threshold - minimum signal strength

Data Mapping

Device Configuration

• Device name - name in IndustryOS
• Device profile - device type
• MAC address - Bluetooth MAC
• Connection type - persistent or polling

Service and Characteristic Mapping

Map GATT services and characteristics:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "services": [
    {
      "uuid": "0000180f-0000-1000-8000-00805f9b34fb",
      "characteristics": [
        {
          "uuid": "00002a19-0000-1000-8000-00805f9b34fb",
          "key": "batteryLevel",
          "method": "read",
          "pollPeriod": 60
        }
      ]
    }
  ]
}

Data Types

• Read - read characteristic value
• Notify - subscribe to notifications
• Indicate - subscribe to indications
• Write - write characteristic value

Value Conversion

Convert raw BLE data:

• Format - uint8, uint16, int8, int16, float, string
• Byte order - little-endian or big-endian
• Offset - byte offset in data
• Scale - multiplication factor

Standard Profiles

Battery Service

• UUID: 0x180F
• Characteristic: Battery Level (0x2A19)

Environmental Sensing

• UUID: 0x181A
• Temperature: 0x2A6E
• Humidity: 0x2A6F
• Pressure: 0x2A6D

Heart Rate

• UUID: 0x180D
• Measurement: 0x2A37

Beacon Support

iBeacon

• UUID - proximity UUID
• Major - major value
• Minor - minor value
• RSSI - signal strength

Eddystone

• UID - namespace and instance
• URL - beacon URL
• TLM - telemetry data

Requests Mapping

Write Characteristics

Send data to BLE devices:

• Key - attribute name
• Service UUID - target service
• Characteristic UUID - target characteristic
• Value - data to write
• Write type - with or without response

RPC Methods

Execute BLE operations:

• Method name - RPC identifier
• Operation - read, write, or notify
• Service - service UUID
• Characteristic - characteristic UUID

Advanced Features

Connection Management

• Auto-reconnect - reconnect on disconnect
• Connection interval - optimise power/latency
• MTU size - maximum transmission unit

Bonding and Pairing

• Pairing mode - just works, passkey, OOB
• Bond management - store bonds
• Encryption - require encrypted connection

System Requirements

Linux

1
2
3
sudo apt-get install bluetooth bluez
sudo systemctl enable bluetooth
sudo systemctl start bluetooth

Permissions

1
sudo setcap 'cap_net_raw,cap_net_admin+eip' gateway-binary

Next Steps

• Sensor data collection
• Asset tracking
• Proximity detection
• Environmental monitoring