Documentation

This commit is contained in:
Greg 2019-11-27 11:06:42 -05:00
parent 321b94a486
commit 7223b8c380
3 changed files with 55 additions and 1 deletions

2
.gitignore vendored
View File

@ -1 +1 @@
Ble.jar

BIN
Ble.jar Normal file

Binary file not shown.

54
README.md Normal file
View File

@ -0,0 +1,54 @@
# BLE
A modern, cross-platform Go library for Bluetooth Low Energy
This package is a working but incomplete interface for access to Bluetooth
Low Energy devices. It is intended to support multiple operating systems
with a uniform API. Currently, MacOS and Android are supported. Android
support requires the use of [Gio](https://gioui.org).
The API is asyncrhonous and event driven. To access Bluetooth hardware,
first create a `BLE` variable with `NewBLE()`. On Android, you must also
call `Enable` with a pointer to your Gio Window.
```go
import (
...
"git.wow.st/gmp/ble"
"gioui.org/app"
)
func runloop() {
b := ble.NewBle()
w := app.NewWindow()
b.Enable(w)
...
```
Once enabled, you can call the primary API functions, `Scan`, `StopScan`,
`Connect`, and `CancelConnection`. You can also query the state of the
Bluetooth hardware by calling `State`.
Calling `Events` on your `BLE` object returns a channel on which API events
are delivered. These events notify your program when the state of the
BLE hardware changes (e.g. powered on or off), peripherals are connected,
services or characteristics are discovered, or values for characteristics
are updated.
Using Gio, your main event loop will look something like this:
```
for {
select {
case e := <-b.Events():
switch e := e.(type) {
// Handle BLE Events
}
}
case e := <-w.Events():
switch e := e.(type) {
// Handle Gio events
}
}
}
```