doc/technology-api.txt

   1 Technology hierarchy
   2 ====================
   3
   4 Service         net.connman
   5 Interface       net.connman.Technology
   6 Object path     [variable prefix]/{technology0,technology1,...}
   7
   8 Methods         dict GetProperties()  [deprecated]
   9
  10                         Returns properties for the technology object. See
  11                         the properties section for available properties.
  12
  13                         Usage of this method is highly discouraged. Use
  14                         the Manager.GetTechnologies() method instead.
  15
  16                         Possible Errors: [service].Error.InvalidArguments
  17
  18                 void SetProperty(string name, variant value)
  19
  20                         Changes the value of the specified property. Only
  21                         properties that are listed as read-write are
  22                         changeable. On success a PropertyChanged signal
  23                         will be emitted.
  24
  25                         Possible Errors: [service].Error.InvalidArguments
  26                                          [service].Error.InvalidProperty
  27
  28                 void Scan()
  29
  30                         Trigger a scan for this specific technology. The
  31                         method call will return when a scan has been
  32                         finished and results are available. So setting
  33                         a longer D-Bus timeout might be a really good
  34                         idea.
  35
  36                         Results will be signaled via the ServicesChanged
  37                         signal from the manager interface.
  38
  39                         In case of P2P technology, results will be signaled
  40                         via the PeersChanged signal from the manager
  41                         interface.
  42
  43 Signals         PropertyChanged(string name, variant value)
  44
  45                         This signal indicates a changed value of the given
  46                         property.
  47
  48 Properties      boolean Powered [readwrite]
  49
  50                         Boolean representing the power state of the
  51                         technology. False means that the technology is
  52                         off (and is available RF-Killed) while True means
  53                         that the technology is enabled.
  54
  55                 boolean Connected [readonly]
  56
  57                         Boolean representing if a technology is connected.
  58
  59                         This is just a convience property for allowing the
  60                         UI to easily show if this technology has an active
  61                         connection or not.
  62
  63                         If this property is True it means that at least one
  64                         service of this technology is in ready state.
  65
  66                 string Name [readonly]
  67
  68                         Name of this technology.
  69
  70                 string Type [readonly]
  71
  72                         The technology type (for example "ethernet" etc.)
  73
  74                         This information should only be used to determine
  75                         advanced properties or showing the correct icon
  76                         to the user.
  77
  78                 boolean Tethering [readwrite]
  79
  80                         This option allows to enable or disable the support
  81                         for tethering. When tethering is enabled then the
  82                         default service is bridged to all clients connected
  83                         through the technology.
  84
  85                 string TetheringIdentifier [readwrite]
  86
  87                         The tethering broadcasted identifier.
  88
  89                         This property is only valid for the WiFi technology,
  90                         and is then mapped to the WiFi AP SSID clients will
  91                         have to join in order to gain internet connectivity.
  92
  93                 string TetheringPassphrase [readwrite]
  94
  95                         The tethering connection passphrase.
  96
  97                         This property is only valid for the WiFi technology,
  98                         and is then mapped to the WPA pre-shared key clients
  99                         will have to use in order to establish a connection.
 100
 101                 boolean Hidden [readwrite]
 102
 103                         This option allows to enable or disable the support
 104                         for the hidden Wi-Fi tethering.