Goal
I am developping a simple device running Linux. It is BLE capable, and I am currently using bluez 5.8.
I want to trigger an action on this device using an iPhone.
What already works:
I setup the bluetooth device like this on linux (thanks to this question):
# activate bluetooth hciconfig hci0 up # set advertise data: "hello world" hcitool -i hci0 cmd 0x08 0x0008 48 45 4c 4c 4f 57 4f 52 4c 44 # start advertising as connectable hciconfig hci0 leadv 0
The iOS code is straightforward:
- (int) scanForPeripherals { if (self->centralManager.state != CBCentralManagerStatePoweredOn) { return -1; } NSDictionary *options = [NSDictionary dictionaryWithObjectsAndKeys:[NSNumber numberWithBool:NO], CBCentralManagerScanOptionAllowDuplicatesKey, nil]; [self.centralManager scanForPeripheralsWithServices:nil options:options]; return 0; } - (void)centralManagerDidUpdateState:(CBCentralManager *)central { if (central.state == CBCentralManagerStatePoweredOn) { NSLog(@"Starting scan"); [self scanForPeripherals]; } } - (void) centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber *)RSSI { NSLog(@"didDiscoverPeripheral"); /* * Retain the peripheral to avoid the error: * CoreBluetooth[WARNING]: state = connecting> is being dealloc'ed while connecting */ self.activePeripheral = peripheral; [centralManager connectPeripheral:peripheral options:nil]; } - (void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral { NSLog(@"Connected to peripheral"); /* discover all services */ [peripheral discoverServices:nil]; } - (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(NSError *)error { NSLog(@"Discovered services"); for (CBService *service in peripheral.services) { NSLog(@"Discovered service %@", service); } }
When running this code on the iPhone, I get this log:
2013-12-19 12:53:22.609 Test2[18518:60b] Starting scan 2013-12-19 12:53:29.945 Test2[18518:60b] didDiscoverPeripheral 2013-12-19 12:53:31.230 Test2[18518:60b] Connected to peripheral
So it seems that the iPhone connects fine, but does not see any service.
What I am missing
I should probably mention that I saw this question: Creating a gatt server, but the answers raise too much questions (for example, where is the GATT api for bluez? how to set the GATT database? How to register for read/write events?)
EDIT: The commands I use only set-up the BLE device to advertise some data, but iOS reports that the connection is accepted. What part of bluez is accepting incoming connections?
A GATT Server is a device that stores attribute data locally and provides data access methods to a remote GATT Client paired via BLE.
This makes GATT a key section of the BLE specification, because every single item of data relevant to applications and users must be formatted, packed, and sent according to its rules. GATT uses the Attribute Protocol (detailed in “Attribute Protocol (ATT)”) as its transport protocol to exchange data between devices.
GAP defines the general topology of the BLE network stack. GATT describes in detail how attributes (data) are transferred once devices have a dedicated connection.
What is BlueZ? BlueZ is the Bluetooth stack for Linux. It handles both Bluetooth BR/EDR as well as BLE.
Eventually, I discovered the answers to all the questions I had.
I will start by answering the last question:
The commands I use only set-up the BLE device to advertise some data, but iOS reports that the connection is accepted. What part of bluez is accepting incoming connections?
This one was answered on the bluez mailing-list, in response to me.
Summary: the BLE connection is accepted at the HCI level by the kernel. If you want to use that connection from user space you need to use an l2cap socket with the ATT channel ID (which is 4).
Bleno has a good example of using an L2CAP socket.
How an L2CAP socket works is basically like this:
/* create L2CAP socket, and bind it to the local adapter */ l2cap_socket = socket(AF_BLUETOOTH, SOCK_SEQPACKET, BTPROTO_L2CAP); hci_device_id = hci_get_route(NULL); hci_socket = hci_open_dev(hci_device_id); memset(&l2cap_address, sizeof(l2cap_address)); l2cap_address.l2_family = AF_BLUETOOTH; l2cap_address.l2_bdaddr = hci_device_address; l2cap_address.l2_cid = htobs(ATT_CID); bind(l2cap_socket, (struct sockaddr*)&l2cap_address, sizeof(l2cap_address)); listen(l2cap_socket, 1); while (1) { /* now select and accept() client connections. */ select(l2cap_socket + 1, &afds, NULL, NULL, &tv); client_socket = accept(l2cap_socket, (struct sockaddr *)&l2cap_address, &len); /* you can now read() what the client sends you */ int ret = read(client_socket, buffer, sizeof(buffer)); printf("data len: %d\n", ret); for (i = 0; i < ret; i++) { printf("%02x", ((int)buffer[i]) & 0xff); } printf("\n"); close(client_socket); }
How to advertise a service?
I realized I needed an answer to the previous question to answer that one.
Once you can read the data over L2CAP socket, everything makes more sense, for example, if your Android phone does gatt.discoverServices()
, then the little program above will read (i.e. receive):
10 0100 ffff 0028
Which basically means:
10: READ_BY_GROUP 0100: from handle 0001 ffff: to handle ffff 0028: with UUID 2800
This request is the way any BLE peripheral will request the list of services.
Then, you can answer this request with the list of services your device provides, formatted according to the GATT protocol.
Again, see the implementation of this in Bleno.
You're really close.
To see the services on a device using your iOS code, try adding
peripheral.delegate = self;
to your didConnectPeripheral
, before the discoverServices
call. I got that from the Apple documentation and it fixed things for me (just don't forget to add CBPeripheralDelegate
to the interface declaration in the header file). Without it, didDiscoverServices
will never be called.
I was able to get the gatt-example
service plugin to run by compiling BlueZ from source with the ./configure --enable-maintainer-mode
. Then if you launch bluetoothd -nd
you'll see something like
src/plugin.c:add_plugin() Loading gatt_example plugin
near the top of the output, and then
attrib/gatt-service.c:gatt_service_add() New service: handle 0x0009, UUID a002, 4 attributes src/attrib-server.c:attrib_db_add_new() handle=0x0009 attrib/gatt-service.c:gatt_service_add() New characteristic: handle 0x000a src/attrib-server.c:attrib_db_add_new() handle=0x000a
At that point, my iOS app was able to see the BlueZ peripheral
, connect, and discover its services (after a hciconfig hci0 leadv
).
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With