File Coverage

blib/lib/THD7.pm

Criterion	Covered	Total	%
statement	185	900	20.5
branch	0	314	0.0
condition	0	17	0.0
subroutine	61	277	22.0
pod	116	216	53.7
total	362	1724	21.0

package THD7;

require 5.004;

# David Nesting
# THD7.pm - A module for providing control to a TH-D7 radio via serial port
#
# Kevin Wittmer
# Version 1.3 - 3 April 2004
# Added support for APRS message send
#
# Kevin Wittmer
# Version 1.2 - 17 January 2004
# Added support for the Windows operating system
#
# David Nesting
# Version 1.1 - 17 April 1999
# Added support for: CH, DW, UP, FL, FQ, SC, TC, VR, VW, MON, SFT
#
# David Nesting
# Version 1.0 - 15 April 1999

BEGIN {
	use Exporter ();
	use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);

	$VERSION = 1.30;

	@ISA = qw(Exporter);
	@EXPORT = qw(NOCALLBACK);
	%EXPORT_TAGS = (
		'constants' => [qw{ BAND_A BAND_B ON OFF KEY KEY_DATA ALL
		TIME CARRIER SEEK DATA BOTH SLOW FAST APO_30 APO_60
		ENGLISH METRIC MANUAL PTT AUTO NMEA POSITIVE NEGATIVE
		BLACK BLUE RED MAGENTA GREEN CYAN YELLOW WHITE
		HIGH LOW EL OPEN CLOSED FULL HALF AIR VHF_A VHF_B UHF }],
		'functions'	=> [qw{ ToStep FromStep ToTone FromTone ToPosit FromPosit }]
	);
	@EXPORT_OK = qw(BAND_A BAND_B ON OFF KEY KEY_DATA ALL
		TIME CARRIER SEEK DATA BOTH SLOW FAST APO_30 APO_60
		ENGLISH METRIC MANUAL PTT AUTO NMEA POSITIVE NEGATIVE
		BLACK BLUE RED MAGENTA GREEN CYAN YELLOW WHITE
		HIGH LOW EL OPEN CLOSED FULL HALF AIR VHF_A VHF_B UHF
		ToStep FromStep ToTone FromTone ToPosit FromPosit
	);
}

use strict;
use Symbol;
use Carp;

use constant (BAND_A	=>	0);
use constant (BAND_B	=>	1);
use constant (OFF	=>	0);
use constant (ON	=>	1);
use constant (HIGH	=>	0);
use constant (LOW	=>	1);
use constant (EL	=>	2);
use constant (CLOSED	=>	0);
use constant (OPEN	=>	1);
use constant (HALF	=>	0);
use constant (FULL	=>	1);
use constant (AIR	=>	1);
use constant (VHF_A	=>	2);
use constant (VHF_B	=>	3);
use constant (UHF	=>	6);
use constant (KEY	=>	1);
use constant (KEY_DATA	=>	2);
use constant (ALL	=>	3);
use constant (TIME	=>	0);
use constant (CARRIER	=>	1);
use constant (SEEK	=>	2);
use constant (DATA	=>	0);
use constant (BOTH	=>	1);
use constant (SLOW	=>	0);
use constant (FAST	=>	1);
use constant (APO_30	=>	1);
use constant (APO_60	=>	2);
use constant (FM		=>	0);
use constant (AM		=>	1);
use constant (ENGLISH	=>	0);
use constant (METRIC	=>	1);
use constant (MANUAL	=>	0);
use constant (PTT		=>	1);
use constant (AUTO		=>	2);
use constant (BLACK		=>	0);
use constant (BLUE		=>	1);
use constant (RED		=>	2);
use constant (MAGENTA		=>	3);
use constant (GREEN		=>	4);
use constant (CYAN		=>	5);
use constant (YELLOW		=>	6);
use constant (WHITE		=>	7);
use constant (TONES		=>	1,3..39);
use constant (NMEA		=>	1);
use constant (VFO		=>	0);
use constant (MEMORY	=>	2);
use constant (CALL		=>	3);
use constant (POSITIVE		=>	2);
use constant (NEGATIVE		=>	1);

sub NOCALLBACK {
	\&NOCALLBACK;
}

my %STEPS = (
	5		=>	0,
	6.25	=>	1,
	10		=>	2,
	12.5	=>	3,
	15		=>	4,
	20		=>	5,
	25		=>	6,
	30		=>	7,
	50		=>	8,
	100		=>	9
);
my %REV_STEPS;
$REV_STEPS{values %STEPS} = keys %STEPS;

my %TONES = (
	67		=>	1,
	71.9	=>	3,
	74.4	=>	4,
	77		=>	5,
	79.7	=>	6,
	82.5	=>	7,
	85.4	=>	8,
	88.5	=>	9,
	91.5	=>	10,
	94.8	=>	11,
	97.4	=>	12,
	100		=>	13,
	103.5	=>	14,
	107.2	=>	15,
	110.9	=>	16,
	114.8	=>	17,
	118.8	=>	18,
	123		=>	19,
	127.3	=>	20,
	131.8	=>	21,
	136.5	=>	22,
	141.3	=>	23,
	146.2	=>	24,
	151.4	=>	25,
	156.7	=>	26,
	162.2	=>	27,
	167.9	=>	28,
	173.8	=>	29,
	179.9	=>	30,
	186.2	=>	31,
	192.8	=>	32,
	203.5	=>	33,
	210.7	=>	34,
	218.8	=>	35,
	225.7	=>	36,
	223.6	=>	37,
	241.8	=>	38,
	250.3	=>	39
);
my %REV_TONES;
$REV_TONES{values %TONES} = keys %TONES;

my $DEBUG = 1;
my $TEXT = 1;

# Method error messages
use constant (INVALID_BAND	=>
	"Invalid band selection, expected BAND_A or BAND_B (0/1)");
use constant (INVALID_ONOFF	=>
	"Invalid setting, expected OFF or ON (0/1)");
use constant (NOWRITE	=>
	"Too many arguments (read-only method)");
use constant (INVALID_MODE	=>
	"Invalid mode selection, expected FM or AM (0/1)");
use constant (INVALID_TONE	=>
	"Invalid tone selection, expected 1,3..39 (use ToTone method?)");
use constant (INVALID_COLOR	=>
	"Invalid color selection, expected 0..7 (use color constants?)");

sub new {
  my $caller = shift;
  my $serial = shift;

  my $self = {};

  my $UNIX = 0;
  my $WINDOWS = 1;

  my $os = ($^O eq "MSWin32" ? $WINDOWS : $UNIX);

  if ($os == $UNIX) {
		my $tty = $serial;
		$tty =~ s/[^\w\/\.]//g;
		if ($tty) {
			if ((-r $tty) && (-w $tty)) {
				system("stty 9600 -echo -cstopb raw < $tty");
				$self->{_fd} = gensym;
				if (open($self->{_fd}, "+<$tty")) {
					$self->{_serial} = $tty;
				} else {
					croak "$tty: $!";
				}
				my $oldfh = select($self->{_fd});
				$|=1;
				select($oldfh);
			} else {
				$! = 13;	# EACCES
			}
		}
  } elsif ($os == $WINDOWS) {
    my $configuration = $serial;
    require Win32::SerialPort;
    tie(*FH, 'Win32::SerialPort', $configuration) || croak("Can't tie: $^E");
    $self->{_fd} = *FH;
    $self->{_serial} = $configuration;
  }

  $self->{_CALLBACK} = {};
  $self->{_TEXT} = $TEXT;

  if ((!$serial) || $self->{_serial}) {
    bless $self, $caller;
    return $self;
  } else {
    return undef;
  }
}

##################
# Sends the raw argument straight to the serial port
sub Send {
	my $self = shift;
	my $data = shift;
	local($_);

	if ($DEBUG) {
		my $ddata = $data;
		chop($ddata);
		$ddata =~ s/[^\w\s]/./g;
		print "[Debug] Sending:  $ddata [";
		print join(" ", map(sprintf("%02x", ord($_)), split(//, $data)));
		print "]\n";
	}

	if ($self->{_TEXT}) {
		my $S = $self->{_fd};
		print $S $data;
	} else {
		syswrite($self->{_fd}, $data, length($data));
	}
}
sub RawSend {
	&Send(@_);
}

##################
# Receives raw data from the serial port.
sub RawReceive {
	my $self = shift;
	my $timeout = shift || 0.3;
	my $buf = "";

	if ($self->{_TEXT}) {
		my $save = $/;
		$/ = "\r";
		my $S = $self->{_fd};
		$buf = <$S>;
		$/ = $save;
	} else {
		my ($rin, $rout, $t);
		vec($rin, fileno($self->{_fd}), 1) = 1;
		while (select($rout=$rin, undef, undef, $timeout)) {
			sysread($self->{_fd}, $t, 1);
			$buf .= $t;
		}
	}

	if ($DEBUG) {
		my $ddata = $buf;
		chop($ddata);
		$ddata =~ s/[^\w\s]/./g;
		print "[Debug] Received: $ddata [";
		print join(" ", map(sprintf("%02x", ord($_)), split(//, $buf)));
		print "]\n";
	}

	return $buf;
}

##################
# Performs an action and returns the results
sub Do {
	my $self = shift;
	my $message = shift;
	my $args = shift;
	$args = " $args" if defined($args);
	$args .= join(",", @_);

	my $success = $self->Send("$message$args\r");

	if ($success) {
		my $result = $self->RawReceive($self->{Timeout} ? $self->{Timeout} : 0.3);

		chomp($result);
		return wantarray ? () : undef if $result eq "N";
		$self->do_poll($result) if $self->{_PollOnResult};

		$result =~ s/^\S+\s*//;

		return wantarray ? split(/,/, $result) : $result;
	} else {
		return wantarray ? () : undef;
	}
}

##################
# Enters binary mode for sending/receiving data
sub BinaryMode {
	my $self = shift;
	my $onoff = shift;

	&validate($onoff, INVALID_ONOFF, undef, ON, OFF);

	$self->{_TEXT} = (!$onoff) if defined($onoff);
	return $self->{_TEXT};
}

sub GetSocket {
	my $self = shift;

	return $self->{_fd};
}

# Checks the values of an argument to be sure it's within a required range
sub validate {
	my $what = shift;
	my $message = shift || "Invalid argument '$what'";

	for my $v (@_) {
		return 1 if $v eq $what;
	}

	if (defined($what)) {
		croak $message;
	} else {
		croak "Insufficient arguments";
	}
}

##################
# Waits $timeout seconds (or indefinitely if undef'd) for a notification
# from the D7 about an event.  It then passes that event off to any
# defined callback function and returns.
# Returns: undef=timed out, 0=no callback function, 1=callback called
# If called in a list context, the actual line received is returned as
# the second argument.
sub Poll {
	my $self = shift;
	my $timeout = shift;

	# AI must be ON for polling to do anything useful
	$self->AI(ON) unless $self->{_AI};

	my ($rin, $rout, $t, $buf);
	vec($rin, fileno($self->{_fd}), 1) = 1;
	while (select($rout=$rin, undef, undef, $timeout)) {
		sysread($self->{_fd}, $t, 1);
		$buf .= $t;
		if ($t eq "\r") {
			if ($DEBUG) {
				my $ddata = $buf;
				chop($ddata);
				$ddata =~ s/[^\w\s]/./g;
				print "[Debug] Received: $ddata [";
				print join(" ", map(sprintf("%02x", ord($_)), split(//, $buf)));
				print "]\n";
			}
			chop($buf);
			return $self->do_poll($buf);
		}
	}
	return undef;
}

##################
# Used by Poll and RawReceive to check incoming text to see if we should
# pass it off to a callback function
sub do_poll {
	my $self = shift;
	my $buf = shift;

	my ($cmd, $args) = ($buf =~ /^(\S+)\s*(.*)/);

	# Quick hack to make TC callbacks work -- TS is not a real command?
	$cmd = "TC" if $cmd eq "TS";

	my @args = split(/,/, $args);
	if (exists($self->{_CALLBACK}->{$cmd})) {
		&{$self->{_CALLBACK}->{$cmd}}($self, $cmd, split(/,/,$args));
		return wantarray ? (1, $cmd, @args) : 1;
	} elsif (exists($self->{_CALLBACK}->{_DEFAULT_})) {
		&{$self->{_CALLBACK}->{_DEFAULT_}}($self, $cmd, split(/,/,$args));
		return wantarray ? (0, $cmd, @args) : 1;
	} else {
		return wantarray ? (0, $cmd, @args) : 0;
	}
}

##################
# Adds a coderef to the callback hash for the specified command
sub add_callback {
	my $self = shift;
	my $which = shift;
	my $proc = shift;

	undef $proc if $proc == NOCALLBACK;

	if (defined($proc)) {
		$self->{_CALLBACK}->{$which} = $proc;
	} else {
		delete $self->{_CALLBACK}->{$which};
	}
}

##################
# Sets the "default" callback function, where unassigned callback events go.
sub Callback {
	my $self = shift;
	my $proc = shift;

	return $self->add_callback("_DEFAULT_", $proc) if
		(ref($proc) eq "CODE" || (!defined($proc)));
	croak "Not a code ref to Callback method";
}

##################
# Changes the PollOnResult flag.  If set, callback functions will be
# called for arguments returned from explicitely sent commands instead
# of just when things on the D7 change.
sub PollOnResult {
	my $self = shift;
	my $setting = shift;

	&validate($setting, INVALID_ONOFF, undef, ON, OFF);

	$self->{_PollOnResult} = $setting if defined($setting);
	return $self->{_PollOnResult};
}

##################
sub Simple_OnOff {
	my $item = shift;
	my $self = shift;
	my $setting = shift;

	return $self->add_callback($item, $setting) if ref($setting) eq "CODE";
	&validate($setting, INVALID_ONOFF, undef, ON, OFF);

	$self->Do($item, $setting);
}

sub Simple_Text {
	my $item = shift;
	my $self = shift;
	my $text = shift;

	return $self->add_callback($item, $text) if ref($text) eq "CODE";

	$self->Do($item, $text);
}

sub Unknown {
	my $item = shift;
	my $self = shift;

	if ($^W) {
		carp("Warning, $item is an unknown/undefined D7 function in THD7.pm version $VERSION");
	}
	return $self->add_callback($item, $_[0]) if ref($_[0]) eq "CODE";

	$self->Do($item, @_);
}

sub ToStep {
	my ($self, $step) = @_;
	$step = $self unless ref($self);
	return $STEPS{$step};
}
sub FromStep {
	my ($self, $step) = @_;
	$step = $self unless ref($self);
	return $REV_STEPS{$step};
}
sub ToTone {
	my ($self, $tone) = @_;
	$tone = $self unless ref($self);
	return $TONES{$tone};
}
sub FromTone {
	my ($self, $tone) = @_;
	$tone = $self unless ref($self);
	return $REV_TONES{$tone};
}
sub ToPosit {
	my $self = shift;
	unshift(@_, $self) unless ref($self);
	my $latm = shift;
	my $lats = shift;
	my $longm = shift;
	my $longs = shift;
	my ($ns, $ew);

	if ($latm < 0) {
		$ns = 1;
		$latm *= -1;
	} else {
		$ns = 0;
	}

	if ($longm < 0) {
		$ew = 1;
		$longm *= -1;
	} else {
		$ew = 0;
	}

	my $posit = sprintf("%02d%05d%1d%03d%05d%1d", $latm, $lats * 1000,
		$ns, $longm, $longs * 1000, $ew);

	if ($DEBUG) {
		print "[DEBUG] $latm' $lats\" $ns x $longm' $longs\" $ew -> $posit\n";
	}
	return $posit;
}
sub FromPosit {
	my $self = shift;
	unshift(@_, $self) unless ref($self);
	my $posit = shift;

	my $latm = substr($posit, 0, 2);
	my $lats = substr($posit, 2, 5) / 1000;
	my $ns = substr($posit, 7, 1);
	my $longm = substr($posit, 8, 3);
	my $longs = substr($posit, 11, 5) / 1000;
	my $ew = substr($posit, 16, 1);

	$latm *= -1 if $ns;
	$longm *= -1 if $ew;

	return ($latm, $lats, $longm, $longs);
}

# Begin TH-D7 Functions

##################
# Advanced output
#
# Syntax:
# AI [0|1]
# AI [OFF|ON]
#
# Turns on output functions. Immediate functions output to the serial port.
# This feature must be enabled before polling for events.
#
sub AI {
	my $self = shift;
	my $which = shift;

	return $self->add_callback("AI", $which) if ref($which) eq "CODE";
	&validate($which, INVALID_ONOFF, undef, ON, OFF);

	$self->{_AI} = $self->Do("AI", $which);
}

##################
# Advanced Intercept Point
#
# Syntax:
# AIP [0|1]
# AIP [OFF|ON]
#
# Alias: VHFAIP
#
sub AIP {
	&Simple_OnOff("AIP", @_);
}
sub VHFAIP { &AIP(@_); }

##################
# Automatic Message Reply
#
# Syntax:
# AMR [0|1]
# AMR [OFF|ON]
#
sub AMR {
	my $self = shift;
	my $mode = shift;

	return $self->add_callback("AMR", $mode) if ref($mode) eq "CODE";
	# &validate($mode, ...);

	$self->Do("AMR", $mode);
}

##################
# Send APRS message
#
# Syntax: AMGS [Callsign][Message]
#
# Alias: APRS_Send
#
sub AMSG {
  my $self = shift;
  my $callsign = shift;
  my $message = shift;

	return $self->add_callback("AMSG", $message) if ref($message) eq "CODE";
  # Both parameters are strings so validation step has been left out.

  $self->Do("AMSG", 0, $callsign, $message);
}
sub APRS_Send { &AMSG(@_); }

##################
# Automatic Power Off
#
# APO [0..2]
# APO [OFF|APO_30|APO_60]
#
# This subroutine returns a second argument that, when ON, indicates the unit is
# about to power off due to inactivity.
#
sub APO {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("APO", $setting) if ref($setting) eq "CODE";
	&validate($setting,
		"Invalid APO setting, expected OFF/APO_30/APO_60 [0..2]", undef, OFF,
		APO_30, APO_60);

	$self->Do("APO", $setting);
}

##################
# Auto Repeater Offset
#
# Syntax:
# ARO [0|1]
# ARO [OFF|ON]
#
# Alias: AutoOffset
#
sub ARO {
	&Simple_OnOff("ARO", @_);
}
sub AutoOffset { &ARO(@_); }

##################
# APRS Position Limit
#
# Syntax: ARL n (units dependent upon UNIT setting)
# Alias: APRS_PosLimit
#
sub ARL {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("ARL", $setting) if ref($setting) eq "CODE";

	$setting = sprintf("%04d", $setting) if defined($setting);
	$self->Do("ARL", $setting);
}
sub APRS_PosLimit { &ARL(@_); }

##################
# Speaker Balance
#
# Syntax: BAL [0|1],[0..4], 0=A Only, 4=B Only, 2=Even
#
# Alias: Balance
#
# Returns: Balance [0..4]
#
sub BAL {
	my $self = shift;
	my $balance = shift;

	return $self->add_callback("BAL", $balance) if ref($balance) eq "CODE";
	&validate($balance, "Invalid balance setting (0..4)", undef, 0..4);

	$self->Do("BAL", $balance);
}
sub Balance { &BAL(@_); }

##################
# Band Switch
#
# Syntax:
# BC [0|1]
# BC [A|B]
# Alias: Band
#
# Returns: Band A/B [0|1]
#
sub BC {
	my $self = shift;
	my $which = shift;

	return $self->add_callback("BC", $which) if ref($which) eq "CODE";
	&validate($which, INVALID_BAND, undef, BAND_A, BAND_B);

	$self->Do("BC", $which);
}
sub Band { &BC(@_); }

##################
# APRS Beacon
#
# Syntax:
# BCN [0|1]
# BCN [OFF|ON]
#
# Alias: APRS_Beacon
#
sub BCN {
	&Simple_OnOff("BCN", @_);
}
sub APRS_Beacon { &BCN(@_); }

##################
# Bell
#
# Syntax:
# BEL [0|1],[0|1]
# BEL [A|B],[OFF|ON]
# Alias: Bell
#
# Turn bell on or off for band A or band B
#
sub BEL {
	my $self = shift;
	my $band = shift;
	my $setting = shift;

	return $self->add_callback("BEL", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);
	&validate($setting, INVALID_ONOFF, undef, ON, OFF);

	my $arg = $band;
	$arg = "$band,$setting" if defined($setting);

	$self->Do("BEL", $arg);
}
sub Bell { &BEL(@_); }

##################
# Key Beep Mode
#
# Syntax:
# BEP [0..3]
# BEP [OFF|KEY|KEY_DATA|ALL]
# Alias: Beep
#
sub BEP {
	my $self = shift;
	my $mode = shift;

	return $self->add_callback("BEP", $mode) if ref($mode) eq "CODE";
	&validate($mode, "Invalid beep setting, expected 0..3", undef, 0..3);

	$self->Do("BEP", $mode);
}
sub Beep { &BEP(@_); }

##################
# APRS Tone Alert Events
#
# Syntax: BEPT [0..3]
#
# Sets a distinct tone alert for APRS events.
#
sub BEPT {
  my $self = shift;
  my $mode = shift;

  return $self->add_callback("BEPT", $mode) if ref($mode) eq "CODE";
	&validate($mode, "Invalid APRS beep setting, expected 0..3", undef, 0..3);

  $self->Do("BEPT", $mode);
}

##################
# Store VHO Frequency
#
# Syntax: BUF [A|B],freq_in_Hz,step,?,rev,tone,ctcss,?,tonefreq,?,ctcssfreq,ofs,mode
# Alias: Buffer, Set
#
# Sets the VFO frequency for band [A|B] to the parameters specified.
#
sub BUF {
	my $self = shift;
	my ($band, $freq, $step, $x1, $reverse, $tone, $ctcss, $x2,
		$tonefreq, $x3, $ctcssfreq, $offset, $mode) = @_;

	return $self->add_callback("BUF", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);
	if ($freq) {
		croak("Invalid frequency, expected integer Hz") if $freq !~ /^\d+$/;
		&validate($step, "Invalid step range, expected 0..9", 0..9);
		&validate($reverse, INVALID_ONOFF, ON, OFF);
		&validate($tone, INVALID_ONOFF, ON, OFF);
		&validate($ctcss, INVALID_ONOFF, ON, OFF);
		&validate($tonefreq, "Invalid PL freq, expected 1,3..39 (use ToTone method?)", TONES);
		&validate($ctcssfreq, "Invalid CTCSS freq, expected 1,3..39 (use ToTone method?)", TONES);
		croak("Invalid repeater offset, expected integer Hz") if $offset !~ /^\d+$/;
		&validate($mode, INVALID_MODE, FM, AM);
		$self->Do("BUF", $band, sprintf("%011d", $freq), $step, $x1 ? $x1 : 0,
			$reverse, $tone, $ctcss, $x2 ? $x2 : 0, $tonefreq, $x3 ? $x3 : 0,
			$ctcssfreq, sprintf("%011d", $offset), $mode);
	} else {
		$self->Do("BUF", $band);
	}
}
sub Buffer { &BUF(@_); }
sub Set { &BUF(@_); }

##################
# Squlech on Band (Not Writeable)
#
# Syntax:
# BY [0|1],[0|1]
# BY [A|B], [CLOSED|OPEN]
# Alias: Squelched
#
# Returns: Band A/B [0|1], Squelch Open [0|1]
#
sub BY {
	my $self = shift;
	my $band = shift;
	my $anything_else = shift;

	return $self->add_callback("BY", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);
	&validate($anything_else, NOWRITE, undef);

	$self->Do("BY", $band);
}
sub Squelched { &BY(@_); }

##################
# Channel Display Mode
#
# Syntax: CH [0|1]
# Alias: ChannelMode
#
# Channel Display mode, access restricted to navigating the stored memory channels ONLY.
#
sub CH {
	&Simple_OnOff("CH", @_);
}
sub ChannelMode { &CH(@_); }

##################
# LCD Screen Constrast
#
# Syntax: CNT [1-16] LCD contrast (8 = default)
# Alias: Contrast
#
sub CNT {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("CNT", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid contrast setting, expected 1..16", undef,
		1..16);

	if (defined($setting)) {
		$self->Do("CNT", sprintf("%02d", $setting));
	} else {
		$self->Do("CNT");
	}
}
sub Contrast { &CNT(@_); }

##################
# CTCSS Enabled
#
# Syntax:
# CT [0|1]
# CTCSS [OFF|ON]
# Alias: CTCSS
#
sub CT {
	&Simple_OnOff("CT", @_);
}
sub CTCSS { &CT(@_); }

##################
# CTCSS Frequency
#
# Syntax: CTN n
# Alias: CTCSSFreq
#
sub CTN {
	my $self = shift;
	my $freq = shift;

	return $self->add_callback("CTN", $freq) if ref($freq) eq "CODE";
	&validate($freq, "Invalid CTCSS frequency, expected 1,3..39 (use ToTone method?)",
    undef, TONES);

	$self->Do("CTN", $freq);
}
sub CTCSSFreq { &CTN(@_); }

##################
# Dual Channels
#
# Syntax: DL [OFF|ON]
# Alias: Dual
#
# Returns: Setting OFF/ON [0|1]
#
sub DL {
	&Simple_OnOff("DL", @_);
}
sub Dual { &DL(@_); }

##################
# DTMF Store Sequence in Memory
#
# Syntax: DM cc,n (store sequence n in memory cc)
# Alias: DTMF_Memory
#
sub DM {
	my $self = shift;
	my $mem = shift;
	my $num = shift;

	return $self->add_callback("DM", $mem) if ref($mem) eq "CODE";
	croak "Invalid DTMF memory number, expected integer" unless $mem =~ /^\d+$/;

	$self->Do("DM", sprintf("%02d", $mem), $num);
}
sub DTMF_Memory { &DM(@_); }

##################
# DTMF Names Channel
#
# Syntax: DMN cc,name
# Alias: DTMF_Name
#
sub DMN {
	my $self = shift;
	my $mem = shift;
	my $name = shift;

	return $self->add_callback("DMN", $mem) if ref($mem) eq "CODE";
	croak "Invalid DTMF memory number, expected integer" unless $mem =~ /^\d+$/;

	$self->Do("DMN", sprintf("%02d", $mem), $name);
}
sub DTMF_Name { &DMN(@_); }

##################
# DCD Sense
#
# Syntax:
# DS [0|1]
# DS [DATA|BOTH]
# Alias: DCDSense
#
sub DS {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("DS", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid DS setting, expected DATA/BOTH [0|1]",
		undef, DATA, BOTH);

	$self->Do("DS", $setting);
}
sub DCDSense { &DS(@_); }

##################
# Set Data BAnd
#
# Syntax:
# DTB [0|1]
# DTB [A|B]
# Alias: DataBand
#
sub DTB {
	&Simple_OnOff("DTB", @_);
}
sub DataBand { &DTB(@_); }

##################
# APRS Data Tx Mode
#
# Syntax:
# DTX [0..2]
# DTX [MANUAL|PTT|AUTO]
# Alias: APRS_TransmitMode
#
sub DTX {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("DTX", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid APRS TX mode, expected MANUAL/PTT/AUTO [0..2]",
		undef, MANUAL, PTT, AUTO);

	$self->Do("DTX", $setting);
}
sub APRS_TransmitMode { &DTX(@_); }

##################
# Set Full Duplex Mode
#
# Syntax:
# DUP [0|1]
# DUP [HALF|FULL]
# Alias: Duplex
#
sub DUP {
	&Simple_OnOff("DUP", @_);
}
sub Duplex { &DUP(@_); }

##################
# Adjust Frequency Downward
#
# Syntax: DW
# Alias: Down
#
sub DW {
	my $self = shift;
	my $blah = shift;

	return $self->add_callback("DW", $blah) if ref($blah) eq "CODE";
	&validate($blah, NOWRITE, undef);

	$self->Do("DW");
}
sub Down { &DW(@_); }

##################
# Tune Enable
#
# Syntax:
# ELK [0|1]
# ELK [OFF|ON]
# Alias: TuneEnable
#
sub ELK {
	&Simple_OnOff("ELK", @_);
}
sub TuneEnable { &ELK(@_); }

##################
# Returns an Even Numbered List of Band Extents
#
# Syntax: FL
# Alias: FreqList
#
sub FL {
	my $self = shift;
	my $blah = shift;

	return $self->add_callback("FL", $blah) if ref($blah) eq "CODE";
	&validate($blah, NOWRITE, undef);

	$self->Do("FL");
}
sub FreqList { &FL(@_); }

##################
# Sets the Current Frequency and Select Band
#
# Syntax: FQ
# Alias: Freq
#
# Sets/returns the current frequency and step on the currently selected band.
# This callback is not normally used.
#
sub FQ {
	my $self = shift;
	my $freq = shift;
	my $step = shift;

	return $self->add_callback("FQ", $freq) if ref($freq) eq "CODE";
	if (defined($freq)) {
		croak("Invalid frequency, expected integer Hz") unless $freq =~ /^\d+$/;
		&validate($step, "Invalid step, expected 0..9 (use ToStep method?)",
			0..9);
		$freq .= ",$step";
	}

	$self->Do("FQ", $freq);
}

##################
# GPS Unit
#
# Syntax:
# GU [0|1]
# GU [OFF|ON]
# Alias: GPS
#
sub GU {
	&Simple_OnOff("GU", @_);
}
sub GPS { &GU(@_); }

##################
# Set APRS Icon
#
# Syntax:
# ICO [0|1],i
# ICO [BUILT-IN|EXTENDED], icon # or string
# Alias: APRS_Icon
#
sub ICO {
	my $self = shift;
	my $extended = shift;
	my $icon = shift;

	return $self->add_callback("ICO", $extended) if ref($extended) eq "CODE";
	&validate($extended, "Invalid icon description flag, expected 1 or 0",
		undef, 1, 0);
	if ($extended) {
		croak "Invalid APRS icon, expected user-defined two-byte icon string"
			unless $icon;
	} elsif (defined($extended)) {
		&validate($icon, "Invalid APRS icon, expected built-in hex range 0..E",
			 0..9, "A".."E", "a".."e");
	}

	$self->Do("ICO", $extended, $icon);
}
sub APRS_Icon { &ICO(@_); }

##################
# Radio ID
#
# Syntax: ID
#
# Returns ID (should be "TH-D7")
#
sub ID {
	my $self = shift;
	my $callback = shift;

	return $self->add_callback("ID", $callback) if ref($callback) eq "CODE";

	$self->Do("ID");
}

##################
# Lock Radio
#
# Syntax:
# LK [0|1]
# LK [OFF|ON]
# Alias: Lock
#
sub LK {
	&Simple_OnOff("LK", @_);
}
sub Lock { &LK(@_); }

##################
# Radio Lamp
#
# Syntax:
# LMP [0|1]
# LMP [OFF|ON]
# Alias: Lamp
#
sub LMP {
	&Simple_OnOff("LMP", @_);
}
sub Lamp { &LMP(@_); }

##################
# APRS list message
#
# Syntax: LIST
# Alias: APRS_List
#
sub LIST {
	my $self = shift;
	my $message = shift;

	return $self->add_callback("LIST", $message) if ref($message) eq "CODE";
	&validate($message, "Invalid message id", undef, 1..40);

	$self->Do("LIST", $message, ". KB8VME");
}
sub APRS_List { &LIST(@_); }

##################
# MAC Color SSTV
#
# Syntax: MAC color
# Alias: SSTV_CallColor
#
sub MAC {
	my $self = shift;
	my $color = shift;

	return $self->add_callback("MAC", $color) if ref($color) eq "CODE";
	&validate($color, INVALID_COLOR, undef, 0..7);

	$self->Do("MAC", $color);
}
sub SSTV_CallColor { &MAC(@_); }

##################
# Set Memory Channel
#
# Syntax:
# MC [0|1], n
# MC [BAND_A|BAND_B], n
# Alias: Memory
#
sub MC {
	my $self = shift;
	my $band = shift;
	my $mem = shift;

	return $self->add_callback("MC", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);

	$self->Do("MC", $band, $mem);
}
sub Memory { &MC(@_); }

##################
# Modulation Mode
#
# Syntax:
# MD [0|1]
# MD [FM|AM]
# Alias: Modulation
#
sub MD {
	my $self = shift;
	my $amfm = shift;

	return $self->add_callback("MD", $amfm) if ref($amfm) eq "CODE";
	&validate($amfm, "Invalid modulation, expected AM or FM", undef, AM, FM);

	$self->Do("MD", $amfm);
}
sub Modulation { &MD(@_); }

##################
# Lock Memory Channel
#
# Syntax:
# MCL [0|1],[0|1]
# MCL [BAND_A|BAND_B] [OFF|ON]
# Alias: MemoryLock
#
sub MCL {
	my $self = shift;
	my $band = shift;
	my $locked = shift;

	return $self->add_callback("MCL", $band) if ref($band) eq "CODE";
	&validate($locked, INVALID_ONOFF, undef, ON, OFF);

	$self->Do("MCL", $band, $locked);
}
sub MemoryLock { &MCL(@_); }

##################
# Power-on Message
#
# Syntax: MES message
# Alias: Message
#
sub MES {
	&Simple_Text("MES", @_);
}
sub Message { &MES(@_); }

##################
# Memory Channel Name
#
# Syntax: MNA 0?,n,name (8chars max)
# Alias: MemoryName
#
sub MNA {
	my $self = shift;
	my $x1 = shift;
	my $mem = shift;
	my $name = shift;

	return $self->add_callback("MNA", $x1) if ref($x1) eq "CODE";
	$x1 = 0 unless $x1;
	$mem = 0 unless $mem;

	$self->Do("MNA", $x1, $mem, $name);
}
sub MemoryName { &MNA(@_); }

##################
# Monitor Mode
#
# Syntax: MON [0|1]
# Alias: Monitor
#
# Turns on/off "monitor" (squelch).  Similar in effect to BY, but uses
# the currently selected band.
#
sub MON {
	&Simple_OnOff("MON", @_);
}
sub Monitor { &MON(@_); }

##################
# Position
#
# Syntax: MP posit (iiffffNiiiffffW)
#
# Use ToPosit method to convert normalized coordinates to this format.
# Alias: Position
#
sub MP {
	my $self = shift;
	my $position = shift;

	return $self->add_callback("MP", $position) if ref($position) eq "CODE";
	croak "Invalid position string (use ToPosit?)"
		unless !defined($position) || $position =~ /^\d{15}$/;

	$self->Do("MP", $position);
}
sub Position { &MP(@_); }

##################
# Read Memory Channel
#
# Syntax: MR 0?,0?,n Reads memory channel n
# This appears to be the only way you can get an "MR" response, so callback
# seems unnecessary
# Alias: MemoryRead
#
sub MR {
	my $self = shift;
	my $x1 = shift;
	my $x2 = shift;
	my $mem = shift;

	return $self->add_callback("MR", $x1) if ref($x1) eq "CODE";
	$x1 = 0 unless $x1;
	$x2 = 0 unless $x2;
	croak "Invalid memory channel, expected integer" unless $mem =~ /^\d+$/;

	$self->Do("MR", $x1, $x2, sprintf("%03d", $mem));
}
sub MemoryRead { &MR(@_); }

##################
# Memory Write
#
# Syntax: MW 0?,n,freq,step,0?,rev,tone,ctcss,0?,tonefreq,0?,ctcssfreq,ofs,mode,0?
# Alias: MemoryWrite
#
sub MW {
	my $self = shift;
	my ($x1, $mem, $freq, $step, $x2, $reverse, $tone, $ctcss, $x3,
		$tonefreq, $x4, $ctcssfreq, $offset, $mode, $x5) = @_;

	return $self->add_callback("MW", $x1) if ref($x1) eq "CODE";
	if ($freq) {
		croak("Invalid frequency, expected integer Hz") if $freq !~ /^\d+$/;
		&validate($step, "Invalid step range, expected 0..9 (use ToStep method?)",
      0..9);
		&validate($reverse, INVALID_ONOFF, ON, OFF);
		&validate($tone, INVALID_ONOFF, ON, OFF);
		&validate($ctcss, INVALID_ONOFF, ON, OFF);
		&validate($tonefreq, "Invalid PL freq, expected 1,3..39 (use ToTone method?)",
      TONES);
		&validate($ctcssfreq, "Invalid CTCSS freq, expected 1,3..39 (use ToTone method?)",
      TONES);
		croak("Invalid repeater offset, expected integer Hz") if $offset !~ /^\d+$/;
		&validate($mode, INVALID_MODE, FM, AM);
		$self->Do("MW", $x1 ? $x1 : 0, sprintf("%03d", $mem),
			sprintf("%011d", $freq), $step, $x2 ? $x2 : 0,
			$reverse, $tone, $ctcss, $x3 ? $x3 : 0, $tonefreq, $x4 ? $x4 : 0,
			$ctcssfreq, sprintf("%011d", $offset), $mode, $x5 ? $x5 : 0);
	} else {
		$self->Do("MW", $x1, $mem);
	}
}
sub MemoryWrite { &MW(@_); }

##################
# Call
#
# Syntax: MYC call
# Alias: APRS_MyCall
#
sub MYC {
	&Simple_Text("MYC", @_);
}
sub APRS_MyCall { &MYC(@_); }

##################
# NSFT
#
sub NSFT {
	my $self = shift;
	my $x1 = shift;

	return $self->add_callback("NSFT", $x1) if ref($x1) eq "CODE";

	$self->Do("NSFT", $x1, @_);
}

##################
# Repeater Offset
#
# Syntax: OS nnnnnnnnn
# Alias: Offset
#
# Note, repeater offset is in Hz
#
sub OS {
	my $self = shift;
	my $offset = shift;

	return $self->add_callback("OS", $offset) if ref($offset) eq "CODE";
	$offset = sprintf("%09d", $offset) if defined($offset);

	$self->Do("OS", $offset);
}
sub Offset { &OS(@_); }

##################
# APRS Position Comment
#
# Syntax:
# POSC [0..7]
# POSC off duty|enroute|in service|returning|committed|special|priority|emergency
# Alias: APRS_Comment
#
sub POSC {
	my $self = shift;
	my $comment = shift;

	return $self->add_callback("POSC", $comment) if ref($comment) eq "CODE";
	&validate($comment, "Invalid comment setting, expected 0..9", undef, 0..9);

	$self->Do("POSC", $comment);
}
sub APRS_Comment { &POSC(@_); }

##################
# APRS Packet Path
# Syntax: PP path
# Alias: APRS_Path
#
sub PP {
	&Simple_Text("PP", @_);
}
sub APRS_Path { &PP(@_); }

##################
# DTMF Transmit Pause
#
# Syntax:
# PT [0-6]
# PT 100|200|500|750|1000|1500|2000 ms
# Alias: DTMF_Pause
#
sub PT {
	my $self = shift;
	my $pause = shift;

	return $self->add_callback("PT", $pause) if ref($pause) eq "CODE";
	&validate($pause, "Invalid pause range, expected 0..6", undef, 0..6);

	$self->Do("PT", $pause);
}
sub DTMF_Pause { &PT(@_); }

##################
# Programmable VFO
#
# Syntax:
# PV [1|2|3|6],f1,f2
# PV [AIR|VHF_A|VHF_B|UHF] low=f1 high=f2
# Alias: ProgrammableVFO
#
# f1 and f2 are frequencies in MHz.
#
sub PV {
	my $self = shift;
	my $band = shift;
	my $f1 = shift;
	my $f2 = shift;

	return $self->add_callback("PV", $band) if ref($band) eq "CODE";
	&validate($band, "Invalid PV band, expected AIR/VHF_A/VHF_B/UHF",
		AIR, VHF_A, VHF_B, UHF);
	if (defined($f1)) {
		if ($f1 =~ /\D/) {
			croak("Invalid PV argument, expected numeric MHz value for f1");
		}
		if ($f2 =~ /\D/) {
			croak("Invalid PV argument, expected numeric MHz value for f2");
		}
		$self->Do("PV", $band, sprintf("%05d,%05d", $f1, $f2));
	} else {
		$self->Do("PV", $band);
	}
}
sub ProgrammableVFO { &PV(@_); }

##################
# Reverse Mode
#
# Syntax: REV [OFF|ON]
# Alias: Reverse
#
# Returns: Setting OFF/ON [0|1]
#
sub REV {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("REV", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Argument must be ON or OFF (1/0)", undef, ON, OFF);

	$self->Do("REV", $setting);
}
sub Reverse { &REV(@_); }

##################
# SSTV RSV Message
#
# Syntax: RSV message
# Alias: SSTV_RSV
#
sub RSV {
	&Simple_Text("RSV", @_);
}
sub SSTV_RSVMessage { &RSV(@_); }

##################
# SSTV RSC Color
#
# Syntax: RSC color[0..7]
# Alias: SSTV_RSVColor
#
sub RSC {
	my $self = shift;
	my $color = shift;

	return $self->add_callback("RSC", $color) if ref($color) eq "CODE";
	&validate($color, INVALID_COLOR, undef, 0..7);

	$self->Do("RSC", $color);
}
sub SSTV_RSVColor { &RSC(@_); }

##################
# RX Receive
#
# Syntax: RX
# Alias: Receive
#
# Returns: 1 if success, undef if failure
#
sub RX {
	my $self = shift;
	my $which = shift;

	return $self->add_callback("RX", $which) if ref($which) eq "CODE";
	&validate($which, NOWRITE, undef);

	return defined($self->Do("RX")) ? 1 : undef;
}
sub Receive { &RX(@_); }

##################
# Scan Toggle
#
# Syntax:
# SC [0|1]
# SC [OFF|ON]
# Alias: Scan
#
# Begins/stops scanning on the currently selected band
#
sub SC {
	&Simple_OnOff("SC", @_);
}
sub Scan { &SC(@_); }

##################
# Sky Commander Call Sign
#
# SCC call
# Alias: Sky_CommanderCall
#
sub SCC {
	&Simple_Text("SCC", @_);
}
sub Sky_CommanderCall { &SCC(@_); }

##################
# Scan Resume
#
# Syntax:
# SCR [0..2]
# SCR [TIME|CARRIER|SEEK]
# Alias: ScanResume
#
sub SCR {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("SCR", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid SCR setting, expected 0..2", undef, 0..2);

	$self->Do("SCR", $setting);
}
sub ScanResume { &SCR(@_); }

##################
# Sky Command Transporter Call Sign
#
# Syntax: SCT call call sign
# Alias: Sky_TransporterCall
#
sub SCT {
	&Simple_Text("SCT", @_);
}
sub Sky_TransporterCall { &SCT(@_); }

##################
# Repeater Offset Shift
#
# Syntax:
# SFT [0|1|2]
# SFT [OFF|NEGATIVE|POSITIVE]
# Alias: Shift
#
sub SFT {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("SFT", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid shift, expected OFF/NEGATIVE/POSITIVE",
		undef, OFF, NEGATIVE, POSITIVE);

	$self->Do("SFT", $setting);
}
sub Shift { &SFT(@_); }

##################
# Sky Commander Access Tone
#
# Syntax: SKTN tone [1,3..39]
# Alias: Sky_Tone
#
sub SKTN {
	my $self = shift;
	my $tone = shift;

	return $self->add_callback("SKTN", $tone) if ref($tone) eq "CODE";
	&validate($tone, INVALID_TONE, undef, TONES);

	$self->Do("SKTN", $tone);
}
sub Sky_Tone { &SKTN(@_); }

##################
# Signal Meter
#
# Syntax:
# SM [0|1],nn
# SM [A|B
# Alias: SignalMeter
#
# Returns 00..05, READ ONLY
#
sub SM {
	my $self = shift;
	my $band = shift;
	my $else = shift;

	return $self->add_callback("SM", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);
	&validate($else, NOWRITE, undef);

	$self->Do("SM", $band);
}
sub SignalMeter { &SM(@_); }

##################
# SSTV Message Color
#
# Syntax: SMC color[0..7]
# Alias: SSTV_MessageColor
#
sub SMC {
	my $self = shift;
	my $color = shift;

	return $self->add_callback("SMC", $color) if ref($color) eq "CODE";
	&validate($color, INVALID_COLOR, undef, 0..7);
}
sub SSTV_MessageColor { &SMC(@_); }

##################
# SSTV Message
#
# Syntax: SMSG msg SSTV
# Alias: SSTV_Message
#
sub SMSG {
	&Simple_Text("SMSG", @_);
}
sub SSTV_Message { &SMSG(@_); }

##################
# SSTV Call
#
# SMY call
# Alias: SSTV_MyCall
#
sub SMY {
	&Simple_Text("SMY", @_);
}
sub SSTV_MyCall { &SMY(@_); }

##################
# Squelch
#
# Syntax:
# SQ [0|1],[00..05]
# SQ [A|B] (00=open)
# Alias: Squelch
#
sub SQ {
	my $self = shift;
	my $band = shift;
	my $value = shift;

	return $self->add_callback("SQ", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, BAND_A, BAND_B);
	&validate($value, "Invalid squelch setting, expected 0..5 (0=open)",
		undef, 0..5);

	$value = sprintf("%02d", $value) if defined($value);

	$self->Do("SQ", $band, $value);
}
sub Squelch { &SQ(@_); }

##################
# Set Step Size
#
# Syntax: ST n
# Alias: Step
#
sub ST {
	my $self = shift;
	my $step = shift;

	return $self->add_callback("ST", $step) if ref($step) eq "CODE";
	&validate($step, "Invalid step size, expected 0..9 (use ToStep method?)",
		undef, 0..9);

	$self->Do("ST", $step);
}
sub Step { &ST(@_); }

##################
# Set APRS Text
#
# Syntax: STAT text
# Alias: APRS_Status
#
sub STAT {
	&Simple_Text("STAT", @_);
}
sub APRS_Status { &STAT(@_); }

##################
# APRS Status Tx
#
# Syntax: STXR
# Alias: APRS_StatusTx
#
sub STXR {
  my $self = shift;
  my $level = 1;

	return $self->add_callback("STXR", $level) if ref($level) eq "CODE";
	&validate($level, "Invalid statux tx, expected 0..8", undef, 0..8);

  $self->Do("STXR", $level);
}
sub APRS_StatusTx { &STXR(@_); }

##################
# SSTV Superimpose
#
# Syntax: STC call,n
# Alias: SSTV_Superimpose
#
sub STC {
	my $self = shift;
	my $call = shift;
	my $x1 = shift;

	return $self->add_callback("STC", $call) if ref($call) eq "CODE";

	$self->Do("STC", $call, $x1 ? $x1 : 0);
}
sub SSTV_Superimpose { &STC(@_); }

##################
# SSTV Transmit Mode
#
# Syntax: STS transmit mode
# Alias: SSTV_Mode
#
sub STS {
	my $self = shift;
	my $x1 = shift;

	return $self->add_callback("STS", $x1) if ref($x1) eq "CODE";

	$self->Do("STS", $x1, @_);
}
sub SSTV_Mode { &STS(@_); }

##################
# Set Battery Saver
#
# Syntax:
# SV [0..9]
# SV (off|0.2|0.4|0.6|0.8|1.0|2|3|4|5)
# Alias: BatterySave
#
sub SV {
	my $self = shift;
	my $mode = shift;

	return $self->add_callback("SV", $mode) if ref($mode) eq "CODE";
	&validate($mode, "Invalid saver mode, expected 0..9", undef, 0..9);

	$self->Do("SV", $mode);
}
sub BatterySave { &SV(@_); }

##################
# TNC Packet Mode
#
# Syntax:
# TC [0|1]
# TC [OFF|ON] WRITE-ONLY
# Alias: Packet
#
# Note: Entering packet mode via the D7 keypad will NOT activate a
# callback via this method.
# Note: While in Packet mode, NO OTHER COMMANDS WILL BE AVAILABLE
# EXCEPT THIS ONE.  I suppose if your script is designed for that
# sort of thing, you can use the RawSend and RawReceive methods to
# talk to the TNC directly.
# Note: The command itself actually takes 0=ON and 1=OFF, but we
# switch them in the code.
# Note: A callback will be sent ONLY upon the issue of a TC 1 while
# in packet mode, BUT, this callback uses the command "TS" for some
# strange reason.  I think we'll change it to TC in the callback
# code.
#
sub TC {
	my $self = shift;
	my $onoff = shift;

	return $self->add_callback("TS", $onoff) if ref($onoff) eq "CODE";
	&validate($onoff, INVALID_ONOFF, ON, OFF);

	$self->Do("TC", $onoff ? OFF : ON);
}
sub Packet { &TC(@_); }

##################
# Toggle APRS Mode
#
# Syntax:
# TNC [0|1]
# TNC [OFF|ON]
#
# A notification will not be sent via this callback in the event the D7
# enters Packet mode.
# Alias: APRS
#
sub TNC {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("TNC", $setting) if ref($setting) eq "CODE";
	&validate($setting, INVALID_ONOFF, undef, ON, OFF);

	$self->Do("TNC", $setting);
}
sub APRS { &TNC(@_); }

##################
# PL Tone Enable
#
# Syntax: TO [0|1]
# Alias: Tone
#
sub TO {
	&Simple_OnOff("TO", @_);
}
sub Tone { &TO(@_); }

##################
# PL Tone Frequency
#
# Syntax: TN n
# Alias: ToneFreq
#
sub TN {
	my $self = shift;
	my $tone = shift;

	return $self->add_callback("TN", $tone) if ref($tone) eq "CODE";
	&validate($tone, INVALID_TONE, undef, TONES);

	$self->Do("TN", $tone);
}
sub ToneFreq { &TN(@_); }

##################
# DTMF Transmission Speed
#
# Syntax:
# TSP [0|1]
# TSP [SLOW|FAST]
# Alias: DTMF_Speed
#
sub TSP {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("TSP", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid TSP setting, expected SLOW/FAST [0|1]",
		undef, SLOW, FAST);

	$self->Do("TSP", $setting);
}
sub DTMF_Speed { &TSP(@_); }

##################
# Transmit
#
# Syntax:
# TX [0|1]
# TX [A|B]
# Alias: Transmit
#
# WARNING: THIS WILL CAUSE THE D7 TO TRANSMIT UNTIL AN RX COMMAND IS RECEIVED
# UNLESS THE D7'S TX INHIBIT IS ENABLED.
#
sub TX {
	my $self = shift;
	my $band = shift;

	return $self->add_callback("TX", $band) if ref($band) eq "CODE";
	&validate($band, INVALID_BAND, undef, BAND_A, BAND_B);

	$self->Do("TX", $band);
}
sub Transmit { &TX(@_); }

##################
# DTMF Transmit Hold
#
# Syntax:
# TXH [0|1]
# TXH [OFF|ON]
# Alias: DTMF_TransmitHold
#
sub TXH {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("TXH", $setting) if ref($setting) eq "CODE";
	&validate($setting, INVALID_ONOFF, undef, ON, OFF);

	$self->Do("TXH", $setting);
}
sub DTMF_TransmitHold { &TXH(@_) }

##################
# APRS Transmit Interval
#
# Syntax: TXI [0..7]
# Alias: APRS_TransmitInterval
#
sub TXI {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("TXI", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid interval, expected 0..7", undef, 0..7);

	$self->Do("TXI", $setting);
}
sub APRS_TransmitInterval { &TXI(@_); }

##################
# TX Inhibit
#
# Syntax: TXS [0|1]
# Alias: TransmitInhibit
#
sub TXS {
	&Simple_OnOff("TXS", @_);
}
sub TransmitInhibit { &TXS(@_); }

##################
# Measurement Units
#
# Syntax:
# UNIT [0|1]
# UNIT [ENGLISH|METRIC]
# Alias: Unit
#
sub UNIT {
	my $self = shift;
	my $setting = shift;

	return $self->add_callback("UNIT", $setting) if ref($setting) eq "CODE";
	&validate($setting, "Invalid unit selection, expected ENGLISH/METRIC [0|1]",
		undef, METRIC, ENGLISH);

	$self->Do("UNIT", $setting);
}
sub Unit { &UNIT(@_); }

##################
# Adjust the Frequency
#
# Syntax: UP
# Alias: Up
#
sub UP {
	my $self = shift;
	my $blah = shift;

	return $self->add_callback("DW", $blah) if ref($blah) eq "CODE";
	&validate($blah, NOWRITE, undef);

	$self->Do("UP");
}
sub Up { &UP(@_); }

##################
# APRS Unprotocol String
#
# Syntax: UPR unprotocol string
# Alias: APRS_Unprotocol
#
sub UPR {
	&Simple_Text("UPR", @_);
}
sub APRS_Unprotocol { &UPR(@_); }

##################
# VCS Shutter
#
# Syntax:
# VCS [0|1]
# VCS [OFF|ON]
# Alias: SSTV_Shutter
#
sub VCS {
	&Simple_OnOff("VCS", @_);
}
sub SSTV_Shutter { &VCS(@_); }

##################
# VMC Band Mode
#
# Syntax:
# VMC [0|1],[0|2|3]
# VMC [A|B], [VFO|Memory|Call]
# Alias: Mode
#
sub VMC {
	my $self = shift;
	my $mode = shift;

	return $self->add_callback("VMC", $mode) if ref($mode) eq "CODE";
	&validate($mode, "Invalid mode, expected VFO/MEMORY/CALL (0|2|3)",
		undef, 0,2,3);

	$self->Do("VMC", $mode);
}
sub Mode { &VMC(@_); }

##################
# Read VFO Frequency
#
# Syntax: VR vfo
# Alias: VFORead
#
# Reads the currently set frequency for VFO band vfo.
#
sub VR {
	my $self = shift;
	my $vfo = shift;

	return $self->add_callback("VR", $vfo) if ref($vfo) eq "CODE";
	&validate($vfo, "Invalid VFO, expected 1/2/3/6", 1,2,3,6);

	$self->Do("VR", $vfo);
}

##################
# Write VFO Frequency
#
# Syntax: VW vfo,freq_in_Hz,step,?,rev,tone,ctcss,?,tonefreq,?,ctcssfreq,ofs,mode
# Alias: VFOWrite
#
# Sets the VFO frequency for the specified VFO to the parameters specified.
#
sub VW {
	my $self = shift;
	my ($vfo, $freq, $step, $x1, $reverse, $tone, $ctcss, $x2,
		$tonefreq, $x3, $ctcssfreq, $offset, $mode) = @_;

	return $self->add_callback("VW", $vfo) if ref($vfo) eq "CODE";
	&validate($vfo, "Invalid VFO, expected 1/2/3/6", 1,2,3,6);
	croak("Invalid frequency, expected integer Hz") if $freq !~ /^\d+$/;
	&validate($step, "Invalid step range, expected 0..9", 0..9);
	&validate($reverse, INVALID_ONOFF, ON, OFF);
	&validate($tone, INVALID_ONOFF, ON, OFF);
	&validate($ctcss, INVALID_ONOFF, ON, OFF);
	&validate($tonefreq, "Invalid PL freq, expected 1,3..39 (use ToTone method?)",
     TONES);
	&validate($ctcssfreq, "Invalid CTCSS freq, expected 1,3..39 (use ToTone method?)",
     TONES);
	croak("Invalid repeater offset, expected integer Hz") if $offset !~ /^\d+$/;
	&validate($mode, INVALID_MODE, FM, AM);
	$self->Do("VW", $vfo, sprintf("%011d", $freq), $step, $x1 ? $x1 : 0,
		$reverse, $tone, $ctcss, $x2 ? $x2 : 0, $tonefreq, $x3 ? $x3 : 0,
		$ctcssfreq, sprintf("%011d", $offset), $mode);
}

# UNKNOWNS

sub CR { &Unknown("CR", @_); }
sub CW { &Unknown("CW", @_); }
sub GC { &Unknown("GC", @_); }
sub PC { &Unknown("PC", @_); }
sub SR { &Unknown("SR", @_); }
sub TH { &Unknown("TH", @_); }
sub TT { &Unknown("TT", @_); }
sub CIN { &Unknown("CIN", @_); }
sub CTD { &Unknown("CTD", @_); }
sub LAN { &Unknown("LAN", @_); }
sub MIN { &Unknown("MIN", @_); }
sub MNF { &Unknown("MNF", @_); }
sub MSH { &Unknown("MSH", @_); }
sub RBN { &Unknown("RBN", @_); }
sub STM { &Unknown("STM", @_); }
sub STR { &Unknown("STR", @_); }
sub STP { &Unknown("STP", @_); }
sub STT { &Unknown("STT", @_); }
sub TXN { &Unknown("TXN", @_); }
sub TYD { &Unknown("TYD", @_); }
sub ULC { &Unknown("ULC", @_); }

1;

__END__