* ASatLogger TNC configuration file Help. NOTICE!!!!!!! The contents of TNC configuration files may not be suitable for your TNC. The user must edit TNC configuration files to suit his intended purpose before initializing the TNC. The author assumes no responsibility for misconfigured TNC's or improper operation of same. Please refer to your TNC manual to determine the commands needed by your TNC before editing ASatLogger TNC configuration files and before sending the files to your TNC/D7/D700/D710. ASatLogger can communicate with TNC's operating in COMMAND, CONVERSE, KISS modes and with D7/D700/D710 in Radio Control, APRS (limited command availabilty) and Packet mode. Refer to your TNC or radio manual to determine the steps needed to switch between modes. ASatLogger TNC/D7/D700/D710 support requires an RS-232 communications or serial port and a TNC or TNC equipped radio. USB to serial adapters may work, but your mileage may vary. The ASatLogger TNC Viewer / Editor allows the user to edit TNC configuration files intended for transmission over a serial port to a TNC/D7/D700/D710. The TNC configuration files must be present in your ASatLogger directory. Once you have selected a TNC configuration file in the "Selected TNC cfg file" combo box, the contents of the file is displayed and can be edited by the user. If a file has been edited, ASatLogger will prompt you to save the file before displaying another file, or when exiting from the editor. You can send the contents of a file to an attached TNC/D7/D700/D710 by pressing the "Send cfg to TNC" button. ASatLogger will open the selected serial port, force the TNC into the desired mode, and send the contents of the file. Note that you must have previously configured your serial port to communicate with the TNC/D7/D700/D710. If the serial port configuration does not match the TNC serial port configuration, ASatLogger will be unable to communicate with the TNC. When the "Send selected cfg file to TNC when serial port opens" check box is checked, ASatLogger will send the currently selected TNC cfg file to the TNC each time the serial port is opened. If you shut down ASatLogger with the serial port open, the next time ASatLogger is run, the port will be automatically opened and the file will be sent to the TNC. A .TNC cfg file can be sent to an attached TNC or radio by an authorized remote user via ASatLoggers Virtual Access Server. Remote commands can be imbedded in .TNC files and executed when encountered in the file. See RemoteCommands.text for details. If you know your original TNC settings, ASatLogger can restore them if you enter the required settings into the "RESTORE.TNC" file. Select the RESTORE.TNC file in ASatLoggers Editor / Viewer, enter the required commands and save the file. Once you have the file saved. press the "Send cfg file to TNC" button. Note that ASatLogger will now use this file as the current TNC file and may send it to the TNC the next time the serial port is opened. .TNC file structure: Comments begin with * or #. Empty (blank) lines or lines starting with these char will not be sent to the TNC. However, each blank or comment line will cause ASatLogger to pause for a short time. This feature can be used to implement any needed delays. Control characters can be entered as ^C for example. ^C^C^C can be used to force the TNC into command mode, from converse mode. The command AQA may be used to terminate Host mode. ASatLogger will send #192 Q #192 when this command is encountered. The command AFA may be used to terminate KISS mode. ASatLogger will send #192 #255 #155 when this command is encountered. Remote control commands (Virtual Access Server) for ASatLogger can be included as well. For example, you can include the following command to change your APRS-IS filter settings for a particular satellite: &ADDITONALLOGONTEXT filter r/41.5/-88.03/250 p/PCSAT/W3ADO-1/RSOISS/4XTECH d/PCSAT*/W3ADO-1/RS0ISS*/4XTECH* The above command does not take affect until you connect or reconnect to an APRS-IS server. To connect to an APRS-IS server you must specify the server URL or IP address and the port number and issue the connect command: &connect first.aprs.net:14580 See VASReadme.txt for details on issuing Virtual Access Server commands. KISS mode: Generally each manufacturor uses a different method for entering KISS mode. There also may be variations between models. ASatLogger includes example KISS mode files based on information gleaned from Roger Barker's UiView32. Most of these have not been tested in ASatLogger and may require editing. Most KISS capable TNC's support up to 7 commands when in KISS mode. One notable exception is John Hansen's TNC-X. The TNC-X provides a pot to adjust TXDelay. The KISS commands must be prefaced with KISS (all caps or upper case), space, a number between 0 and 6 and an argument consisting of a number or string. Examples follow: * Data frame or packet. KISS 0KC9XG>APRS:>This packet will be sent in KISS mode * TxDelay in 10's of milliseconds. Example is 200ms. KISS 120 * Persistance in 10's of milliseconds KISS 220 * SlotTime KISS 320 * TxTail in 10's of milliseconds. Legacy command, not supported by current TNC's KISS 420 * Full or half duplex. Not supported in most TNC's. KISS 5HALF * or full duplex KISS 5FULL * Hardware. TNC specific, not supported in all TNC's and implemtations vary. KISS 6Hardware command * Reset or terminate KISS mode. Can also be entered as AFA KISS FF ASatLogger accepts some additional commands to control how KISS packets are constructed: * KISS Port. Used with dual port TNC's. Should be either port 0 or 1. * Port 0 is default KISS PORT0 * PID, protocol ID. Normally set to 240. See AX25 specs for other settings. KISS PID240 * KISS Ctl, normally set to 3. KISS CTL3 * KISS PollCode, default is 2. See AX25 specs for other settings. KISS POLLCODE2 * Turn KISS mode on. Implementation specific. * Usually used in conjunction with other commands. * Not used with TNC-X KISS ON * Turn KISS mode OFF. Implementaions specific. * May require other commands. See KISS FF. KISS OFF D7/D700/D710 commands (See D7GO32INIT.TNC for details): The D7/D700/D710 radio TNC can be be placed in one of 3 modes: 1. Radio Control mode. TNC off. Commands can be sent to change freq, operating modes etc. Radio display does not show "TNC". 2. APRS mode. TNC is on, but not readily accessible via the serial port. APRS activity is shown on the D7/D700/D710 display and all radio functions are available via button presses etc. Radio display shows "TNC". 3. Packet mode. TNC is on and can be placed in COMMAND or CONVERSE Mode. APRS activity is not shown on display, but available via the serial port. Radio shows "TNC" and "Packet"; Regular TNC commands are available. Any Text sent in converse mode will be transmitted over the air, using MYCALL, UNPROTO and Path. This is the mode used by APRS client applications (UiView, ASatLogger etc) to communicate via the D7/D700/D710 TNC. The Serial Port tab, "Kenwood D7/D700/D710 only" group box contains 3 buttons used to change to the D7/D700/D710 modes outlined above. The D7/D700/D710 commands have not been documented by Kenwood. Various interested users and groups have published many of the commands found to work. However, these published sources may conflict, or apply to only 1 model of the radio. In some cases it is not clear which commands work with which radios. See the following sites which detail known D7/D700 commands: http://jgav.com/ham/tmd700a.htm (Jim Gill, N0RMO) http://radio-active.net.au/ham/d7.html (Darryl Smith, VK2TDS) ASatLogger was developed and tested using a D7 portable using the information from the above web sites. The D7GO32INIT.TNC file contains only those commands found to work and needed to access the GO32 sat with the D7. The ASatLogger menu selection "TNC" will display the "View / Edit TNC configuration files" screen. The "Selected TNC cfg file" combo box can be used to select D7GO32INIT.TNC file. Help buttons are available on the TNC screen to display TNC Help and Remote Command help. The generally required sequence to program the D7 is: 1. Place the D7 in Radio Control Mode with the command: # Turn off TNC. "TNC" no longer appears on radio display. TC 1 2. Issue all commands to set D7 VFO freq, step, Data bands etc. Example command (VFO A to 145.93, VFO B to 435.225): # VFO A FQ 00145930000,0 # VFO B FQ 00435225000,1 3. Reset D7 to packet mode. Causes TNC to Reset. Command: # Turn on TNC. Re-initializes. "TNC" and "Packet" appear on radio display. TC 0 4. After a delay to allow for TNC re-initialization, the HBAUD command must be issued (does not appear to be persistant from control to Packet mode) : HBAUD 9600 or HBAUD 1200 5. D7 TNC will now be in regular CMD mode. Regular D7 TNC commands can be sent. See D7 manual for supported commands. ASatLogger includes "Remote Commands" which can be included in a .TNC file to control most aspects of ASatLogger operation. See the files D7MODECTRL.TNC, D7MODEAPRS.TNC and D7MODEPKT.TNC. Simlar files for the D700 and D710 are included in the ASatLogger distribution. These files are used to change the D7/D700/D710 mode of operation: Including the remote command "&SENDTNCCFG D7MODECTRL.TNC" (without the quotes) in a .TNC file will send the contents of the file to the radio and force the radio into radio control mode. This file contains commands to change the TNC mode to command mode, and forces it into Radio Control mode. Similarly, the remote command "&SENDTNCCFG D7MODEPKT.TNC" will send the contents of the file to the radio and force the radio TNC into Packet mode. The above *MODE*.TNC files should not be deleted, since ASatLogger uses them to control mode setting. Modifying these files incorrectly can cause ASatLogger to lose control of the attached radio. The "Serial Tab" allows you to send data and commands to an attached TNC/D7/D700/D710 manually. This feature can be used to determine which commands you need to include in your .TNC file. NOTES: APRS is a registered Trademark of Bob Bruninga, WB4APR ASatLogger Copyright 2001-2007 William Diaz KC9XG. william.diaz@comcast.net 815-838-1194 815-207-3769 cell