This directory contains various support software for using RTEMS onthe TS-1325. Descriptions follow.DOS Loader==========The dos_sup directory contains a DOS-based loader (loader.com) forRTEMS executables on the TS-1325. Fully commented source code isincluded.Once an application has been compiled and the resulting ELF formatexecutable converted to raw binary format and transferred to theTS-1325, the DOS loader program must be used to load and executeit. The loader is simply invoked as "loader filename", where thefilename cannot contain an explicit path.  The loader will work with files stored either on the C: ram disk orthe A: flash disk. Since Zmodem transfers to the C: ram disk are muchfaster than to the A: disk, most development work will be done usingthe C: disk. Once completed, an application may copied to the(non-volatile) A: disk. Additionally, one may add the line "loaderfilename" to the AUTOEXEC.BAT file, allowing the application to berun automatically at boot time.Note that the DOS loader will abort and exit if it detects that thepush-button switch is pressed, thus allowing one to break out of apathological "boot loop" situation i.e. abort an automatic load fromthe AUTOEXEC.BAT file.elf2exe========The elf2exe script is just a convenient wrapper for the objcopycommand. It can convert a list of RTEMS-generated ELF files to rawbinary images that can be loaded on the TS-1325. The converted filesare saved in the current directory with a ".exe" extension.TS-1325 Ada95 Support=====================The TS-1325 includes a few peripherals which are very useful forembedded development: a push-button switch, an LED, and a parallelport which may be used for digital I/O. Note that the pin-out for theparallel port is given in the TS-1325 manual.These devices are all supported by Ada packages allowing easy access;they may be found in the ts_1325_ada directory. Doing a make commandhere will build a program that tests and exercises all these supportpackages. Plugging in some kind of parallel-port "loop-back" connectorwould be useful during this test.Brief descriptions of the main packages are as follows: * ts1325-button: allows one to check or wait for a button press.  * ts1325-led: allows safe reading and setting of the LED colour.* ts1325-parallel: used to read and write byte date to the parallel  port.  * i386_ports: code to access the I/O address space, using Ada  inline assembly.Serial Debugging Support========================RTEMS supports an Ada95 and RTEMS aware version of the GNU gdbdebugger, which can be configured to debug targets over a serialline. The port COM2 on the TS-1325 is normally used for console I/O, leavingCOM1 for use by gdb; an appropriate cable should be connected from thedevelopment host to the TS-1325's COM1. The serial port used on the hostshould match the line "target remote /dev/tty??" in the "cmds" file.Sample C and Ada95 applications showing how to add debugging supportare given in the debug_c and debug_ada sub-directories. Once thedebugging-enabled executable is running on the TS-1325, gdb must bestarted on the Linux host, taking as argument the RTEMS ELF executable.Using a graphical front end to gdb such as the program ddd is highlyrecommended. The script ddd-rtems shows how to invoke gdb using ddd asa front end.Ada95 Networking Support========================The sub-directory network_ada contains code and examples for an Ada95binding to BSD network sockets. The code is based on Samuel Tardieu'sadasockets-0.1.3 package, but has been modified to work under RTEMS.The binding itself is in the adasockets sub-directory. Edit theMakefile to reflect your choice of installation directory, then typethe command  "make install" to compile and install the binding. Thefile networkconfig.h should also be edited according to the RTEMSnetworking document.The directories listener and tcprelay contain networking examples thatuse the binding. The listener application simply accepts connectionson a certain port and echoes back any received data. The tcprelayprogram accepts connections on a port and then relays all subsequentdata to and from another remote host. The makefiles in bothdirectories should be edited to reflect the installation point of theadasockets binding.Tony Ambardar, 8/8/99