Kenwood TS-2000X Operation Manual - Page 124

APPENDIX, COMPUTER CONTROL COMMANDS, Parameters, Terminator, Error Messages, Alphabetical Commands

Page 124 highlights

21 APPENDIX COMPUTER CONTROL COMMANDS 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: Computer control commands Input command (Input to the transceiver) Output command (From the transceiver) Set command (Sets a particular condition) Read command (Reads an answer) Answer command (Transmits a condition) 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 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}. ■ Parameters 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. Error Message ?; E; O; Reason for Error • 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. A communication error occurred such as an overrun or framing error during a serial data transmission. Receive data was sent but processing was not completed. 114

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156

114
21
APPENDIX
Parameters
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.
Error
Message
Reason for Error
Command syntax was incorrect.
Command was not executed due to
the current status of the transceiver
(even though the command syntax
was correct).
A communication error occurred such
as an overrun or framing error during a
serial data transmission.
Receive data was sent but processing
was not completed.
?;
E;
O;
Note:
Occasionally this message may not
appear due to microprocessor transients in the
transceiver.
COMPUTER CONTROL COMMANDS
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
Alphabetical command
;
Terminator
00007000000
FA
Parameters
Commands can be classified as shown below:
Input
command
(Input to the
transceiver)
Output
command
(From the
transceiver)
Set command
(Sets a
particular condition)
Read command
(Reads an answer)
Answer command
(Transmits a condition)
Computer
control
commands
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
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}.