https://github.com/kevinbrewster/SwiftLinuxBLE

SwiftLinuxBLE is a lightweight convenience wrapper for the PureSwift BluetoothLinux library. It enables you to very quickly create a BLE GATT peripheral on linux (for example, on the Raspberry Pi).
https://github.com/kevinbrewster/SwiftLinuxBLE

Last synced: about 1 month ago
JSON representation

SwiftLinuxBLE is a lightweight convenience wrapper for the PureSwift BluetoothLinux library. It enables you to very quickly create a BLE GATT peripheral on linux (for example, on the Raspberry Pi).

• Host: GitHub
• URL: https://github.com/kevinbrewster/SwiftLinuxBLE
• Owner: kevinbrewster
• Created: 2019-10-08T17:10:42.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-10-10T19:24:01.000Z (about 5 years ago)
• Last Synced: 2024-08-02T07:01:50.309Z (4 months ago)
• Language: Swift
• Homepage:
• Size: 22.5 KB
• Stars: 8
• Watchers: 2
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-embedded-swift - SwiftLinuxBLE - SwiftLinuxBLE is a lightweight convenience wrapper for the PureSwift BluetoothLinux library. (Communication / Networking, IoT, Bus Protocols, …)

README

        
# SwiftLinuxBLE

SwiftLinuxBLE is a lightweight convenience wrapper for the [PureSwift BluetoothLinux library](https://github.com/PureSwift/BluetoothLinux).

It enables you to very quickly create a BLE GATT peripheral on linux (for example, on the Raspberry Pi).

# Usage

Create a `Service` for each service you want to expose. Use the `@SwiftLinuxBLE.Characteristic` propertyWrapper for each characteristic. The peripheral will automagically track changes to each characteristic and will also write to them.

```

final class TemperatureService : SwiftLinuxBLE.Service {

    let uuid = BluetoothUUID(rawValue: "88d738cc-bdd0-485b-b197-b7186ff534e4")!

    

    // Characteristics

    @SwiftLinuxBLE.Characteristic(uuid: BluetoothUUID(), [.read, .notify])

    var temperature = 7.0

       

    @SwiftLinuxBLE.Characteristic(uuid: BluetoothUUID(), [.write])

    var tx = Data()

    

    @SwiftLinuxBLE.Characteristic(uuid: BluetoothUUID(), [.read, .notify])

    var rx = Data()

}

```

2. Create a `Peripheral` class and add each service. 

```

public final class ThermometerPeripheral : SwiftLinuxBLE.Peripheral {

    

    public let peripheral: GATTPeripheral

    let name: GAPCompleteLocalName = "Ferment"

    let iBeaconUUID = UUID(rawValue: "1DC24957-9DDA-46C4-88D4-3D3640CB3FDA")!

    

    public var services: [SwiftLinuxBLE.Service] = []

    public var characteristicsByHandle = [UInt16: CharacteristicType]()

    

    public init(hostController: HostController) throws {

        peripheral = try hostController.newPeripheral()

        

        add(service: TemperatureService())

                

        // Start peripheral

        try peripheral.start()

        print("BLE Peripheral started")

                       

        try advertise(name: name, services: services, iBeaconUUID: iBeaconUUID)

        

        peripheral.didWrite = didWrite

    }

}

```

# Example:

Check out the [SwiftLinuxGATTServerExample](https://github.com/kevinbrewster/SwiftLinuxGATTServerExample) for a working example.