Creating a Downloadable Firmware File




	NOTE: The 8-channel NIO and EISA cards and the 2-channel NIO card have the facility to build customised downloadable firmware files. This allows protocol modules to be added or removed from the standard firmware files. This section only applies to these ACC card types.

The ACC product protocol accessories provide one or more .zrel relocatable protocol files. The protocol accessory products may or may not provide a pre-loaded .zabs absolute file.

A .zabs downloadable protocol file can contain one or more protocol modules. All protocols used on the whole system can be loaded into one downloadable file, but this is not a requirement. However, all protocols used on any single mux must be in one downloadable file. The loopback protocol should be included in all downloadable files.

If the protocol accessory product does not provide a .zabs file, or if you want to create a .zabs file that contains a number of protocol modules, you must perform the steps listed below. (Refer to the “ZLINK - Z80/Z180 Relocating Linker” chapter of the ACC Utilities Reference Guide for more information on this process.)

Create a .zlnk file. The file /opt/acc/<card-type>/loopback.zlnk can be used as a template.
The nam command parameter should be changed to reflect what is to be contained in the new downloadable file.
The ma and ab commands should be changed to reflect the new names of the map and downloadable files.
All of the protocol/*.zrel relocatable protocol files that are to be included should be referred to in re commands between the following two comment lines:
```
*********************  Protocol Modules  *********************
 
******************  End of Protocol Modules  ******************
```
All other lines must be duplicated exactly as shown in the loopback.zlnk file.
The example that follows is for an HP-PB (NIO) backplane, 8-port ACC product. It shows the /opt/acc/z7200a/loopback.zlnk file with modifications to include the X.25 protocol module. The edits that were made to the original loopback.zlnk file are shown in bold.
Also note that files shown in the “Required ZLNK Directives” section of this example vary with the ACC hardware platform. Refer to the sample loopback.zlnk file provided with your software product.
Sample .zlnk File
```
* Create a map file to describe what is contained in the 
* absolute firmware file
ma z7200a/loopx25.zmap
 
* Modify the "nam" to reflect what is contained in the 
* resultant firmware file.
nam VMUX-1.1 Loopback and X.25 Download file for HP-UX Zcom System
 
sn sys/vmux302a.zsnp	
org,vmux1org, vmux1lim
re sys/wmux1.zrel	   
org,vmux3org, vmux3lim
re sys/wmux3.zrel
org,progorg, proglim
re sys/wmux4.zrel		   
re protocol/level1.zrel
 
******************* Protocol Modules **********************
re protocol/zx25.zrel
**************** End of Protocol Modules ******************
 
re protocol/monitor.zrel
re protocol/testprot.zrel
org, eptable
re sys/pmenttab.zrel
org, preptbl
re sys/umuxent.zrel
 
* Absolute file that is created:
ab z7200a/loopx25.zabs
end
```
For this example, assume that zlink is to be run from the /opt/acc/ directory (but this is not a requirement) and the new .zlnk file name is /opt/acc/z7200a/loopx25.zlnk.
Run the zlink utility on this new file.
```
% cd /opt/acc
% zlink z7200a/loopx25.zlnk
ZCOM Relocating Linker Rev:2.02 <900725.1546>
Absolute file ready: z7200a/loopx25.zabs
ZLINK: End.  Rev.<900725.1546>
%
```
This creates the following files:
```
/opt/acc/z7200a/loopx25.zmap 
/opt/acc/z7200a/loopx25.zabs
```
The .zabs file is the downloadable file. It should be referred to in the MUX configuration lines in the “Interface-Definition” section of the ttgen configuration file for the mux cards that will use these protocols. For example:
```
Mux  3  0:8  /opt/acc/z7200a/loopx25.zabs
```

Creating a Downloadable Firmware File

Technical documentation

» Table of Contents

» Index