From 0ace7e5f914df0af92c885ade23a2708b80b085c Mon Sep 17 00:00:00 2001 From: maheshkkv Date: Wed, 10 May 2023 16:18:32 -0700 Subject: [PATCH] Add documentation for Aware suspend & resume Bug: 281882132 Test: build Change-Id: Ifea3dd9a0bd635c95e3b80f09427d380b75e0fa9 --- wifi/aidl/android/hardware/wifi/IWifiNanIface.aidl | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/wifi/aidl/android/hardware/wifi/IWifiNanIface.aidl b/wifi/aidl/android/hardware/wifi/IWifiNanIface.aidl index 3ce8d0214a..e5bb34ef5e 100644 --- a/wifi/aidl/android/hardware/wifi/IWifiNanIface.aidl +++ b/wifi/aidl/android/hardware/wifi/IWifiNanIface.aidl @@ -243,7 +243,10 @@ interface IWifiNanIface { void terminateDataPathRequest(in char cmdId, in int ndpInstanceId); /** - * Start the suspension of a discovery service. + * Start the suspension of a discovery service. During the suspend state, the Wi-Fi Aware + * device must not transmit or receive frames for this session including any active NDPs. If + * all discovery sessions are suspended then the Wi-Fi Aware device must not transmit or + * receive any Wi-Fi Aware frames. * Asynchronous response is with |IWifiNanIfaceEventCallback.notifySuspendResponse|. * * @param cmdId Command Id to use for this invocation. @@ -256,7 +259,10 @@ interface IWifiNanIface { void suspendRequest(in char cmdId, in byte sessionId); /** - * Stop the suspension of a discovery service. + * Stop the suspension of a discovery service. Resume cancels an ongoing suspend for this Wi-Fi + * Aware discovery session and automatically resumes the session and any associated NDPs to the + * state before they were suspended. The Wi-Fi Aware resume operation should be faster than + * recreating the corresponding discovery session and NDPs with the same benefit of power. * Asynchronous response is with |IWifiNanIfaceEventCallback.notifyResumeResponse|. * * @param cmdId Command Id to use for this invocation.