freesmartphone.org Framework DBus Interface Specification

org.freesmartphone.Time.Alarm

Description

The Alarm interface is used to register wakeup alarms. Alarm notifications will be submitted as dbus method calls, hence alarm receivers need to implement the interface org.freesmartphone.Notification on the root object. Alarm receivers need to be running dbus system services or dbus system-activatable. If the system features a suspend mode, the framework will ensure that the system is awake at the time the alarm triggers. Per bus name only one alarm can be registered. If you need more than one alarm or want to run on the dbus session bus, consider using the org.freesmartphone.PIM event interface instead.

Namespace

org.freesmartphone.Time.Alarm

Methods

Signals

None

Errors

None

Methods

ClearAlarm ( s )

Description: Clears the alarm for a certain dbus system service.

Parameters

s: busname

The dbus bus name to clear the alarm for.

SetAlarm ( si )

Description: Sets an alarm time for a certain dbus system service.

Parameters

s: busname

The dbus bus name to set the alarm for.

i: timestamp

The timestamp for sending the alarm notification in seconds since 1970 (epoch).


| Specified 2008-2009 by the Freesmartphone.org team. | Join us and discuss further drafts smartphones-standards (at) linuxtogo (dot) org