Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xevilmaxx/bleperipheral
BLE GATT Server, Linux/Windows even from simple Console App
https://github.com/xevilmaxx/bleperipheral
ble bluetooth bluetooth-low-energy bluez bluez-dbus csharp dbus gatt gatt-server maui maui-blazor net8 netcore
Last synced: about 1 month ago
JSON representation
BLE GATT Server, Linux/Windows even from simple Console App
- Host: GitHub
- URL: https://github.com/xevilmaxx/bleperipheral
- Owner: xevilmaxx
- Created: 2024-03-04T08:17:56.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-03-04T09:20:02.000Z (10 months ago)
- Last Synced: 2024-03-05T10:00:41.335Z (10 months ago)
- Topics: ble, bluetooth, bluetooth-low-energy, bluez, bluez-dbus, csharp, dbus, gatt, gatt-server, maui, maui-blazor, net8, netcore
- Language: C#
- Homepage:
- Size: 29.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# What this project is:
Its an attempt to create a simple cross-platform library which works on Windows/Linux without necessity of creating special types of projects.
The aim is to have as simpliest possible init way in order to expose on both platforms GATT Service and Read/Write characteristics.
# Derived From:
- https://github.com/exendahal/dotnet_bluez_server
- which derives from:
- https://github.com/phylomeno/dotnet-ble-server
# GATT Features Support:
| Is Supported | Characteristic Type |
|--|--|
| V | Read |
| V | Write |
| X | Subscribe / Notify |
# Basic working range:
Without external antennas, its normally approximately **10 meters**, the distance may vary depending of how much radio interference you may have between devices.
Sometimes if you increase discovery time in MAUI you can fetch devices even from greater distance, maybe +-20 meters is a maximum limit without additional antennas.
If you need more range that that, probably its better to consider LoRa instead.
# Usage Sample
**Basic Struct:**
var maxStruct = new MaxStructBuilder()
.BuildTestV3_ExternalActions(
(data) =>
{
Console.WriteLine("Written Data to us ----->" + Encoding.ASCII.GetString(data));
},
() =>
{
return Encoding.ASCII.GetBytes($"okkkkkk");
}
);
**Than in order to expose it simply do:**
var ble = new BlePeripheralFactory()
.GetDriver()
.SetMaxBleDevice(maxStruct)
.Expose();
**Advanced struct usage:**
var maxStruct = new MaxBleDevice()
{
Name = "EvilMax",
Services = new List()
{
new MaxGattService()
{
UUID = "00000000-0000-0000-0000-000000000001",
Characteristics = new List()
{
new MaxGattCharacteristic()
{
UUID = "00000000-0000-0000-0000-000000000002",
Flags = new List() { MaxCharactPropType.Read, MaxCharactPropType.Write },
Descriptor = new MaxGattDescriptor()
{
UUID = "00000000-0000-0000-0000-000000000021",
StaticValue = Encoding.ASCII.GetBytes("Static Value")
},
OnWriteCaptured = (receivedData) =>
{
Console.WriteLine(Encoding.ASCII.GetString(receivedData));
}
}
}
},
new MaxGattService()
{
UUID = "00000000-0000-0000-0000-000000000003",
Characteristics = new List()
{
new MaxGattCharacteristic()
{
UUID = "00000000-0000-0000-0000-000000000004",
Flags = new List() { MaxCharactPropType.Read },
OnReadCaptured = () =>
{
//return random number as string
return Encoding.ASCII.GetBytes(new Random().Next().ToString());
//this may be your personal local variable
//return ChangableData;
},
}
}
},
new MaxGattService()
{
UUID = "00000000-0000-0000-0000-000000000005",
Characteristics = new List()
{
new MaxGattCharacteristic()
{
UUID = "00000000-0000-0000-0000-000000000006",
Flags = new List() { MaxCharactPropType.Write },
OnWriteCaptured = (receivedData) =>
{
Console.WriteLine(Encoding.ASCII.GetString(receivedData));
}
}
}
}
}
};
You can attach something to execute (lambda [which may use your local variables]) when someone tries to **Write** certain characteristic and you can define dynamic data to return in case of **Read** is received.
# Platfrom Notes:
- Definition of device Name
- **Linux**
- Works perfectly
- **Windows**
- You need set it manually from windows settings (guide is provided in Notes.txt under LibBlePeripheral/WindowsBleServer )
# Trick used to make Windows work in normal ConsoleApp:
Extracted DLLs from nuget package: **Microsoft.Windows.SDK.NET.Ref**, and referenced the oldest version to gain as much compatibility as possible.
You are free to change the SDK reference version, just add reference to different local DLLs which are already included in LibBlePeripheral project.
# Tested On:
- **Windows 11** (Should work fine starting from: Windows 10 build 17763)
- **Raspberry 3B+** (which means it should work without problems on **RPI 4**)
- Basically will work on any linux that supports:
- **BlueZ**
- **Dbus**
# Extras:
Included a **MAUI** implementation of client in order to play around with exposed server.
Best pages for Test:
- /
- /**bleactonvicinity**
- this one will basically attempt to call some characteristic on exposed server as soon as its discovered, with some timeouts (***eventually you will need to change DeviceName you are scanning for if its different for you***)
# Frameworks Used:
- **NET CORE - NET8.0**
- Pure **C#**
- Basic **Console App** for Server (**Peripheral**)
- **MAUI + Blazor** for Mobile Device (**Central**)
# Reminders for me:
Not yet exposable as nuget package as need provide universal way in order to be able to attach a generic logger and avoid dependency from Nlog (expecially for those who use different version of same library).