Teledyne Using PCIUW User Manual

Using PCIUW from a C++ Code

The PCIUW utility may be executed from within a C program code. The functions below describe how to
read, save and write back to the registers. These functions are for Microsoft C++ compilers. The
PCIUW.EXE and necessary DLLs must reside in the directory where this program is executed from.
The necessary steps are:

1- Read all devices
2- Search for the desired device in the CFG file
3- Save the information for the device to a file, by specifying the bus number and the device number in

the save command

4- Write from the file to reload the hardware

The format of the CFG file is described below to allow locating the desired device(s).

A- Description of function calls to read, save and reload devices

void CTestDlg::OnButtonRun()
{

/*run the utility to read all devices */
int ReturnCode = 0 ;
ReturnCode=WinExec("pciuw",SW_SHOW);
/*run the utility to show help dialog */
// ReturnCode=WinExec("pciuw /?",SW_SHOW);
/*run the utility to save the device configuration information of the device on BusNo = 1 and
device No = 0 */
// ReturnCode=WinExec("pciuw /s 1 0",SW_SHOW);
/* Bus number=1 and Device = 0 here are examples, to find the specific of what your device
number is search the CFG file to located your device, using the cfg file description below, after
you run the utility to read all devices. The device related information may also be located from a
command line outside of the c program and then used in the code, so long as the system
configuration does not change. */
/*run the utility to load configuration information from the last saved file into the hardware */

// ReturnCode=WinExec("pciuw /w",SW_SHOW);
if(ReturnCode < 31)
AfxMessageBox ("run command failed.");

}

B- CFG file description

PCIUW program when executed saves its configuration information in “set@@@.cfg” file. This document
describes the format of this file.

FILE FORMAT

Order Length Byte(s)

1 File type label 20 "PCIUW settig File"
2 Header_data 64 * 452
3 ActiveDevice 4 Int
4 ActivePointer 4
5 Counter 4
6 MaxCounter 4
7 ActiveSelect 4
8 ActiveFunction 64 * 4
9 ActiveBus 64 * 4
Sum 29480

DETAILED LAYOUT OF HEADER DATA

Type Name Len Start Address

Int Dev_func 4 0
Int BusNo 4 4
Int MultiFunction 4 8
Char Dummy 1 12

Alignment Bits 3 13

Unsigned int Device_Id 4 16
Unsigned int Vendor_Id 4 20
Unsigned int Command 4 24
Unsigned int Status 4 28
Char Revision_Id 1 32
Char Programming_interface 1 33
Char Sub_class 1 34
Char Base_class 1 35
Char Cache_line 1 36
Char Latency_timer 1 37
Char Header_type 1 38
Char BIST 1 39
Unsigned long Base_Address1 4 40
Unsigned long Base_Address2 4 44
Unsigned long Base_Address3 4 48
Unsigned long Base_Address4 4 52
Unsigned long Base_Address5 4 56
Unsigned long Base_Address6 4 60
Unsigned long CardBus 4 64
Unsigned int SubsystemVendorID 4 68
Unsigned int SubsystemID 4 72
Unsigned long Expansion_ROM 4 76
Unsigned long Reserve3 4 80
Unsigned long Reserve4 4 84
Char Interrupt_line 1 88
Char Interrupt_pin 1 89
Char Min_Gnt 1 90
Char Max_Lat 1 91