This can happen if connected to a hotspot portal
page without WISPr support.
- Possible Errors: net.connman.Agent.Error.Retry
+ Possible Errors: net.connman.Agent.Error.Canceled
dict RequestInput(object service, dict fields)
The dictionary arguments contains field names with
their input parameters.
+ In case of WISPr credentials requests and if the user
+ prefers to login through the browser by himself, agent
+ will have to return a LaunchBrowser error (see below).
+
Possible Errors: net.connman.Agent.Error.Canceled
+ net.connman.Agent.Error.LaunchBrowser
void Cancel()
key, a PSK passphrase or a passphrase for EAP
authentication methods.
+ string PreviousPassphrase
+
+ The previous passphrase successfully saved, i.e.
+ which lead to a successfull connection. This field is
+ provided as an informational argument when connecting
+ with it does not work anymore, for instance when it
+ has been changed on the AP. Such argument appears when
+ a RequestInput is raised after a retry.
+
string WPS
This field requests the use of WPS to get associated.
Arguments string Type
Contains the type of a field. For example "psk", "wep"
- "passphrase", "response", "ssid", "wpspin" or plain
- "string".
+ "informational", "passphrase", "response", "ssid",
+ "wpspin" or plain "string". "informational" has no
+ "Requirement" but a "Value".
string Requirement
Contains the list of alternate field names this
field can be represented by.
+ string Value
+
+ Contains data as a string, relatively to an
+ "informational" argument.
+
Examples Requesting a passphrase for WPA2 network
RequestInput("/service1",
- { "Passphrase" : { "Type" : "psk",
+ { "Passphrase" : { "Type" : "psk",
"Requirement" : "mandatory"
}
}
==> { "Passphrase" : "secret123" }
+ Requesting a passphrase after an error on the previous one:
+
+ RequestInput("/service1",
+ { "Passphrase" : { "Type" : "psk",
+ "Requirement" : "mandatory"
+ },
+ "PreviousPassphrase" :
+ { "Type" : "informational",
+ "Value" : "secret123"
+ }
+ }
+
Requesting name for hidden network
RequestInput("/service2",
"Requirement" : "mandatory",
"Alternates" : [ "SSID" ]
},
- "SSID" : { "Type" : "ssid",
- "Requirement" : "alternate"
- }
+ "SSID" : { "Type" : "ssid",
+ "Requirement" : "alternate"
+ }
}
==> { "Name" : "My hidden network" }
"Alternates" : [ "WPS" ]
},
"WPS" : { "Type" : "wpspin",
- "Requirement" : "alternate"
+ "Requirement" : "alternate"
}
}
{ "Identity" : { "Type" : "string",
"Requirement" : "mandatory"
},
- "Passphrase" : { "Type" : "passphrase",
+ "Passphrase" : { "Type" : "passphrase",
"Requirement" : "mandatory"
}
}
{ "Identity" : { "Type" : "string",
"Requirement" : "mandatory"
},
- "Passphrase" : { "Type" : "response",
+ "Passphrase" : { "Type" : "response",
"Requirement" : "mandatory"
}
}
Requesting username and password for a WISPr-enabled hotspot:
RequestInput("/service5",
- { "Username" : { "Type" : "string",
- "Requirement" : "mandatory"
- },
- "Password" : { "Type" : "passphrase",
- "Requirement" : "mandatory"
- }
- }
-
- ==> { "Username" : "foo", "Password": "secret" }
+ { "Username" : { "Type" : "string",
+ "Requirement" : "mandatory"
+ },
+ "Password" : { "Type" : "passphrase",
+ "Requirement" : "mandatory"
+ }
+ }
+
+ ==> { "Username" : "foo", "Password": "secret" }