https://github.com/pureswift/bluetoothlinux

Pure Swift Linux Bluetooth Stack
https://github.com/pureswift/bluetoothlinux

bluetooth bluetooth-low-energy bluez gatt ibeacon iot linux swift

Last synced: 3 days ago
JSON representation

Pure Swift Linux Bluetooth Stack

• Host: GitHub
• URL: https://github.com/pureswift/bluetoothlinux
• Owner: PureSwift
• License: mit
• Created: 2015-12-06T10:10:21.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-09-14T04:26:19.000Z (2 months ago)
• Last Synced: 2024-10-15T08:02:04.064Z (30 days ago)
• Topics: bluetooth, bluetooth-low-energy, bluez, gatt, ibeacon, iot, linux, swift
• Language: Swift
• Homepage:
• Size: 3.52 MB
• Stars: 182
• Watchers: 13
• Forks: 30
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![BluetoothLinux](https://github.com/PureSwift/BluetoothLinux/raw/master/Assets/PureSwiftBluetoothLinux.png)

[![Swift][swift-badge]][swift-url]

[![Platform][platform-badge]][platform-url]

[![Release][release-badge]][release-url]

[![License][mit-badge]][mit-url]

Pure Swift Bluetooth Stack for Linux

Does not require [BlueZ](https://www.bluez.org) userland library, communicates directly with the Linux kernel Bluetooth subsystem. 

## Usage

```swift

import Bluetooth

import BluetoothLinux

guard let hostController = await BluetoothLinux.HostController.default

    else { fatalError("No Bluetooth adapters found") }

let uuid = UUID(rawValue: "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0")!

let beacon = AppleBeacon(uuid: uuid, major: 1, minor: 1, rssi: -29)

do { try await hostController.iBeacon(beacon) }

catch { print("Error enabling iBeacon: \(error)") }

```

## Installation

### Swift Package Manager

```swift

import PackageDescription

let package = Package(

    dependencies: [

        .package(

			url: "https://github.com/PureSwift/BluetoothLinux.git",

    		.branch("master")

    	)

    ]

)

```

## Documentation

Read the documentation [here](http://pureswift.github.io/BluetoothLinux/documentation/bluetoothlinux/).

Documentation can be generated with [DocC](https://github.com/apple/swift-docc).

## See Also

- [Bluetooth](https://github.com/PureSwift/Bluetooth) - Pure Swift Bluetooth Definitions.

- [GATT](https://github.com/PureSwift/GATT) - Bluetooth Generic Attribute Profile (GATT) for Swift.

- [Netlink](https://github.com/PureSwift/Netlink) - Swift library for communicating with Linux Kernel Netlink subsystem.

License

-------

**BluetoothLinux** is released under the MIT license. See LICENSE for details.

[swift-badge]: https://img.shields.io/badge/Swift-5.6-orange.svg?style=flat

[swift-url]: https://swift.org

[platform-badge]: https://img.shields.io/badge/platform-linux-lightgrey.svg

[platform-url]: https://swift.org

[mit-badge]: https://img.shields.io/badge/License-MIT-blue.svg?style=flat

[mit-url]: https://tldrlegal.com/license/mit-license

[release-badge]: https://img.shields.io/github/release/PureSwift/BluetoothLinux.svg

[release-url]: https://github.com/PureSwift/BluetoothLinux/releases