diff options
| -rw-r--r-- | proto/src/wifi.proto | 2707 |
1 files changed, 0 insertions, 2707 deletions
diff --git a/proto/src/wifi.proto b/proto/src/wifi.proto deleted file mode 100644 index bd682de52471..000000000000 --- a/proto/src/wifi.proto +++ /dev/null @@ -1,2707 +0,0 @@ -/* - * Copyright (C) 2016 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -syntax = "proto2"; - -package clearcut.connectivity; - -option java_package = "com.android.server.wifi"; -option java_outer_classname = "WifiMetricsProto"; - -// The information about the Wifi events. -message WifiLog { - - // Session information that gets logged for every Wifi connection. - repeated ConnectionEvent connection_event = 1; - - // Number of saved networks in the user profile. - optional int32 num_saved_networks = 2; - - // Number of open networks in the saved networks. - optional int32 num_open_networks = 3; - - // Number of legacy personal networks. - optional int32 num_legacy_personal_networks = 4; - - // Number of legacy enterprise networks. - optional int32 num_legacy_enterprise_networks = 5; - - // Does the user have location setting enabled. - optional bool is_location_enabled = 6; - - // Does the user have scanning enabled. - optional bool is_scanning_always_enabled = 7; - - // Number of times user toggled wifi using the settings menu. - optional int32 num_wifi_toggled_via_settings = 8; - - // Number of times user toggled wifi using the airplane menu. - optional int32 num_wifi_toggled_via_airplane = 9; - - // Number of networks added by the user. - optional int32 num_networks_added_by_user = 10; - - // Number of networks added by applications. - optional int32 num_networks_added_by_apps = 11; - - // Number scans that returned empty results. - optional int32 num_empty_scan_results = 12; - - // Number scans that returned at least one result. - optional int32 num_non_empty_scan_results = 13; - - // Number of single scans requests. - optional int32 num_oneshot_scans = 14; - - // Number of repeated background scans that were scheduled to the chip. - optional int32 num_background_scans = 15; - - // Error codes that a scan can result in. - enum ScanReturnCode { - - // Return Code is unknown. - SCAN_UNKNOWN = 0; - - // Scan was successful. - SCAN_SUCCESS = 1; - - // Scan was successfully started, but was interrupted. - SCAN_FAILURE_INTERRUPTED = 2; - - // Scan failed to start because of invalid configuration - // (bad channel, etc). - SCAN_FAILURE_INVALID_CONFIGURATION = 3; - - // Could not start a scan because wifi is disabled. - FAILURE_WIFI_DISABLED = 4; - - } - - // Mapping of error codes to the number of times that scans resulted - // in that error. - repeated ScanReturnEntry scan_return_entries = 16; - - message ScanReturnEntry { - - // Return code of the scan. - optional ScanReturnCode scan_return_code = 1; - - // Number of entries that were found in the scan. - optional int32 scan_results_count = 2; - } - - // State of the Wifi. - enum WifiState { - - // State is unknown. - WIFI_UNKNOWN = 0; - - // Wifi is disabled. - WIFI_DISABLED = 1; - - // Wifi is enabled. - WIFI_DISCONNECTED = 2; - - // Wifi is enabled and associated with an AP. - WIFI_ASSOCIATED = 3; - } - - // Mapping of system state to the number of times that scans were requested in - // that state - repeated WifiSystemStateEntry wifi_system_state_entries = 17; - - message WifiSystemStateEntry { - - // Current WiFi state. - optional WifiState wifi_state = 1; - - // Count of scans in state. - optional int32 wifi_state_count = 2; - - // Is screen on. - optional bool is_screen_on = 3; - } - - // Mapping of Error/Success codes to the number of background scans that resulted in it - repeated ScanReturnEntry background_scan_return_entries = 18; - - // Mapping of system state to the number of times that Background scans were requested in that - // state - repeated WifiSystemStateEntry background_scan_request_state = 19; - - // Total number of times the Watchdog of Last Resort triggered, resetting the wifi stack - optional int32 num_last_resort_watchdog_triggers = 20; - - // Total number of networks over bad association threshold when watchdog triggered - optional int32 num_last_resort_watchdog_bad_association_networks_total = 21; - - // Total number of networks over bad authentication threshold when watchdog triggered - optional int32 num_last_resort_watchdog_bad_authentication_networks_total = 22; - - // Total number of networks over bad dhcp threshold when watchdog triggered - optional int32 num_last_resort_watchdog_bad_dhcp_networks_total = 23; - - // Total number of networks over bad other threshold when watchdog triggered - optional int32 num_last_resort_watchdog_bad_other_networks_total = 24; - - // Total count of networks seen when watchdog triggered - optional int32 num_last_resort_watchdog_available_networks_total = 25; - - // Total count of triggers with atleast one bad association network - optional int32 num_last_resort_watchdog_triggers_with_bad_association = 26; - - // Total count of triggers with atleast one bad authentication network - optional int32 num_last_resort_watchdog_triggers_with_bad_authentication = 27; - - // Total count of triggers with atleast one bad dhcp network - optional int32 num_last_resort_watchdog_triggers_with_bad_dhcp = 28; - - // Total count of triggers with atleast one bad other network - optional int32 num_last_resort_watchdog_triggers_with_bad_other = 29; - - // Count of times connectivity watchdog confirmed pno is working - optional int32 num_connectivity_watchdog_pno_good = 30; - - // Count of times connectivity watchdog found pno not working - optional int32 num_connectivity_watchdog_pno_bad = 31; - - // Count of times connectivity watchdog confirmed background scan is working - optional int32 num_connectivity_watchdog_background_good = 32; - - // Count of times connectivity watchdog found background scan not working - optional int32 num_connectivity_watchdog_background_bad = 33; - - // The time duration represented by this wifi log, from start to end of capture - optional int32 record_duration_sec = 34; - - // Counts the occurrences of each individual RSSI poll level - repeated RssiPollCount rssi_poll_rssi_count = 35; - - // Total number of times WiFi connected immediately after a Last Resort Watchdog trigger, - // without new networks becoming available. - optional int32 num_last_resort_watchdog_successes = 36; - - // Total number of saved hidden networks - optional int32 num_hidden_networks = 37; - - // Total number of saved passpoint / hotspot 2.0 networks - optional int32 num_passpoint_networks = 38; - - // Total number of scan results - optional int32 num_total_scan_results = 39; - - // Total number of scan results for open networks - optional int32 num_open_network_scan_results = 40; - - // Total number of scan results for legacy personal networks - optional int32 num_legacy_personal_network_scan_results = 41; - - // Total number of scan results for legacy enterprise networks - optional int32 num_legacy_enterprise_network_scan_results = 42; - - // Total number of scan results for hidden networks - optional int32 num_hidden_network_scan_results = 43; - - // Total number of scan results for hotspot 2.0 r1 networks - optional int32 num_hotspot2_r1_network_scan_results = 44; - - // Total number of scan results for hotspot 2.0 r2 networks - optional int32 num_hotspot2_r2_network_scan_results = 45; - - // Total number of scans handled by framework (oneshot or otherwise) - optional int32 num_scans = 46; - - // Counts the occurrences of each alert reason. - repeated AlertReasonCount alert_reason_count = 47; - - // Counts the occurrences of each Wifi score - repeated WifiScoreCount wifi_score_count = 48; - - // Histogram of Soft AP Durations - repeated SoftApDurationBucket soft_ap_duration = 49; - - // Histogram of Soft AP ReturnCode - repeated SoftApReturnCodeCount soft_ap_return_code = 50; - - // Histogram of the delta between scan result RSSI and RSSI polls - repeated RssiPollCount rssi_poll_delta_count = 51; - - // List of events - repeated StaEvent sta_event_list = 52; - - // Total number of times WiFi HAL crashed. - optional int32 num_hal_crashes = 53; - - // Total number of times WiFicond crashed. - optional int32 num_wificond_crashes = 54; - - // Indicates the number of times an error was encountered in - // Wifi HAL on |WifiNative.setupInterfaceForClientMode|. - optional int32 num_setup_client_interface_failure_due_to_hal = 55; - - // Indicates the number of times an error was encountered in - // Wificond on |WifiNative.setupInterfaceForClientMode|. - optional int32 num_setup_client_interface_failure_due_to_wificond = 56; - - // Wi-Fi Aware metrics - optional WifiAwareLog wifi_aware_log = 57; - - // Number of saved Passpoint providers in user profile. - optional int32 num_passpoint_providers = 58; - - // Count of times Passpoint provider being installed. - optional int32 num_passpoint_provider_installation = 59; - - // Count of times Passpoint provivider is installed successfully. - optional int32 num_passpoint_provider_install_success = 60; - - // Count of times Passpoint provider is being uninstalled. - optional int32 num_passpoint_provider_uninstallation = 61; - - // Count of times Passpoint provider is uninstalled successfully. - optional int32 num_passpoint_provider_uninstall_success = 62; - - // Count of saved Passpoint providers device has ever connected to. - optional int32 num_passpoint_providers_successfully_connected = 63; - - // Histogram counting instances of scans with N many ScanResults with unique ssids - repeated NumConnectableNetworksBucket total_ssids_in_scan_histogram = 64; - - // Histogram counting instances of scans with N many ScanResults/bssids - repeated NumConnectableNetworksBucket total_bssids_in_scan_histogram = 65; - - // Histogram counting instances of scans with N many unique open ssids - repeated NumConnectableNetworksBucket available_open_ssids_in_scan_histogram = 66; - - // Histogram counting instances of scans with N many bssids for open networks - repeated NumConnectableNetworksBucket available_open_bssids_in_scan_histogram = 67; - - // Histogram counting instances of scans with N many unique ssids for saved networks - repeated NumConnectableNetworksBucket available_saved_ssids_in_scan_histogram = 68; - - // Histogram counting instances of scans with N many bssids for saved networks - repeated NumConnectableNetworksBucket available_saved_bssids_in_scan_histogram = 69; - - // Histogram counting instances of scans with N many unique SSIDs for open or saved networks - repeated NumConnectableNetworksBucket available_open_or_saved_ssids_in_scan_histogram = 70; - - // Histogram counting instances of scans with N many BSSIDs for open or saved networks - repeated NumConnectableNetworksBucket available_open_or_saved_bssids_in_scan_histogram = 71; - - // Histogram counting instances of scans with N many ScanResults matching unique saved passpoint providers - repeated NumConnectableNetworksBucket available_saved_passpoint_provider_profiles_in_scan_histogram = 72; - - // Histogram counting instances of scans with N many ScanResults BSSIDs matching a saved passpoint provider - repeated NumConnectableNetworksBucket available_saved_passpoint_provider_bssids_in_scan_histogram = 73; - - // Counts the number of AllSingleScanLister.onResult calls with a full band scan result - optional int32 full_band_all_single_scan_listener_results = 74; - - // Counts the number of AllSingleScanLister.onResult calls with a partial (channels) scan result - optional int32 partial_all_single_scan_listener_results = 75; - - // Pno scan metrics - optional PnoScanMetrics pno_scan_metrics = 76; - - // Histogram of "Connect to Network" notifications. - // The notification Action should be unset. - repeated ConnectToNetworkNotificationAndActionCount connect_to_network_notification_count = 77; - - // Histogram of "Connect to Network" notification user actions. - repeated ConnectToNetworkNotificationAndActionCount connect_to_network_notification_action_count = 78; - - // The number of SSIDs blacklisted from recommendation by the open network - // notification recommender - optional int32 open_network_recommender_blacklist_size = 79; - - // Is the available network notification feature turned on - optional bool is_wifi_networks_available_notification_on = 80; - - // Count of recommendation updates made by the open network notification - // recommender - optional int32 num_open_network_recommendation_updates = 81; - - // Count of connection attempts that were initiated unsuccessfully - optional int32 num_open_network_connect_message_failed_to_send = 82; - - // Histogram counting instances of scans with N many HotSpot 2.0 R1 APs - repeated NumConnectableNetworksBucket observed_hotspot_r1_aps_in_scan_histogram = 83; - - // Histogram counting instances of scans with N many HotSpot 2.0 R2 APs - repeated NumConnectableNetworksBucket observed_hotspot_r2_aps_in_scan_histogram = 84; - - // Histogram counting instances of scans with N many unique HotSpot 2.0 R1 ESS. - // Where ESS is defined as the (HESSID, ANQP Domain ID), (SSID, ANQP Domain ID) or - // (SSID, BSSID) tuple depending on AP configuration (in the above priority - // order). - repeated NumConnectableNetworksBucket observed_hotspot_r1_ess_in_scan_histogram = 85; - - // Histogram counting instances of scans with N many unique HotSpot 2.0 R2 ESS. - // Where ESS is defined as the (HESSID, ANQP Domain ID), (SSID, ANQP Domain ID) or - // (SSID, BSSID) tuple depending on AP configuration (in the above priority - // order). - repeated NumConnectableNetworksBucket observed_hotspot_r2_ess_in_scan_histogram = 86; - - // Histogram counting number of HotSpot 2.0 R1 APs per observed ESS in a scan - // (one value added per unique ESS - potentially multiple counts per single - // scan!) - repeated NumConnectableNetworksBucket observed_hotspot_r1_aps_per_ess_in_scan_histogram = 87; - - // Histogram counting number of HotSpot 2.0 R2 APs per observed ESS in a scan - // (one value added per unique ESS - potentially multiple counts per single - // scan!) - repeated NumConnectableNetworksBucket observed_hotspot_r2_aps_per_ess_in_scan_histogram = 88; - - // SoftAP event list tracking sessions and client counts in tethered mode - repeated SoftApConnectedClientsEvent soft_ap_connected_clients_events_tethered = 89; - - // SoftAP event list tracking sessions and client counts in local only mode - repeated SoftApConnectedClientsEvent soft_ap_connected_clients_events_local_only = 90; - - // Wps connection metrics - optional WpsMetrics wps_metrics = 91; - - // Wifi power statistics - optional WifiPowerStats wifi_power_stats = 92; - - // Number of connectivity single scan requests. - optional int32 num_connectivity_oneshot_scans = 93; - - // WifiWake statistics - optional WifiWakeStats wifi_wake_stats = 94; - - // Histogram counting instances of scans with N many 802.11mc (RTT) supporting APs - repeated NumConnectableNetworksBucket observed_80211mc_supporting_aps_in_scan_histogram = 95; - - // Total number of times supplicant crashed. - optional int32 num_supplicant_crashes = 96; - - // Total number of times hostapd crashed. - optional int32 num_hostapd_crashes = 97; - - // Indicates the number of times an error was encountered in - // supplicant on |WifiNative.setupInterfaceForClientMode|. - optional int32 num_setup_client_interface_failure_due_to_supplicant = 98; - - // Indicates the number of times an error was encountered in - // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|. - optional int32 num_setup_soft_ap_interface_failure_due_to_hal = 99; - - // Indicates the number of times an error was encountered in - // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|. - optional int32 num_setup_soft_ap_interface_failure_due_to_wificond = 100; - - // Indicates the number of times an error was encountered in - // Wifi HAL on |WifiNative.setupInterfaceForSoftApMode|. - optional int32 num_setup_soft_ap_interface_failure_due_to_hostapd = 101; - - // Indicates the number of times we got an interface down in client mode. - optional int32 num_client_interface_down = 102; - - // Indicates the number of times we got an interface down in softap mode. - optional int32 num_soft_ap_interface_down = 103; - - // Indicates the number of scan requests from external apps. - optional int32 num_external_app_oneshot_scan_requests = 104; - - // Indicates the number of times a scan request from an external foreground app was throttled. - optional int32 num_external_foreground_app_oneshot_scan_requests_throttled = 105; - - // Indicates the number of times a scan request from an external background app was throttled. - optional int32 num_external_background_app_oneshot_scan_requests_throttled = 106; - - // WifiLastResortWatchdog time milliseconds delta between trigger and first connection success - optional int64 watchdog_trigger_to_connection_success_duration_ms = 107 [default = -1]; - - // The number of times wifi experienced failures after watchdog has already been triggered and is - // waiting for a connection success - optional int64 watchdog_total_connection_failure_count_after_trigger = 108; - - // Number of times DFS channel scans are requested in single scan requests. - optional int32 num_oneshot_has_dfs_channel_scans = 109; - - // Wi-Fi RTT metrics - optional WifiRttLog wifi_rtt_log = 110; - - // Flag which indicates if Connected MAC Randomization is enabled - optional bool is_mac_randomization_on = 111 [default = false]; - - // Number of radio mode changes to MCC (Multi channel concurrency). - optional int32 num_radio_mode_change_to_mcc = 112; - - // Number of radio mode changes to SCC (Single channel concurrency). - optional int32 num_radio_mode_change_to_scc = 113; - - // Number of radio mode changes to SBS (Single band simultaneous). - optional int32 num_radio_mode_change_to_sbs = 114; - - // Number of radio mode changes to DBS (Dual band simultaneous). - optional int32 num_radio_mode_change_to_dbs = 115; - - // Number of times the firmware picked a SoftAp channel not satisfying user band preference. - optional int32 num_soft_ap_user_band_preference_unsatisfied = 116; - - // Identifier for experimental scoring parameter settings. - optional string score_experiment_id = 117; - - // Data on wifi radio usage - optional WifiRadioUsage wifi_radio_usage = 118; - - // Stores settings values used for metrics testing. - optional ExperimentValues experiment_values = 119; - - // List of WifiIsUnusableEvents which get logged when we notice that WiFi is unusable. - // Collected only when WIFI_IS_UNUSABLE_EVENT_METRICS_ENABLED Settings is enabled. - repeated WifiIsUnusableEvent wifi_is_unusable_event_list = 120; - - // Counts the occurrences of each link speed (Mbps) level - // with rssi (dBm) and rssi^2 sums (dBm^2) - repeated LinkSpeedCount link_speed_counts = 121; - - // Number of times the SarManager failed to register SAR sensor listener - optional int32 num_sar_sensor_registration_failures = 122; - - // Hardware revision (EVT, DVT, PVT etc.) - optional string hardware_revision = 124; - - // Total wifi link layer usage data over the logging duration in ms. - optional WifiLinkLayerUsageStats wifi_link_layer_usage_stats = 125; - - // Multiple lists of timestamped link layer stats with labels to represent whether wifi is usable - repeated WifiUsabilityStats wifi_usability_stats_list = 126; - - // Counts the occurrences of each Wifi usability score provided by external app - repeated WifiUsabilityScoreCount wifi_usability_score_count = 127; - - // List of PNO scan stats, one element for each mobility state - repeated DeviceMobilityStatePnoScanStats mobility_state_pno_stats_list = 128; - - // Wifi p2p statistics - optional WifiP2pStats wifi_p2p_stats = 129; - - // Easy Connect (DPP) metrics - optional WifiDppLog wifi_dpp_log = 130; - - // Number of Enhanced Open (OWE) networks in the saved networks. - optional int32 num_enhanced_open_networks = 131; - - // Number of WPA3-Personal networks. - optional int32 num_wpa3_personal_networks = 132; - - // Number of WPA3-Enterprise networks. - optional int32 num_wpa3_enterprise_networks = 133; - - // Total number of scan results for Enhanced open networks - optional int32 num_enhanced_open_network_scan_results = 134; - - // Total number of scan results for WPA3-Personal networks - optional int32 num_wpa3_personal_network_scan_results = 135; - - // Total number of scan results for WPA3-Enterprise networks - optional int32 num_wpa3_enterprise_network_scan_results = 136; - - // WifiConfigStore read/write metrics. - optional WifiConfigStoreIO wifi_config_store_io = 137; - - // Total number of saved networks with mac randomization enabled. - optional int32 num_saved_networks_with_mac_randomization = 138; - - // Link Probe metrics - optional LinkProbeStats link_probe_stats = 139; - - // List of NetworkSelectionExperimentDecisions stats for each experiment - repeated NetworkSelectionExperimentDecisions network_selection_experiment_decisions_list = 140; - - // Network Request API surface metrics. - optional WifiNetworkRequestApiLog wifi_network_request_api_log = 141; - - // Network Suggestion API surface metrics. - optional WifiNetworkSuggestionApiLog wifi_network_suggestion_api_log = 142; - - // WifiLock statistics - optional WifiLockStats wifi_lock_stats = 143; - - // Stats on number of times Wi-Fi is turned on/off though the WifiManager#setWifiEnabled API - optional WifiToggleStats wifi_toggle_stats = 144; - - // Number of times WifiManager#addOrUpdateNetwork is called. - optional int32 num_add_or_update_network_calls = 145; - - // Number of times WifiManager#enableNetwork is called. - optional int32 num_enable_network_calls = 146; - - // Passpoint provison metrics - optional PasspointProvisionStats passpoint_provision_stats = 147; - - // Histogram of the EAP method type of all installed Passpoint profiles for R1 - repeated PasspointProfileTypeCount installed_passpoint_profile_type_for_r1 = 123; - - // Histogram of the EAP method type of all installed Passpoint profiles for R2 - repeated PasspointProfileTypeCount installed_passpoint_profile_type_for_r2 = 148; - - // Histogram of Tx link speed at 2G - repeated Int32Count tx_link_speed_count_2g = 149; - - // Histogram of Tx link speed at 5G low band - repeated Int32Count tx_link_speed_count_5g_low = 150; - - // Histogram of Tx link speed at 5G middle band - repeated Int32Count tx_link_speed_count_5g_mid = 151; - - // Histogram of Tx link speed at 5G high band - repeated Int32Count tx_link_speed_count_5g_high = 152; - - // Histogram of Rx link speed at 2G - repeated Int32Count rx_link_speed_count_2g = 153; - - // Histogram of Rx link speed at 5G low band - repeated Int32Count rx_link_speed_count_5g_low = 154; - - // Histogram of Rx link speed at 5G middle band - repeated Int32Count rx_link_speed_count_5g_mid = 155; - - // Histogram of Rx link speed at 5G high band - repeated Int32Count rx_link_speed_count_5g_high = 156; -} - -// Information that gets logged for every WiFi connection. -message RouterFingerPrint { - - enum RoamType { - - // Type is unknown. - ROAM_TYPE_UNKNOWN = 0; - - // No roaming - usually happens on a single band (2.4 GHz) router. - ROAM_TYPE_NONE = 1; - - // Enterprise router. - ROAM_TYPE_ENTERPRISE = 2; - - // DBDC => Dual Band Dual Concurrent essentially a router that - // supports both 2.4 GHz and 5 GHz bands. - ROAM_TYPE_DBDC = 3; - } - - enum Auth { - - // Auth is unknown. - AUTH_UNKNOWN = 0; - - // No authentication. - AUTH_OPEN = 1; - - // If the router uses a personal authentication. - AUTH_PERSONAL = 2; - - // If the router is setup for enterprise authentication. - AUTH_ENTERPRISE = 3; - } - - enum RouterTechnology { - - // Router is unknown. - ROUTER_TECH_UNKNOWN = 0; - - // Router Channel A. - ROUTER_TECH_A = 1; - - // Router Channel B. - ROUTER_TECH_B = 2; - - // Router Channel G. - ROUTER_TECH_G = 3; - - // Router Channel N. - ROUTER_TECH_N = 4; - - // Router Channel AC. - ROUTER_TECH_AC = 5; - - // When the channel is not one of the above. - ROUTER_TECH_OTHER = 6; - } - - optional RoamType roam_type = 1; - - // Channel on which the connection takes place. - optional int32 channel_info = 2; - - // DTIM setting of the router. - optional int32 dtim = 3; - - // Authentication scheme of the router. - optional Auth authentication = 4; - - // If the router is hidden. - optional bool hidden = 5; - - // Channel information. - optional RouterTechnology router_technology = 6; - - // whether ipv6 is supported. - optional bool supports_ipv6 = 7; - - // If the router is a passpoint / hotspot 2.0 network - optional bool passpoint = 8; -} - -message ConnectionEvent { - - // Roam Type. - enum RoamType { - - // Type is unknown. - ROAM_UNKNOWN = 0; - - // No roaming. - ROAM_NONE = 1; - - // DBDC roaming. - ROAM_DBDC = 2; - - // Enterprise roaming. - ROAM_ENTERPRISE = 3; - - // User selected roaming. - ROAM_USER_SELECTED = 4; - - // Unrelated. - ROAM_UNRELATED = 5; - } - - // Connectivity Level Failure. - enum ConnectivityLevelFailure { - - // Failure is unknown. - HLF_UNKNOWN = 0; - - // No failure. - HLF_NONE = 1; - - // DHCP failure. - HLF_DHCP = 2; - - // No internet connection. - HLF_NO_INTERNET = 3; - - // No internet connection. - HLF_UNWANTED = 4; - } - - // Level 2 failure reason. - enum Level2FailureReason { - - // Unknown default - FAILURE_REASON_UNKNOWN = 0; - - // The reason code if there is no error during authentication. It could - // also imply that there no authentication in progress. - AUTH_FAILURE_NONE = 1; - - // The reason code if there was a timeout authenticating. - AUTH_FAILURE_TIMEOUT = 2; - - // The reason code if there was a wrong password while authenticating. - AUTH_FAILURE_WRONG_PSWD = 3; - - // The reason code if there was EAP failure while authenticating. - AUTH_FAILURE_EAP_FAILURE = 4; - - // The reason code if the AP can no longer accept new clients. - ASSOCIATION_REJECTION_AP_UNABLE_TO_HANDLE_NEW_STA = 5; - } - - // Entity that recommended connecting to this network. - enum ConnectionNominator { - // Unknown nominator - NOMINATOR_UNKNOWN = 0; - - // User selected network manually - NOMINATOR_MANUAL = 1; - - // Saved network - NOMINATOR_SAVED = 2; - - // Suggestion API - NOMINATOR_SUGGESTION = 3; - - // Passpoint - NOMINATOR_PASSPOINT = 4; - - // Carrier suggestion - NOMINATOR_CARRIER = 5; - - // External scorer - NOMINATOR_EXTERNAL_SCORED = 6; - - // Network Specifier - NOMINATOR_SPECIFIER = 7; - - // User connected choice override - NOMINATOR_SAVED_USER_CONNECT_CHOICE = 8; - - // Open Network Available Pop-up - NOMINATOR_OPEN_NETWORK_AVAILABLE = 9; - } - - // Start time of the connection. - optional int64 start_time_millis = 1;// [(datapol.semantic_type) = ST_TIMESTAMP]; - - // Duration to connect. - optional int32 duration_taken_to_connect_millis = 2; - - // Router information. - optional RouterFingerPrint router_fingerprint = 3; - - // RSSI at the start of the connection. - optional int32 signal_strength = 4; - - // Roam Type. - optional RoamType roam_type = 5; - - // Result of the connection. - optional int32 connection_result = 6; - - // Reasons for level 2 failure (needs to be coordinated with wpa-supplicant). - optional int32 level_2_failure_code = 7; - - // Failures that happen at the connectivity layer. - optional ConnectivityLevelFailure connectivity_level_failure_code = 8; - - // Has bug report been taken. - optional bool automatic_bug_report_taken = 9; - - // Connection is using locally generated random MAC address. - optional bool use_randomized_mac = 10 [default = false]; - - // Who chose to connect. - optional ConnectionNominator connection_nominator = 11; - - // The currently running network selector when this connection event occurred. - optional int32 network_selector_experiment_id = 12; - - // Breakdown of level_2_failure_code with more detailed reason. - optional Level2FailureReason level_2_failure_reason = 13 - [default = FAILURE_REASON_UNKNOWN]; -} - -// Number of occurrences of a specific RSSI poll rssi value -message RssiPollCount { - // RSSI - optional int32 rssi = 1; - - // Number of RSSI polls with 'rssi' - optional int32 count = 2; - - // Beacon frequency of the channel in MHz - optional int32 frequency = 3; -} - -// Number of occurrences of a specific alert reason value -message AlertReasonCount { - // Alert reason - optional int32 reason = 1; - - // Number of alerts with |reason|. - optional int32 count = 2; -} - -// Counts the number of instances of a specific Wifi Score calculated by WifiScoreReport -message WifiScoreCount { - // Wifi Score - optional int32 score = 1; - - // Number of Wifi score reports with this score - optional int32 count = 2; -} - -// Counts the number of instances of a specific Wifi Usability Score -message WifiUsabilityScoreCount { - // Wifi Usability Score - optional int32 score = 1; - - // Number of Wifi score reports with this score - optional int32 count = 2; -} - -// Number of occurrences of a specific link speed (Mbps) -// and sum of rssi (dBm) and rssi^2 (dBm^2) -message LinkSpeedCount { - // Link speed (Mbps) - optional int32 link_speed_mbps = 1; - - // Number of RSSI polls with link_speed - optional int32 count = 2; - - // Sum of absolute values of rssi values (dBm) - optional int32 rssi_sum_dbm = 3; - - // Sum of squares of rssi values (dBm^2) - optional int64 rssi_sum_of_squares_dbm_sq = 4; -} - - -// Number of occurrences of Soft AP session durations -message SoftApDurationBucket { - // Bucket covers duration : [duration_sec, duration_sec + bucket_size_sec) - // The (inclusive) lower bound of Soft AP session duration represented by this bucket - optional int32 duration_sec = 1; - - // The size of this bucket - optional int32 bucket_size_sec = 2; - - // Number of soft AP session durations that fit into this bucket - optional int32 count = 3; -} - -// Number of occurrences of a soft AP session return code -message SoftApReturnCodeCount { - - enum SoftApStartResult { - - // SoftApManager return code unknown - SOFT_AP_RETURN_CODE_UNKNOWN = 0; - - // SoftAp started successfully - SOFT_AP_STARTED_SUCCESSFULLY = 1; - - // Catch all for failures with no specific failure reason - SOFT_AP_FAILED_GENERAL_ERROR = 2; - - // SoftAp failed to start due to NO_CHANNEL error - SOFT_AP_FAILED_NO_CHANNEL = 3; - } - - // Historical, no longer used for writing as of 01/2017. - optional int32 return_code = 1 [deprecated = true]; - - // Occurrences of this soft AP return code - optional int32 count = 2; - - // Result of attempt to start SoftAp - optional SoftApStartResult start_result = 3; -} - -message StaEvent { - message ConfigInfo { - // The set of key management protocols supported by this configuration. - optional uint32 allowed_key_management = 1 [default = 0]; - - // The set of security protocols supported by this configuration. - optional uint32 allowed_protocols = 2 [default = 0]; - - // The set of authentication protocols supported by this configuration. - optional uint32 allowed_auth_algorithms = 3 [default = 0]; - - // The set of pairwise ciphers for WPA supported by this configuration. - optional uint32 allowed_pairwise_ciphers = 4 [default = 0]; - - // The set of group ciphers supported by this configuration. - optional uint32 allowed_group_ciphers = 5; - - // Is this a 'hidden network' - optional bool hidden_ssid = 6; - - // Is this a Hotspot 2.0 / passpoint network - optional bool is_passpoint = 7; - - // Is this an 'ephemeral' network (Not in saved network list, recommended externally) - optional bool is_ephemeral = 8; - - // Has a successful connection ever been established using this WifiConfiguration - optional bool has_ever_connected = 9; - - // RSSI of the scan result candidate associated with this WifiConfiguration - optional int32 scan_rssi = 10 [default = -127]; - - // Frequency of the scan result candidate associated with this WifiConfiguration - optional int32 scan_freq = 11 [default = -1]; - } - - enum EventType { - // Default/Invalid event - TYPE_UNKNOWN = 0; - - // Supplicant Association Rejection event. Code contains the 802.11 - TYPE_ASSOCIATION_REJECTION_EVENT = 1; - - // Supplicant L2 event, - TYPE_AUTHENTICATION_FAILURE_EVENT = 2; - - // Supplicant L2 event - TYPE_NETWORK_CONNECTION_EVENT = 3; - - // Supplicant L2 event - TYPE_NETWORK_DISCONNECTION_EVENT = 4; - - // Supplicant L2 event - TYPE_SUPPLICANT_STATE_CHANGE_EVENT = 5; - - // Supplicant L2 event - TYPE_CMD_ASSOCIATED_BSSID = 6; - - // IP Manager successfully completed IP Provisioning - TYPE_CMD_IP_CONFIGURATION_SUCCESSFUL = 7; - - // IP Manager failed to complete IP Provisioning - TYPE_CMD_IP_CONFIGURATION_LOST = 8; - - // IP Manager lost reachability to network neighbors - TYPE_CMD_IP_REACHABILITY_LOST = 9; - - // Indicator that Supplicant is targeting a BSSID for roam/connection - TYPE_CMD_TARGET_BSSID = 10; - - // Wifi framework is initiating a connection attempt - TYPE_CMD_START_CONNECT = 11; - - // Wifi framework is initiating a roaming connection attempt - TYPE_CMD_START_ROAM = 12; - - // SystemAPI connect() command, Settings App - TYPE_CONNECT_NETWORK = 13; - - // Network Agent has validated the internet connection (Captive Portal Check success, or user - // validation) - TYPE_NETWORK_AGENT_VALID_NETWORK = 14; - - // Framework initiated disconnect. Sometimes generated to give an extra reason for a disconnect - // Should typically be followed by a NETWORK_DISCONNECTION_EVENT with a local_gen = true - TYPE_FRAMEWORK_DISCONNECT = 15; - - // The NetworkAgent score for wifi has changed in a way that may impact - // connectivity - TYPE_SCORE_BREACH = 16; - - // Framework changed Sta interface MAC address - TYPE_MAC_CHANGE = 17; - - // Wifi is turned on - TYPE_WIFI_ENABLED = 18; - - // Wifi is turned off - TYPE_WIFI_DISABLED = 19; - - // The NetworkAgent Wifi usability score has changed in a way that may - // impact connectivity - TYPE_WIFI_USABILITY_SCORE_BREACH = 20; - - // Link probe was performed - TYPE_LINK_PROBE = 21; - } - - enum FrameworkDisconnectReason { - // default/none/unknown value - DISCONNECT_UNKNOWN = 0; - - // API DISCONNECT - DISCONNECT_API = 1; - - // Some framework internal reason (generic) - DISCONNECT_GENERIC = 2; - - // Network Agent network validation failed, user signaled network unwanted - DISCONNECT_UNWANTED = 3; - - // Roaming timed out - DISCONNECT_ROAM_WATCHDOG_TIMER = 4; - - // P2P service requested wifi disconnect - DISCONNECT_P2P_DISCONNECT_WIFI_REQUEST = 5; - - // SIM was removed while using a SIM config - DISCONNECT_RESET_SIM_NETWORKS = 6; - } - - // Authentication Failure reasons as reported through the API. - enum AuthFailureReason { - // Unknown default - AUTH_FAILURE_UNKNOWN = 0; - - // The reason code if there is no error during authentication. It could also imply that there no - // authentication in progress, - AUTH_FAILURE_NONE = 1; - - // The reason code if there was a timeout authenticating. - AUTH_FAILURE_TIMEOUT = 2; - - // The reason code if there was a wrong password while authenticating. - AUTH_FAILURE_WRONG_PSWD = 3; - - // The reason code if there was EAP failure while authenticating. - AUTH_FAILURE_EAP_FAILURE = 4; - } - - // What event was this - optional EventType type = 1; - - // 80211 death reason code, relevant to NETWORK_DISCONNECTION_EVENTs - optional int32 reason = 2 [default = -1]; - - // 80211 Association Status code, relevant to ASSOCIATION_REJECTION_EVENTs - optional int32 status = 3 [default = -1]; - - // Designates whether a NETWORK_DISCONNECT_EVENT was by the STA or AP - optional bool local_gen = 4 [default = false]; - - // Network information from the WifiConfiguration of a framework initiated connection attempt - optional ConfigInfo config_info = 5; - - // RSSI from the last rssi poll (Only valid for active connections) - optional int32 last_rssi = 6 [default = -127]; - - // Link speed from the last rssi poll (Only valid for active connections) - optional int32 last_link_speed = 7 [default = -1]; - - // Frequency from the last rssi poll (Only valid for active connections) - optional int32 last_freq = 8 [default = -1]; - - // Enum used to define bit positions in the supplicant_state_change_bitmask - // See {@code frameworks/base/wifi/java/android/net/wifi/SupplicantState.java} for documentation - enum SupplicantState { - STATE_DISCONNECTED = 0; - - STATE_INTERFACE_DISABLED = 1; - - STATE_INACTIVE = 2; - - STATE_SCANNING = 3; - - STATE_AUTHENTICATING = 4; - - STATE_ASSOCIATING = 5; - - STATE_ASSOCIATED = 6; - - STATE_FOUR_WAY_HANDSHAKE = 7; - - STATE_GROUP_HANDSHAKE = 8; - - STATE_COMPLETED = 9; - - STATE_DORMANT = 10; - - STATE_UNINITIALIZED = 11; - - STATE_INVALID = 12; - } - - // Bit mask of all supplicant state changes that occurred since the last event - optional uint32 supplicant_state_changes_bitmask = 9 [default = 0]; - - // The number of milliseconds that have elapsed since the device booted - optional int64 start_time_millis = 10 [default = 0]; - - optional FrameworkDisconnectReason framework_disconnect_reason = 11 [default = DISCONNECT_UNKNOWN]; - - // Flag which indicates if an association rejection event occurred due to a timeout - optional bool association_timed_out = 12 [default = false]; - - // Authentication failure reason, as reported by WifiManager (calculated from state & deauth code) - optional AuthFailureReason auth_failure_reason = 13 [default = AUTH_FAILURE_UNKNOWN]; - - // NetworkAgent score of connected wifi - optional int32 last_score = 14 [default = -1]; - - // NetworkAgent Wifi usability score of connected wifi - optional int32 last_wifi_usability_score = 15 [default = -1]; - - // Prediction horizon (in second) of Wifi usability score provided by external - // system app - optional int32 last_prediction_horizon_sec = 16 [default = -1]; - - // Only valid if event type == TYPE_LINK_PROBE. - // true if link probe succeeded, false otherwise. - optional bool link_probe_was_success = 17; - - // Only valid if event type == TYPE_LINK_PROBE and link_probe_was_success == true. - // Elapsed time, in milliseconds, of a successful link probe. - optional int32 link_probe_success_elapsed_time_ms = 18; - - // Only valid if event type == TYPE_LINK_PROBE and link_probe_was_success == false. - // Failure reason for an unsuccessful link probe. - optional LinkProbeStats.LinkProbeFailureReason link_probe_failure_reason = 19; -} - -// Wi-Fi Aware metrics -message WifiAwareLog { - // total number of unique apps that used Aware (measured on attach) - optional int32 num_apps = 1; - - // total number of unique apps that used an identity callback when attaching - optional int32 num_apps_using_identity_callback = 2; - - // maximum number of attaches for an app - optional int32 max_concurrent_attach_sessions_in_app = 3; - - // histogram of attach request results - repeated NanStatusHistogramBucket histogram_attach_session_status = 4; - - // maximum number of concurrent publish sessions in a single app - optional int32 max_concurrent_publish_in_app = 5; - - // maximum number of concurrent subscribe sessions in a single app - optional int32 max_concurrent_subscribe_in_app = 6; - - // maximum number of concurrent discovery (publish+subscribe) sessions in a single app - optional int32 max_concurrent_discovery_sessions_in_app = 7; - - // maximum number of concurrent publish sessions in the system - optional int32 max_concurrent_publish_in_system = 8; - - // maximum number of concurrent subscribe sessions in the system - optional int32 max_concurrent_subscribe_in_system = 9; - - // maximum number of concurrent discovery (publish+subscribe) sessions in the system - optional int32 max_concurrent_discovery_sessions_in_system = 10; - - // histogram of publish request results - repeated NanStatusHistogramBucket histogram_publish_status = 11; - - // histogram of subscribe request results - repeated NanStatusHistogramBucket histogram_subscribe_status = 12; - - // number of unique apps which experienced a discovery session creation failure due to lack of - // resources - optional int32 num_apps_with_discovery_session_failure_out_of_resources = 13; - - // histogram of create ndp request results - repeated NanStatusHistogramBucket histogram_request_ndp_status = 14; - - // histogram of create ndp out-of-band (OOB) request results - repeated NanStatusHistogramBucket histogram_request_ndp_oob_status = 15; - - // maximum number of concurrent active data-interfaces (NDI) in a single app - optional int32 max_concurrent_ndi_in_app = 19; - - // maximum number of concurrent active data-interfaces (NDI) in the system - optional int32 max_concurrent_ndi_in_system = 20; - - // maximum number of concurrent data-paths (NDP) in a single app - optional int32 max_concurrent_ndp_in_app = 21; - - // maximum number of concurrent data-paths (NDP) in the system - optional int32 max_concurrent_ndp_in_system = 22; - - // maximum number of concurrent secure data-paths (NDP) in a single app - optional int32 max_concurrent_secure_ndp_in_app = 23; - - // maximum number of concurrent secure data-paths (NDP) in the system - optional int32 max_concurrent_secure_ndp_in_system = 24; - - // maximum number of concurrent data-paths (NDP) per data-interface (NDI) - optional int32 max_concurrent_ndp_per_ndi = 25; - - // histogram of durations of Aware being available - repeated HistogramBucket histogram_aware_available_duration_ms = 26; - - // histogram of durations of Aware being enabled - repeated HistogramBucket histogram_aware_enabled_duration_ms = 27; - - // histogram of duration (in ms) of attach sessions - repeated HistogramBucket histogram_attach_duration_ms = 28; - - // histogram of duration (in ms) of publish sessions - repeated HistogramBucket histogram_publish_session_duration_ms = 29; - - // histogram of duration (in ms) of subscribe sessions - repeated HistogramBucket histogram_subscribe_session_duration_ms = 30; - - // histogram of duration (in ms) of data-paths (NDP) - repeated HistogramBucket histogram_ndp_session_duration_ms = 31; - - // histogram of usage (in MB) of data-paths (NDP) - repeated HistogramBucket histogram_ndp_session_data_usage_mb = 32; - - // histogram of usage (in MB) of data-path creation time (in ms) measured as request -> confirm - repeated HistogramBucket histogram_ndp_creation_time_ms = 33; - - // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: minimum - optional int64 ndp_creation_time_ms_min = 34; - - // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: maximum - optional int64 ndp_creation_time_ms_max = 35; - - // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum - optional int64 ndp_creation_time_ms_sum = 36; - - // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum of sq - optional int64 ndp_creation_time_ms_sum_of_sq = 37; - - // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: number of - // samples - optional int64 ndp_creation_time_ms_num_samples = 38; - - // total time within the logging window that aware was available - optional int64 available_time_ms = 39; - - // total time within the logging window that aware was enabled - optional int64 enabled_time_ms = 40; - - // maximum number of concurrent publish sessions enabling ranging in a single app - optional int32 max_concurrent_publish_with_ranging_in_app = 41; - - // maximum number of concurrent subscribe sessions specifying a geofence in a single app - optional int32 max_concurrent_subscribe_with_ranging_in_app = 42; - - // maximum number of concurrent publish sessions enabling ranging in the system - optional int32 max_concurrent_publish_with_ranging_in_system = 43; - - // maximum number of concurrent subscribe sessions specifying a geofence in the system - optional int32 max_concurrent_subscribe_with_ranging_in_system = 44; - - // histogram of subscribe session geofence minimum (only when specified) - repeated HistogramBucket histogram_subscribe_geofence_min = 45; - - // histogram of subscribe session geofence maximum (only when specified) - repeated HistogramBucket histogram_subscribe_geofence_max = 46; - - // total number of subscribe sessions which enabled ranging - optional int32 num_subscribes_with_ranging = 47; - - // total number of matches (service discovery indication) with ranging provided - optional int32 num_matches_with_ranging = 48; - - // total number of matches (service discovery indication) for service discovery with ranging - // enabled which did not trigger ranging - optional int32 num_matches_without_ranging_for_ranging_enabled_subscribes = 49; - - // Histogram bucket for Wi-Fi Aware logs. Range is [start, end) - message HistogramBucket { - // lower range of the bucket (inclusive) - optional int64 start = 1; - - // upper range of the bucket (exclusive) - optional int64 end = 2; - - // number of samples in the bucket - optional int32 count = 3; - } - - // Status of various NAN operations - enum NanStatusTypeEnum { - // constant to be used by proto - UNKNOWN = 0; - - // NAN operation succeeded - SUCCESS = 1; - - // NAN Discovery Engine/Host driver failures - INTERNAL_FAILURE = 2; - - // NAN OTA failures - PROTOCOL_FAILURE = 3; - - // The publish/subscribe discovery session id is invalid - INVALID_SESSION_ID = 4; - - // Out of resources to fufill request - NO_RESOURCES_AVAILABLE = 5; - - // Invalid arguments passed - INVALID_ARGS = 6; - - // Invalid peer id - INVALID_PEER_ID = 7; - - // Invalid NAN data-path (ndp) id - INVALID_NDP_ID = 8; - - // Attempting to enable NAN when not available, e.g. wifi is disabled - NAN_NOT_ALLOWED = 9; - - // Over the air ACK not received - NO_OTA_ACK = 10; - - // Attempting to enable NAN when already enabled - ALREADY_ENABLED = 11; - - // Can't queue tx followup message foor transmission - FOLLOWUP_TX_QUEUE_FULL = 12; - - // Unsupported concurrency of NAN and another feature - NAN disabled - UNSUPPORTED_CONCURRENCY_NAN_DISABLED = 13; - - // Unknown NanStatusType - UNKNOWN_HAL_STATUS = 14; - } - - // Histogram bucket for Wi-Fi Aware (NAN) status. - message NanStatusHistogramBucket { - // status type defining the bucket - optional NanStatusTypeEnum nan_status_type = 1; - - // number of samples in the bucket - optional int32 count = 2; - } -} - -// Data point used to build 'Number of Connectable Network' histograms -message NumConnectableNetworksBucket { - // Number of connectable networks seen in a scan result - optional int32 num_connectable_networks = 1 [default = 0]; - - // Number of scan results with num_connectable_networks - optional int32 count = 2 [default = 0]; -} - -// Pno scan metrics -// Here "Pno Scan" refers to the session of offloaded scans, these metrics count the result of a -// single session, and not the individual scans within that session. -message PnoScanMetrics { - // Total number of attempts to offload pno scans - optional int32 num_pno_scan_attempts = 1; - - // Total number of pno scans failed - optional int32 num_pno_scan_failed = 2; - - // Number of pno scans started successfully over offload - optional int32 num_pno_scan_started_over_offload = 3; - - // Number of pno scans failed over offload - optional int32 num_pno_scan_failed_over_offload = 4; - - // Total number of pno scans that found any network - optional int32 num_pno_found_network_events = 5; -} - -// Number of occurrences for a particular "Connect to Network" Notification or -// notification Action. -message ConnectToNetworkNotificationAndActionCount { - - // "Connect to Network" notifications - enum Notification { - - // Default - NOTIFICATION_UNKNOWN = 0; - - // Initial notification with a recommended network. - NOTIFICATION_RECOMMEND_NETWORK = 1; - - // Notification when connecting to the recommended network. - NOTIFICATION_CONNECTING_TO_NETWORK = 2; - - // Notification when successfully connected to the network. - NOTIFICATION_CONNECTED_TO_NETWORK = 3; - - // Notification when failed to connect to network. - NOTIFICATION_FAILED_TO_CONNECT = 4; - } - - // "Connect to Network" notification actions - enum Action { - - // Default - ACTION_UNKNOWN = 0; - - // User dismissed the "Connect to Network" notification. - ACTION_USER_DISMISSED_NOTIFICATION = 1; - - // User tapped action button to connect to recommended network. - ACTION_CONNECT_TO_NETWORK = 2; - - // User tapped action button to open Wi-Fi Settings. - ACTION_PICK_WIFI_NETWORK = 3; - - // User tapped "Failed to connect" notification to open Wi-Fi Settings. - ACTION_PICK_WIFI_NETWORK_AFTER_CONNECT_FAILURE = 4; - } - - // Recommenders of the "Connect to Network" notification - enum Recommender { - - // Default. - RECOMMENDER_UNKNOWN = 0; - - // Open Network Available recommender. - RECOMMENDER_OPEN = 1; - } - - // Notification Type. - optional Notification notification = 1; - - // Action Type. - optional Action action = 2; - - // Recommender Type. - optional Recommender recommender = 3; - - // Occurrences of this action. - optional int32 count = 4; -} - -// SoftAP event tracking sessions and client counts -message SoftApConnectedClientsEvent { - - // Soft AP event Types - enum SoftApEventType { - - // Soft AP is Up and ready for use - SOFT_AP_UP = 0; - - // Soft AP is Down - SOFT_AP_DOWN = 1; - - // Number of connected soft AP clients has changed - NUM_CLIENTS_CHANGED = 2; - } - - // Soft AP channel bandwidth types - enum ChannelBandwidth { - - BANDWIDTH_INVALID = 0; - - BANDWIDTH_20_NOHT = 1; - - BANDWIDTH_20 = 2; - - BANDWIDTH_40 = 3; - - BANDWIDTH_80 = 4; - - BANDWIDTH_80P80 = 5; - - BANDWIDTH_160 = 6; - } - - // Type of event being recorded - optional SoftApEventType event_type = 1; - - // Time passed since last boot in milliseconds - optional int64 time_stamp_millis = 2; - - // Number of connected clients if event_type is NUM_CLIENTS_CHANGED, otherwise zero. - optional int32 num_connected_clients = 3; - - // Channel frequency used for Soft AP - optional int32 channel_frequency = 4; - - // Channel bandwidth used for Soft AP - optional ChannelBandwidth channel_bandwidth = 5; -} - -// Wps connection metrics -// Keeps track of Wi-Fi Protected Setup usage -message WpsMetrics { - // Total number of wps connection attempts - optional int32 num_wps_attempts = 1; - - // Total number of wps connection successes - optional int32 num_wps_success = 2; - - // Total number of wps failures on start - optional int32 num_wps_start_failure = 3; - - // Total number of wps overlap failure - optional int32 num_wps_overlap_failure = 4; - - // Total number of wps timeout failure - optional int32 num_wps_timeout_failure = 5; - - // Total number of other wps failure during connection - optional int32 num_wps_other_connection_failure = 6; - - // Total number of supplicant failure after wps - optional int32 num_wps_supplicant_failure = 7; - - // Total number of wps cancellation - optional int32 num_wps_cancellation = 8; -} - -// Power stats for Wifi -message WifiPowerStats { - - // Duration of log (ms) - optional int64 logging_duration_ms = 1; - - // Energy consumed by wifi (mAh) - optional double energy_consumed_mah = 2; - - // Amount of time wifi is in idle (ms) - optional int64 idle_time_ms = 3; - - // Amount of time wifi is in rx (ms) - optional int64 rx_time_ms = 4; - - // Amount of time wifi is in tx (ms) - optional int64 tx_time_ms = 5; - - // Amount of time kernel is active because of wifi data (ms) - optional int64 wifi_kernel_active_time_ms = 6; - - // Number of packets sent (tx) - optional int64 num_packets_tx = 7; - - // Number of bytes sent (tx) - optional int64 num_bytes_tx = 8; - - // Number of packets received (rx) - optional int64 num_packets_rx = 9; - - // Number of bytes sent (rx) - optional int64 num_bytes_rx = 10; - - // Amount of time wifi is in sleep (ms) - optional int64 sleep_time_ms = 11; - - // Amount of time wifi is scanning (ms) - optional int64 scan_time_ms = 12; - - // Actual monitored rail energy consumed by wifi (mAh) - optional double monitored_rail_energy_consumed_mah = 13; -} - -// Metrics for Wifi Wake -message WifiWakeStats { - // An individual session for Wifi Wake - message Session { - // A Wifi Wake lifecycle event - message Event { - // Elapsed time in milliseconds since start of session. - optional int64 elapsed_time_millis = 1; - - // Number of scans that have occurred since start of session. - optional int32 elapsed_scans = 2; - } - - // Start time of session in milliseconds. - optional int64 start_time_millis = 1; - - // The number of networks the lock was provided with at start. - optional int32 locked_networks_at_start = 2; - - // The number of networks in the lock at the time of the initialize event. Only valid if - // initialize_event is recorded. - optional int32 locked_networks_at_initialize = 6; - - // Event for fully initializing the WakeupLock (i.e. WakeupLock is "locked"). - optional Event initialize_event = 7; - - // Event for unlocking the WakeupLock. Does not occur if lock was initialized with 0 networks. - optional Event unlock_event = 3; - - // Event for triggering wakeup. - optional Event wakeup_event = 4; - - // Event for WifiWake reset event. This event marks the end of a session. - optional Event reset_event = 5; - } - - // Total number of sessions for Wifi Wake. - optional int32 num_sessions = 1; - - // Session information for every Wifi Wake session (up to a maximum of 10). - repeated Session sessions = 2; - - // Number of ignored calls to start (due to WakeupController already being active). - optional int32 num_ignored_starts = 3; - - // Number of Wifi Wake sessions that have recorded wakeup events. - optional int32 num_wakeups = 4; -} - -// Metrics for Wi-Fi RTT -message WifiRttLog { - // Number of RTT request API calls - optional int32 num_requests = 1; - - // Histogram of RTT operation overall status - repeated RttOverallStatusHistogramBucket histogram_overall_status = 2; - - // RTT to Access Points metrics - optional RttToPeerLog rtt_to_ap = 3; - - // RTT to Wi-Fi Aware peers metrics - optional RttToPeerLog rtt_to_aware = 4; - - // Metrics for a RTT to Peer (peer = AP or Wi-Fi Aware) - message RttToPeerLog { - // Total number of API calls - optional int32 num_requests = 1; - - // Total number of individual requests - optional int32 num_individual_requests = 2; - - // Total number of apps which requested RTT - optional int32 num_apps = 3; - - // Histogram of total number of RTT requests by an app (WifiRttManager#startRanging) - repeated HistogramBucket histogram_num_requests_per_app = 4; - - // Histogram of number of peers in a single RTT request (RangingRequest entries) - repeated HistogramBucket histogram_num_peers_per_request = 5; - - // Histogram of status of individual RTT operations (RangingResult entries) - repeated RttIndividualStatusHistogramBucket histogram_individual_status = 6; - - // Histogram of measured distances (RangingResult entries) - repeated HistogramBucket histogram_distance = 7; - - // Histogram of interval of RTT requests by an app (WifiRttManager#startRanging) - repeated HistogramBucket histogram_request_interval_ms = 8; - } - - // Histogram bucket for Wi-Fi RTT logs. Range is [start, end) - message HistogramBucket { - // lower range of the bucket (inclusive) - optional int64 start = 1; - - // upper range of the bucket (exclusive) - optional int64 end = 2; - - // number of samples in the bucket - optional int32 count = 3; - } - - // Status codes for overall RTT operation - enum RttOverallStatusTypeEnum { - // constant to be used by proto - OVERALL_UNKNOWN = 0; - - // RTT operation succeeded (individual results may still fail) - OVERALL_SUCCESS = 1; - - // RTT operation failed (unspecified reason) - OVERALL_FAIL = 2; - - // RTT operation failed since RTT was not available (e.g. Airplane mode) - OVERALL_RTT_NOT_AVAILABLE = 3; - - // RTT operation timed-out: didn't receive response from HAL in expected time - OVERALL_TIMEOUT = 4; - - // RTT operation aborted since the app is spamming the service - OVERALL_THROTTLE = 5; - - // RTT request to HAL received immediate failure - OVERALL_HAL_FAILURE = 6; - - // RTT to Wi-Fi Aware peer using PeerHandle failed to get a MAC address translation - OVERALL_AWARE_TRANSLATION_FAILURE = 7; - - // RTT operation failed due to missing Location permission (post execution) - OVERALL_LOCATION_PERMISSION_MISSING = 8; - } - - // Status codes for individual RTT operation - enum RttIndividualStatusTypeEnum { - // constant to be used by proto - UNKNOWN = 0; - - // RTT operation succeeded - SUCCESS = 1; - - // RTT failure: generic reason (no further information) - FAILURE = 2; - - // Target STA does not respond to request - FAIL_NO_RSP = 3; - - // Request rejected. Applies to 2-sided RTT only - FAIL_REJECTED = 4; - - // Operation not scheduled - FAIL_NOT_SCHEDULED_YET = 5; - - // Timing measurement times out - FAIL_TM_TIMEOUT = 6; - - // Target on different channel, cannot range - FAIL_AP_ON_DIFF_CHANNEL = 7; - - // Ranging not supported - FAIL_NO_CAPABILITY = 8; - - // Request aborted for unknown reason - ABORTED = 9; - - // Invalid T1-T4 timestamp - FAIL_INVALID_TS = 10; - - // 11mc protocol failed - FAIL_PROTOCOL = 11; - - // Request could not be scheduled - FAIL_SCHEDULE = 12; - - // Responder cannot collaborate at time of request - FAIL_BUSY_TRY_LATER = 13; - - // Bad request args - INVALID_REQ = 14; - - // WiFi not enabled - NO_WIFI = 15; - - // Responder overrides param info, cannot range with new params - FAIL_FTM_PARAM_OVERRIDE = 16; - - // HAL did not provide a result to a framework request - MISSING_RESULT = 17; - } - - // Histogram bucket for Wi-Fi RTT overall operation status - message RttOverallStatusHistogramBucket { - // status type defining the bucket - optional RttOverallStatusTypeEnum status_type = 1; - - // number of samples in the bucket - optional int32 count = 2; - } - - // Histogram bucket for Wi-Fi RTT individual operation status - message RttIndividualStatusHistogramBucket { - // status type defining the bucket - optional RttIndividualStatusTypeEnum status_type = 1; - - // number of samples in the bucket - optional int32 count = 2; - } -} - -// Usage data for the wifi radio while device is running on battery. -message WifiRadioUsage { - // Duration of log (ms) - optional int64 logging_duration_ms = 1; - - // Total time for which the radio is awake due to scan. - optional int64 scan_time_ms = 2; -} - -message ExperimentValues { - // Indicates if we are logging WifiIsUnusableEvent in metrics - optional bool wifi_is_unusable_logging_enabled = 1; - - // Minimum number of txBad to trigger a data stall - optional int32 wifi_data_stall_min_tx_bad = 2; - - // Minimum number of txSuccess to trigger a data stall - // when rxSuccess is 0 - optional int32 wifi_data_stall_min_tx_success_without_rx = 3; - - // Indicates if we are logging LinkSpeedCount in metrics - optional bool link_speed_counts_logging_enabled = 4; - - // Duration for evaluating Wifi condition to trigger a data stall - // measured in milliseconds - optional int32 data_stall_duration_ms = 5; - - // Threshold of Tx throughput below which to trigger a data stall - // measured in Kbps - optional int32 data_stall_tx_tput_thr_kbps = 6; - - // Threshold of Rx throughput below which to trigger a data stall - // measured in Kbps - optional int32 data_stall_rx_tput_thr_kbps = 7; - - // Threshold of Tx packet error rate above which to trigger a data stall - // in percentage - optional int32 data_stall_tx_per_thr = 8; - - // Threshold of CCA level above which to trigger a data stall in percentage - optional int32 data_stall_cca_level_thr = 9; -} - -message WifiIsUnusableEvent { - enum TriggerType { - // Default/Invalid event - TYPE_UNKNOWN = 0; - - // There is a data stall from tx failures - TYPE_DATA_STALL_BAD_TX = 1; - - // There is a data stall from rx failures - TYPE_DATA_STALL_TX_WITHOUT_RX = 2; - - // There is a data stall from both tx and rx failures - TYPE_DATA_STALL_BOTH = 3; - - // Firmware generated an alert - TYPE_FIRMWARE_ALERT = 4; - - // IP Manager lost reachability to network neighbors - TYPE_IP_REACHABILITY_LOST = 5; - } - - // What event triggered WifiIsUnusableEvent. - optional TriggerType type = 1; - - // The timestamp at which this event occurred. - // Measured in milliseconds that have elapsed since the device booted. - optional int64 start_time_millis = 2; - - // NetworkAgent score of connected wifi. - // Defaults to -1 if the score was never set. - optional int32 last_score = 3 [default = -1]; - - // Delta of successfully transmitted (ACKed) unicast data packets - // between the last two WifiLinkLayerStats. - optional int64 tx_success_delta = 4; - - // Delta of transmitted unicast data retry packets - // between the last two WifiLinkLayerStats. - optional int64 tx_retries_delta = 5; - - // Delta of lost (not ACKed) transmitted unicast data packets - // between the last two WifiLinkLayerStats. - optional int64 tx_bad_delta = 6; - - // Delta of received unicast data packets - // between the last two WifiLinkLayerStats. - optional int64 rx_success_delta = 7; - - // Time in millisecond between the last two WifiLinkLayerStats. - optional int64 packet_update_time_delta = 8; - - // The timestamp at which the last WifiLinkLayerStats was updated. - // Measured in milliseconds that have elapsed since the device booted. - optional int64 last_link_layer_stats_update_time = 9; - - // Firmware alert code. Only valid when the event was triggered by a firmware alert, otherwise -1. - optional int32 firmware_alert_code = 10 [default = -1]; - - // NetworkAgent wifi usability score of connected wifi. - // Defaults to -1 if the score was never set. - optional int32 last_wifi_usability_score = 11 [default = -1]; - - // Prediction horizon (in second) of Wifi usability score provided by external - // system app - optional int32 last_prediction_horizon_sec = 12 [default = -1]; - - // Whether screen status is on when WifiIsUnusableEvent happens. - optional bool screen_on = 13 [default = false]; -} - -message PasspointProfileTypeCount { - enum EapMethod { - // Unknown Type - TYPE_UNKNOWN = 0; - - // EAP_TLS (13) - TYPE_EAP_TLS = 1; - - // EAP_TTLS (21) - TYPE_EAP_TTLS = 2; - - // EAP_SIM (18) - TYPE_EAP_SIM = 3; - - // EAP_AKA (23) - TYPE_EAP_AKA = 4; - - // EAP_AKA_PRIME (50) - TYPE_EAP_AKA_PRIME = 5; - } - - // Eap method type set in Passpoint profile - optional EapMethod eap_method_type = 1; - - // Num of installed Passpoint profile with same eap method - optional int32 count = 2; -} - -message WifiLinkLayerUsageStats { - // Total logging duration in ms. - optional int64 logging_duration_ms = 1; - - // Total time the wifi radio is on in ms over the logging duration. - optional int64 radio_on_time_ms = 2; - - // Total time the wifi radio is doing tx in ms over the logging duration. - optional int64 radio_tx_time_ms = 3; - - // Total time the wifi radio is doing rx in ms over the logging duration. - optional int64 radio_rx_time_ms = 4; - - // Total time the wifi radio is scanning in ms over the logging duration. - optional int64 radio_scan_time_ms = 5; - - // Total time the wifi radio spent doing nan scans in ms over the logging duration. - optional int64 radio_nan_scan_time_ms = 6; - - // Total time the wifi radio spent doing background scans in ms over the logging duration. - optional int64 radio_background_scan_time_ms = 7; - - // Total time the wifi radio spent doing roam scans in ms over the logging duration. - optional int64 radio_roam_scan_time_ms = 8; - - // Total time the wifi radio spent doing pno scans in ms over the logging duration. - optional int64 radio_pno_scan_time_ms = 9; - - // Total time the wifi radio spent doing hotspot 2.0 scans and GAS exchange - // in ms over the logging duration. - optional int64 radio_hs20_scan_time_ms = 10; -} - -message WifiUsabilityStatsEntry { - // Status codes for link probe status - enum LinkProbeStatus { - // Link probe status is unknown - PROBE_STATUS_UNKNOWN = 0; - - // Link probe is not triggered - PROBE_STATUS_NO_PROBE = 1; - - // Link probe is triggered and the result is success - PROBE_STATUS_SUCCESS = 2; - - // Link probe is triggered and the result is failure - PROBE_STATUS_FAILURE = 3; - } - - // Codes for cellular data network type - enum CellularDataNetworkType { - // Unknown network - NETWORK_TYPE_UNKNOWN = 0; - - // GSM network - NETWORK_TYPE_GSM = 1; - - // CDMA network - NETWORK_TYPE_CDMA = 2; - - // CDMA EVDO network - NETWORK_TYPE_EVDO_0 = 3; - - // WCDMA network - NETWORK_TYPE_UMTS = 4; - - // TDSCDMA network - NETWORK_TYPE_TD_SCDMA = 5; - - // LTE network - NETWORK_TYPE_LTE = 6; - - // NR network - NETWORK_TYPE_NR = 7; - } - - // Absolute milliseconds from device boot when these stats were sampled - optional int64 time_stamp_ms = 1; - - // The RSSI at the sample time - optional int32 rssi = 2; - - // Link speed at the sample time in Mbps - optional int32 link_speed_mbps = 3; - - // The total number of tx success counted from the last radio chip reset - optional int64 total_tx_success = 4; - - // The total number of MPDU data packet retries counted from the last radio chip reset - optional int64 total_tx_retries = 5; - - // The total number of tx bad counted from the last radio chip reset - optional int64 total_tx_bad = 6; - - // The total number of rx success counted from the last radio chip reset - optional int64 total_rx_success = 7; - - // The total time the wifi radio is on in ms counted from the last radio chip reset - optional int64 total_radio_on_time_ms = 8; - - // The total time the wifi radio is doing tx in ms counted from the last radio chip reset - optional int64 total_radio_tx_time_ms = 9; - - // The total time the wifi radio is doing rx in ms counted from the last radio chip reset - optional int64 total_radio_rx_time_ms = 10; - - // The total time spent on all types of scans in ms counted from the last radio chip reset - optional int64 total_scan_time_ms = 11; - - // The total time spent on nan scans in ms counted from the last radio chip reset - optional int64 total_nan_scan_time_ms = 12; - - // The total time spent on background scans in ms counted from the last radio chip reset - optional int64 total_background_scan_time_ms = 13; - - // The total time spent on roam scans in ms counted from the last radio chip reset - optional int64 total_roam_scan_time_ms = 14; - - // The total time spent on pno scans in ms counted from the last radio chip reset - optional int64 total_pno_scan_time_ms = 15; - - // The total time spent on hotspot2.0 scans and GAS exchange in ms counted from the last radio - // chip reset - optional int64 total_hotspot_2_scan_time_ms = 16; - - // Internal framework Wifi score - optional int32 wifi_score = 17; - - // Wifi usability score provided by external system app - optional int32 wifi_usability_score = 18; - - // Sequence number from external system app to framework - optional int32 seq_num_to_framework = 19; - - // The total time CCA is on busy status on the current frequency in ms - // counted from the last radio chip reset - optional int64 total_cca_busy_freq_time_ms = 20; - - // The total radio on time of the current frequency from the last radio - // chip reset - optional int64 total_radio_on_freq_time_ms = 21; - - // The total number of beacons received from the last radio chip reset - optional int64 total_beacon_rx = 22; - - // Prediction horizon (in second) of Wifi usability score provided by external - // system app - optional int32 prediction_horizon_sec = 23; - - // The link probe status since last stats update - optional LinkProbeStatus probe_status_since_last_update = 24; - - // The elapsed time of the most recent link probe since last stats update; - optional int32 probe_elapsed_time_since_last_update_ms = 25; - - // The MCS rate of the most recent link probe since last stats update - optional int32 probe_mcs_rate_since_last_update = 26; - - // Rx link speed at the sample time in Mbps - optional int32 rx_link_speed_mbps = 27; - - // Sequence number generated by framework - optional int32 seq_num_inside_framework = 28; - - // Whether current entry is for the same BSSID on the same frequency compared - // to last entry - optional bool is_same_bssid_and_freq = 29; - - // Cellular data network type currently in use on the device for data transmission - optional CellularDataNetworkType cellular_data_network_type = 30; - - // Cellular signal strength in dBm, NR: CsiRsrp, LTE: Rsrp, WCDMA/TDSCDMA: Rscp, - // CDMA: Rssi, EVDO: Rssi, GSM: Rssi - optional int32 cellular_signal_strength_dbm = 31; - - // Cellular signal strength in dB, NR: CsiSinr, LTE: Rsrq, WCDMA: EcNo, TDSCDMA: invalid, - // CDMA: Ecio, EVDO: SNR, GSM: invalid */ - optional int32 cellular_signal_strength_db = 32; - - // Whether the primary registered cell of current entry is same as that of previous entry - optional bool is_same_registered_cell = 33; - - // The device mobility state - optional DeviceMobilityStatePnoScanStats.DeviceMobilityState - device_mobility_state = 34; -} - -message WifiUsabilityStats { - enum Label { - // Default label - LABEL_UNKNOWN = 0; - - // Wifi is usable - LABEL_GOOD = 1; - - // Wifi is unusable - LABEL_BAD = 2; - } - - enum UsabilityStatsTriggerType { - // Default/Invalid event - TYPE_UNKNOWN = 0; - - // There is a data stall from tx failures - TYPE_DATA_STALL_BAD_TX = 1; - - // There is a data stall from rx failures - TYPE_DATA_STALL_TX_WITHOUT_RX = 2; - - // There is a data stall from both tx and rx failures - TYPE_DATA_STALL_BOTH = 3; - - // Firmware generated an alert - TYPE_FIRMWARE_ALERT = 4; - - // IP Manager lost reachability to network neighbors - TYPE_IP_REACHABILITY_LOST = 5; - } - - // The current wifi usability state - optional Label label = 1; - - // The list of timestamped wifi usability stats - repeated WifiUsabilityStatsEntry stats = 2; - - // What event triggered WifiUsabilityStats. - optional UsabilityStatsTriggerType trigger_type = 3; - - // Firmware alert code. Only valid when the stats was triggered by a firmware - // alert, otherwise -1. - optional int32 firmware_alert_code = 4 [default = -1]; - - // Absolute milliseconds from device boot when these stats were sampled - optional int64 time_stamp_ms = 5; -} - -message DeviceMobilityStatePnoScanStats { - // see WifiManager.DEVICE_MOBILITY_STATE_* constants - enum DeviceMobilityState { - // Unknown mobility - UNKNOWN = 0; - - // High movement - HIGH_MVMT = 1; - - // Low movement - LOW_MVMT = 2; - - // Stationary - STATIONARY = 3; - } - - // The device mobility state - optional DeviceMobilityState device_mobility_state = 1; - - // The number of times that this state was entered - optional int32 num_times_entered_state = 2; - - // The total duration elapsed while in this mobility state, in ms - optional int64 total_duration_ms = 3; - - // the total duration elapsed while in this mobility state with PNO scans running, in ms - optional int64 pno_duration_ms = 4; -} - -// The information about the Wifi P2p events. -message WifiP2pStats { - - // Group event list tracking sessions and client counts in tethered mode. - repeated GroupEvent group_event = 1; - - // Session information that gets logged for every Wifi P2p connection. - repeated P2pConnectionEvent connection_event = 2; - - // Number of persistent group in the user profile. - optional int32 num_persistent_group = 3; - - // Number of peer scan. - optional int32 num_total_peer_scans = 4; - - // Number of service scan. - optional int32 num_total_service_scans = 5; -} - -message P2pConnectionEvent { - - enum ConnectionType { - - // fresh new connection. - CONNECTION_FRESH = 0; - - // reinvoke a group. - CONNECTION_REINVOKE = 1; - - // create a group with the current device as the group owner locally. - CONNECTION_LOCAL = 2; - - // create a group or join a group with config. - CONNECTION_FAST = 3; - } - - enum ConnectivityLevelFailure { - - // Failure is unknown. - CLF_UNKNOWN = 0; - - // No failure. - CLF_NONE = 1; - - // Timeout for current connecting request. - CLF_TIMEOUT = 2; - - // The connecting request is canceled by the user. - CLF_CANCEL = 3; - - // Provision discovery failure, e.g. no pin code, timeout, rejected by the peer. - CLF_PROV_DISC_FAIL = 4; - - // Invitation failure, e.g. rejected by the peer. - CLF_INVITATION_FAIL = 5; - - // Incoming request is rejected by the user. - CLF_USER_REJECT = 6; - - // New connection request is issued before ending previous connecting request. - CLF_NEW_CONNECTION_ATTEMPT = 7; - } - - // WPS method. - enum WpsMethod { - // WPS is skipped for Group Reinvoke. - WPS_NA = -1; - - // Push button configuration. - WPS_PBC = 0; - - // Display pin method configuration - pin is generated and displayed on device. - WPS_DISPLAY = 1; - - // Keypad pin method configuration - pin is entered on device. - WPS_KEYPAD = 2; - - // Label pin method configuration - pin is labelled on device. - WPS_LABEL = 3; - } - - // Start time of the connection. - optional int64 start_time_millis = 1; - - // Type of the connection. - optional ConnectionType connection_type = 2; - - // WPS method. - optional WpsMethod wps_method = 3 [default = WPS_NA]; - - // Duration to connect. - optional int32 duration_taken_to_connect_millis = 4; - - // Failures that happen at the connectivity layer. - optional ConnectivityLevelFailure connectivity_level_failure_code = 5; -} - -// GroupEvent tracking group information from GroupStarted to GroupRemoved. -message GroupEvent { - - enum GroupRole { - - GROUP_OWNER = 0; - - GROUP_CLIENT = 1; - } - - // The ID of network in supplicant for this group. - optional int32 net_id = 1; - - // Start time of the group. - optional int64 start_time_millis = 2; - - // Channel frequency used for Group. - optional int32 channel_frequency = 3; - - // Is group owner or group client. - optional GroupRole group_role = 5; - - // Number of connected clients. - optional int32 num_connected_clients = 6; - - // Cumulative number of connected clients. - optional int32 num_cumulative_clients = 7; - - // The session duration. - optional int32 session_duration_millis = 8; - - // The idle duration. A group without any client is in idle. - optional int32 idle_duration_millis = 9; -} - -// Easy Connect (DPP) -message WifiDppLog { - reserved 6; - - // Number of Configurator-Initiator requests - optional int32 num_dpp_configurator_initiator_requests = 1; - - // Number of Enrollee-Initiator requests - optional int32 num_dpp_enrollee_initiator_requests = 2; - - // Easy Connect (DPP) Enrollee success - optional int32 num_dpp_enrollee_success = 3; - - // Easy Connect (DPP) Configurator success code bucket - repeated DppConfiguratorSuccessStatusHistogramBucket dpp_configurator_success_code = 4; - - // Easy Connect (DPP) failure code bucket - repeated DppFailureStatusHistogramBucket dpp_failure_code = 5; - - // Easy Connect (DPP) operation time bucket - repeated HistogramBucketInt32 dpp_operation_time = 7; - - // Histogram bucket for Wi-Fi DPP configurator success - message DppConfiguratorSuccessStatusHistogramBucket { - // status type defining the bucket - optional DppConfiguratorSuccessCode dpp_status_type = 1; - - // number of samples in the bucket - optional int32 count = 2; - } - - // Histogram bucket for Wi-Fi DPP failures - message DppFailureStatusHistogramBucket { - // status type defining the bucket - optional DppFailureCode dpp_status_type = 1; - - // number of samples in the bucket - optional int32 count = 2; - } - - enum DppConfiguratorSuccessCode { - // Unknown success code - EASY_CONNECT_EVENT_SUCCESS_UNKNOWN = 0; - - // Easy Connect Configurator success event: Configuration sent to enrollee - EASY_CONNECT_EVENT_SUCCESS_CONFIGURATION_SENT = 1; - } - - enum DppFailureCode { - // Unknown failure - EASY_CONNECT_EVENT_FAILURE_UNKNOWN = 0; - - // Easy Connect Failure event: Scanned QR code is either not a Easy Connect URI, or the Easy - // Connect URI has errors. - EASY_CONNECT_EVENT_FAILURE_INVALID_URI = 1; - - // Easy Connect Failure event: Bootstrapping/Authentication initialization process failure. - EASY_CONNECT_EVENT_FAILURE_AUTHENTICATION = 2; - - // Easy Connect Failure event: Both devices are implementing the same role and are - // incompatible. - EASY_CONNECT_EVENT_FAILURE_NOT_COMPATIBLE = 3; - - // Easy Connect Failure event: Configuration process has failed due to malformed message. - EASY_CONNECT_EVENT_FAILURE_CONFIGURATION = 4; - - // Easy Connect Failure event: Easy Connect request while in another Easy Connect exchange. - EASY_CONNECT_EVENT_FAILURE_BUSY = 5; - - // Easy Connect Failure event: No response from the peer. - EASY_CONNECT_EVENT_FAILURE_TIMEOUT = 6; - - // Easy Connect Failure event: General protocol failure. - EASY_CONNECT_EVENT_FAILURE_GENERIC = 7; - - // Easy Connect Failure event: Feature or option is not supported. - EASY_CONNECT_EVENT_FAILURE_NOT_SUPPORTED = 8; - - // Easy Connect Failure event: Invalid network provided to Easy Connect configurator. - // Network must either be WPA3-Personal (SAE) or WPA2-Personal (PSK). - EASY_CONNECT_EVENT_FAILURE_INVALID_NETWORK = 9; - } -} - -// WifiConfigStore read/write metrics. -message WifiConfigStoreIO { - // Histogram of config store read durations. - repeated DurationBucket read_durations = 1; - - // Histogram of config store write durations. - repeated DurationBucket write_durations = 2; - - // Total Number of instances of write/read duration in this duration bucket. - message DurationBucket { - // Bucket covers duration : [range_start_ms, range_end_ms) - // The (inclusive) lower bound of read/write duration represented by this bucket - optional int32 range_start_ms = 1; - - // The (exclusive) upper bound of read/write duration represented by this bucket - optional int32 range_end_ms = 2; - - // Number of read/write durations that fit into this bucket - optional int32 count = 3; - } -} - -// Histogram bucket counting with int32. Range is [start, end) -message HistogramBucketInt32 { - // lower range of the bucket (inclusive) - optional int32 start = 1; - - // upper range of the bucket (exclusive) - optional int32 end = 2; - - // number of samples in the bucket - optional int32 count = 3; -} - -// Counts occurrences of a int32 key -message Int32Count { - // the key - optional int32 key = 1; - - // the count - optional int32 count = 2; -} - -message LinkProbeStats { - enum LinkProbeFailureReason { - // unknown reason - LINK_PROBE_FAILURE_REASON_UNKNOWN = 0; - - // Specified MCS rate when it is unsupported by the driver. - LINK_PROBE_FAILURE_REASON_MCS_UNSUPPORTED = 1; - - // Driver reported that no ACK was received for the transmitted probe. - LINK_PROBE_FAILURE_REASON_NO_ACK = 2; - - // Driver failed to report on the status of the transmitted probe within the timeout. - LINK_PROBE_FAILURE_REASON_TIMEOUT = 3; - - // An existing link probe is in progress. - LINK_PROBE_FAILURE_REASON_ALREADY_STARTED = 4; - } - - // Counts the number of failures for each failure reason. - message LinkProbeFailureReasonCount { - // The failure reason. - optional LinkProbeFailureReason failure_reason = 1; - - // The number of occurrences for this failure reason. - optional int32 count = 2; - } - - // Counts the number of link probes for each experiment. - message ExperimentProbeCounts { - // The experiment ID. - optional string experiment_id = 1; - - // The number of link probes triggered for this experiment. - optional int32 probe_count = 2; - } - - // Counts the occurrences of RSSI values when a link probe succeeds. - repeated Int32Count success_rssi_counts = 1; - - // Counts the occurrences of RSSI values when a link probe fails. - repeated Int32Count failure_rssi_counts = 2; - - // Counts the occurrences of Link Speed values when a link probe succeeds. - repeated Int32Count success_link_speed_counts = 3; - - // Counts the occurrences of Link Speed values when a link probe fails. - repeated Int32Count failure_link_speed_counts = 4; - - // Histogram for the number of seconds since the last TX success when a link probe succeeds. - repeated HistogramBucketInt32 success_seconds_since_last_tx_success_histogram = 5; - - // Histogram for the number of seconds since the last TX success when a link probe fails. - repeated HistogramBucketInt32 failure_seconds_since_last_tx_success_histogram = 6; - - // Histogram for the elapsed time of successful link probes, in ms. - repeated HistogramBucketInt32 success_elapsed_time_ms_histogram = 7; - - // Counts the occurrences of error codes for failed link probes. - repeated LinkProbeFailureReasonCount failure_reason_counts = 8; - - // Counts the number of link probes for each experiment. - repeated ExperimentProbeCounts experiment_probe_counts = 9; -} - -// Stores the decisions that were made by a experiment when compared against another experiment -message NetworkSelectionExperimentDecisions { - // the id of one experiment - optional int32 experiment1_id = 1; - - // the id of the other experiment - optional int32 experiment2_id = 2; - - // Counts occurrences of the number of network choices there were when experiment1 makes the - // same network selection as experiment2. - // The keys are the number of network choices, and the values are the number of occurrences of - // this number of network choices when exp1 and exp2 make the same network selection. - repeated Int32Count same_selection_num_choices_counter = 3; - - // Counts occurrences of the number of network choices there were when experiment1 makes the - // same network selection as experiment2. - // The keys are the number of network choices, and the values are the number of occurrences of - // this number of network choices when exp1 and exp2 make different network selections. - // Note that it is possible for the network selection to be different even when there only exists - // a single network choice, since choosing not to connect to that network is a valid choice. - repeated Int32Count different_selection_num_choices_counter = 4; -} - -// NetworkRequest API metrics. -message WifiNetworkRequestApiLog { - // Number of requests via this API surface. - optional int32 num_request = 1; - - // Histogram of requests via this API surface to number of networks matched in scan results. - repeated HistogramBucketInt32 network_match_size_histogram = 2; - - // Number of successful network connection from this API. - optional int32 num_connect_success = 3; - - // Number of requests via this API surface that bypassed user approval. - optional int32 num_user_approval_bypass = 4; - - // Number of requests via this API surface that was rejected by the user. - optional int32 num_user_reject = 5; - - // Number of unique apps using this API surface. - optional int32 num_apps = 6; -} - -// NetworkSuggestion API metrics. -message WifiNetworkSuggestionApiLog { - // Number of modifications to their suggestions by apps. - optional int32 num_modification = 1; - - // Number of successful network connection from app suggestions. - optional int32 num_connect_success = 2; - - // Number of network connection failures from app suggestions. - optional int32 num_connect_failure = 3; - - // Histogram for size of the network lists provided by various apps on the device. - repeated HistogramBucketInt32 network_list_size_histogram = 4; -} - -// WifiLock metrics -message WifiLockStats { - // Amount of time wifi is actively in HIGH_PERF mode (ms) - // This means the lock takes effect and the device takes the actions required for this mode - optional int64 high_perf_active_time_ms = 1; - - // Amount of time wifi is actively in LOW_LATENCY mode (ms) - // This means the lock takes effect and the device takes the actions required for this mode - optional int64 low_latency_active_time_ms = 2; - - // Histogram of HIGH_PERF lock acquisition duration (seconds) - // Note that acquiring the lock does not necessarily mean that device is actively in that mode - repeated HistogramBucketInt32 high_perf_lock_acq_duration_sec_histogram = 3; - - // Histogram of LOW_LATENCY lock acquisition duration (seconds) - // Note that acquiring the lock does not necessarily mean that device is actively in that mode - repeated HistogramBucketInt32 low_latency_lock_acq_duration_sec_histogram = 4; - - // Histogram of HIGH_PERF active session duration (seconds) - // This means the lock takes effect and the device takes the actions required for this mode - repeated HistogramBucketInt32 high_perf_active_session_duration_sec_histogram = 5; - - // Histogram of LOW_LATENCY active session duration (seconds) - // This means the lock takes effect and the device takes the actions required for this mode - repeated HistogramBucketInt32 low_latency_active_session_duration_sec_histogram = 6; -} - -// Stats on number of times Wi-Fi is turned on/off though the WifiManager#setWifiEnabled API -message WifiToggleStats { - // Number of time Wi-Fi is turned on by privileged apps - optional int32 num_toggle_on_privileged = 1; - - // Number of time Wi-Fi is turned off by privileged apps - optional int32 num_toggle_off_privileged = 2; - - // Number of time Wi-Fi is turned on by normal apps - optional int32 num_toggle_on_normal = 3; - - // Number of time Wi-Fi is turned off by normal apps - optional int32 num_toggle_off_normal = 4; -} - -// Information about the Passpoint provision metrics. -message PasspointProvisionStats { - enum ProvisionFailureCode { - // provisioning failure for unknown reason. - OSU_FAILURE_UNKNOWN = 0; - - // The reason code for Provisioning Failure due to connection failure to OSU AP. - OSU_FAILURE_AP_CONNECTION = 1; - - // The reason code for invalid server URL address. - OSU_FAILURE_SERVER_URL_INVALID = 2; - - // The reason code for provisioning failure due to connection failure to the server. - OSU_FAILURE_SERVER_CONNECTION = 3; - - // The reason code for provisioning failure due to invalid server certificate. - OSU_FAILURE_SERVER_VALIDATION = 4; - - // The reason code for provisioning failure due to invalid service provider. - OSU_FAILURE_SERVICE_PROVIDER_VERIFICATION = 5; - - // The reason code for provisioning failure when a provisioning flow is aborted. - OSU_FAILURE_PROVISIONING_ABORTED = 6; - - // The reason code for provisioning failure when a provisioning flow is not possible. - OSU_FAILURE_PROVISIONING_NOT_AVAILABLE = 7; - - // The reason code for provisioning failure due to invalid web url format for an OSU web page. - OSU_FAILURE_INVALID_URL_FORMAT_FOR_OSU = 8; - - // The reason code for provisioning failure when a command received is not the expected command - // type. - OSU_FAILURE_UNEXPECTED_COMMAND_TYPE = 9; - - // The reason code for provisioning failure when a SOAP message is not the expected message - // type. - OSU_FAILURE_UNEXPECTED_SOAP_MESSAGE_TYPE = 10; - - // The reason code for provisioning failure when a SOAP message exchange fails. - OSU_FAILURE_SOAP_MESSAGE_EXCHANGE = 11; - - // The reason code for provisioning failure when a redirect listener fails to start. - OSU_FAILURE_START_REDIRECT_LISTENER = 12; - - // The reason code for provisioning failure when a redirect listener timed out to receive a HTTP - // redirect response. - OSU_FAILURE_TIMED_OUT_REDIRECT_LISTENER = 13; - - // The reason code for provisioning failure when there is no OSU activity to listen to intent. - OSU_FAILURE_NO_OSU_ACTIVITY_FOUND = 14; - - // The reason code for provisioning failure when the status of a SOAP message is not the - // expected message status. - OSU_FAILURE_UNEXPECTED_SOAP_MESSAGE_STATUS = 15; - - // The reason code for provisioning failure when there is no PPS MO. - OSU_FAILURE_NO_PPS_MO = 16; - - // The reason code for provisioning failure when there is no AAAServerTrustRoot node in a PPS - // MO. - OSU_FAILURE_NO_AAA_SERVER_TRUST_ROOT_NODE = 17; - - // The reason code for provisioning failure when there is no TrustRoot node for remediation - // server in a PPS MO. - OSU_FAILURE_NO_REMEDIATION_SERVER_TRUST_ROOT_NODE = 18; - - // The reason code for provisioning failure when there is no TrustRoot node for policy server in - // a PPS MO. - OSU_FAILURE_NO_POLICY_SERVER_TRUST_ROOT_NODE = 19; - - // The reason code for provisioning failure when failing to retrieve trust root certificates - // used for validating server certificate for AAA, Remediation and Policy server. - OSU_FAILURE_RETRIEVE_TRUST_ROOT_CERTIFICATES = 20; - - // The reason code for provisioning failure when there is no trust root certificate for AAA - // server. - OSU_FAILURE_NO_AAA_TRUST_ROOT_CERTIFICATE = 21; - - // The reason code for provisioning failure when a {@link PasspointConfiguration} is failed to - // install. - OSU_FAILURE_ADD_PASSPOINT_CONFIGURATION = 22; - - // The reason code for provisioning failure when an {@link OsuProvider} is not found for - // provisioning. - OSU_FAILURE_OSU_PROVIDER_NOT_FOUND = 23; - } - - // Number of passpoint provisioning success - optional int32 num_provision_success = 1; - - // Count for passpoint provisioning failure - repeated ProvisionFailureCount provision_failure_count = 2; - - // Number of occurrences of a specific passpoint provision failure code - message ProvisionFailureCount { - // Failure code - optional ProvisionFailureCode failure_code = 1; - - // Number of failure for the failure_code. - optional int32 count = 2; - } -} |