= Remotely Controlling LED Bluetooth Candle with the Gateworks GW16126 CATM1/BLE Mini-PCIe Adapter = [[Image(candle.jpg,300px)]] Bluetooth Low Engery (BLE) is the latest communication standard in the Internet of Things (IoT) and M2M markets. Sensors that report small amounts of data periodically can last for several years using BLE. The Generic Attribute Profile (GATT) is one of the most common profiles used over BLE. Gateworks setup a LED candle that changes colors and brightness using BLE commands sent from a Gateworks SBC and GW16126 BLE radio. The GW16126 Mini-PCIe card features a u-blox NINA-B301 BLE module with custom Zephyr firmware to use HCI. It also has a u-blox SARA-R4 LTE Cat M-1 modem for pushing data up to the cloud. More can be read on the [wiki:expansion/gw16126 GW16126 wiki page] == Hardware Requirements == 1. Gateworks SBC, preferably Ventana or Newport 1. Gateworks GW16126 Mini-PCIe BLE & Modem Card 1. LED Candle 1. Android Smartphone 1. Linux Host PC == Sniffing Bluetooth Packets == 1. Install Magic Hue app for the candle onto Android Phone 1. Use Bluetooth settings on Android Phone to find and connect to the Magic Candle (LEDBlue-081051FE) a. [[Image(screen-bluetoothsettings.png,200px)]] 1. Open Magic Hue and connect to Candle device and verify ability to change colors a. [[Image(screen-magic-hue-device.png,200px)]] 1. Connect Android phone to Linux computer (desktop or laptop) 1. Allow USB Debugging on Android phone 1. Under Developer Options in Settings on the phone, Enable Bluetooth HCI snoop log a. [[Image(screen-debug.png,200px)]] 1. Go back to Magic Hue app and change the colors in a known sequence, such as Blue, Green, Red which will then be recorded in the log. a. [[Image(screen-magic-hue.png,200px)]] 1. On the Linux computer, use the following command to retrieve the Bluetooth Log immediately after changing the colors using the Android app: {{{ adb pull /sdcard/btsnoop_hci.log }}} 1. Open btsnoop_hci.log using WireShark on the host PC 1. Typically scroll to the bottom and find some events with protocol ATT. a. Note the Handle, value 0x002e a. Note the Value, 56:ff:00:00:00:f0:aa a. [[Image(wireshark_bluetooth_candle.png,400px)]] == Sending BLE Packets over GATT == Now that the packet structure and values are established, the candle can be controlled by the Gateworks SBC & GW16126 BLE card. The following was done with a Gateworks Ventana SBC using Ubuntu Bionic software. 1. Load the following modules {{{ modprobe algif_hash; modprobe algif_skcipher; modprobe algif_rng; modprobe algif_aead; modprobe af_alg; modprobe hci_uart; }}} 1. Start the bluetooth daemon {{{ bluetoothd -E & }}} 1. Find the device the bluetooth is connected to {{{ dev=$(basename $(ls -d /sys/bus/usb/drivers/ftdi_sio/*/ttyUSB*)) }}} 1. Attach bluetooth to inferface dev {{{ btattach -B /dev/$dev -S 1000000 -P h4 & }}} 1. Now scan for BLE devices and confirm we have found the candle {{{ hcitool -i hci0 lescan }}} 1. Change the color of the candle to red: {{{ gatttool -i hci0 -b 3C:A3:08:10:51:FE --char-write-req -a 0x002e -n 56ff000000f0aa }}} 1. Change the color to green: {{{ gatttool -i hci0 -b 3C:A3:08:10:51:FE --char-write-req -a 0x002e -n 5600ff0000f0aa }}} == IoT and Beyond == The LED Candle is only an example. BLE can be used for many industrial sensors, such as tags for location information. The CAT M1 modem on the GW16126 can then further enable internet connectivity, allowing sensor data to be pushed to the cloud.