Return-Path: From: Vinicius Costa Gomes To: Alex Coplan , linux-bluetooth@vger.kernel.org Subject: Re: Possible bug: D-Bus Advertising API does not generate first section of advertising payload In-Reply-To: <024AE186-38B1-4A58-B889-02AF6D776F8D@starleaf.com> References: <024AE186-38B1-4A58-B889-02AF6D776F8D@starleaf.com> Date: Tue, 02 Aug 2016 14:26:40 -0300 Message-ID: <87lh0fytdb.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Sender: linux-bluetooth-owner@vger.kernel.org List-ID: Hi Alex, Alex Coplan writes: > Hi all, > > I’m experiencing a bit of trouble using the BlueZ D-Bus API for broadcast advertising. In particular, I’m trying to generate iBeacon advertisements using the API. > > So far, I have successfully used the D-Bus API to implement LE peripheral advertising (Type = ‘peripheral’). However, getting BlueZ to generate well-formed iBeacon packets is proving problematic. > > In the process of debugging, I used hcidump to obtain the advertising payload produced by my code. I have a reference implementation using the HCI socket API to generate iBeacon advertisements, and this works well. Here is the advertising payload generated by the HCI code (which I obtained from here: https://github.com/carsonmcdonald/bluez-ibeacon/blob/master/bluez-beacon/ibeacon.c). > > ============================================================== > Working advertising payload generated by HCI code > ============================================================== > > Total AD 0 Ad AD 1 Ad Apple Inc > Length Len Type Flags Len Type --------- > | | | | | | | | > 1e 02 01 1a 1a ff 4c 00 > > iBeacon > Prefix . . . . . . . U U I D . . . . > --------- ------------------------------------- > | | | > 02 15 56 5c a5 be 7a df > > . . . . . . U U I D . . . . . . . . . . . . > --------------------------------------------------- > 4f 7b b2 68 91 f4 08 d7 > > . . . . . Major=10 Minor=10 Tx > --------- --------- --------- Power Padding > | | | | | | | > 70 cd 00 0a 00 0a cf 00 > > ============================================================ > > I am using the terminology from this packet diagram (http://www.argenox.com/wp-content/uploads/ibeacon-packet-format.png). Packets containing this advertising payload are correctly recognised by iOS devices as iBeacon packets. > > In my D-Bus code, I am sending advertisements to BlueZ with the following parameters: > - Type = 'broadcast' > - ServiceUUIDs = [] > - ManufacturerData = { 0x4C: 02 15 [UUID] 00 0a 00 0a } (2 byte manufacturer ID + 22 bytes of data) > - SolicitUUIDs = [] > - ServiceData = [] > - IncludeTxPower = True > > This follows the iBeacon spec as closely as possible. Unfortuantely, the packets generated by BlueZ are not recognised by iOS devices! On closer inspection, it becomes apparent why this is the case: > > ============================================================== > Broken advertisement payload generated by D-Bus code > ============================================================== > > iBeacon > Total AD 1 Ad Apple Inc Prefix . . > Length Len Type --------- --------- ----- > | | | | | | | | > 1d 19 ff 4c 00 02 15 56 > > . . . . . . U U I D . . . . . . > --------------------------------------------------- > 5c a5 be 7a df 4f 7b b2 > > . . . . . . U U I D . . . . Major > -------------------------------------------- ----- > | | > 68 91 f4 08 d7 70 cd 00 > > Minor=10 Tx ? ? ? ? Padding > -- --------- Power? --------- --------- > | | | | | | | | > 0a 00 0a 02 0a 08 00 00 > > ============================================================== > > The most obvious difference between this packet and the correct one is > that this packet is missing the AD 0 section! BlueZ fails to emit this > part of the advertisement packet altogether. I assume that without > this section, the packet is sufficiently malformed that devices cannot > recognise it as an iBeacon packet. > > Is this a bug, or am I missing something? Any help or advice would be > greatly appreciated. Quoting the specification (Core Specification Supplement v6, part A, Section 1.3.1, page 12): "The Flags data type shall be included when any of the Flag bits are non-zero and the advertising packet is connectable, otherwise the Flags data type may be omitted. All octets that are 0x00 are not transmitted as long as all other octets after that octet are also 0x00." I guess BlueZ (the kernel side in this case, around net/bluetooth/hci_request.c:1081) interprets this as if the flags are zero, they can be omitted. It seems that the correct interpretation would be that it could be omitted only if the rest of the advertising payload was all zeroes. (nice diagrams btw :-) > > Regards, > Alex > > -- > To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html Cheers, -- Vinicius