Standards/OpenTelephonyAPI

From FreeSmartphoneWiki

(Redirected from Standards/OpenPhoneServerAPI)

1 Purpose
2 Requirements
3 Namespaces / Subsystems
- 3.1 Global Prefix
- 3.2 Subsystem Prefixes & API Purpose
  - 3.2.1 Device
  - 3.2.2 SIM
  - 3.2.3 Network
  - 3.2.4 Call
  - 3.2.5 SMS
  - 3.2.6 CB
  - 3.2.7 HZ
  - 3.2.8 PDP

Purpose

The purpose of the phone interface is to provide common and language independent interface for applications, e.g. dialer application (dial, answer, hold, resume, hangup, dtfm), addressbook application (contact information, vcard), sms application (send, receive, manage) and audio apps (speaker level, etc.).

Requirements

All blocking method calls must be carefully designed: The interface is used mostly by graphical user interface applications which should not block user interaction. For example if dial is performed with a blocking method the user may not hang up the call while the modem is still connecting.

Suitable abstraction level: We must not blindly map GSM 07.07 calls to the dbus interface. We can and should design the method calls slightly more high level.

Namespaces / Subsystems

Global Prefix

Global prefix: org.freesmartphone.GSM

Rationales:

GSM is ubiquitous and not going away soon.
It's more concrete than a 'Phone' or 'Telephony' prefix. Usually, conceptual terms should be preferred over technical terms, however in the mobile phone space these terms are so ubiquitous and established that we don't want to make people learn new taxonomy just for our API.
Many subsystems are specific to GSM and are too unspecific if used without a prefix (i.e. Network).

Subsystem Prefixes & API Purpose

Note that these links are pointing to our generated docbook documentation. Please checkout our code repository for the actual DBus XML specification files.