NAME
Net::Radio::oFono::MessageManager - provide MessageManager interface for Modem objects
SYNOPSIS
my $oFono = Net::Location::oFono->new();
my @modems = Net::Location::oFono->get_modems();
# show default network information
foreach my $modem_path (@modems) {
my $msgman = Net::Location::oFono->get_modem_interface($modem_path, "MessageManager");
say "Alphabet: ", $msgman->GetProperty("Alphabet");
$msgman->SendMessage("911", "Wanna have some fun?");
}
INHERITANCE
Net::Radio::oFono::MessageManager
ISA Net::Radio::oFono::Modem
ISA Net::Radio::oFono::Helpers::EventMgr
DOES Net::Radio::oFono::Roles::RemoteObj
DOES Net::Radio::oFono::Roles::Manager
METHODS
See ofono/doc/messagemanager-api.txt
for valid properties and detailed action description and possible errors.
_init($obj_path)
Initializes the modem and the manager role to handle the MessageAdded and MessageRemoved signals. After it handlers for the D-Bus signals ImmediateMessage and IncomingMessage are added.
GetMessages(;$force)
Get an hash of message object paths and properties that represents the currently pending messages.
Set the $force parameter to a true value when no D-Bus main loop is running and signal handling might be incomplete.
This method is injected by Net::Radio::oFono::Roles::Manager as an alias for Net::Radio::oFono::Roles::Manager/GetObjects(;$force).
GetMessage($obj_path;$force)
Returns an instance of the specified Net::Radio::oFono::Message.
Set the $force parameter to a true value when no D-Bus main loop is running and signal handling might be incomplete.
This method is injected by Net::Radio::oFono::Roles::Manager as an alias for Net::Radio::oFono::Roles::Manager/GetObject($object_path;$force).
SendMessage($to,$text)
Send the message in text to the number in to. If the message could be queued successfully, this method returns an object path to the created Message object.
onImmediateMessage
Called when D-Bus signal ImmediateMessage is received.
Generates event ON_IMMEDIATE_MESSAGE
with arguments $message, $info
. $info has Sender, LocalSentTime, and SentTime information.
onIncomingMessage
Called when D-Bus signal IncomingMessage is received.
Generates event ON_INCOMING_MESSAGE
with arguments $message, $info
. $info has Sender, LocalSentTime, and SentTime information.
BUGS
Please report any bugs or feature requests to bug-net-radio-ofono at rt.cpan.org
, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Radio-oFono. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Net::Radio::oFono
You can also look for information at:
RT: CPAN's request tracker (report bugs here)
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Net-Radio-oFono
If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.
AnnoCPAN: Annotated CPAN documentation
CPAN Ratings
Search CPAN
Where can I go for help with a concrete version?
Bugs and feature requests are accepted against the latest version only. To get patches for earlier versions, you need to get an agreement with a developer of your choice - who may or not report the issue and a suggested fix upstream (depends on the license you have chosen).
Business support and maintenance
For business support you can contact Jens via his CPAN email address rehsackATcpan.org. Please keep in mind that business support is neither available for free nor are you eligible to receive any support based on the license distributed with this package.
ACKNOWLEDGEMENTS
At first the guys from the oFono-Team shall be named: Marcel Holtmann and Denis Kenzior, the maintainers and all the people named in ofono/AUTHORS. Without their effort, there would no need for a Net::Radio::oFono module.
Further, Peter "ribasushi" Rabbitson helped a lot by providing hints and support how to make this API accessor a valuable CPAN module.
AUTHOR
Jens Rehsack, <rehsack at cpan.org>
LICENSE AND COPYRIGHT
Copyright 2012 Jens Rehsack.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
2 POD Errors
The following errors were encountered while parsing the POD:
- Around line 104:
alternative text 'Net::Radio::oFono::Roles::Manager/GetObjects(;$force)' contains non-escaped | or /
- Around line 114:
alternative text 'Net::Radio::oFono::Roles::Manager/GetObject($object_path;$force)' contains non-escaped | or /