Difference between revisions of "CAT"

From DDUtilV3
Jump to: navigation, search
(Created page with "= CAT Commands = ==History== In the beginning the '''CAT Command''' set for '''PowerSDR''' used the same commands as '''Kenwood''' TS-2000 radios. As the '''F...")
 
(→‎DDUtil Macro Commands)
Line 39: Line 39:
  
 
In the event an error is made composing the command structure a pop-up error window will appear describing the error. '''Note:''' this error catcher will not tell you if you use the wrong command or the wrong command parameters.
 
In the event an error is made composing the command structure a pop-up error window will appear describing the error. '''Note:''' this error catcher will not tell you if you use the wrong command or the wrong command parameters.
−
 
−
 
−
[[Image:FadeError.jpg]]
 
  
 
====DDUtil Command Reference====
 
====DDUtil Command Reference====

Revision as of 12:06, 21 February 2013

CAT Commands

History

In the beginning the CAT Command set for PowerSDR used the same commands as Kenwood TS-2000 radios. As the Flex radios developed the Kenwood command set no longer was adequate enough to cover the features of the Flex radios.

As you read through the CAT Command Dictionary you will notice that many commands have the same functionality. Such commands are FA/ZZFA, FB/ZZFB, etc. these commands can be used interchangeably, but it is recommended to use the ZZxx commands for continuity and consistency. All of the original Kenwood commands have been re-written with a ZZ equivalent, but there are many more ZZ commands to pick from.

Command Structure

PowerSDR CAT Commands

See this link to browse the PowerSDR CAT Command Reference Guide

CAT commands are a fixed structure of multiple elements. In these examples we are only going to be discuss the ZZ commands to keep the confusion down. The Kenwood commands can be used interchangably if they exist for a given function. This example we will use is ZZMA1; which will Mute the receiver when executed. Below is a disection of the command structure.

  • Preamble (ZZ)
    ZZ precedes each CAT command. This tells the CAT Parser the following string of characters is a PowerSDR CAT Command.
  • Function Identifier (MA)
    Follows the Preamble and is a two alpha character string that represents a specific function to be performed on the radio.
  • Parameter List (1)
    The parameter list can be one or many characters depending on the function identifiers. See the following examples for differences in parameter list characters.
  • Terminator (;)
    The terminator for all commands is a semicolon (;) and tells the CAT parser that this is the end of the command string, go ahead and execute the command.
ZZMA    Sets or reads the Mute (MUT) status
Get	ZZMA	;								
Set	ZZMA 	P1	;							
Answer	ZZMA	P1	;							
Notes	P1 = 0 for off, 1 for on.

ZZGL    Sets or reads the Noise Gate Threshold value
Get	ZZGL	;								
Set	ZZGL	P1	P1	P1	P1	;				
Answer	ZZGL	P1	P1	P1	P1	;				
Notes	P1 = -160 to 0 (- sign required except for 0000).


Note: For more information on setting up, programming and using CAT and DDUtil commands see the How To section.

DDUtil Macro Commands

The DDUtil macro are formed the same as the PowerSDR CAT commands but use a DD prefix in lieu of a ZZ prefix.

In the event an error is made composing the command structure a pop-up error window will appear describing the error. Note: this error catcher will not tell you if you use the wrong command or the wrong command parameters.

DDUtil Command Reference

Click the + next to any macro reference to make it expand.
Note: ALL commands require a semicolon (;) terminator. {{#tree:

  • DD34 - SteppIR antenna to 3/4 mode (vertical only)
    • Form: DD34;
  • DD9W - Opens Alpha 9500 sub window
    • Form: DD9W;
    • Note: DDUtil v1 & 2 only
  • DDAD - Auto Drive Enable/Disable
    • Form: DDAD P1 ;
    • Parm: P1 = 1 for Enabled, P1 = 0 for Disabled
    • Uses: DDAD1; Enables the Auto Drive feature
  • DDAM - Sets the Palstar AT-Auto tuner to Auto Mode
    • Form: DDAM ;
  • DDAO - Set selected supported amplifier to Operate
    • Form: DDAO;
  • DDAP - Selects Auto Drive settings for Amp1 or Amp2.
    • Form: DDAP P1;
    • Parm: P1 = 1 for amp1, 2 for amp2
    • Uses: DDAP2; loads drive settings for amplifier #2
  • DDAS - Set selected supported amplifier to Standby
    • Form: DDAS;
  • DDBC - Sets the Aux BCD data bytes
    • Form: DDBC P1 P1 P1 P1 P1 P1 P1 P1 ;
    • Parm: P1 = 0 for off, 1 for on.
    • Uses: DDBC01010101; Sends decimal 85 (0x55) to the BCD port.
  • DDBE - Enables/Disables BCD port output
    • Form: DDBE P1 ;
    • Parm: P1 = 1 Enabled, 0 = Disabled (DDBE1;)
  • DDBI - Sets the SteppIR antenna to the Bi-Direction mode (Yagi only)
    • Form: DDBI ;
  • DDBL - Sets the Palstar AT-Auto tuner to Balanced Mode
    • Form: DDBL ;
  • DDBM - Sets the Palstar AT-Auto tuner to Bypass Mode
    • Form: DDBM ;
  • DDCX - Sets the Palstar AT-Auto tuner to Coax Mode
    • Form: DDCX ;
  • DDDT - Toggles the DTR line of the SerMacPort on/off
    • Form: DDRT P1 ;
    • Parm: P1 = 0 for off, P1 = 1 for on
    • Uses: DDDT1; sets the SerMacPort DTR line to on
  • DDDV - Syncs RX1/2 filter/mode for diversity reception.
    • Form: DDDV P1 ;
    • Parm: P1 = 0 for off, P1 = 1 for on
    • Uses: DDDV1; turns the sync on.
    • Note: When on sets RX2 Filter/Mode = RX1 Filter/Mode and RX2 follows RX1 changes.
    • Note: DDDV0; or RX2 off cancels sync.
    • Note: F5K only
  • DDFA - Write to FlexWire port #4
    • Form: DDFA P1 P1 ;
    • Parm: P1 is in decimal (<=255)
    • Uses: DDFA18; sends hex 0x12 (00010010) to the FlexWire port
  • DDFW - Sets the SteppIR antenna to the forward direction mode (Beam only)
    • Form: DDFW ;
  • DDKA - Sets CX-Auto switch to select multiple ports
    • Form: DDKA P1 P2 ;
    • Uses: DDKA0101; selects ports 4 and 0.
    • Note: See CX-Auto users manual for more information.
  • DDKM - Sets CX-Auto switch to select single port using switch address
    • Form: DDKM P1 P2 ;
    • Parm: P1 = B1-B3, P2 = 01-07
    • Uses: DDKMB101; selects port 1 on switch with address B1
  • DDKS - Sets CX-Auto switch to select single port using GUI address
    • Form: DDKS P1 ;
    • Uses: DDKS01; selects port 1
  • DDKW - Display the Tuning Knob sub window
    • Form: DDKW ;
    • Note: DDUtil v1 & 2 only
  • DDLP - Write to a parallel port
    • Form: DDLP P1 P1 P1 P1 P1 P2 P2 ;
    • Parm: P1 = port address in decimal, P2 = hex value (DDLP00888FF;)
  • DDLY - Inserts a delay between commands
    • Form: DDLY P1 ;
    • Parm: P1 = milliseconds to delay (1000 = 1 second)
    • Uses: DDLY3000; adds a delay of 3 seconds
  • DDMB - Sets SSB to correct side band (based on band)
    • Form: DDMB ;
    • Uses: DDMB; selects LSB for 160, 80, 60 and 40 meters and USB for all others.
  • DDME - Executes another macro
    • Form: DDME P1 ;
    • Parm: P1 = other macro to execute
    • Uses: DDME21; will execute DDUtil macro 21
  • DDMM - Sets Palstar AT-Auto tuner to Manual mode.
    • Form: DDMM ;
  • DDMW - Opens the DDUtil Mini Window.
    • Form: DDMW ;
    • Note: DDUtil v1 & 2 only
  • DDMS - Sets a Macro Memory (0-9) to either 0 or 1
    • Form: DDMS P1 P2 P3 ;
    • Parm: P1 = memory (0-9)
    • Parm: P2 = : colon separator
    • Parm: P3 = 0 = off, 1 = on
    • Uses: DDMS3:1; Sets Macro Memory #3 to 1
    • Note: Memory values DO NOT persist between sessions
  • DDMT - Tests a Macro Memory (0-9) for 0 or 1 & executes a macro based on condition
    • Form: DDMT P1 P2 P3 P4 P5 ;
    • Parm: P1 = memory (0-9)
    • Parm: P2 = : colon separator
    • Parm: P3 = nnn macro to execute if memory = 1
    • Parm: P4 = : colon separator
    • Parm: P5 = nnn macro to execute if memory = 0
    • Uses: DDMT3:005:006; if Macro Memory #3 = 1 execute macro #5 else execute macro #6
    • Note: nnn macro numbers must be 3 digits each
    • Note: Memory values DO NOT persist between sessions
  • DDPD - Loads/Closes PSDR (toggle)
    • Form: DDPD ;
    • Note: Uses PSDR file location on the Setup tab
  • DDPL - Sets Auto Drive to Low Power
    • Form: DDPL ;
    • Note: PTT must be in Operate prior to execution
  • DDPP - Enables/Disables DDUtil PTT
    • Form: DDPP P1 ;
    • Parm: P1 = 1 for Enabled, 0 for Disabled
    • Uses: DDPP1; Enables the Auto Drive PTT in DDUtil
  • DDPQ - Sends serial string with embedded ";" to the Serial Macro Port
    • Form: DDPQ P1 ;
    • Parm: P1 = string to send (DDPQS01;)
    • Note: Use for K9DUR Voice Keyer remote Trigger
    • Note: Voice Keyer macro to activate (S01-S10).
  • DDPS - Sends serial string to the Serial Macro Port
    • Form: DDPS P1 ;
    • Parm: P1 = string to send
    • Uses: DDPSHELLO WORLD; sends the string Hello World to the SerMacPort
  • DDPT - Toggles the PTT function in DDUtil
    • Form: DDPT :
  • DDRB - Sends Denkovi Relay Baard a value between 0-255
    • Form: DDRB P1 ;
    • Parm: P1 = decimal digit(s) 0 - 255
    • Uses: DDRB7; Turns on relays 1, 2 and 3
    • Note: Uses binary notation (128 = 10000000 = relay #8)
  • DDRE - Enables the Rotor
    • Form: DDRE P1 ;
    • Parm: P1 = 1 for Enabled, 0 for Disabled (DDRE1;)
  • DDRR; - Sets rotor interrogation interval
    • Form: DDRR P1 ;
    • Parm: P1 Index of rotor interval drop-down combo box (0=none)
    • Uses: DDRR1; sets interval to 1 second
    • Note: Values are from 0 to 6 which equates from 0 = None to 6 = 10 seconds
  • DDRT - Toggles the RTS line of the SerMacPort on/off
    • Form: DDRT P1 ;
    • Parm: P1 = 0 for off, P1 = 1 for on
    • Uses: DDRT1; sets the SerMacPort RTS line to on
  • DDRV - Sets the SteppIR antenna to the Reverse direction mode (Beam only)
    • Form: DDRV ;
  • DDRW - Display the Rotor sub window
    • Form: DDRW ;
    • Note: DDU v1 & 2 only
  • DDSC - Activates the SteppIR Calibrate function
    • Form: DDSC ;
  • DDSE - Enables/Disables the SteppIR antenna
    • Form: DDSE P1 ;
    • Parm: P1 = 1 for Enabled, 0 for Disabled
    • Uses: DDSE1; enables the SteppIR antenna functionality
  • DDSF - Announces PSDR Frequency using Speech Synthesis
    • Form: DDSF ;
  • DDSH - Activates the SteppIR Home function
    • Form: DDSH ;
  • DDSM - Announces PSDR Mode using Speech Synthesis
    • Form: DDSM ;
  • DDSO - Sets Offset: for the active rotor
    • Form: DDS0 P1 ;
    • Parm: P1 = -180 to 180 degrees
    • Note: DDSO5; for +5 degrees offset, DDSO-5; for -5 degrees offset
  • DDSP - Turns the Rotor to a specific heading
    • Form: DDSP P1 P1 P1 ;
    • Parm: P1 = 000 to 359 (DDSP180;)
  • DDSR - Loads SO2R matrix file
    • Form: DDSR P1 ;
    • Parm: P1 file name from the %APPDATA%\Macro folder
    • Uses: DDSRmySo2rfile.xml;
    • Note: DDUtil v1 & 2 only
  • DDSS - Announces PSDR S-Meter reading using Speech Synthesis
    • Form: DDSS ;
    • Note: Reading is peak for a 2 second period.
  • DDSX - Selects the active rotor (1, 2, 3)
    • Form: DDSX P1 ;
    • Parm: P1 = 1, 2, or 3
    • Uses: DDSX2; selects rotor #2
  • DDTA - Appends text to Status Bar
    • Form: DDTA P1 ;
    • Parm: P1 = Plain text
    • Uses: DDTA 1234;
    • Note: Can be used with DDTM to add text to existing
  • DDTF - Set Power Master watt meter Forward Trim
    • Form: DDTF P1 ;
    • Uses: DDTF8; Sets forward trim to 8.
  • DDTG - Toggles 2 macros
    • Form: DDTG P1 P2 ;
    • Uses: DDTG2021; toggles macros 20 and 21
  • DDTM - Add user text to Status Bar
    • Form: DDTM P1 ;
    • Parm: P1 = Plain text
    • Uses: DDTAHello Radio;
  • DDTR - Set Power Master watt meter Reverse Trim
    • Form: DDTR P1 ;
    • Uses: DDTR4; Sets forward trim to 4
  • DDTS - Sets the VFO A/B Tune Step
    • Form: DDTS P1 P2 ;
    • Parm: P1 = VFO A/B, P2 = Tune Step index (zero based)
    • Uses: DDTSA01; sets VFO A to 10 Hz tune step.
  • DDVA - Sets TX VFO = VFO A
    • Form: DDVA ;
  • DDVB - Sets TX VFO = VFO B
    • Form: DDVB ;
  • DDVR - Sets Tuning Knob Variable Tuning rate on/off (toggle)
    • Form: DDVR ;
  • DDWW - Sends commands to DXLab WinWarbler to execute any of it's 32 message macros.
    • Form: DDWW P1 ;
    • Parm: P1 = 0 - 31
    • Uses: DDWW30; will execute DXLab WinWarbler macro #30

}}

Retrieved from "http://k5fr.com/DDUtilV3wiki/index.php?title=CAT&oldid=27"