Merge "Update TWT related comments" into main

wifi/aidl/android/hardware/wifi/TwtCapabilities.aidl

@@ -18,6 +18,14 @@ package android.hardware.wifi;
 
 /**
  * Target Wake Time (TWT) Capabilities supported.
+ *
+ * TWT allows Wi-Fi stations to manage activity in a network by scheduling to operate at different
+ * times. This minimizes the contention and reduces the required amount of time that a station
+ * utilizing a power management mode needs to be awake.
+ *
+ * IEEE 802.11ax standard defines two modes of TWT operation:
+ *  - Individual TWT (default mode of operation if TWT requester is supported)
+ *  - Broadcast TWT
  */
 @VintfStability
 parcelable TwtCapabilities {

wifi/aidl/android/hardware/wifi/TwtRequest.aidl

@@ -31,6 +31,9 @@ parcelable TwtRequest {
     int minWakeDurationUs;
     /**
      * Maximum TWT wake duration in microseconds.
+     *
+     * As per IEEE 802.11ax spec, section 9.4.2.199 TWT element, the maximum wake duration is
+     * 65280 microseconds.
      */
     int maxWakeDurationUs;
     /**
@@ -39,6 +42,9 @@ parcelable TwtRequest {
     long minWakeIntervalUs;
     /**
      * Maximum TWT wake interval in microseconds.
+     *
+     * As per IEEE 802.11ax spec, section 9.4.2.199 TWT element, the maximum wake interval is
+     * 65535 * 2^31 microseconds.
      */
     long maxWakeIntervalUs;
 }