Specifications

The purpose of the freesmartphone.org.* D-Bus interface specifications is to provide interoperatibility between implementations and a reliable API contract between all processes.

Active

For details, please see our automatically generated docs that follow right after this page.

Brainstorming

For brainstorming, please use our mailing list fso@openphoenux.org.

Style guide

  • Bus names are all lowercase with . separation, e.g. org.freesmartphone.odeviced.
  • Object names all lowercase with / separation, e.g. /org/freesmartphone/device/idlenotifier/0.
  • Method and Signal names are CamelCased, e.g. ListFoo, GetBar.
  • Use Get/Set prefixes for accessors, such as GetServiceCenter, SetServiceCenter.
  • Use verbs for operations, such as ListProviders, Unlock, SendAuthCode.
  • Use similar terms for similar operations, e.g. ListProviders, ListCells.
  • Keep the vocabulary as simple as possible, but as large as necessary.
  • The use of D-Bus properties is controversial, for now we don’t use them in any of the freesmartphone.org specifications.