Glen Kuhne | 9481457 | 2016-10-25 12:40:35 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2016 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | syntax = "proto2"; |
| 18 | |
| 19 | package clearcut.connectivity; |
| 20 | |
| 21 | option java_package = "com.android.server.wifi"; |
| 22 | option java_outer_classname = "WifiMetricsProto"; |
| 23 | |
| 24 | // The information about the Wifi events. |
| 25 | message WifiLog { |
| 26 | |
| 27 | // Session information that gets logged for every Wifi connection. |
| 28 | repeated ConnectionEvent connection_event = 1; |
| 29 | |
| 30 | // Number of saved networks in the user profile. |
| 31 | optional int32 num_saved_networks = 2; |
| 32 | |
| 33 | // Number of open networks in the saved networks. |
| 34 | optional int32 num_open_networks = 3; |
| 35 | |
| 36 | // Number of personal networks. |
| 37 | optional int32 num_personal_networks = 4; |
| 38 | |
| 39 | // Number of enterprise networks. |
| 40 | optional int32 num_enterprise_networks = 5; |
| 41 | |
| 42 | // Does the user have location setting enabled. |
| 43 | optional bool is_location_enabled = 6; |
| 44 | |
| 45 | // Does the user have scanning enabled. |
| 46 | optional bool is_scanning_always_enabled = 7; |
| 47 | |
| 48 | // Number of times user toggled wifi using the settings menu. |
| 49 | optional int32 num_wifi_toggled_via_settings = 8; |
| 50 | |
| 51 | // Number of times user toggled wifi using the airplane menu. |
| 52 | optional int32 num_wifi_toggled_via_airplane = 9; |
| 53 | |
| 54 | // Number of networks added by the user. |
| 55 | optional int32 num_networks_added_by_user = 10; |
| 56 | |
| 57 | // Number of networks added by applications. |
| 58 | optional int32 num_networks_added_by_apps = 11; |
| 59 | |
| 60 | // Number scans that returned empty results. |
| 61 | optional int32 num_empty_scan_results = 12; |
| 62 | |
| 63 | // Number scans that returned at least one result. |
| 64 | optional int32 num_non_empty_scan_results = 13; |
| 65 | |
| 66 | // Number of scans that were one time. |
| 67 | optional int32 num_oneshot_scans = 14; |
| 68 | |
| 69 | // Number of repeated background scans that were scheduled to the chip. |
| 70 | optional int32 num_background_scans = 15; |
| 71 | |
| 72 | // Error codes that a scan can result in. |
| 73 | enum ScanReturnCode { |
| 74 | |
| 75 | // Return Code is unknown. |
| 76 | SCAN_UNKNOWN = 0; |
| 77 | |
| 78 | // Scan was successful. |
| 79 | SCAN_SUCCESS = 1; |
| 80 | |
| 81 | // Scan was successfully started, but was interrupted. |
| 82 | SCAN_FAILURE_INTERRUPTED = 2; |
| 83 | |
| 84 | // Scan failed to start because of invalid configuration |
| 85 | // (bad channel, etc). |
| 86 | SCAN_FAILURE_INVALID_CONFIGURATION = 3; |
| 87 | |
| 88 | // Could not start a scan because wifi is disabled. |
| 89 | FAILURE_WIFI_DISABLED = 4; |
| 90 | |
| 91 | } |
| 92 | |
| 93 | // Mapping of error codes to the number of times that scans resulted |
| 94 | // in that error. |
| 95 | repeated ScanReturnEntry scan_return_entries = 16; |
| 96 | |
| 97 | message ScanReturnEntry { |
| 98 | |
| 99 | // Return code of the scan. |
| 100 | optional ScanReturnCode scan_return_code = 1; |
| 101 | |
| 102 | // Number of entries that were found in the scan. |
| 103 | optional int32 scan_results_count = 2; |
| 104 | } |
| 105 | |
| 106 | // State of the Wifi. |
| 107 | enum WifiState { |
| 108 | |
| 109 | // State is unknown. |
| 110 | WIFI_UNKNOWN = 0; |
| 111 | |
| 112 | // Wifi is disabled. |
| 113 | WIFI_DISABLED = 1; |
| 114 | |
| 115 | // Wifi is enabled. |
| 116 | WIFI_DISCONNECTED = 2; |
| 117 | |
| 118 | // Wifi is enabled and associated with an AP. |
| 119 | WIFI_ASSOCIATED = 3; |
| 120 | } |
| 121 | |
| 122 | // Mapping of system state to the number of times that scans were requested in |
| 123 | // that state |
| 124 | repeated WifiSystemStateEntry wifi_system_state_entries = 17; |
| 125 | |
| 126 | message WifiSystemStateEntry { |
| 127 | |
| 128 | // Current WiFi state. |
| 129 | optional WifiState wifi_state = 1; |
| 130 | |
| 131 | // Count of scans in state. |
| 132 | optional int32 wifi_state_count = 2; |
| 133 | |
| 134 | // Is screen on. |
| 135 | optional bool is_screen_on = 3; |
| 136 | } |
| 137 | |
| 138 | // Mapping of Error/Success codes to the number of background scans that resulted in it |
| 139 | repeated ScanReturnEntry background_scan_return_entries = 18; |
| 140 | |
| 141 | // Mapping of system state to the number of times that Background scans were requested in that |
| 142 | // state |
| 143 | repeated WifiSystemStateEntry background_scan_request_state = 19; |
| 144 | |
| 145 | // Total number of times the Watchdog of Last Resort triggered, resetting the wifi stack |
| 146 | optional int32 num_last_resort_watchdog_triggers = 20; |
| 147 | |
| 148 | // Total number of networks over bad association threshold when watchdog triggered |
| 149 | optional int32 num_last_resort_watchdog_bad_association_networks_total = 21; |
| 150 | |
| 151 | // Total number of networks over bad authentication threshold when watchdog triggered |
| 152 | optional int32 num_last_resort_watchdog_bad_authentication_networks_total = 22; |
| 153 | |
| 154 | // Total number of networks over bad dhcp threshold when watchdog triggered |
| 155 | optional int32 num_last_resort_watchdog_bad_dhcp_networks_total = 23; |
| 156 | |
| 157 | // Total number of networks over bad other threshold when watchdog triggered |
| 158 | optional int32 num_last_resort_watchdog_bad_other_networks_total = 24; |
| 159 | |
| 160 | // Total count of networks seen when watchdog triggered |
| 161 | optional int32 num_last_resort_watchdog_available_networks_total = 25; |
| 162 | |
| 163 | // Total count of triggers with atleast one bad association network |
| 164 | optional int32 num_last_resort_watchdog_triggers_with_bad_association = 26; |
| 165 | |
| 166 | // Total count of triggers with atleast one bad authentication network |
| 167 | optional int32 num_last_resort_watchdog_triggers_with_bad_authentication = 27; |
| 168 | |
| 169 | // Total count of triggers with atleast one bad dhcp network |
| 170 | optional int32 num_last_resort_watchdog_triggers_with_bad_dhcp = 28; |
| 171 | |
| 172 | // Total count of triggers with atleast one bad other network |
| 173 | optional int32 num_last_resort_watchdog_triggers_with_bad_other = 29; |
| 174 | |
| 175 | // Count of times connectivity watchdog confirmed pno is working |
| 176 | optional int32 num_connectivity_watchdog_pno_good = 30; |
| 177 | |
| 178 | // Count of times connectivity watchdog found pno not working |
| 179 | optional int32 num_connectivity_watchdog_pno_bad = 31; |
| 180 | |
| 181 | // Count of times connectivity watchdog confirmed background scan is working |
| 182 | optional int32 num_connectivity_watchdog_background_good = 32; |
| 183 | |
| 184 | // Count of times connectivity watchdog found background scan not working |
| 185 | optional int32 num_connectivity_watchdog_background_bad = 33; |
| 186 | |
| 187 | // The time duration represented by this wifi log, from start to end of capture |
| 188 | optional int32 record_duration_sec = 34; |
| 189 | |
| 190 | // Counts the occurrences of each individual RSSI poll level |
| 191 | repeated RssiPollCount rssi_poll_rssi_count = 35; |
| 192 | |
| 193 | // Total number of times WiFi connected immediately after a Last Resort Watchdog trigger, |
| 194 | // without new networks becoming available. |
| 195 | optional int32 num_last_resort_watchdog_successes = 36; |
| 196 | |
| 197 | // Total number of saved hidden networks |
| 198 | optional int32 num_hidden_networks = 37; |
| 199 | |
| 200 | // Total number of saved passpoint / hotspot 2.0 networks |
| 201 | optional int32 num_passpoint_networks = 38; |
| 202 | |
| 203 | // Total number of scan results |
| 204 | optional int32 num_total_scan_results = 39; |
| 205 | |
| 206 | // Total number of scan results for open networks |
| 207 | optional int32 num_open_network_scan_results = 40; |
| 208 | |
| 209 | // Total number of scan results for personal networks |
| 210 | optional int32 num_personal_network_scan_results = 41; |
| 211 | |
| 212 | // Total number of scan results for enterprise networks |
| 213 | optional int32 num_enterprise_network_scan_results = 42; |
| 214 | |
| 215 | // Total number of scan results for hidden networks |
| 216 | optional int32 num_hidden_network_scan_results = 43; |
| 217 | |
| 218 | // Total number of scan results for hotspot 2.0 r1 networks |
| 219 | optional int32 num_hotspot2_r1_network_scan_results = 44; |
| 220 | |
| 221 | // Total number of scan results for hotspot 2.0 r2 networks |
| 222 | optional int32 num_hotspot2_r2_network_scan_results = 45; |
| 223 | |
| 224 | // Total number of scans handled by framework (oneshot or otherwise) |
| 225 | optional int32 num_scans = 46; |
| 226 | |
| 227 | // Counts the occurrences of each alert reason. |
| 228 | repeated AlertReasonCount alert_reason_count = 47; |
| 229 | |
| 230 | // Counts the occurrences of each Wifi score |
| 231 | repeated WifiScoreCount wifi_score_count = 48; |
| 232 | |
| 233 | // Histogram of Soft AP Durations |
| 234 | repeated SoftApDurationBucket soft_ap_duration = 49; |
| 235 | |
| 236 | // Histogram of Soft AP ReturnCode |
| 237 | repeated SoftApReturnCodeCount soft_ap_return_code = 50; |
| 238 | |
| 239 | // Histogram of the delta between scan result RSSI and RSSI polls |
| 240 | repeated RssiPollCount rssi_poll_delta_count = 51; |
Glen Kuhne | 8ce9a1c | 2017-03-28 14:02:48 -0700 | [diff] [blame] | 241 | |
| 242 | // List of events |
| 243 | repeated StaEvent sta_event_list = 52; |
Roshan Pius | 3607a39 | 2017-05-11 09:05:58 -0700 | [diff] [blame] | 244 | |
| 245 | // Total number of times WiFi HAL crashed. |
| 246 | optional int32 num_hal_crashes = 53; |
| 247 | |
| 248 | // Total number of times WiFicond crashed. |
| 249 | optional int32 num_wificond_crashes = 54; |
| 250 | |
| 251 | // Indicates the number of times an error was encountered in |
| 252 | // Wifi HAL when wifi was turned on. |
| 253 | optional int32 num_wifi_on_failure_due_to_hal = 55; |
| 254 | |
| 255 | // Indicates the number of times an error was encountered in |
| 256 | // Wificond when wifi was turned on. |
| 257 | optional int32 num_wifi_on_failure_due_to_wificond = 56; |
Etan Cohen | 737addc | 2017-04-26 08:01:57 -0700 | [diff] [blame] | 258 | |
| 259 | // Wi-Fi Aware metrics |
| 260 | optional WifiAwareLog wifi_aware_log = 57; |
Glen Kuhne | 9481457 | 2016-10-25 12:40:35 -0700 | [diff] [blame] | 261 | } |
| 262 | |
| 263 | // Information that gets logged for every WiFi connection. |
| 264 | message RouterFingerPrint { |
| 265 | |
| 266 | enum RoamType { |
| 267 | |
| 268 | // Type is unknown. |
| 269 | ROAM_TYPE_UNKNOWN = 0; |
| 270 | |
| 271 | // No roaming - usually happens on a single band (2.4 GHz) router. |
| 272 | ROAM_TYPE_NONE = 1; |
| 273 | |
| 274 | // Enterprise router. |
| 275 | ROAM_TYPE_ENTERPRISE = 2; |
| 276 | |
| 277 | // DBDC => Dual Band Dual Concurrent essentially a router that |
| 278 | // supports both 2.4 GHz and 5 GHz bands. |
| 279 | ROAM_TYPE_DBDC = 3; |
| 280 | } |
| 281 | |
| 282 | enum Auth { |
| 283 | |
| 284 | // Auth is unknown. |
| 285 | AUTH_UNKNOWN = 0; |
| 286 | |
| 287 | // No authentication. |
| 288 | AUTH_OPEN = 1; |
| 289 | |
| 290 | // If the router uses a personal authentication. |
| 291 | AUTH_PERSONAL = 2; |
| 292 | |
| 293 | // If the router is setup for enterprise authentication. |
| 294 | AUTH_ENTERPRISE = 3; |
| 295 | } |
| 296 | |
| 297 | enum RouterTechnology { |
| 298 | |
| 299 | // Router is unknown. |
| 300 | ROUTER_TECH_UNKNOWN = 0; |
| 301 | |
| 302 | // Router Channel A. |
| 303 | ROUTER_TECH_A = 1; |
| 304 | |
| 305 | // Router Channel B. |
| 306 | ROUTER_TECH_B = 2; |
| 307 | |
| 308 | // Router Channel G. |
| 309 | ROUTER_TECH_G = 3; |
| 310 | |
| 311 | // Router Channel N. |
| 312 | ROUTER_TECH_N = 4; |
| 313 | |
| 314 | // Router Channel AC. |
| 315 | ROUTER_TECH_AC = 5; |
| 316 | |
| 317 | // When the channel is not one of the above. |
| 318 | ROUTER_TECH_OTHER = 6; |
| 319 | } |
| 320 | |
| 321 | optional RoamType roam_type = 1; |
| 322 | |
| 323 | // Channel on which the connection takes place. |
| 324 | optional int32 channel_info = 2; |
| 325 | |
| 326 | // DTIM setting of the router. |
| 327 | optional int32 dtim = 3; |
| 328 | |
| 329 | // Authentication scheme of the router. |
| 330 | optional Auth authentication = 4; |
| 331 | |
| 332 | // If the router is hidden. |
| 333 | optional bool hidden = 5; |
| 334 | |
| 335 | // Channel information. |
| 336 | optional RouterTechnology router_technology = 6; |
| 337 | |
| 338 | // whether ipv6 is supported. |
| 339 | optional bool supports_ipv6 = 7; |
| 340 | |
| 341 | // If the router is a passpoint / hotspot 2.0 network |
| 342 | optional bool passpoint = 8; |
| 343 | } |
| 344 | |
| 345 | message ConnectionEvent { |
| 346 | |
| 347 | // Roam Type. |
| 348 | enum RoamType { |
| 349 | |
| 350 | // Type is unknown. |
| 351 | ROAM_UNKNOWN = 0; |
| 352 | |
| 353 | // No roaming. |
| 354 | ROAM_NONE = 1; |
| 355 | |
| 356 | // DBDC roaming. |
| 357 | ROAM_DBDC = 2; |
| 358 | |
| 359 | // Enterprise roaming. |
| 360 | ROAM_ENTERPRISE = 3; |
| 361 | |
| 362 | // User selected roaming. |
| 363 | ROAM_USER_SELECTED = 4; |
| 364 | |
| 365 | // Unrelated. |
| 366 | ROAM_UNRELATED = 5; |
| 367 | } |
| 368 | |
| 369 | // Connectivity Level Failure. |
| 370 | enum ConnectivityLevelFailure { |
| 371 | |
| 372 | // Failure is unknown. |
| 373 | HLF_UNKNOWN = 0; |
| 374 | |
| 375 | // No failure. |
| 376 | HLF_NONE = 1; |
| 377 | |
| 378 | // DHCP failure. |
| 379 | HLF_DHCP = 2; |
| 380 | |
| 381 | // No internet connection. |
| 382 | HLF_NO_INTERNET = 3; |
| 383 | |
| 384 | // No internet connection. |
| 385 | HLF_UNWANTED = 4; |
| 386 | } |
| 387 | |
| 388 | // Start time of the connection. |
| 389 | optional int64 start_time_millis = 1;// [(datapol.semantic_type) = ST_TIMESTAMP]; |
| 390 | |
| 391 | // Duration to connect. |
| 392 | optional int32 duration_taken_to_connect_millis = 2; |
| 393 | |
| 394 | // Router information. |
| 395 | optional RouterFingerPrint router_fingerprint = 3; |
| 396 | |
| 397 | // RSSI at the start of the connection. |
| 398 | optional int32 signal_strength = 4; |
| 399 | |
| 400 | // Roam Type. |
| 401 | optional RoamType roam_type = 5; |
| 402 | |
| 403 | // Result of the connection. |
| 404 | optional int32 connection_result = 6; |
| 405 | |
| 406 | // Reasons for level 2 failure (needs to be coordinated with wpa-supplicant). |
| 407 | optional int32 level_2_failure_code = 7; |
| 408 | |
| 409 | // Failures that happen at the connectivity layer. |
| 410 | optional ConnectivityLevelFailure connectivity_level_failure_code = 8; |
| 411 | |
| 412 | // Has bug report been taken. |
| 413 | optional bool automatic_bug_report_taken = 9; |
| 414 | } |
| 415 | |
| 416 | // Number of occurrences of a specific RSSI poll rssi value |
| 417 | message RssiPollCount { |
| 418 | // RSSI |
| 419 | optional int32 rssi = 1; |
| 420 | |
| 421 | // Number of RSSI polls with 'rssi' |
| 422 | optional int32 count = 2; |
| 423 | } |
| 424 | |
| 425 | // Number of occurrences of a specific alert reason value |
| 426 | message AlertReasonCount { |
| 427 | // Alert reason |
| 428 | optional int32 reason = 1; |
| 429 | |
| 430 | // Number of alerts with |reason|. |
| 431 | optional int32 count = 2; |
| 432 | } |
| 433 | |
| 434 | // Counts the number of instances of a specific Wifi Score calculated by WifiScoreReport |
| 435 | message WifiScoreCount { |
| 436 | // Wifi Score |
| 437 | optional int32 score = 1; |
| 438 | |
| 439 | // Number of Wifi score reports with this score |
| 440 | optional int32 count = 2; |
| 441 | } |
| 442 | |
| 443 | // Number of occurrences of Soft AP session durations |
| 444 | message SoftApDurationBucket { |
| 445 | // Bucket covers duration : [duration_sec, duration_sec + bucket_size_sec) |
| 446 | // The (inclusive) lower bound of Soft AP session duration represented by this bucket |
| 447 | optional int32 duration_sec = 1; |
| 448 | |
| 449 | // The size of this bucket |
| 450 | optional int32 bucket_size_sec = 2; |
| 451 | |
| 452 | // Number of soft AP session durations that fit into this bucket |
| 453 | optional int32 count = 3; |
| 454 | } |
| 455 | |
| 456 | // Number of occurrences of a soft AP session return code |
| 457 | message SoftApReturnCodeCount { |
Rebecca Silberstein | 28d9de2 | 2017-01-24 10:42:59 -0800 | [diff] [blame] | 458 | |
| 459 | enum SoftApStartResult { |
| 460 | |
| 461 | // SoftApManager return code unknown |
| 462 | SOFT_AP_RETURN_CODE_UNKNOWN = 0; |
| 463 | |
| 464 | // SoftAp started successfully |
| 465 | SOFT_AP_STARTED_SUCCESSFULLY = 1; |
| 466 | |
| 467 | // Catch all for failures with no specific failure reason |
| 468 | SOFT_AP_FAILED_GENERAL_ERROR = 2; |
| 469 | |
| 470 | // SoftAp failed to start due to NO_CHANNEL error |
| 471 | SOFT_AP_FAILED_NO_CHANNEL = 3; |
| 472 | } |
| 473 | |
| 474 | // Historical, no longer used for writing as of 01/2017. |
| 475 | optional int32 return_code = 1 [deprecated = true]; |
Glen Kuhne | 9481457 | 2016-10-25 12:40:35 -0700 | [diff] [blame] | 476 | |
| 477 | // Occurrences of this soft AP return code |
| 478 | optional int32 count = 2; |
Rebecca Silberstein | 28d9de2 | 2017-01-24 10:42:59 -0800 | [diff] [blame] | 479 | |
| 480 | // Result of attempt to start SoftAp |
| 481 | optional SoftApStartResult start_result = 3; |
Glen Kuhne | 9481457 | 2016-10-25 12:40:35 -0700 | [diff] [blame] | 482 | } |
Glen Kuhne | 8ce9a1c | 2017-03-28 14:02:48 -0700 | [diff] [blame] | 483 | |
| 484 | message StaEvent { |
| 485 | message ConfigInfo { |
| 486 | // The set of key management protocols supported by this configuration. |
| 487 | optional uint32 allowed_key_management = 1 [default = 0]; |
| 488 | |
| 489 | // The set of security protocols supported by this configuration. |
| 490 | optional uint32 allowed_protocols = 2 [default = 0]; |
| 491 | |
| 492 | // The set of authentication protocols supported by this configuration. |
| 493 | optional uint32 allowed_auth_algorithms = 3 [default = 0]; |
| 494 | |
| 495 | // The set of pairwise ciphers for WPA supported by this configuration. |
| 496 | optional uint32 allowed_pairwise_ciphers = 4 [default = 0]; |
| 497 | |
| 498 | // The set of group ciphers supported by this configuration. |
| 499 | optional uint32 allowed_group_ciphers = 5; |
| 500 | |
| 501 | // Is this a 'hidden network' |
| 502 | optional bool hidden_ssid = 6; |
| 503 | |
| 504 | // Is this a Hotspot 2.0 / passpoint network |
| 505 | optional bool is_passpoint = 7; |
| 506 | |
| 507 | // Is this an 'ephemeral' network (Not in saved network list, recommended externally) |
| 508 | optional bool is_ephemeral = 8; |
| 509 | |
| 510 | // Has a successful connection ever been established using this WifiConfiguration |
| 511 | optional bool has_ever_connected = 9; |
| 512 | |
| 513 | // RSSI of the scan result candidate associated with this WifiConfiguration |
| 514 | optional int32 scan_rssi = 10 [default = -127]; |
| 515 | |
| 516 | // Frequency of the scan result candidate associated with this WifiConfiguration |
| 517 | optional int32 scan_freq = 11 [default = -1]; |
| 518 | } |
| 519 | |
| 520 | enum EventType { |
| 521 | // Default/Invalid event |
| 522 | TYPE_UNKNOWN = 0; |
| 523 | |
| 524 | // Supplicant Association Rejection event. Code contains the 802.11 |
| 525 | TYPE_ASSOCIATION_REJECTION_EVENT = 1; |
| 526 | |
| 527 | // Supplicant L2 event, |
| 528 | TYPE_AUTHENTICATION_FAILURE_EVENT = 2; |
| 529 | |
| 530 | // Supplicant L2 event |
| 531 | TYPE_NETWORK_CONNECTION_EVENT = 3; |
| 532 | |
| 533 | // Supplicant L2 event |
| 534 | TYPE_NETWORK_DISCONNECTION_EVENT = 4; |
| 535 | |
| 536 | // Supplicant L2 event |
| 537 | TYPE_SUPPLICANT_STATE_CHANGE_EVENT = 5; |
| 538 | |
| 539 | // Supplicant L2 event |
| 540 | TYPE_CMD_ASSOCIATED_BSSID = 6; |
| 541 | |
| 542 | // IP Manager successfully completed IP Provisioning |
| 543 | TYPE_CMD_IP_CONFIGURATION_SUCCESSFUL = 7; |
| 544 | |
| 545 | // IP Manager failed to complete IP Provisioning |
| 546 | TYPE_CMD_IP_CONFIGURATION_LOST = 8; |
| 547 | |
| 548 | // IP Manager lost reachability to network neighbors |
| 549 | TYPE_CMD_IP_REACHABILITY_LOST = 9; |
| 550 | |
| 551 | // Indicator that Supplicant is targeting a BSSID for roam/connection |
| 552 | TYPE_CMD_TARGET_BSSID = 10; |
| 553 | |
| 554 | // Wifi framework is initiating a connection attempt |
| 555 | TYPE_CMD_START_CONNECT = 11; |
| 556 | |
| 557 | // Wifi framework is initiating a roaming connection attempt |
| 558 | TYPE_CMD_START_ROAM = 12; |
| 559 | |
| 560 | // SystemAPI connect() command, Settings App |
| 561 | TYPE_CONNECT_NETWORK = 13; |
| 562 | |
| 563 | // Network Agent has validated the internet connection (Captive Portal Check success, or user |
| 564 | // validation) |
| 565 | TYPE_NETWORK_AGENT_VALID_NETWORK = 14; |
| 566 | |
| 567 | // Framework initiated disconnect. Sometimes generated to give an extra reason for a disconnect |
| 568 | // Should typically be followed by a NETWORK_DISCONNECTION_EVENT with a local_gen = true |
| 569 | TYPE_FRAMEWORK_DISCONNECT = 15; |
| 570 | } |
| 571 | |
| 572 | enum FrameworkDisconnectReason { |
| 573 | // default/none/unknown value |
| 574 | DISCONNECT_UNKNOWN = 0; |
| 575 | |
| 576 | // API DISCONNECT |
| 577 | DISCONNECT_API = 1; |
| 578 | |
| 579 | // Some framework internal reason (generic) |
| 580 | DISCONNECT_GENERIC = 2; |
| 581 | |
| 582 | // Network Agent network validation failed, user signaled network unwanted |
| 583 | DISCONNECT_UNWANTED = 3; |
| 584 | |
| 585 | // Roaming timed out |
| 586 | DISCONNECT_ROAM_WATCHDOG_TIMER = 4; |
| 587 | |
| 588 | // P2P service requested wifi disconnect |
| 589 | DISCONNECT_P2P_DISCONNECT_WIFI_REQUEST = 5; |
| 590 | |
| 591 | // SIM was removed while using a SIM config |
| 592 | DISCONNECT_RESET_SIM_NETWORKS = 6; |
| 593 | } |
| 594 | |
| 595 | // Authentication Failure reasons as reported through the API. |
| 596 | enum AuthFailureReason { |
| 597 | // Unknown default |
| 598 | AUTH_FAILURE_UNKNOWN = 0; |
| 599 | |
| 600 | // The reason code if there is no error during authentication. It could also imply that there no |
| 601 | // authentication in progress, |
| 602 | AUTH_FAILURE_NONE = 1; |
| 603 | |
| 604 | // The reason code if there was a timeout authenticating. |
| 605 | AUTH_FAILURE_TIMEOUT = 2; |
| 606 | |
| 607 | // The reason code if there was a wrong password while authenticating. |
| 608 | AUTH_FAILURE_WRONG_PSWD = 3; |
| 609 | |
| 610 | // The reason code if there was EAP failure while authenticating. |
| 611 | AUTH_FAILURE_EAP_FAILURE = 4; |
| 612 | } |
| 613 | |
| 614 | // What event was this |
| 615 | optional EventType type = 1; |
| 616 | |
| 617 | // 80211 death reason code, relevant to NETWORK_DISCONNECTION_EVENTs |
| 618 | optional int32 reason = 2 [default = -1]; |
| 619 | |
| 620 | // 80211 Association Status code, relevant to ASSOCIATION_REJECTION_EVENTs |
| 621 | optional int32 status = 3 [default = -1]; |
| 622 | |
| 623 | // Designates whether a NETWORK_DISCONNECT_EVENT was by the STA or AP |
| 624 | optional bool local_gen = 4 [default = false]; |
| 625 | |
| 626 | // Network information from the WifiConfiguration of a framework initiated connection attempt |
| 627 | optional ConfigInfo config_info = 5; |
| 628 | |
| 629 | // RSSI from the last rssi poll (Only valid for active connections) |
| 630 | optional int32 last_rssi = 6 [default = -127]; |
| 631 | |
| 632 | // Link speed from the last rssi poll (Only valid for active connections) |
| 633 | optional int32 last_link_speed = 7 [default = -1]; |
| 634 | |
| 635 | // Frequency from the last rssi poll (Only valid for active connections) |
| 636 | optional int32 last_freq = 8 [default = -1]; |
| 637 | |
| 638 | // Enum used to define bit positions in the supplicant_state_change_bitmask |
| 639 | // See {@code frameworks/base/wifi/java/android/net/wifi/SupplicantState.java} for documentation |
| 640 | enum SupplicantState { |
| 641 | STATE_DISCONNECTED = 0; |
| 642 | |
| 643 | STATE_INTERFACE_DISABLED = 1; |
| 644 | |
| 645 | STATE_INACTIVE = 2; |
| 646 | |
| 647 | STATE_SCANNING = 3; |
| 648 | |
| 649 | STATE_AUTHENTICATING = 4; |
| 650 | |
| 651 | STATE_ASSOCIATING = 5; |
| 652 | |
| 653 | STATE_ASSOCIATED = 6; |
| 654 | |
| 655 | STATE_FOUR_WAY_HANDSHAKE = 7; |
| 656 | |
| 657 | STATE_GROUP_HANDSHAKE = 8; |
| 658 | |
| 659 | STATE_COMPLETED = 9; |
| 660 | |
| 661 | STATE_DORMANT = 10; |
| 662 | |
| 663 | STATE_UNINITIALIZED = 11; |
| 664 | |
| 665 | STATE_INVALID = 12; |
| 666 | } |
| 667 | |
| 668 | // Bit mask of all supplicant state changes that occured since the last event |
| 669 | optional uint32 supplicant_state_changes_bitmask = 9 [default = 0]; |
| 670 | |
| 671 | // The number of milliseconds that have elapsed since the device booted |
| 672 | optional int64 start_time_millis = 10 [default = 0]; |
| 673 | |
| 674 | optional FrameworkDisconnectReason framework_disconnect_reason = 11 [default = DISCONNECT_UNKNOWN]; |
| 675 | |
| 676 | // Flag which indicates if an association rejection event occured due to a timeout |
| 677 | optional bool association_timed_out = 12 [default = false]; |
| 678 | |
| 679 | // Authentication failure reason, as reported by WifiManager (calculated from state & deauth code) |
| 680 | optional AuthFailureReason auth_failure_reason = 13 [default = AUTH_FAILURE_UNKNOWN]; |
| 681 | } |
Etan Cohen | 737addc | 2017-04-26 08:01:57 -0700 | [diff] [blame] | 682 | |
| 683 | // Wi-Fi Aware metrics |
| 684 | message WifiAwareLog { |
| 685 | // total number of unique apps that used Aware (measured on attach) |
| 686 | optional int32 num_apps = 1; |
| 687 | |
| 688 | // total number of unique apps that used an identity callback when attaching |
| 689 | optional int32 num_apps_using_identity_callback = 2; |
| 690 | |
| 691 | // maximum number of attaches for an app |
| 692 | optional int32 max_concurrent_attach_sessions_in_app = 3; |
| 693 | |
| 694 | // histogram of attach request results |
| 695 | repeated NanStatusHistogramBucket histogram_attach_session_status = 4; |
| 696 | |
| 697 | // maximum number of concurrent publish sessions in a single app |
| 698 | optional int32 max_concurrent_publish_in_app = 5; |
| 699 | |
| 700 | // maximum number of concurrent subscribe sessions in a single app |
| 701 | optional int32 max_concurrent_subscribe_in_app = 6; |
| 702 | |
| 703 | // maximum number of concurrent discovery (publish+subscribe) sessions in a single app |
| 704 | optional int32 max_concurrent_discovery_sessions_in_app = 7; |
| 705 | |
| 706 | // maximum number of concurrent publish sessions in the system |
| 707 | optional int32 max_concurrent_publish_in_system = 8; |
| 708 | |
| 709 | // maximum number of concurrent subscribe sessions in the system |
| 710 | optional int32 max_concurrent_subscribe_in_system = 9; |
| 711 | |
| 712 | // maximum number of concurrent discovery (publish+subscribe) sessions in the system |
| 713 | optional int32 max_concurrent_discovery_sessions_in_system = 10; |
| 714 | |
| 715 | // histogram of publish request results |
| 716 | repeated NanStatusHistogramBucket histogram_publish_status = 11; |
| 717 | |
| 718 | // histogram of subscribe request results |
| 719 | repeated NanStatusHistogramBucket histogram_subscribe_status = 12; |
| 720 | |
| 721 | // number of unique apps which experienced a discovery session creation failure due to lack of |
| 722 | // resources |
| 723 | optional int32 num_apps_with_discovery_session_failure_out_of_resources = 13; |
| 724 | |
| 725 | // histogram of create ndp request results |
| 726 | repeated NanStatusHistogramBucket histogram_request_ndp_status = 14; |
| 727 | |
| 728 | // histogram of create ndp out-of-band (OOB) request results |
| 729 | repeated NanStatusHistogramBucket histogram_request_ndp_oob_status = 15; |
| 730 | |
| 731 | // maximum number of concurrent active data-interfaces (NDI) in a single app |
| 732 | optional int32 max_concurrent_ndi_in_app = 19; |
| 733 | |
| 734 | // maximum number of concurrent active data-interfaces (NDI) in the system |
| 735 | optional int32 max_concurrent_ndi_in_system = 20; |
| 736 | |
| 737 | // maximum number of concurrent data-paths (NDP) in a single app |
| 738 | optional int32 max_concurrent_ndp_in_app = 21; |
| 739 | |
| 740 | // maximum number of concurrent data-paths (NDP) in the system |
| 741 | optional int32 max_concurrent_ndp_in_system = 22; |
| 742 | |
| 743 | // maximum number of concurrent secure data-paths (NDP) in a single app |
| 744 | optional int32 max_concurrent_secure_ndp_in_app = 23; |
| 745 | |
| 746 | // maximum number of concurrent secure data-paths (NDP) in the system |
| 747 | optional int32 max_concurrent_secure_ndp_in_system = 24; |
| 748 | |
| 749 | // maximum number of concurrent data-paths (NDP) per data-interface (NDI) |
| 750 | optional int32 max_concurrent_ndp_per_ndi = 25; |
| 751 | |
| 752 | // histogram of durations of Aware being available |
| 753 | repeated HistogramBucket histogram_aware_available_duration_ms = 26; |
| 754 | |
| 755 | // histogram of durations of Aware being enabled |
| 756 | repeated HistogramBucket histogram_aware_enabled_duration_ms = 27; |
| 757 | |
| 758 | // histogram of duration (in ms) of attach sessions |
| 759 | repeated HistogramBucket histogram_attach_duration_ms = 28; |
| 760 | |
| 761 | // histogram of duration (in ms) of publish sessions |
| 762 | repeated HistogramBucket histogram_publish_session_duration_ms = 29; |
| 763 | |
| 764 | // histogram of duration (in ms) of subscribe sessions |
| 765 | repeated HistogramBucket histogram_subscribe_session_duration_ms = 30; |
| 766 | |
| 767 | // histogram of duration (in ms) of data-paths (NDP) |
| 768 | repeated HistogramBucket histogram_ndp_session_duration_ms = 31; |
| 769 | |
| 770 | // histogram of usage (in MB) of data-paths (NDP) |
| 771 | repeated HistogramBucket histogram_ndp_session_data_usage_mb = 32; |
| 772 | |
| 773 | // histogram of usage (in MB) of data-path creation time (in ms) measured as request -> confirm |
| 774 | repeated HistogramBucket histogram_ndp_creation_time_ms = 33; |
| 775 | |
| 776 | // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: minimum |
| 777 | optional int64 ndp_creation_time_ms_min = 34; |
| 778 | |
| 779 | // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: maximum |
| 780 | optional int64 ndp_creation_time_ms_max = 35; |
| 781 | |
| 782 | // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum |
| 783 | optional int64 ndp_creation_time_ms_sum = 36; |
| 784 | |
| 785 | // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: sum of sq |
| 786 | optional int64 ndp_creation_time_ms_sum_of_sq = 37; |
| 787 | |
| 788 | // statistics for data-path (NDP) creation time (in ms) measured as request -> confirm: number of |
| 789 | // samples |
| 790 | optional int64 ndp_creation_time_ms_num_samples = 38; |
| 791 | |
| 792 | // total time within the logging window that aware was available |
| 793 | optional int64 available_time_ms = 39; |
| 794 | |
| 795 | // total time within the logging window that aware was enabled |
| 796 | optional int64 enabled_time_ms = 40; |
| 797 | |
| 798 | // Histogram bucket for Wi-Fi Aware logs. Range is [start, end) |
| 799 | message HistogramBucket { |
| 800 | // lower range of the bucket (inclusive) |
| 801 | optional int64 start = 1; |
| 802 | |
| 803 | // upper range of the bucket (exclusive) |
| 804 | optional int64 end = 2; |
| 805 | |
| 806 | // number of samples in the bucket |
| 807 | optional int32 count = 3; |
| 808 | } |
| 809 | |
| 810 | // Status of various NAN operations |
| 811 | enum NanStatusTypeEnum { |
| 812 | // constant to be used by proto |
| 813 | UNKNOWN = 0; |
| 814 | |
| 815 | // NAN operation succeeded |
| 816 | SUCCESS = 1; |
| 817 | |
| 818 | // NAN Discovery Engine/Host driver failures |
| 819 | INTERNAL_FAILURE = 2; |
| 820 | |
| 821 | // NAN OTA failures |
| 822 | PROTOCOL_FAILURE = 3; |
| 823 | |
| 824 | // The publish/subscribe discovery session id is invalid |
| 825 | INVALID_SESSION_ID = 4; |
| 826 | |
| 827 | // Out of resources to fufill request |
| 828 | NO_RESOURCES_AVAILABLE = 5; |
| 829 | |
| 830 | // Invalid arguments passed |
| 831 | INVALID_ARGS = 6; |
| 832 | |
| 833 | // Invalid peer id |
| 834 | INVALID_PEER_ID = 7; |
| 835 | |
| 836 | // Invalid NAN data-path (ndp) id |
| 837 | INVALID_NDP_ID = 8; |
| 838 | |
| 839 | // Attempting to enable NAN when not available, e.g. wifi is disabled |
| 840 | NAN_NOT_ALLOWED = 9; |
| 841 | |
| 842 | // Over the air ACK not received |
| 843 | NO_OTA_ACK = 10; |
| 844 | |
| 845 | // Attempting to enable NAN when already enabled |
| 846 | ALREADY_ENABLED = 11; |
| 847 | |
| 848 | // Can't queue tx followup message foor transmission |
| 849 | FOLLOWUP_TX_QUEUE_FULL = 12; |
| 850 | |
| 851 | // Unsupported concurrency of NAN and another feature - NAN disabled |
| 852 | UNSUPPORTED_CONCURRENCY_NAN_DISABLED = 13; |
| 853 | |
| 854 | // Unknown NanStatusType |
| 855 | UNKNOWN_HAL_STATUS = 14; |
| 856 | } |
| 857 | |
| 858 | // Histogram bucket for Wi-Fi Aware (NAN) status. |
| 859 | message NanStatusHistogramBucket { |
| 860 | // status type defining the bucket |
| 861 | optional NanStatusTypeEnum nan_status_type = 1; |
| 862 | |
| 863 | // number of samples in the bucket |
| 864 | optional int32 count = 2; |
| 865 | } |
| 866 | } |
| 867 | |