Behaviorally based redefinition of CoreBluetooth.

CoreBluetooth is amazing! It’s good times, for real. Sadly, it is lacks a few features I find very useful when dealing with lesser devices such as the HM-10. For example, a search which is based on a timer. Of course, it’s fairly easy to implement these features, but I got tired of rewriting the same helpers over-and-over.

I am pushing the design of the module to be behavior based. I’m not sure this is the correct term, but it does describe what I am trying to accomplish. Often, I want to switch how the iOS BLE device acts, these behaviors are really all I care about. Well, that and actually getting data from the iOS to a nearby microcontroller. Anyway, I decided to try and focus on getting these desired behaviors out the iOS device, rather than conforming to sound OO code.

It’s an expirement!

Getting Started

The full code to get connected to a remote device would be,

import UIKit

class ViewController: UIViewController, LocalBehavioralSerialDeviceDelegate {
  var myLocal = LocalBluetoothLECentral()
  var myRemote = RemoteBluetoothLEPeripheral()

  override func viewDidLoad() {

    // Attach the delegate to ViewController.
    myLocal.delegate = self

    // Tells the iOS BLE to attempt to retry connecting 3 times, with 1.5
    // seconds inbetween attempts.
    myLocalBLE.reconnectOnDisconnect(tries: 3, timeBetweenTries: 1.5)
    // Instructs the iOS BLE to gather advertizing data on search
    myLocalBLE.discoverAdvertizingDataOnSearch = false
    // Tells the iOS BLE to search for peripherals for two seconds.

  func searchTimerExpired() {
    // Look up a discovered remote device by its advertized name.
    if let foundRemote = myLocal.getDiscoveredRemoteDeviceByName("HMSoft"){
        myRemote = foundRemote
        // Connect to the device, returning true if successful.
        let didConnect = myLocal.connectToDevice(myRemote)

Functions and Behaviors

List of Devices sorted by RSSI

let sortedDeviceArrayByRSSI = myLocal.getAscendingSortedArraysBasedOnRSSI()

for(var i = 0; i < sortedDeviceArrayByRSSI.nsuuids.count; i++){
    if let name = myLocal.getDeviceName(sortedDeviceArrayByRSSI.nsuuids[i]){
    print("NSUUID: " + String(sortedDeviceArrayByRSSI.nsuuids[i].UUIDString) 
    + "\n\tRSSI: " + String(sortedDeviceArrayByRSSI.rssies[i]))

Console output, Apple TV NSUUID: C35327C8-DAEE-0959-C047-F0D9B02ED90C RSSI: -85 Apple TV NSUUID: A311FF27-FD16-8F62-971E-FEB023B0EA96 RSSI: -87 Unknown_0 NSUUID: 12FE30E7-9DA0-A791-B9E4-F618CB4482C9 RSSI: -95

Debug Output


Console output, Started search with 2.0 sec timeout Searching for BLE Devices didDiscoverPeripheral A311FF27-FD16-8F62-971E-FEB023B0EA96 didDiscoverPeripheral 8BF37705-5698-8306-F8CF-5203D6DB16C9 didDiscoverPeripheral C35327C8-DAEE-0959-C047-F0D9B02ED90C didDiscoverPeripheral 12FE30E7-9DA0-A791-B9E4-F618CB4482C9 Attempting to connect to: HMSoft setConnectedDevice didConnectToPeripheral: 8BF37705-5698-8306-F8CF-5203D6DB16C9 didDiscoverServices: FFE0

Local Device State Change

This will start the search when the iOS BLE device is powered on and ready. This allows the app to start scanning on load. It is often tempting to put the Search method in the ViewDidLoad method, however, if the iOS BLE device had not yet powered on the scan will not discover peripherals resulting in the search always failing.

func localDeviceStateChange() {
    if(myLocal.deviceState == DeviceState.idle){

Documentation Waka Report

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.