Documentation update: device-lowlevel-api and service-api

doc/device-lowlevel-api.txt

 Device hierarchy
 ================
 
 Service         org.chromium.flimflam
 Interface       org.chromium.flimflam.Device
 Object path     [variable prefix]/{device0,device1,...}
 
 Methods         dict GetProperties()
 
                         Returns properties for the device object. See
@@ skipping 10 matching lines @@
 
                         Possible Errors: [service].Error.InvalidArguments
                                          [service].Error.InvalidProperty
 
                 void ProposeScan()
 
                         Proposes to trigger a scan transaction.
 
                         Possible Errors: [service].Error.InvalidArguments
 
-                Object path AddIPConfig(string method)
+                object path AddIPConfig(string method)
 
                         Create an IPConfig element of the specified type.
                         The element is appended to the list of IPConfig
-                        elements assciated with the device.
+                        elements associated with the device.
 
                         Possible values for method are:
                            "ipv4"       (fixed IPv4 network state)
                            "ipv6"       (fixed IPv6 network state)
                            "dhcp"       (IPv4 state setup using DHCP)
                            "bootp"      (IPv4 state setup using BOOTP)
                            "zeroconf"   (IPV4 state setup using ZeroConf)
-                           "dhcp6"      (IPv6 state setup using DHCP6)
                            "ppp"        (IPv4 state setup using PPP)
+                           *"dhcp6"     (IPv6 state setup using DHCP6)
+                           
+                        * Not currently implemented.
 
                         Possible Errors: [service].Error.InvalidArguments
 
 Signals         PropertyChanged(string name, variant value)
 
                         This signal indicates a changed value of the given
                         property.
 
 Properties      string Name [readonly]
 
@@ skipping 13 matching lines @@
 
                         This value is for pure informational purposes. It
                         is not guaranteed that it is always present.
 
                 boolean Powered [readwrite]
 
                         Switch a device on or off. This will also modify
                         the list of networks in range. All known networks
                         will be still available via the Networks property.
 
-                        Changing this value doesn't change the value of the
+                        Changing this value does not change the value of the
                         Policy property.
 
                         The value of this property can be changed by other
                         parts of the system (including the kernel). An
                         example would be modifications via the "ifconfig"
                         command line utility.
 
+                boolean Scanning [readonly]
+
+                        Indicates that a device is currently performing a
+                        network scan.
+                        
+                boolean Reconnect [readonly]
+
+                        Indicates that the active service on this device should
+                        attempt to reconnect when idle. 
+
                 uint16 ScanInterval [readwrite]
 
                         The scan interval describes the time in seconds
                         between automated scan attempts. Setting this
                         value to 0 will disable the background scanning.
 
                         The default value is 300 and so every 5 minutes
                         a scan procedure will be triggered.
 
                         This property is not available with all types
                         of devices. Some might not support background
                         scanning at all.
 
-                boolean Scanning [readonly]
+                string BgscanMethod [readwrite]
 
-                        Indicates if a device is scanning. Not all device
-                        types might support this. Also some hardware might
-                        execute background scanning without notifying the
-                        driver about it. Use this property only for visual
-                        indication.
+                        A string identifying the background scan algorithm.
+                        Possible values:
+                                "simple" [default]
+                                "learn"
+
+                uint16 BgscanShortInterval [readwrite]
+
+                        Time in seconds between background scans when actively
+                        searching for better APs (e.g., when roaming).
+
+                int32 BgscanSignalThreshold [readwrite]
+
+                        Receive signal strength threshold (in dBm), for the
+                        currently connected network, below which roaming is
+                        triggered. 
 
                 array{object} Networks [readonly]
 
                         List of networks objects paths. Every object path
                         represents a network in range or a known network.
 
                 array{object} IPConfigs [readonly]
 
                         List of IPConfig objects paths. Every object path
                         represents a Layer 3 configuration record.
@@ skipping 15 matching lines @@
                         If the device type is "cellular", then this property
                         gives the International Mobile Equipment Identity
                         of the modem.
 
                 string Cellular.IMSI [readonly]
 
                         If the device type is "cellular", and the device is
                         a GSM modem, then this property gives the International
                         Mobile Subscriber Identity of the SIM card contained in
                         the modem.
+
+                string Cellular.ESN [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the Electronic Serial Number of the modem.
+
+                string Cellular.MDN [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the Mobile Directory Number (i.e., phone number)
+                        of the modem.
+
+                string Cellular.MIN [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the Mobile Identification Number of the modem.
+                        The MIN is often the same as the MDN, but may change if
+                        a user changes to a different service provider.
+
+                string Cellular.ModelID [readonly]
+
+                        If the device type is "cellular", then this property
+                        identifies the hardware model of the modem. The
+                        contents of this property are unspecified, and are
+                        useful primarily as a diagnostic aid.
+
+                string Cellular.Manufacturer [readonly]
+
+                        If the device type is "cellular", then this property
+                        identifies the manufacturer of the modem. The contents
+                        of this property are unspecified, and are useful
+                        primarily as a diagnostic aid.
+
+                string Cellular.FirmwareRevision [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the revision of firmware that is loaded on the
+                        modem. The contents of this property are unspecified,
+                        and are useful primarily as a diagnostic aid.
+
+                string Cellular.HardwareRevision [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the hardware revision of the modem. The contents
+                        of this property are unspecified, and are useful
+                        primarily as a diagnostic aid.
+
+                string Cellular.LastDeviceUpdate [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the date and time, in ISO 8601 format, of the
+                        last over-the-air device update that was performed. If
+                        an OTA update has never occurred, this property does
+                        not exist.
+
+                int16 Cellular.PRLVersion [readonly]
+
+                        If the device type is "cellular", then this property
+                        gives the revision of the Preferred Roaming List that
+                        is loaded on the modem. It is primarily useful as a
+                        diagnostic aid.
+