Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yskszk63/gatt
Bluetooth Low Energy Generic Attribute Profile Library.
https://github.com/yskszk63/gatt
ble gatt gatt-server
Last synced: about 1 month ago
JSON representation
Bluetooth Low Energy Generic Attribute Profile Library.
- Host: GitHub
- URL: https://github.com/yskszk63/gatt
- Owner: yskszk63
- Created: 2020-11-15T13:16:28.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-12-09T03:07:17.000Z (about 3 years ago)
- Last Synced: 2024-10-28T22:38:46.520Z (about 2 months ago)
- Topics: ble, gatt, gatt-server
- Language: Rust
- Homepage:
- Size: 135 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# gatt
Bluetooth Low Energy Generic Attribute Profile
ref BLUETOOTH CORE SPECIFICATION Version 5.1 | Vol 3, Part G
Generic Attribute Profile (GATT)
### Example
```rust
use gatt::{CharacteristicProperties, Registration, Server};
use gatt::services as srv;
use gatt::characteristics as ch;
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
enum Token {
DeviceName,
BatteryLevelNotify,
}
fn new_registration() -> Registration {
let mut registration = Registration::new();
registration.add_primary_service(srv::GENERIC_ACCESS);
registration.add_characteristic_with_token(
Token::DeviceName,
ch::DEVICE_NAME,
"abc",
CharacteristicProperties::WRITE,
);
registration.add_characteristic(
ch::APPEARANCE,
0x03c0u16.to_le_bytes().to_vec(),
CharacteristicProperties::READ,
);
registration.add_primary_service(srv::GENERIC_ATTRIBUTE);
registration.add_characteristic(
ch::SERVICE_CHANGED,
"",
CharacteristicProperties::INDICATE,
);
registration.add_primary_service(srv::DEVICE_INFORMATION);
registration.add_characteristic(
ch::MANUFACTURER_NAME_STRING,
"機械",
CharacteristicProperties::READ,
);
registration.add_characteristic(
ch::MODEL_NUMBER_STRING,
"A123",
CharacteristicProperties::READ,
);
registration.add_characteristic(
ch::SERIAL_NUMBER_STRING,
"333-444",
CharacteristicProperties::READ,
);
registration.add_primary_service(srv::BATTERY);
registration.add_characteristic_with_token(
Token::BatteryLevelNotify,
ch::BATTERY_LEVEL,
"",
CharacteristicProperties::NOTIFY,
);
registration
}
#[tokio::main(flavor = "current_thread")]
async fn main() -> anyhow::Result<()> {
use std::io::stdin;
use tokio::task::spawn_blocking;
use tokio::io::AsyncWriteExt;
let mut server = Server::bind()?;
let mut connection = server.accept(new_registration()).await?.unwrap();
let mut events = connection.events();
let mut notification = connection.notification(&Token::BatteryLevelNotify)?;
let task = connection.run();
tokio::pin!(task);
let mut n = 0;
loop {
tokio::select! {
r = Pin::new(&mut task) => {
r?;
break;
}
maybe_line = spawn_blocking(|| stdin().read_line(&mut String::new())) => {
maybe_line??;
notification.write_all(&[n]).await?;
n += 1;
}
event = events.next() => {
if let Some(event) = event {
println!("{:?}", event);
}
}
}
}
// ...
# Ok(())
}
```
## Supported target
- x86_64-unknown-linux-gnu
Tested on Linux 5.13 (Arch Linux)
### License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.!
License: MIT OR Apache-2.0