view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    More generic options are the M20 from Siemens and the A1 or A2 from
    Falcom.

    A good start is to read the docs for GSM::SMS::NBS. This class is a
    facade for the rest of the package and provides easy to use methods.

    (Upcoming) When using EMS, you can use the L>GSM::SMS::EMS> package.

    For the moment the package comes with support for the following Smart
    Messaging formats:

    ring tones (RTTTL)
    Caller Line Identification logos
    Operator logos
    VCard
    OTA Configuration for WAP phones
    PictureMessage

    More are on their way, as is support for EMS.

NEW IN THIS RELEASE
    Win32 support
    Flash SMS support
    Refactored directory structure layout
    More docs
    Better error reporting
    Configuration wizard update

    Look in the 'Changes' file for a complete review and credits.

PREREQUISITES
    Following packages are mandatory

    Data::Dumper
    MIME::Base64
    Image::Magick
    LWP
    Device::SerialPort or Win32::SerialPort
    Log::Agent

    Note: Device::SerialPort and Win32::SerialPort are only necessary when
    using serial transport.

INSTALL
    It *should* be a simple:

            perl Makefile.PL
            make
            make install

    When you want to use the default values for installing, you can set
    PERL_MM_USE_DEFAULT to true before running perl Makefile.PL. This can be
    of interest when installing GSM::SMS from a script.

CONFIGURATION
    This package needs configuration, period. When you're installing the
    package on a Windows machine then you'll need to type double back
    slashes when providing a path, e.g. for the log directory:

      c:\\gsmsms\\log

    You have three options to configure the package:

    On installation
        Running "perl Makefile.PL" will invoke the configuration wizard.

    After installation
        You can always run the configuration wizard again by the following
        command

          perl -MGSM::SMS::Config -esetup

    When instantiating GSM::SMS::NBS (or GSM::SMS::EMS)
        You can provide a configuration file to the constructor. This
        configuration file can be generated from the default configuration
        (created by previous config methods) by running the next command

          perl -MGSM::SMS::Config -egenerate_config

SERIAL TRANSPORT
    To use the serial transport, you'll need to have either
    Device::SerialPort or Win32::SerialPort installed.

    A problem that can arise when using the serial transport is the setting
    of the service center address. If this happens, or if you want to set
    this manually, use the following command(s) in your favourite comms
    program. I use minicom ... (Win32 users can use *terminal*).

            >minicom -s
            AT+CPIN?
                    Check for pincode
            AT+CPIN="nnnn"
                    Set pincode. Important ... only 3 tries!!!
            AT+CSCA?
                    Check for service center address
            AT+CSCA="+32475161616"
                    Set service center address. ( This one is for proximus belgium ).

EXAMPLES
    Look in the examples directory, this should get you started. The most
    complex one is the smartmessagingserver, allowing you to request a rttl
    or groupgraphic by sending an sms message. The slashdot example allows
    you to receive the latest slashdot headlines in a SMS message. The ideas
    are ofcourse endless.

Win32 Specific issues
    Sometimes I need to open up a terminal program to connect to the modem
    manually. If I don't do that, Perl cannot connect to the serial port. I
    only need to do that one time, when I boot up the system. Afterwards,
    everything works fine.

    You probably will get warnings when running the test suite. These do not
    originate from GSM::SMS, but from Image::Magick. They are harmless I
    guess, as I did not see apatch from ActiveState yet.

BUGS
    Probably a lot. I hope I get a lot of feedback so we can figure the bugs
    out and start fixing them!

AUTHOR