The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

GSM::ARFCN - Absolute Radio Frequency Channel Number (ARFCN) Converter

SYNOPSIS

use GSM::ARFCN;
my $ga=GSM::ARFCN->new(24);
my $frequency=$ga->fdl;

DESCRIPTION

The Absolute Radio Frequency Channel Number (ARFCN) is a unique number given to each radio channel in GSM Radio Communication Band plan. The ARFCN can be used to calculate the frequency of the radio channel.

The ARFCNs used in GSM-1900 band (US PCS-1900) overlap with the ARFCNs used in GSM-1800 band (DCS-1800). In the GSM-1900 band plan, the ARFCNs 512 to 810 are different frequencies than the same channel numbers in the GMS-1800 band plan. A multiband mobile phone will interpret ARFCN numbers 512 to 810 as either GSM-1800 or GSM-1900 frequencies based on a band plan indicator.

For this package to interpret ARFCN numbers 512 to 810 as either GSM-1800 or GSM-1900 frequencies, set the additional parameter band plan indicator (i.e. "bpi") to either "GSM-1800" or "GSM-1900" (DEFAULT) to make the correct interpretation.

USAGE

use GSM::ARFCN;
my $frequency=GSM::ARFCN->new(24)->fdl; #MHz

Looping without blessing a new object each time

use GSM::ARFCN;
my $ga=GSM::ARFCN->new;
foreach my $channel (0 .. 1023) {
  $ga->channel($channel);  #sets channel and recalculates the object properties
  printf "Channel: %s;\tBand: %s\tUplink: %s MHz,\tDownlink: %s MHz\n", $ga->channel, $ga->band, $ga->ful, $ga->fdl
    if $ga->band;
}

CONSTRUCTOR

new

my $obj=GSM::ARFCN->new;                                  #blesses empty object; no channel set
my $obj=GSM::ARFCN->new(24);                              #default bpi=>"GSM-1900"
my $obj=GSM::ARFCN->new(channel=>24);                     #default bpi=>"GSM-1900"
my $obj=GSM::ARFCN->new(channel=>24, bpi=>"GSM-1800");    #specify band plan indicator

METHODS

channel

Sets or returns the channel. Recalculates properties when updated.

bpi

Set and returns the band plan indicator. Recalculates properties when set.

my $bpi=$ga->bpi("GSM-1900"); #default
my $bpi=$ga->bpi("GSM-1800");

PROPERTIES

band

Returns the GSM band for the current channel. If the current channel is unknown by this package, this property will be false but defined.

print $ga->band;
if ($ga->band) {
  #Channel is valid
} else {
  #Channel is not valid
}

ful (Frequency Uplink)

Returns the channel uplink frequency in MHz.

my $frequency=$ga->ful;

fdl (Frequency Downlink)

Returns the channel downlink frequency in MHz.

fs (Frequency Separation)

Returns the frequency separation between the uplink and downlink frequencies in MHz.

cs (Channel Spacing)

Returns the channel spacing in MHz. Currently, this is always 0.2 MHz. The actual bandwidth of the signal is 270.833 KHz.

BUGS

Submit to RT and email author.

SUPPORT

Try the author.

AUTHOR

Michael R. Davis
CPAN ID: MRDVT
STOP, LLC
domain=>michaelrdavis,tld=>com,account=>perl
http://www.stopllc.com/

COPYRIGHT

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO

http://www.telecomabc.com/a/arfcn.html, http://wireless.agilent.com/rfcomms/refdocs/gsmgprs/gen_bse_cell_band.php