Difference between revisions of "TCP Server"

Revision as of 13:24, 9 September 2013

General

The TCP/IP Server allows third party Ethernet clients to remotely control DDUtil_V3 functionality. The Server is not intended to replicate or replace the functionality of DDUtil, but is intended to augment users wanting to operate the radio remotely by allowing some of the critical functions to be controlled. Some of these remote functions include:

• Turning Rotor to desired heading.
• Toggling Auto Drive PTT (Oper/Stby).
• Turning Amplifier power on/off for selected amplifiers.
• Setting SteppIR yagi to Forward/Reverse mode.
• Executing Macros.

Setup

Connections are restricted to the Local Area Network (LAN) that DDUtil is connected to.

• Use the IP address of the host PC DDUtil is open on; i.e. 192.168.1.xxx.
• Use port 5678

Commands

The following commands are available for remote DDUtil control.
Notes:

• Commands must be input EXACTLY as shown below.
• All commands must be terminated with a CRLF (\r\n).
• ACK returns only guarantee the commands were sent, not that they actually worked.
• Rotor feedback is provided anytime the rotor moves whether initiated from this app, manually or some other manner.
• Separator characters can be any recognizable character. A colon (:) is suggested.

GETSLICE  -  Gets frequency of radio slice n (n = 0-7)						  
   Form:     GETSLICE P1 \r\n			
   Parm:     P1 = Slice number 0-7
   Uses:     GETSLICE2\r\n	
   Rtrn:     Slice2:00014123456

SETSLICE  -  Sets frequency of radio slice n (n = 0-7)						  
   Form:     SETSLICE P1 P2 P3 \r\n			
   Parm:     P1 = Slice number 0-7
   Parm:     P2 = Separator (:)
   Parm:     P3 = 11 digit frequency to set slice
   Uses:     SETSLICE2:00014123456\r\n	
   Rtrn:     SETSLICW:ACK

GETROTOR  -  Gets Rotor position						  
   Form:     GETROTOR \r\n			
   Uses:     GETROTOR\r\n	
   Rtrn:     Head:045

SETROTOR  -  Sets Rotor position						  
   Form:     SETROTOR P1 \r\n			
   Parm:     P1 = a 3 digit heading to turn the rotor to.
   Uses:     SETROTOR045\r\n	
   Rtrn:     Head:045 (when finished turning)

STOPROTOR -  Stops Rotor movement						  
   Form:     STOPROTOR \r\n			
   Parm:     P1 = a 3 digit heading to turn the rotor to.
   Uses:     STOPROTOR\r\n	
   Rtrn:     NotifyIcon message

  AUTOPTT -  Toggle Auto Drive Oper/Stby (PTT)						
    Form:    AUTOPTT \r\n			
    Uses:    AUTOPTT\r\n	
    Rtrn:    AUTOPTT:{Oper|Stby}

   A95PWR -  A9500 Power On						
    Form:    A95PWR \r\n			
    Uses:    A95PWR\r\n	
    Rtrn:    A95PWR:ACK

   A95AUX -  A9500 Aux Power On / Power Off						
    Form:    A95AUX \r\n			
    Uses:    A95AUX\r\n	
    Rtrn:    A95AUX:ACK

  A95AUTO -  A9500 Auto Memory Mode On/Off (toggle)						
    Form:    A95AUTO \r\n			
    Uses:    A95AUTO\r\n	
    Rtrn:    A95AUTO:ACK

   A95ANT -  A9500 Antenna Select (steps 1-4)						
    Form:    A95ANT \r\n			
    Uses:    A95ANT\r\n	
    Rtrn:    A95ANT:ACK

  A95MODE -  A9500 Oper/Stby (toggle)						
    Form:    A95MODE \r\n			
    Uses:    A95MODE\r\n	
    Rtrn:    A95MODE:ACK

   KPAPWR -  KPA500 Power On/Off						
    Form:    KPAPWR \r\n			
    Uses:    KPAPWR\r\n	
    Rtrn:    KPA:{On|Off}

  KPAMODE -  KPA500 Oper/Stby (toggle)						
    Form:    KPAMODE \r\n			
    Uses:    KPAMODE\r\n	
    Rtrn:    KPA:{Oper|Stby}

  STEPFWD -  Set SteppIR Yagi to Forward mode
    Form:    STEPFWD \r\n			
    Uses:    STEPFWD\r\n	
    Rtrn:    STEPFWD:ACK

  STEPREV -  Set SteppIR Yagi to Reverse mode
    Form:    STEPREV \r\n			
    Uses:    STEPREV\r\n	
    Rtrn:    STEPREV:ACK