<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSpy v2007 rel. 3 (http://www.altova.com) by Greg Ehmann (Philips Electronics Nederland BV) -->
<!-- edited with XMLSPY v2004 rel. 3 U (http://www.xmlspy.com) by Mark Noll (Synopsys) -->
<!--
// Description : busInterface.xsd
// Author : SPIRIT Schema Working Group
// Version:     $Revision: 740 $
// Date:        $Date: 2007-06-28 10:59:59 -0500 (Thu, 28 Jun 2007) $
// Tag:         $Name$
//
// Copyright (c) 2005 SPIRIT.  All rights reserved.
// www.spiritconsortium.com
//
// THIS WORK FORMS PART OF A SPIRIT CONSORTIUM SPECIFICATION.
// THIS WORK CONTAINS TRADE SECRETS AND PROPRIETARY INFORMATION
// WHICH IS THE EXCLUSIVE PROPERTY OF INDIVIDUAL MEMBERS OF THE
// SPIRIT CONSORTIUM. USE OF THESE MATERIALS ARE GOVERNED BY
// THE LEGAL TERMS AND CONDITIONS OUTLINED IN THE SPIRIT
// SPECIFICATION DISCLAIMER AVAILABLE FROM
// www.spiritconsortium.org
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:spirit="http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4" targetNamespace="http://www.spiritconsortium.org/XMLSchema/SPIRIT/1.4" elementFormDefault="qualified" attributeFormDefault="qualified">
	<xs:include schemaLocation="identifier.xsd"/>
	<xs:include schemaLocation="memoryMap.xsd"/>
	<xs:include schemaLocation="port.xsd"/>
	<xs:simpleType name="bitSteeringType">
		<xs:restriction base="xs:string">
			<xs:enumeration value="on"/>
			<xs:enumeration value="off"/>
		</xs:restriction>
	</xs:simpleType>
	<xs:element name="busInterface" type="spirit:busInterfaceType">
		<xs:annotation>
			<xs:documentation>Describes one of the bus interfaces supported by this component.</xs:documentation>
		</xs:annotation>
	</xs:element>
	<xs:element name="busInterfaces">
		<xs:annotation>
			<xs:documentation>A list of bus interfaces supported by this component.</xs:documentation>
		</xs:annotation>
		<xs:complexType>
			<xs:sequence>
				<xs:element ref="spirit:busInterface" maxOccurs="unbounded"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:complexType name="busInterfaceType">
		<xs:annotation>
			<xs:documentation>Type definition for a busInterface in a component</xs:documentation>
		</xs:annotation>
		<xs:sequence>
			<xs:group ref="spirit:nameGroup"/>
			<xs:element name="busType" type="spirit:libraryRefType">
				<xs:annotation>
					<xs:documentation>The bus type of this interface. Refers to bus definition using vendor, library, name, version attributes.</xs:documentation>
				</xs:annotation>
			</xs:element>
			<xs:element name="abstractionType" type="spirit:libraryRefType" minOccurs="0">
				<xs:annotation>
					<xs:documentation>The abstraction type/level of this interface. Refers to abstraction definition using vendor, library, name, version attributes. Bus definition can be found through a reference in this file.</xs:documentation>
				</xs:annotation>
			</xs:element>
			<xs:group ref="spirit:interfaceMode">
				<xs:annotation>
					<xs:documentation>Indicates the usage mode of this instance of the bus interface.</xs:documentation>
				</xs:annotation>
			</xs:group>
			<xs:element name="connectionRequired" type="xs:boolean" default="false" minOccurs="0">
				<xs:annotation>
					<xs:documentation>Indicates whether a connection to this interface is required for proper component functionality.</xs:documentation>
				</xs:annotation>
			</xs:element>
			<xs:element name="portMap" minOccurs="0">
				<xs:annotation>
					<xs:documentation>Listing of maps between component ports and bus ports.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element name="portName" maxOccurs="unbounded">
							<xs:annotation>
								<xs:documentation>Maps a component's port to a port in a bus description. This is the logical to physical mapping. The logical pin comes from the bus interface and the physical pin from the component.</xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:sequence>
									<xs:element name="componentPortName" type="xs:Name">
										<xs:annotation>
											<xs:documentation>Component port name as specified inside the model port section</xs:documentation>
										</xs:annotation>
									</xs:element>
									<xs:element name="busPortName" type="xs:Name">
										<xs:annotation>
											<xs:documentation>Bus port name as specified inside the abstraction definition</xs:documentation>
										</xs:annotation>
									</xs:element>
									<xs:element ref="spirit:vector" minOccurs="0"/>
								</xs:sequence>
								<!--								<xs:simpleContent>
									<xs:extension base="xs:token">
										<xs:attribute name="busSignal" type="xs:Name" use="required"/>
										<xs:attribute name="left" type="xs:nonNegativeInteger"/>
										<xs:attribute name="right" type="xs:nonNegativeInteger"/>
									</xs:extension>
								</xs:simpleContent> -->
							</xs:complexType>
						</xs:element>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="bitSteering" default="off" minOccurs="0">
				<xs:annotation>
					<xs:documentation>Indicates whether bit steering should be used to map this interface onto a bus of different data width.

Values are "on", "off" (defaults to "off").</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:simpleContent>
						<xs:extension base="spirit:bitSteeringType">
							<xs:attributeGroup ref="spirit:autoConfig"/>
						</xs:extension>
					</xs:simpleContent>
				</xs:complexType>
			</xs:element>
			<xs:element ref="spirit:parameters" minOccurs="0"/>
			<xs:element ref="spirit:vendorExtensions" minOccurs="0"/>
		</xs:sequence>
		<xs:anyAttribute namespace="##any" processContents="lax"/>
	</xs:complexType>
	<xs:element name="group" type="xs:Name">
		<xs:annotation>
			<xs:documentation>Indicates which system interface is being mirrored. Name must match a group name present on one or more signals in the corresonding bus definition.</xs:documentation>
		</xs:annotation>
	</xs:element>
	<xs:element name="channels">
		<xs:annotation>
			<xs:documentation>Lists all channel connections between mirror interfaces of this component.</xs:documentation>
		</xs:annotation>
		<xs:complexType>
			<xs:sequence>
				<xs:element name="channel" maxOccurs="unbounded">
					<xs:annotation>
						<xs:documentation>Defines a set of mirrored interfaces of this component that are connected to one another.</xs:documentation>
					</xs:annotation>
					<xs:complexType>
						<xs:sequence>
							<xs:group ref="spirit:nameGroup"/>
							<xs:element name="busInterfaceRef" type="xs:Name" minOccurs="2" maxOccurs="unbounded">
								<xs:annotation>
									<xs:documentation>Contains the name of one of the bus interfaces that is part of this channel. The ordering of the references may be important to the design environment.</xs:documentation>
								</xs:annotation>
							</xs:element>
						</xs:sequence>
					</xs:complexType>
				</xs:element>
			</xs:sequence>
		</xs:complexType>
		<xs:unique name="channelConnections">
			<xs:selector xpath="spirit:channel/spirit:busInterfaceRef"/>
			<xs:field xpath="."/>
		</xs:unique>
	</xs:element>
	<xs:element name="remapStates">
		<xs:annotation>
			<xs:documentation>Contains a list of remap state names and associated signal values</xs:documentation>
		</xs:annotation>
		<xs:complexType>
			<xs:sequence>
				<xs:element name="remapState" maxOccurs="unbounded">
					<xs:annotation>
						<xs:documentation>Contains a list of signals and values which tell the decoder to enter this remap state. The name attribute identifies the name of the state</xs:documentation>
					</xs:annotation>
					<xs:complexType>
						<xs:sequence>
							<xs:group ref="spirit:nameGroup"/>
							<xs:element name="remapPort" maxOccurs="unbounded">
								<xs:annotation>
									<xs:documentation>Contains the name and value of a port on the component, the value indicates the logic value which this port must take to effect the remapping. The portMapRef attribute stores the name of the signal which takes that value.</xs:documentation>
								</xs:annotation>
								<xs:complexType>
									<xs:simpleContent>
										<xs:extension base="spirit:scaledInteger">
											<xs:attribute name="portNameRef" type="xs:NMTOKEN" use="required">
												<xs:annotation>
													<xs:documentation>This attribute identifies a signal on the component which affects the component's memory layout </xs:documentation>
												</xs:annotation>
											</xs:attribute>
											<xs:attribute name="portIndex" type="xs:nonNegativeInteger">
												<xs:annotation>
													<xs:documentation>Index for a vectored type port. Must be a number between left and right for the port.</xs:documentation>
												</xs:annotation>
											</xs:attribute>
										</xs:extension>
									</xs:simpleContent>
								</xs:complexType>
							</xs:element>
						</xs:sequence>
					</xs:complexType>
				</xs:element>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
	<xs:group name="interfaceMode">
		<xs:annotation>
			<xs:documentation>Group of the different modes a busInterface can take on in a component</xs:documentation>
		</xs:annotation>
		<xs:choice>
			<xs:element name="master">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface can serve as a master.  This element encapsulates additional information related to its role as master.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element name="addressSpaceRef" minOccurs="0">
							<xs:annotation>
								<xs:documentation>If this master connects to an addressable bus, this element references the address space  it maps to.  It has an addressSpaceRef attribute which is an addrSpaceID key ref.</xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:complexContent>
									<xs:extension base="spirit:addrSpaceRefType">
										<xs:sequence>
											<xs:annotation>
												<xs:documentation>If master's mapping to the physical address space is not zero based, baseAddress and bitOffset elements may be used to indicate the offsets.</xs:documentation>
											</xs:annotation>
											<xs:element ref="spirit:baseAddress" minOccurs="0"/>
											<xs:element ref="spirit:bitOffset" minOccurs="0"/>
										</xs:sequence>
									</xs:extension>
								</xs:complexContent>
							</xs:complexType>
						</xs:element>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="slave">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface can serve as a slave.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:memoryMapRef" minOccurs="0"/>
						<xs:element name="bridge" minOccurs="0" maxOccurs="unbounded">
							<xs:annotation>
								<xs:documentation>If this element is present, it indicates that the bus interface provides a bridge to another master bus interface on the same component.  It has a masterRef attribute which contains the name of the other bus interface.  It also has an opaque attribute to indicate that the bus bridge is opaque.

Any slave interface can bridge to multiple master interfaces, and multiple slave interfaces can bridge to the same master interface.</xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:attribute name="masterRef" type="xs:Name" use="required">
									<xs:annotation>
										<xs:documentation>The name of the master bus interface to which this interface bridges.</xs:documentation>
									</xs:annotation>
								</xs:attribute>
								<xs:attribute name="opaque" type="xs:boolean" use="required">
									<xs:annotation>
										<xs:documentation>If true, then this bridge is opaque; the whole of the address range is mappeed by the bridge and there are no gaps.</xs:documentation>
									</xs:annotation>
								</xs:attribute>
							</xs:complexType>
						</xs:element>
						<xs:element name="fileSetRefGroup" minOccurs="0" maxOccurs="unbounded">
							<xs:annotation>
								<xs:documentation>This reference is used to point the filesets that are associated with this slave port.

Depending on the slave port function, there may be completely different software drivers associated with the different ports. </xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:sequence>
									<xs:element name="group" type="xs:Name" minOccurs="0"/>
									<xs:element ref="spirit:fileSetRef" minOccurs="0" maxOccurs="unbounded"/>
								</xs:sequence>
							</xs:complexType>
						</xs:element>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="system">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface is a system interface, neither master nor slave, with a specific function on the bus.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:group"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="mirroredSlave">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored slave interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence minOccurs="0">
						<xs:element name="baseAddresses" minOccurs="0">
							<xs:annotation>
								<xs:documentation>Represents a set of remap base addresses.</xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:sequence>
									<xs:element name="remapAddress" maxOccurs="unbounded">
										<xs:annotation>
											<xs:documentation>Base of an address block. The state attribute indicates the name of the remap state for which this address is valid.</xs:documentation>
										</xs:annotation>
										<xs:complexType>
											<xs:simpleContent>
												<xs:extension base="spirit:scaledNonNegativeInteger">
													<xs:attributeGroup ref="spirit:long.att"/>
													<xs:attribute ref="spirit:prompt" default="Base Address:"/>
													<xs:attribute name="state" type="xs:string">
														<xs:annotation>
															<xs:documentation>Name of the state in which this remapped address range is valid</xs:documentation>
														</xs:annotation>
													</xs:attribute>
												</xs:extension>
											</xs:simpleContent>
										</xs:complexType>
									</xs:element>
									<xs:element name="range">
										<xs:annotation>
											<xs:documentation>The address range of mirrored slave. </xs:documentation>
										</xs:annotation>
										<xs:complexType>
											<xs:simpleContent>
												<xs:extension base="spirit:scaledPositiveInteger">
													<xs:attributeGroup ref="spirit:long.prompt.att"/>
												</xs:extension>
											</xs:simpleContent>
										</xs:complexType>
									</xs:element>
								</xs:sequence>
							</xs:complexType>
						</xs:element>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="mirroredMaster">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored master interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType/>
			</xs:element>
			<xs:element name="mirroredSystem">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored system interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:group"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="monitor">
				<xs:annotation>
					<xs:documentation>Indicates that this is a (passive) monitor interface. All of the signals in the interface must be inputs. The type of interface to be monitored is specified with the required interfaceType attribute. The spirit:group element must be specified if monitoring a system interface.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:group" minOccurs="0"/>
					</xs:sequence>
					<xs:attribute name="interfaceMode" use="required">
						<xs:simpleType>
							<xs:restriction base="xs:token">
								<xs:enumeration value="master"/>
								<xs:enumeration value="slave"/>
								<xs:enumeration value="system"/>
								<xs:enumeration value="mirroredMaster"/>
								<xs:enumeration value="mirroredSlave"/>
								<xs:enumeration value="mirroredSystem"/>
							</xs:restriction>
						</xs:simpleType>
					</xs:attribute>
				</xs:complexType>
			</xs:element>
		</xs:choice>
	</xs:group>
	<xs:group name="abstractorInterfaceMode">
		<xs:annotation>
			<xs:documentation>Group of the different modes a busInterface can take on in an abstractor</xs:documentation>
		</xs:annotation>
		<xs:choice>
			<xs:element name="master">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface can serve as a master.  This element encapsulates additional information related to its role as master.</xs:documentation>
				</xs:annotation>
				<xs:complexType/>
			</xs:element>
			<xs:element name="slave">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface can serve as a slave.</xs:documentation>
				</xs:annotation>
				<xs:complexType/>
			</xs:element>
			<xs:element name="system">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface is a system interface, neither master nor slave, with a specific function on the bus.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:group"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element name="mirroredSlave">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored slave interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType/>
			</xs:element>
			<xs:element name="mirroredMaster">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored master interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType/>
			</xs:element>
			<xs:element name="mirroredSystem">
				<xs:annotation>
					<xs:documentation>If this element is present, the bus interface represents a mirrored system interface. All directional constraints on signals are reversed relative to the specification in the bus definition.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element ref="spirit:group"/>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
		</xs:choice>
	</xs:group>
	<xs:complexType name="abstractorBusInterfaceType">
		<xs:annotation>
			<xs:documentation>Type definition for a busInterface in a component</xs:documentation>
		</xs:annotation>
		<xs:sequence>
			<xs:group ref="spirit:nameGroup"/>
			<xs:element name="abstractionType" type="spirit:libraryRefType">
				<xs:annotation>
					<xs:documentation>The abstraction type/level of this interface. Refers to abstraction definition using vendor, library, name, version attributes. Bus definition can be found through a reference in this file.</xs:documentation>
				</xs:annotation>
			</xs:element>
			<xs:element name="portMap" minOccurs="0">
				<xs:annotation>
					<xs:documentation>Listing of maps between component ports and bus ports.</xs:documentation>
				</xs:annotation>
				<xs:complexType>
					<xs:sequence>
						<xs:element name="portName" maxOccurs="unbounded">
							<xs:annotation>
								<xs:documentation>Maps a component's port to a port in a bus description.</xs:documentation>
							</xs:annotation>
							<xs:complexType>
								<xs:sequence>
									<xs:element name="abstractorPortName" type="xs:Name">
										<xs:annotation>
											<xs:documentation>Abstractor port name as specified inside the model/ports section</xs:documentation>
										</xs:annotation>
									</xs:element>
									<xs:element name="busPortName" type="xs:Name">
										<xs:annotation>
											<xs:documentation>Bus port name as specified inside the abstraction definition</xs:documentation>
										</xs:annotation>
									</xs:element>
									<xs:element ref="spirit:vector" minOccurs="0"/>
								</xs:sequence>
								<!--								<xs:simpleContent>
									<xs:extension base="xs:token">
										<xs:attribute name="busSignal" type="xs:Name" use="required"/>
										<xs:attribute name="left" type="xs:nonNegativeInteger"/>
										<xs:attribute name="right" type="xs:nonNegativeInteger"/>
									</xs:extension>
								</xs:simpleContent> -->
							</xs:complexType>
						</xs:element>
					</xs:sequence>
				</xs:complexType>
			</xs:element>
			<xs:element ref="spirit:parameters" minOccurs="0"/>
			<xs:element ref="spirit:vendorExtensions" minOccurs="0"/>
		</xs:sequence>
		<xs:anyAttribute namespace="##any" processContents="lax"/>
	</xs:complexType>
</xs:schema>
