User's Manual

pulsAR radio Operator’s Manual
D-1
APPENDIX D – Ethernet Console Program
Short description
The ethernet console program was developed in order to accommodate the remote configuration of a
radio, i.e. the configuration in cases where the physical access to the radio is not feasible, or it is
cumbersome. The software consists of two parts: the client and the server. The client runs on the
administrator's PC, while the server runs on the radio.
The communication is done via a TCP-like protocol. There is an acknowledgment for every packet
that is sent, as well as a retransmission mechanism when a packet gets lost.
Each radio allows multiple sessions, i.e. more than one client can be connected concurrently to the
same server (radio). Nevertheless, for performance reasons, it is not recommended to have more
concurrent sessions than they are really needed, and definitely not more than the maximum number
which currently is 4.
System requirements
• Win95, Win98, Windows ME, WinNT, Win2000, WinXP
• NetBIOS installed
• WinPCap installed
Note: With regard to Windows NT platform, the code has been tested with versions 4.0, or newer. There is also
a Linux beta version
Installation for Windows
In order to install the WinPCap library, if not already installed, just click on the WinPCap.exe.
Support and updates for this library can be found at http://netgroup-serv.polito.it/winpcap/. It is
strongly suggested to uninstall older versions of the library and reboot the machine before installing
the new one. NetBIOS is a software component that comes by default with all Windows system, so
you don't have to install it. To start the Econsole, simply open a MS-DOS window and type econ. For
available command line arguments, please read the "input arguments" section.
Included files
• win_readme.doc The file that you are reading
• econ.exe The EConsole client
• WinPCap The Windows installer for the WinPCap library
• input_script.txt A sample input script file, that contains a list of radio commands.
Input arguments
You can provide the following arguments in the command line, even though none of them is required.