freesmartphone.org Time Alarm Interface
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-activatible. If the system features a suspend mode, the framework will ensure that the system is awake at the time the alarm triggers. Multiple alarms per bus name can be registered. If you want to register named alarm (e.g. agenda items, birthdays, etc.), consider using the PIM services instead.
Namespace
org.freesmartphone.Time.Alarm
Methods
Signals
None
Properties
None
Errors
None
Methods
ClearAlarms ( s )
Description: Clear all scheduled alarms for a given dbus service name.
Parameters:*
s: busname The dbus service bus name to clear all alarms for.
ListAlarms ( ) → a(si)
Description: List all currently scheduled alarms.
Returns:
a(si): alarms All currently scheduled alarms.
RemoveAlarm ( si )
Description: Removes a scheduled alarm.
Parameters:*
s: busname The dbus service bus name to clear the alarm for.
i: timestamp When to call in seconds since 1970 (epoch).
AddAlarm ( si )
Description: Schedules an alarm for a given dbus service name. The alarm will be triggered by calling the service’s Alarm method on the root (/) object.
Implementation Note
Make sure to specify a dbus system service configuration file for the services that use this interface. This way, you can receive alarm notifications even when your service is not running at the time the alarm fires.
Parameters:*
s: busname The dbus service name to call.
i: timestamp When to call in seconds since 1970 (epoch).