BlueSwift 1.1.5

BlueSwift 1.1.5

Maintained by Netguru.



BlueSwift 1.1.5

  • By
  • Jan Posz


Easy to use Bluetooth open source library brought to you by Netguru.
๐ŸคŸ Probably the easiest way to interact with bluetooth peripherals ๐ŸคŸ

๐Ÿคน๐Ÿปโ€โ™‚๏ธ Features

  • Handles connection with remote peripherals.
  • Handles advertising an iPhone as Bluetooth LE peripheral.
  • Closure based read/write/notify requests.
  • Built in data conversion method with Command wrapper.

๐Ÿ“ฒ Connection:

Below you can find an easy code sample to connect to the peripheral.
Really thats all that is needed ๐Ÿพ๐Ÿพ

let connection = BluetoothConnection.shared
let characteristic = try! Characteristic(uuid: "your_characteristic_uuid", shouldObserveNotification: true)
let service = try! Service(uuid: "your_service_uuid", characteristics: [characteristic])
let configuration = try! Configuration(services: [service], advertisement: "your_advertising_uuid")
let peripheral = Peripheral(configuration: configuration)
connection.connect(peripheral) { error in
	// do awesome stuff
}

๐Ÿ“ก Advertisement:

Below you can find a code sample the setup the iPhone to advertise Bluetooth.
That's all it takes to advertise one service containing one characteristic.

let characteristic = try! Characteristic(uuid: "your_characteristic_uuid")
let service = try! Service(uuid: "your_service_uuid", characteristics: [characteristic])
let configuration = try! Configuration(services: [service], advertisement: "your_service_uuid")
let peripheral = Peripheral(configuration: configuration, advertisementData: [.localName("Test"), .servicesUUIDs("your_service_uuid")])
advertisement.advertise(peripheral: peripheral) { error in
	// oh no, something failed in that case          
}

๐Ÿ“Ÿ ๐Ÿ“ฒ Data transfer:

Of course data transfer is also possible, both for advertising and connection mode! Below there are some basic examples, for more please see More usage section ๐Ÿ‘‡๐Ÿป

Connection mode:

let command = Command.utf8String("Hello world")
peripheral.write(command: command, characteristic: someCharacteristic, handler: { error in
	// written!
})
peripheral.read(characteristic, handler: { data, error in
	// read!
})

Advertisement mode:

let command = Command.int8(3)
advertisement.update(command, characteristic: characteristic) { error in
	// data updated!
}
advertisement.writeRequestCallback = { characteristic, data in
	// written!
}

โš™๏ธ More usage:

For more advanced usage check out documentation page at: https://netguru.github.io/BlueSwift/.
Also feel free to check example project bundled with this repository! ๐Ÿ‘ฉ๐Ÿผโ€๐Ÿซ ๐Ÿ‘จ๐Ÿผโ€๐Ÿซ It's a complete app that allows connection and sending text messages between two iPhones.

๐Ÿ›  Dependency management:

BlueSwift can be drag'n dropped to the project directory,
but what's more important it's supported by most common dependency management!

Just drop the line below to your Podfile:

pod 'BlueSwift'

(but probably you'd like to pin it to the nearest major release, so pod 'BlueSwift' , '~> 1.1.5')

The same as with Cocoapods, insert the line below to your Cartfile:

github 'netguru/BlueSwift'

, or including version - github 'netguru/BlueSwift' ~> 1.1.5

๐Ÿ“„ License

(As all cool open source software, it's...)
Licensed under MIT license.

Also it would be really nice if you could drop us a line about your usage!! ๐Ÿš€๐Ÿš€