Introduction

This guide contains information about installing LayGO Toolkit components under each supported operating system:

Hardware Installation and Testing

See the hardware vendor's reference manual for detailed installation instructions for the communication board.

Additional information about supported boards and cable configuration can be found in the LayGO Hardware Guide.

Any special installation instructions which apply to a particular communication board are listed in the Special Instructions section of this guide.

The Testing with Tdrv section of this manual describes how to test the installed hardware using the Tdrv test program. Hardware Troubleshooting discusses the diagnosis and resolution of common hardware problems.

Environment Variables

LayGO uses configuration files which by default it expects to find on the default drive in the LayGO cfg directory. You can specify an alternate default location by setting the LAYGOCFG environment variable. For instance, if you want to store the configuration files in m:\comm\bin, you can add the line:

set LAYGOCFG=m:\comm\bin

to your autoexec.bat file or set the value of this variable in the System Properties section of the control panel (Windows NT).

LayGO also uses a service database which it expects to find in the file service.db in the LayGO cfg directory. You can specify an alternate file by setting the LAYGOSRV environment variable. For instance, if the service database file is m:\comm\bin\ourown.db, you can add the line:

set LAYGOSRV=m:\comm\bin\ourown.db

to your autoexec.bat file or set the value of this variable in the System Properties section of the control panel (Windows NT).

LayGO Device Library uses a device database which it expects to find in the file device.db in the LayGO cfg directory. You can specify an alternate file by setting the LAYGODEV environment variable. For instance, if the device database file is m:\comm\bin\ourdev.db, you can add the line:

set LAYGODEV=m:\comm\bin\ourdev.db

to your autoexec.bat file or set the value of this variable in the System Properties section of the control panel (Windows NT).

LayGO executables are located in the LayGO bin directory and Windows DLLs are located in the LayGO lib directory. You may want to add these directories to your PATH and/or copy the DLLs to your Windows system directory.

Stack Configuration

In order for the LayGO protocol stack to locate the correct driver(s) during stack initialization, a system stack configuration is required. The file stackx.cfg located in the distribution config directory contains a default system stack configuration for the communications board. Applications should load this file by calling lgo_ConfigureStack() prior to initializing the stack. If no system stack configuration is loaded, the emulation driver is used by default.

Sample Programs

The standard distribution contains 5 sample programs which can be compiled for each supported operating system.

dlaygo - dlaygo is a simple LayGO application which demonstrates stacking and control of LayGO protocol modules.
tlaygo - tlaygo allows interactive testing of the LayGO protocol stack and is useful for testing the hardware installation.
laygold - laygold demonstrates the use of the LayGO API for downloading driver modules into intelligent boards.
laygouid - laygouid demonstrates the LayGO user id validation API.
sftp - sftp is a simple file tansfer program which demonstrates the use of the LayGO device library.

The source code for each program is located in the LayGO etc/clib/test directory and an executable copy is located in the LayGO etc/clib/bin/<platform> directory. A makefile is provided for each program for each supported platform. The makefiles assume that the C compiler is in the path and that the compiler can find its include files and libraries either in the standard place or from environment variables. The makefiles should work with virtually any compiler and make utility with only minor modifications.