hpsload(1M) RISC/os Reference Manual hpsload(1M)
NAME
hps_load - download to an HPS host adapter board
SYNOPSIS
hpsload [c] device file
DESCRIPTION
The hpsload program downloads executable code onto an HPS
host adapter, optionally downloads new HPSX operating system
configuration tables, and starts the downloaded code.
The hpsload program expects the downloaded file to be in
Systech's .dnl format. This file has the following binary
header:
dnl_header
{
bit32 start;
bit32 end;
bit32 vt_start;
bit32 vt_len;
bit32 tt_start;
bit32 tt_len;
bit32 boot_start;
bit32 v_ws;
bit32 v_ws_size;
bit16 v_us_size;
bit16 t_count;
bit16 b_pri;
bit16 b_id;
} dnl_header;
OPTIONS
The following option may be selected:
c will reconfigure the on-board operating system (HPSX)
after downloading. This should normally be present for
Systech-provided download code.
EXAMPLES
The following example downloads the Systech Terminal Control
Software to the first HPS host adapter in the system:
hps_load c /dev/rhp0 /etc/asynch_c.dnl
This line would normally be placed in the /etc/brc or
/etc/rc file.
SEE ALSO
gaddrs(S), rhp(M).
Printed 11/19/92 Page 1
hpsload(1M) RISC/os Reference Manual hpsload(1M)
For a detailed description of the HPS download procedures,
refer to the HPS Application Installation Manual.
COMPILATION INSTRUCTIONS
Compile as:
cc -c -I../include/ -O hpsload.c
cc -c -I../include/ -O gaddrs.c
ld -o hpsload /lib/crt0.o hpsload.o
gaddrs.o -lc
If compilation is done on a system that requires IOCB struc-
ture alignment on 32-bit boundaries, compile as:
cc -c -I../include/ -DHPSALIGN -O
hpsload.c
cc -c -I../include/ -DHPSALIGN -O
gaddrs.c
ld -o hpsload /lib/crt0.o hpsload.o
gaddrs.o -lc
The BSD compile-time switches reflect differences in the HPS
drivers for Ver. 7/UNIX System V, and BSD 4.2.
Page 2 Printed 11/19/92