Received-SPF: pass (google.com: domain of linux-bluetooth-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
MIME-Version: 1.0
References: <20220831113647.85110-1-hadess@hadess.net> <20220831113647.85110-4-hadess@hadess.net>
In-Reply-To: <20220831113647.85110-4-hadess@hadess.net>
From:   Luiz Augusto von Dentz <luiz.dentz@gmail.com>
Date:   Wed, 31 Aug 2022 13:43:47 -0700
Message-ID: <CABBYNZL3iTX8sLnQy6Bo_kchqiHXr5VUTz0g29ay3xoXLs76Fw@mail.gmail.com>
Subject: Re: [PATCH BlueZ v5 4/6] adapter-api: Add PowerState property documentation
To:     Bastien Nocera <hadess@hadess.net>
Cc:     "linux-bluetooth@vger.kernel.org" <linux-bluetooth@vger.kernel.org>
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

Hi Bastien,

On Wed, Aug 31, 2022 at 4:40 AM Bastien Nocera <hadess@hadess.net> wrote:
>
> ---
>  doc/adapter-api.txt | 15 +++++++++++++++
>  1 file changed, 15 insertions(+)
>
> diff --git a/doc/adapter-api.txt b/doc/adapter-api.txt
> index 48466ab75..28e53a105 100644
> --- a/doc/adapter-api.txt
> +++ b/doc/adapter-api.txt
> @@ -269,6 +269,21 @@ Properties string Address [readonly]
>                         restart or unplugging of the adapter it will reset
>                         back to false.
>
> +               string PowerState [readonly]

We should have it documented as experimental as well.

> +
> +                       The power state of an adapter.
> +
> +                       The power state will show whether the adapter is
> +                       turning off, or turning on, as well as being on
> +                       or off.
> +
> +                       Possible values:
> +                               "on" - powered on
> +                               "off" - powered off
> +                               "off-enabling" - transitioning from "off" to "on"
> +                               "on-disabling" - transitioning from "on" to "off"
> +                               "off-blocked" - blocked by rfkill
> +
>                 boolean Discoverable [readwrite]
>
>                         Switch an adapter to discoverable or non-discoverable
> --
> 2.37.2
>


-- 
Luiz Augusto von Dentz