Kenwood TS-2000, TS-2000X, TS-B2000 manual 122

21 APPENDIX

COMPUTER CONTROL COMMANDS ■ Parameters

A computer control command is composed of an alphabetical command, various parameters, and the terminator that signals the end of the control command.

EXAMPLE: Command to set VFO A to 7 MHz

FA 00007000000 ;

Terminator

Parameters

Alphabetical command

Commands can be classified as shown below:

	Input		Set command
			(Sets a
	command
			particular condition)
	(Input to the
Computer	transceiver)		Read command
control
			(Reads an answer)
commands
	Output	Answer command
	command
		(Transmits a condition)
	(From the
	transceiver)

For example, note the following in the case of the FA command (Frequency of VFO A):

•To set the frequency to 7 MHz, the following command is sent from the computer to the transceiver:

“FA00007000000;” (Set command)

•To read the frequency of VFO A, the following command is sent from the computer to the

Parameters are used to specify information necessary to implement the desired command. The parameters to be used for each command are predetermined. The number of digits assigned to each parameter is also predetermined. Refer to the Computer Control Commands and the PC Control Command Tables {page 115} to configure the appropriate parameters.

When configuring parameters, be careful not to make the following mistakes.

(correct parameter: “IS+1000”)

IS1000; Not enough parameters specified (No direction given for the IF shift)

IS+100; Not enough digits

(Only three frequency digits given)

IS + 1000; Unnecessary characters between parameters

IS+10000; Too many digits

(Five frequency digits given)

Note: If a particular parameter is not applicable to this transceiver, the parameter digits should be filled using any character except the ASCII control codes (00 to 1Fh) and the terminator (;).

■Terminator

To signal the end of a command, it is necessary to use a semicolon (;). The digit where this special character must appear differs depending on the command used.

■Error Messages

In addition to the Answer command, the transceiver can send the following error messages.

transceiver:

“FA;” (Read command)

•When the Read command above has been sent, the following command is returned to the computer:

“FA00007000000;” (Answer command)

Note:

◆Do not use the control characters 00 to 1Fh since they are either ignored or cause a “?” answer.

◆Program execution may be delayed while turning the Tuning control rapidly.

◆Receive data is not processed if the frequency is entered from the keypad.

■Alphabetical Commands

A command consists of 2 alphabetical characters. You may use either lower or upper case characters. The commands available for this transceiver are listed in the PC Control Command Tables {page 115}.

Error	Reason for Error
Message
?;	• Command syntax was incorrect.
	• Command was not executed due to
	the current status of the transceiver
	(even though the command syntax
	was correct).
	Note: Occasionally this message may not
	appear due to microprocessor transients in the
	transceiver.
E;	A communication error occurred such
	as an overrun or framing error during a
	serial data transmission.
O;	Receive data was sent but processing
	was not completed.

114