view release on metacpan or  search on metacpan

docs/README.pod  view on Meta::CPAN

=head1 NEW IN THIS RELEASE

=over 4

=item Win32 support

=item Flash SMS support

=item Refactored directory structure layout

=item More docs

=item Better error reporting

=item Configuration wizard update

=back

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

=head1 PREREQUISITES

Following packages are mandatory

=over 4

=item Data::Dumper

=item MIME::Base64

=item Image::Magick

=item LWP

=item Device::SerialPort or Win32::SerialPort

=item Log::Agent

=back

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

=head1 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.

=head1 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:

=over 4

=item On installation

Running C<perl Makefile.PL> will invoke the configuration wizard.

=item After installation

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

  perl -MGSM::SMS::Config -esetup

=item 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

=back

=head1 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 I<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 ).

=head1 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. 

=head1 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.