Received: from bali.collaboradmins.com (bali.collaboradmins.com [148.251.105.195]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 54F47220F46 for ; Fri, 23 May 2025 07:26:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.251.105.195 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747985220; cv=none; b=TlpLQYHmZwpFifMsVg7ZSJLBpSRPIfcVx0Q4PbPzVyA9pLaS2RSUgIlvXP3X1uveQYsDJJFO3VRok9HXvz7XGg7L0w8d4ieDeCuc3osM8MsMClw+SL3Qe64kSAO/jBrwwO5emOnH81zjiezphXEneXIGGYgfK1qq2hPf/djKbwo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747985220; c=relaxed/simple; bh=vVPxUDfLT+zq80E6y7maiE1cuSQVEa2zPhJsfchN3yo=; h=From:To:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=TUjhnYGjnKUFYRy1pTaT6DKuQi1FgD2a/YfFzDfGbKamby6/o9IhC/+U3Zb3o3FTCdCO+Ck5mFof1BWqxPex+//qVXjUDdFg86csKG+pkKu9UxXcb5urefj/PQkfk1xew79yYtntodD4dUBtoabwMX0H1dxIaoVoDeZIEoNvgZ8= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com; spf=pass smtp.mailfrom=collabora.com; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b=nxCJIKyk; arc=none smtp.client-ip=148.251.105.195 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=collabora.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=collabora.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b="nxCJIKyk" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1747985216; bh=vVPxUDfLT+zq80E6y7maiE1cuSQVEa2zPhJsfchN3yo=; h=From:To:Subject:Date:In-Reply-To:References:From; b=nxCJIKyku+6cjMzS80qOinQVcFqpZdsLxfK9OX8CvXIvOPQsWS6hGhOlowdNvQx91 l5w7azGMiRgj85FjJ5EHRByHq0px/D/exzLs1NMbbnYN/HvyABLj3p3CNlIlU/D1rY Y7PvueXhDM6ykErDAWzH2qggSUYX9QqT9TgBISv6ZnFyKG53QhDbjLOJBVyNyxCVT2 W3QV2thesIA9S7aZwI9fp6cTZ1GUIEvtOXQGmichBCHonCVqTIjQpMpPiSbvIkD09W KgCg1WH6RsmbHMG4xkoKPOFQI24cj6LeGNyV2uVL0a6M/ZBW9xYrTGenhzH8vNfSah esQ2CydlIuzJQ== Received: from fdanis-ThinkPad-X1.. (2A02-8428-aF44-1001-83a4-18CE-8675-8031.rev.sfr.net [IPv6:2a02:8428:af44:1001:83a4:18ce:8675:8031]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: fdanis) by bali.collaboradmins.com (Postfix) with ESMTPSA id 58A4D17E15A7 for ; Fri, 23 May 2025 09:26:56 +0200 (CEST) From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Danis?= To: linux-bluetooth@vger.kernel.org Subject: [PATCH BlueZ v4 3/4] doc/device: Add Disconnected signal Date: Fri, 23 May 2025 09:26:46 +0200 Message-ID: <20250523072647.689324-4-frederic.danis@collabora.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250523072647.689324-1-frederic.danis@collabora.com> References: <20250523072647.689324-1-frederic.danis@collabora.com> Precedence: bulk X-Mailing-List: linux-bluetooth@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit --- v1->v2: Replace text reason by numerical reason Improve documentation v2->v3: Replace numerical reason by name and message doc/org.bluez.Device.rst | 41 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/doc/org.bluez.Device.rst b/doc/org.bluez.Device.rst index 205f65761..39e51f79c 100644 --- a/doc/org.bluez.Device.rst +++ b/doc/org.bluez.Device.rst @@ -155,6 +155,47 @@ array{array{byte}} GetServiceRecords() [experimental] :org.bluez.Error.NotConnected: :org.bluez.Error.DoesNotExist: +Signals +------- + +void Disconnected(string name, string message) +`````````````````````````````````````````````` + + This signal is launched when a device is disconnected, with the reason of + the disconnection. + + This could be used by client application, depending on internal policy, to + try to reconnect to the device in case of timeout or unknown disconnection, + or to try to connect to another device. + + Possible reasons: + + :org.bluez.Reason.Unknown: + + :org.bluez.Reason.Timeout: + + The link supervision timeout has expired for a connection or the + synchronization timeout has expired for a broadcast. + + :org.bluez.Reason.Local: + + The local device terminated the connection, terminated synchronization + with a broadcaster, or terminated broadcasting packets. + + :org.bluez.Reason.Remote: + + This disconnection can be due to: + - the user on the remote device either terminated the connection + or stopped broadcasting packets, + - the remote device terminated the connection because of low + resources, + - the remote device terminated the connection because the device + is about to power off. + + :org.bluez.Reason.Authentication: + + :org.bluez.Reason.LocalSuspend: + Properties ---------- -- 2.43.0