pcitcl.txt

此代码用于生成测试PCI设备的Verilog代码（Verilog代码为一种硬件描述语言）。此代码可以直接运行于LINUX下。

/*
 * Copyright 2002 Picture Elements
 *    Stephen Williams <[e-mail]>
 *
 *    This source code is free software; you can redistribute it
 *    and/or modify it in source code form under the terms of the GNU
 *    General Public License as published by the Free Software
 *    Foundation; either version 2 of the License, or (at your option)
 *    any later version.
 *
 *    This program is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *    GNU General Public License for more details.
 *
 *    You should have received a copy of the GNU General Public License
 *    along with this program; if not, write to the Free Software
 *    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
 */

PCITCL EXTENSION

The pcisim kit includes a tcl extension module that allows programs to
write tcl scripts to access the pcisim target, instead of C code. The
extension module is avaliable to tcl scripts with the "load" command:

	load pcitcl.so

This loads the pcitcl module, and initializes. This will block
attempting to connect to the simulation, which presumably is already
started. The connection is maintained until the script exits. This
causes an end_simulation to be sent to the simulation.


PCITCL Commands

pci_reset <active> <recovery>

	This function causes the PCI simulation to activate the RESET#
	signal for <active> pci clocks, then hold it inactive for
	<recovery> pci clocks. This function will return after the
	recovery is complete.

pci_wait <delay> <irq>

	This function causes the pci simulation to run for <delay>
	clocks, or until one of the interrupts in <irq> go active. The
	<irq> is a bit mask of enables, with a 1 value for each
	enabled interrupt.

	The function will return a mask of interrupts that caused the
	pci_wait to terminate, or a 0 if the <delay> expired without
	any interrupts.

pci_peekcl <addr>...
pci_pokecl <addr> <value>

	These functions perform configuration reads/writes to the
	given address. The <addr> is the value driven onto the address
	bus during the address phase of a read/write.

	The pci_peekcl command may take any number of addresses, and
	returns the same number of values in a list. If the addressee
	does not respond, the value is 0xffffffff.

	The pci_pokecl command takes an address and value, and writes
	the value to the target address.

pci_peekml <addr>...
pci_pokeml <addr> <value>

	These functions do memory read/write cycles. The <addr> is the
	PCI memory address to read/write, and <value> is a
	DWORD. These commands to single-word memory read/write PCI
	commands.