Hardware Configuration Files

Introduction

The hardware configuration file defines the hardware setup currently in use. This file is generally constructed by Emulator administrators and not by end users. Understanding this file, however, may be useful for end users.

The objective of this file is to let the control software know what physical hardware is currently in use. In particular, this file specifies which ports on the DSP are connected to operational Signal Conversion Modules. In addition, this file contains calibration information for each RF Front End or Signal Conversion Module. The file consists of 3 segments: RF Front End definitions, Signal Conversion definitions, and a DSP definition.

RF Front End Definitions

An RF Front End is specified with an id, a downconversion loss, and an upconversion loss. The id should be the serial number of the card. The conversion losses should be measured offline.

RF Front End example

	<RFFrontEnd id="1">
			<downLoss>14.25</downLoss>
			<upLoss>33.6</upLoss>
	</RFFrontEnd>

Signal Conversion Definitions

A Signal Conversion definition consists of an id, adc and dac power settings, adc and dac bit resolutions, and the id of the RF Front End to which this Signal Conversion Module is attached.

Signal Conversion example

	<SignalConversion id="2">
			<adcFullScalePower>7.7</adcFullScalePower>
			<dacFullScalePower>3.0</dacFullScalePower>
			<rfFrontEndID>6</rfFrontEndID>
			<adcBits>12</adcBits>
			<dacBits>14</dacBits>
	</SignalConversion>

DSP Definition

The DSP definition consists of a set of mappings between DSP ports and Signal Conversion Modules

DSP example

	<DSPHardwareDef>
        <hwVersion>1.0.a</hwVersion>
		<Port id="0">
			<signalConversionID>4</signalConversionID>
		</Port>
		<Port id="1">
			<signalConversionID>8</signalConversionID>
		</Port>
		<Port id="2">
			<signalConversionID>6</signalConversionID>
		</Port>
		<Port id="3">
			<signalConversionID>5</signalConversionID>
		</Port>
		<Port id="4">
			<signalConversionID>3</signalConversionID>
		</Port>
		<Port id="5">
			<signalConversionID>7</signalConversionID>
		</Port>
		<Port id="6">
			<signalConversionID>2</signalConversionID>
		</Port>
		<Port id="7">
			<signalConversionID>fake1</signalConversionID>
		</Port>
	</DSPHardwareDef>