Received: by 2002:a05:6a11:4021:0:0:0:0 with SMTP id ky33csp4281403pxb; Mon, 27 Sep 2021 13:25:01 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwWpSq7+1fjwOqBdySBtTfxzP/fMfmPTLz1mmIafloS7jEZtVEkIZFAhm4ivr9a1zBFcqbm X-Received: by 2002:a17:906:a24c:: with SMTP id bi12mr2248841ejb.530.1632774300806; Mon, 27 Sep 2021 13:25:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1632774300; cv=none; d=google.com; s=arc-20160816; b=cT731KyjZo3iIqESPmZfw1sb6LatWB8Fn1JQL5c6Q4ufhWw2UQOF982Ip2gNTnWPGB aHV44gLuIKQ6uRYpzB0HiX2Z2DqvFXuSbjhpI3QF18eO0F+hPOXv0zwPf5FvdHHxifYn jkGs2Ru5ifhXuB38VV4PNH0IWO3hDs+2/eStHpzxNdIf7wTfzFM8Z6aMTLsDKq1iPcY2 YKi+4maWQuAhm09+vAYTv3WL8pKm3xFhv9TkoS5ytz0m1zBJ/o6BdGQmlxjl8fL0KlgN sizyLDXZVXgFR3aGCq9qv54BHsdsmbtBfysfoE5g1nCEBsA/l+ewGVMPS1UZUCibODOz gEww== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=evY07ERc5o3CxaWJROXLfeIqIcphpacLS/0ORBNDVrE=; b=W8ORAex/J1c6i+Rt6OQ3C88iEnLHy9X3Mzl7Ey9hDH5N1xDFHyczlf5x235HCRv6tg kwh11QtNjztGq++eYyHrR3+r/pUejK0LfjHAKS8iiO5piBIpOvB88zT0xHOSx9UwTgd+ v1WTNO51fX92lN+4lKb+Trva3Eg2C5d7ZDOeSSM2YNIHqn0ZuMSXK1++o03H32EAICRr +QwEhb9gwwlQmCB7JyhiseakvTG9FZGJSseSjuSHsmr4jhZKcIU2lK95TIuATbBRO02r o1L92wvzXOTpT0V07a8UEoLMr5uz6EWvC2aUUoLMbQFJ7LofpHC26/iwDjdFyrkv0RZp dVSw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=BgDDTa+z; spf=pass (google.com: domain of linux-bluetooth-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-bluetooth-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id dp16si2736837ejc.236.2021.09.27.13.24.35; Mon, 27 Sep 2021 13:25:00 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-bluetooth-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=BgDDTa+z; spf=pass (google.com: domain of linux-bluetooth-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-bluetooth-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236984AbhI0UZT (ORCPT + 99 others); Mon, 27 Sep 2021 16:25:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56440 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236910AbhI0UZQ (ORCPT ); Mon, 27 Sep 2021 16:25:16 -0400 Received: from mail-vs1-xe35.google.com (mail-vs1-xe35.google.com [IPv6:2607:f8b0:4864:20::e35]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C3A8FC061575 for ; Mon, 27 Sep 2021 13:23:37 -0700 (PDT) Received: by mail-vs1-xe35.google.com with SMTP id n17so19549023vsr.10 for ; Mon, 27 Sep 2021 13:23:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=evY07ERc5o3CxaWJROXLfeIqIcphpacLS/0ORBNDVrE=; b=BgDDTa+zxOfFFwQ6BqOcniHG24ipj+Dy9Qv7PjDIlWEHWePd9jHvuFQrJlJmCyE/VV Skyw6fKCMcAnMmQ0+JzOwaQagjTwL0eV175qeRxFZ3857UTMFplj0hbcelfOkmzqc5pC +eVm1Yji+cv0kHVhHFElqrbf9L/sjU5OD5pD3SwM3T4+GifSmPqV1JxkD/RLGhuhjGBl OVehAJidwRHfzVOqtnkTSbMMY/8GxaPD1swHv5q9zroVvD9dkkvMgkiIVGKe/W5URvO0 Q5sR32MkRLKR17Squ0qUb7X9y/T4m5F+hzP/LXVxs50z0eKJ9+te1OKbH9/QbP4EzyoU EoEw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=evY07ERc5o3CxaWJROXLfeIqIcphpacLS/0ORBNDVrE=; b=Sx6inwHu8OsVwEWW9N8OS7Qz2r7eszIDLPWVLq2S6wCSYuj8XVNV8O/dzEj4ApmGiQ rlU+S7lVzYBjM8OHupwCpIfUGQ12PEc8ppxcD/VnXlrkhp3/of7+mMjO2rhTGbjAtgu/ e80C6DLiEOafCmUeWMc5DY5z/728FrxYCmhuq78Fo5STtk9tLWVwPzuJriESgQ+Cx+Wz CMzdND4khuRmg60T44YLVTdsq2sblIZwKwcW3JnBOcUzZwFLXWuXLxOPhDrIeHnFQE4U 8aK61F1BKjuTY1j8y65ecxZ865vZN/0ujq6aACH5YrJFN6t2oUVDGFDZE89RZb0pyhs4 CcDA== X-Gm-Message-State: AOAM530vZGMl94qj0ov9HVQZuag0VaGnqEabsZmfvSYGsbBq5+xFzBQF BvDBhtZyUgKqKjAMfA9bAsa/qOTFA0w8wBAlJDnPjOqw X-Received: by 2002:a05:6102:21d0:: with SMTP id r16mr1973687vsg.39.1632774216818; Mon, 27 Sep 2021 13:23:36 -0700 (PDT) MIME-Version: 1.0 References: <20210927201657.593569-1-mmandlik@google.com> <20210927131456.BlueZ.v1.1.I7f6bdb9282c1e12ffc6c662674678f2b1cb69182@changeid> In-Reply-To: <20210927131456.BlueZ.v1.1.I7f6bdb9282c1e12ffc6c662674678f2b1cb69182@changeid> From: Luiz Augusto von Dentz Date: Mon, 27 Sep 2021 13:23:26 -0700 Message-ID: Subject: Re: [BlueZ PATCH v1 1/3] doc: Add Advertisement Monitor Device Tracking event To: Manish Mandlik Cc: Marcel Holtmann , "linux-bluetooth@vger.kernel.org" , ChromeOS Bluetooth Upstreaming , Miao-chen Chou , Yun-Hao Chung Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-bluetooth@vger.kernel.org Hi Manish, On Mon, Sep 27, 2021 at 1:17 PM Manish Mandlik wrote: > > This patch adds the Advertisement Monitor Device Traching event. This > event indicates that the controller has stated/stopped tracking a > particular device matching one of the already added Advertisement > Monitor. > > Reviewed-by: Miao-chen Chou > Reviewed-by: Yun-Hao Chung > --- > > doc/mgmt-api.txt | 27 ++++++++++++++++++++++++++- > 1 file changed, 26 insertions(+), 1 deletion(-) > > diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt > index 5355fedb0..06df3e914 100644 > --- a/doc/mgmt-api.txt > +++ b/doc/mgmt-api.txt > @@ -107,7 +107,8 @@ Configuration command, Default Runtime Configuration Changed event, Get > Device Flags command, Set Device Flags command, Device Flags Changed event, > Read Advertisement Monitor Features command, Add Advertisement Patterns > Monitor command, Remove Advertisement Monitor command, Advertisement Monitor > -Added event and Advertisement Monitor Removed event. > +Added event, Advertisement Monitor Removed event and Advertisement Monitor > +Device Tracking event. > > > Example > @@ -4910,3 +4911,27 @@ Controller Resume Event > Address_Type. Otherwise, Address and Address_Type will both be zero. > > This event will be sent to all management sockets. > + > + > +Advertisement Monitor Device Tracking Event > +=========================================== > + > + Event code: 0x002f > + Controller Index: > + Event Parameters: Monitor_Handle (2 octets) > + Monitor_State (1 octet) > + Address (6 octets) > + Address_Type (1 octet) > + > + This event indicates that the controller has started/stopped tracking > + a particular device matching the Advertisement Monitor with handle > + Monitor_Handle. > + > + Possible values for the Monitor_State parameter: > + 0 The controller has stopped tracking a device > + 1 The controller has started tracking a device > + > + The address of the device being tracked will be shared in Address and > + Address_Type. > + > + This event will be sent to all management sockets. I wonder if wouldn't it be better to indicate this over Device Found? Or the controller will indicate the advertising report in addition to this event? Btw, I think it is about time we introduce these commands to the emulator in order to have proper CI tests, without it cannot become a stable API. > -- > 2.33.0.685.g46640cef36-goog > -- Luiz Augusto von Dentz