B.2.7 opcode 0x06: firmware/payload query, Remote start – Artesyn MOTLoad Firmware Package User's Manual (February 2015) User Manual

Page 253

Advertising
background image

Remote Start

MOTLoad Firmware Package User’s Manual (6806800C24D)

253

the ending address. The addresses are each stored in VR1, which may then be read using the
read virtual register command.

The options field specifies specifics of the command as follows:

Bit 15 specifies whether to return information about the actual (0) or available (1) target
RAM. Information about the actual target RAM does not take into account the areas of
RAM that the firmware is using. Information about the available RAM will return values
which reflects the area of RAM which the firmware is not using.

Note: Memory allocated by the allocate memory Remote Start command is considered
"used" by the target firmware.

Bit 14 specifies whether to return the beginning (0) or ending address (1) of the RAM.

B.2.7

Opcode 0x06: Firmware/Payload Query

This command allows the host to access details of various hardware components present on
the board, as well as the firmware revision. A board payload structure (struct bdPayload,
below) will be written to the target address provided in VR1 by the host.

VR1 contains the address (as viewed from the target's processor) to which the payload
structure will be written.

The host must ensure that the address in VR1 is allocated via Opcode 0x08, Allocate Memory,
prior to calling the Firmware / Payload Query command. The size of the allocation must be
sufficient to contain the bdPayload structure. Upon completion of the command, the host
could use Opcode 0x03, Write/Read Memory, to copy the structure from the target to the
host.The options field is unused and must contain 0.

/*

* This structure defines the organization of pci data that's *returned by

the Remote Start Firmware Query command.

/*

typedef struct pciPopulation {

unsigned char busInstand;

unsigned char bus;

unsigned char device;

unsigned char function;

unsigned short vendorID;

unsigned short deviceID;

Advertising