Hi all,
I had a quick peek on barring API which is currently undocumented.
It seems to me that there is a good reason for it being documented as
the properties by GetProperties() returned are different from the
properties emitted. I kinda like the the emitted properties
(VoiceIncoming and VoiceOutgoing), they seem to capture the
functionality of the barring services as well as the limitations of
both the air and AT interface pretty well.
Here is my stab at the D-Bus API documentation; as it is, the
GetProperties takes 5 air operations in the most pessimal case (~25
seconds if all goes well on UMTS). There should probably be different
atoms for Fax, Data/Video and SMS, if someone ever needs them. Adding
them to this atom does not seem feasible as any basic service might
require 5 new AT+CLCK commands with ~5 seconds delay each.
--Pekka
--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
Voice Call Barring hierarchy
============================
Service org.ofono
Interface org.ofono.CallBarring
Object path [variable prefix]/{modem0,modem1,...}
Methods dict GetProperties()
Contains the properties for this object.
void ChangePassword(string old_password, string new_password)
Register new network password for the barring
services.
void DisableAll(string password)
Disables all voice call barrings.
void DisableAllIncoming(string password)
Disables barrings for incoming voice calls.
void DisableAllOutgoing(string password)
Disables barrings for outgoing voice calls.
void SetProperty(string property, variant value)
Sets the given property value to that specified in
call parameter.
Signals PropertyChanged(string property, variant value)
Signal is emitted whenever a property has changed. The new
value is passed as the signal argument.
Properties string VoiceIncoming [readwrite]
Contains the value of the barrings for the incoming
voice calls. The possible values are
- "always": bar all incoming calls
- "whenroaming": bar incoming calls when roaming,
or
- "" if no barring is active
string VoiceOutgoing [readwrite]
Contains the value of the barrings for the outgoing
voice calls. The possible values are
- "all": bar all outgoing calls
- "international": bar all outgoing international calls
- "internationalnothome": bar all outgoing
international calls except to home country
- "" if no barring is active
--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
--
Pekka.Pessi mail at
nokia.com