Using ZLINK

Introduction

Commands for ZLINK can be made via:

The usual method of running ZLINK is via ZLINK command files, which, for the ZCOM system, are supplied with the ZCOM relocatable files.

Command Files

To run ZLINK using a command file, enter at a shell prompt:

  $ zlink <commandfilename>

A sample command file (to create the absolute code for the HDLC LAP-B protocol), is listed below. This assumes you are executing the zlink command from the /opt/acc/ directory. When ZLINK executes this command file it produces an executable download file called z7400a/hdlc.zabs and a list file z7400a/hdlc.zmap. The list file contains the absolute addresses of the modules within the Z180 subsystem. These addresses are needed when tracing execution of the protocol modules using a logic analyzer (e.g., HP16500A with HP10336H Z180 probe). See the XR and MA detailed command description for examples of the map file output.

ma z7400a/hdlc.zmap             (Specify map listfile name)
nam VMUX-1.1 HDLC Download file for HP-UX Zcom System
sn sys/z7400_rom.zsnp           (Mux kernel entrypoints)
org,fworg,proglim               (Set origin for Mux kernel)
re sys/z7400_fw.zrel            (Mux kernel)
re protocol/level1.zrel         (Line Tx/Rx handling protocol module)
re protocol/hdlcabm.zrel        (HDLC/LAP-B protocol module)
re protocol/monitor.zre         (Monitor protocol module)
re protocol/testprot.zrel       (Loopback protocol module)
org,eptable                     (Set origin for protocol entrypoint table)
re sys/pmenttab.zrel            (Default protocol entrypoint table)
ab z7400a/hdlc.zabs             (Specify absolute output file)
end

All command files for ZLINK must have a file type extension of .ZLNK. The file names and extensions are not case sensitive. ZLINK uses other file type extensions as follows:

.zrel     Relocatable file  (input) 
.zsnp     Snapshot file  (input) 
.zlnk     Command file  (input) 
.zmap     List file  (output) 
.zabs     Absolute code file  (output)

Relocatable files are produced by the Z80 cross assembler, ZX80R, and are used by ZLINK to create the absolute download file.

The snapshot file contains information about the ZCOM executive firmware, under which the executable code will run.