APPENDIX C DOWNLOADING CONFIGURATION FILE

The configuration files are :

_WTnVt.Cfg that contains the program parameters (Chapter 5).
_MsgXX.Cfg that contains the user messages texts (Chapter 6).

C.I Download by RsLink

Install RsLinkOne or RslinkPlus in the PC.

Create a folder that contains the configuration files to download.

Start RsLink. In the "File" menu, select the "Settings" option.

In the "Communication settings" dialog box :

Select the path "PC > PDT" by browsing the folder that contains the configuration files.
Select the appropriate COM: port.
Select 2000 packet size.
Select Baudrate 9600.
Select protocol RsLink.

At boot time, the terminal asks for "configuration download", choose "[F2] By RsLink" option. The terminal downloads the _WTnVt.Cfg file, and the _MsgXX.Cfg associated file (be sure that the TWO files are in the right place). After successful download, the terminal saves the files into the "Flash Memory" and prompts the main menu.

C.II Download by "print"

ANSI, VT52, VT100 and VT200 terminals may have printers attached and have escape sequences that routes the data to printer instead the screen.

WTnVt emulation program has a feature that allows to route the stream to a memory file instead the printer.

This feature allows to download the configuration files from a host to the terminal by standard programs.

If WTnVt recognizes in the data sent by host a "printer header" (%%FILE=xxxx%%) the data is stored into the file indicated by the "printer header".

If the file name is "_WTnVT.Cfg" the terminal disconnects and reloads the configuration.

You should send the "user message" text file _MsgVtXX.cfg before the configuration file.

The printer mode commands are :

ESC [ 5 i (Starts)
ESC [ 4 i (Stops)

Program sample (in C) to "print" a file to WTnVt :

/* To send configuration file */
/* The terminal is attached to the console */

void SendByPrint(void)
{
int iFd;
int iLen;
char sBuff[31];

printf("\x1B[5i");
iFd=open("_MsgFr.Cfg", O_RDONLY | O_BINARY);
while ( (iLen=_read( iFd, sBuff, 30) )>0)
    {
    fwrite(sBuff, 1, iLen, stdout);
    }
_close(iFd);
printf("\x1B[4i");
^}

C.III Download by WTDNL

Install WTDnl in the PC.

Create a folder that contains the configuration files to download.

Start WTDnl. In the "Edit Profile" menu, select the "Settings" option.
In the "settings" dialog box :

Let the default IP address 0.0.0.0 (use all the IP interfaces in the host) and port (3001) if WTDnl is not a conflict with other protocols.
Select the folder where the "DOT-CFG" files are, giving the path or browsing the folders.
Accept by "OK" button.

Save the configuration by the "File" menu, selecting the "Save" option. A ".wtdnl" file is created in a user selected folder that contains the present configuration. For further use, this file is in the MRU list or you can start WTDnl program by selecting the ".wtdnl" file in the windows explorer.

At boot time, the terminal asks for "configuration download", choose "[F1] By Radio" option. Supply the IP address of the host that have the WTDnl program running, and the port (3001 by default).

The terminal downloads the _WTnVt.Cfg file, and the _MsgXX.Cfg associated file (be sure that the TWO files are in the right place). After successful download, the terminal saves the files into the "Flash Memory" and prompts the main menu.

Contents / APPENDIX B / APPENDIX D