From 74fe0aa01a4f3e95a48ef231873615d3e0c96c38 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Sat, 4 Apr 2009 04:07:13 +0200 Subject: [PATCH] Update manager and service interface documentation --- doc/manager-api.txt | 7 +++-- doc/service-api.txt | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 90 insertions(+), 2 deletions(-) diff --git a/doc/manager-api.txt b/doc/manager-api.txt index dd81941..13ca366 100644 --- a/doc/manager-api.txt +++ b/doc/manager-api.txt @@ -41,7 +41,7 @@ Methods dict GetProperties() one must be selected via ActiveProfile property first. - At minium one profile must be available all the time. + At minimum one profile must be available all the time. Possible Errors: [service].Error.InvalidArguments @@ -111,7 +111,10 @@ Properties string State [readonly] array{object} Services [readonly] - List of service object paths. + List of service object paths. The list is sorted + internally to have the service with the default + route always first and then the favorite services + followed by scan results. This list represents the available services for the current selected profile. If the profile gets changed diff --git a/doc/service-api.txt b/doc/service-api.txt index 25c4631..4e09056 100644 --- a/doc/service-api.txt +++ b/doc/service-api.txt @@ -12,6 +12,66 @@ Methods dict GetProperties() Possible Errors: [service].Error.InvalidArguments + void Connect() + + Connect this service. It will attempt to connect + WiFi, WiMAX or Bluetooth services. + + For Ethernet devices this method can only be used + if it has previously been disconnected. Otherwise + the plugging of a cable will trigger connecting + automatically. If no cable is plugged in this method + will fail. + + Possible Errors: [service].Error.InvalidArguments + + void Disconnect() + + Disconnect this service. If the service is not + connected an error message will be generated. + + On Ethernet devices this will disconnect the IP + details from the service. It will not magically + unplug the cable. When no cable is plugged in this + method will fail. + + Possible Errors: [service].Error.InvalidArguments + + void Remove() + + A successfully connected service with Favorite=true + can be removed this way. If it is connected, it will + be automatically disconnected first. + + This is similar to setting the Favorite property + to false, but that is currently not supported. + + Calling this method on Ethernet devices will cause + an error message. It is not possible to remove these + kind of devices. + + Possible Errors: [service].Error.InvalidArguments + + void MoveBefore(object service) + + If a service has been used before, this allows a + reorder of the favorite services. + + The target service object must be part of this + profile. Moving between profiles is not supported. + + Possible Errors: [service].Error.InvalidArguments + + void MoveAfter(object service) + + If a service has been used before, this allows a + reorder of the favorite services. + + The target service object must be part of this + profile. Moving between profiles is not supported. + + Possible Errors: [service].Error.InvalidArguments + Signals PropertyChanged(string name, variant value) This signal indicates a changed value of the given @@ -21,6 +81,9 @@ Properties string State [readonly] The service state information. + Valid states are "idle", "failure", "association", + "configuration" and "ready". + string Name [readonly] The service name (for example "Wireless" etc.) @@ -28,6 +91,9 @@ Properties string State [readonly] This name can be used for directly displaying it in the application. It has pure informational purpose. + For Ethernet device it is not guaranteed that this + property is present. + string Type [readonly] The service type (for example "ethernet", "wifi" etc.) @@ -42,6 +108,9 @@ Properties string State [readonly] present and contains the mode of the network. The possible values are "managed" or "adhoc". + This property might be only present for WiFi + services. + string Security [readonly] If the service type is WiFi, then this property is @@ -50,7 +119,23 @@ Properties string State [readonly] Possible values are "none", "wep", "wpa" and "wpa2". + This property might be only present for WiFi + services. + uint8 Strength [readonly] Indicates the signal strength of the service. This is a normalized value between 0 and 100. + + This property will not be present for Ethernet + devices. + + boolean Favorite [readonly] + + Will be true if a cable is plugged in or the user + selected and successfully connected to this service. + + Setting this property to true has no effect at all + and setting it to false is similar to the Remove() + method. So for now it will be considered a read + only property. -- 2.7.4