User`s manual

Overview
2-2 Single Board Computers SCSI Software UserÕs Manual
2
Firmware Interface
The SIOP Firmware has several externally accessible routines, or entry points,
which may be called by the user to initiate Firmware action. The following is
a brief summary of these routines.
siop_init() This routine is for Firmware initialization. The user calls this
entry point to provide the Firmware with memory resources
and basic SIOP operating parameters and to allow the
Firmware to perform required initialization.
siop_cmd()
This routine is for Firmware command requests. The user
calls this entry point to send command structures ( siop_struc )
to the Firmware. These commands can be used to either
configure the Firmware or initiate SCSI bus activity. This is
the primary entry point for SCSI bus accesses.
siop_int() This routine is for SIOP interrupt handling. The user calls this
entry point to allow the Firmware to process interrupts
generated by the SIOP. This entry point must be called at or
above the interrupt level of the SIOP to protect critical code
regions.
sdt_tinit() This routine is for Firmware debug logging initialization. The
user calls this entry point to enable the debug logger and
provide it with memory resources.
sdt_alloc() This routine is for debug logging. If debug logging has been
enabled, this entry point is called to get the next block of
memory to be used for debug logging.
sfw_getrev() The sfw_getrev() entry point provides a release ID string that
identifies the Firmware. The calling application provides a
pointer to MPU-writable memory and the number of bytes
available there.