[PATCH 3/3] doc: Update overview document with WiFi sorting changes

Patrik Flykt patrik.flykt at linux.intel.com
Wed Sep 25 05:24:38 PDT 2013

 doc/overview-api.txt |   18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/doc/overview-api.txt b/doc/overview-api.txt
index f126887..41ee085 100644
--- a/doc/overview-api.txt
+++ b/doc/overview-api.txt
@@ -53,14 +53,12 @@ do have a signal strength, it is mostly unknown since background scanning
 in Bluetooth is too expensive. The choice here is to sort the last used
 Bluetooth device before the others.
-WiFi networks closer in the proximity should be shown first since it is more
-likely they are selected. The signal strength value is normalized to 0-100
-(effectively a percentage) and allows an easy sorting.
-WiFi networks with the same signal strength are then sorted by their security
-setting. WPA2 encrypted networks should be preferred over WPA/WEP and also
-unencrypted ones. After that they will be sorted by the SSID in alphabetical
+WiFi networks with better encryption should be preferred and therefore shown
+first. WPA PSK networks are ordered before WPA EAP, which are followed by
+WEP and unencrypted ones. WiFi networks of the same security type are then
+sorted according to signal strength. The signal strength value is normalized
+to 0-100 (effectively a precentage). After that they will be sorted by the
+SSID in alphabetical order.
 In the case the WiFi network uses WPS for setup and it is clearly detectable
 that a network waits for Connection Manager to connect to it (for example via
@@ -69,6 +67,10 @@ first before any other WiFi networks. The reason here is that the user already
 made a choice via the access point. However this depends on technical details
 if it is possible to detect these situations.
+All other criteria being equal, networks are sorted alphabetically. This
+applies generally to every network type except WiFi where sorting according
+to signal strength has already been applied.
 Service order

More information about the connman mailing list