OpenBoot 3.x Command Reference Manual

Using dlbin to Load FCode or Binary Executables Over Serial Port A

FCode or binary programs loaded with dlbin must be Client program header files. dlbin loads the files at the entry point indicated in the Client program header. Link binary files for 4000 (hex). Recent versions of the FCode Tokenizer create a Client program header file with entry point 4000.

To load a file over the serial line, connect the test system's serial port A to a machine that is able to transfer a file on request ( i.e. a server). Start a terminal emulator on the server, and use that terminal emulator to download the file using dlbin.

The following example assumes the use of the Solaris terminal emulator tip. (See Appendix A, Setting Up a TIP Connection", for information on this procedure.)

  1. At the test system's ok prompt, type:


     
    
    ok dlbin
    

In the tip window of the server, type:


~c

to obtain a command line with which to issue a Solaris command on the server.


Note -

The C is case-sensitive and must be capitalized.



Note -

tip will only recognize the ~ as a tip command if it is the first character on the command line. If tip fails to recognize the ~C, press Return in the tip window and repeat ~C again.


  1. At the "local command" prompt, use cat to send the file.


    ~C (local command) cat filename
    (Away two seconds)

When tip completes the download, it displays a message of the form (Away n seconds), and the ok prompt reappears on the screen of the test system.

To execute an FCode program, type:


ok 4000 1 byte-load

To execute the downloaded program, type:


ok go