Ka Receiver Manager Modifications to Accommodate the Zpectrometer

Modification Request #1 (C05 2006)

1. Introduction

In order to accommodate the Zpectrometer, the Ka Band receiver requires five items to be added/modified:

The addition of a feature which allows the Zpectrometer to control the cal
The addition of a feature which allows the Zpectrometer to control the phase modulators
The addition of a feature which allows general control of switches which bypass the hybird T
The addition of a feature which allows the control of output signal switches which route signals to the Zpectrometer
The addition of a LO power level monitor

This MR specifies the modifications and additions to the Ka manager. The Cleo information contained in this MR is for informational or illustrative purposes only. Galen is working directly with Ron on the details of the Cleo changes.

2. Background

See KaManagerModifications for background material on this MR.

3. Requirements

Manager:

3.1 Add cal control feature for Zpectrometer via the addition of bit3 of register 49h as shown in the design section. (4.1)
3.2 Add phase modulator control feature for Zpectrometer via the addition of bit3 of register 4Ah and register at 4Dh. (4.2)
3.3 Add monitoring of Zpectrometer LO level (4.4)
3.4 Add 'ZSP' as keyword value for CALSRC primary header keyword in receiver manager FITS file
3.5 Add 'ZSP' as keyword value for PHASSRC primary header keyword in receiver manager FITS file
3.6 Increment FITVERS keyword value to 2.2
3.7 Provide control and monitoring for new hybrid bypass and output select as listed in section 4.3
- 3.7.1 Modify IF Manager emulation to represent new signal paths.
- 3.7.2 Remove DCR routing functionality of bits b7-b0 in register RA 4Eh (4.3)
- 3.7.3 Remove corresponding IFManager parameters supporting this function
- 3.7.4 Re-assign functions to Zpectrometer signal routing and hybird bypass
- 3.7.5 Add 'D1BYSW' as primary keyword to denote bypass switch state. A zero value means not hybird T is bypassed, non-zero means bypassed.
- 3.7.6 Add 'S1BYSW' as primary keyword to denote bypass switch state. Ditto.
- 3.7.7 Add 'D2BYSW' as primary keyword to denote bypass switch state. Ditto.
- 3.7.8 Add 'S2BYSW' as primary keyword to denote bypass switch state. Ditto.

The names L2HTBYSW and R1HTBYSW are misleading at best and I strongly suggest these components be named after the switches not the polarization and feed (eg, d1bysw d2bysw s1bysw s2bysw). At that point in the system you cannot associate a single feed and polarization with a component, they are both mixed up. Plus the feed mapping depends on the phase balance between the hybrids, so you will name it, and maybe get it wrong and it will be backwards (BSM 25jul06)

Cleo:

3.8 Add selection for 'Zpectrometer' to the Cal Control and Phase Control popup menus
- 3.8.1 When Zpectrometer is selected for the phase control, the Sig/Ref track buttons shall become active and selectable to allow the Zpectrometer observer to activate specific phase switches.
- 3.8.2 When Zpectrometer is selected for the Cal control, the External Track buttons shall become deactive and selected
3.9 Add a calibration frequency path to the noise source with an 'LO Level' sampler readout to the screen
- 3.9.1 The value shall be read from MCB RA 1Ah, and made available to Cleo via a sampler.
- 3.9.2 The value display shall be in the range of 0-9.999 volts, with a format of x.xxx

4. Design

4.1 Cal Control

From the document 2640MCBspec, section 2.2 Calibration Signal Control, Relative Address 49h:

Six bits control the noise calibration sources. By writing the desired code to the Cal Control address (relative address 49h), the noise sources may be controlled by the MCB, turned over to external digital signals from the CCB or to an external input where the individual cal sources can be used or disabled.

b3	b2	b1	The EXT/LOCAL/CCB/MCB Cal Control Select bits
0	0	0	LOCAL manual control via a switch on the receiver control box.
0	0	1	Control of both diodes individually by the MCB via b4 and b5.
0	1	0	EXT input to the receiver through BNC connector J31.
0	1	1	Control of both diodes individually by the CCB.
1	0	0	Control of both diodes individually by the Zpectrometer via b6 and b7.
1	0	1	Illegal
1	1	0	Illegal
1	1	1	Illegal

b4 - Controls the diode noise source for beam 1 with the MCB. When bit 4 is set HI the noise source is OFF.
b5 - Controls the diode noise source for beam 2 with the MCB. When bit 5 is set HI the noise source is OFF.
b6 - Controls the diode noise source for beam 1 with the EXT input, J31. When bit 6 is set LOW the noise source is ON when EXT is LOW.
b7 - Controls the diode noise source for beam 2 with the EXT input, J31. When bit 7 is set LOW the noise source is ON when EXT is LOW.

When in the EXT control mode (bits 1 and 2 low), a TTL low signal at connector J31 turns both noise sources ON; TTL high turns them OFF.

4.2 Phase Modulator Control

The phase switches in each differencing leg are controlled by a register at relative address 4Ah, with the following definition:

b3	b2	b1	The LOCAL/CCB/MCB Phase Switch Control Input Select bits
0	0	0	LOCAL manual control via switches on the receiver control box.
0	0	1	Control of phase switches individually by the MCB via 4Ch.
0	1	0	Control of phase switches individually by the SIG/REF-EXT PHASE Input.
0	1	1	Control of phase switches individually by the CCB.
1	0	0	Control of phase switches individually by the Zpectrometer via register at 4Dh
1	0	1	Illegal
1	1	0	Illegal
1	1	1	Illegal

For information only, the register at RA 4Dh controls:

b0 - boolean denoting whether the S1 phase switch was tracking the Phase (beamswitch) signal
b1 - boolean denoting whether the D1 phase switch was tracking the Phase (beamswitch) signal
b2 - boolean denoting whether the S2 phase switch was tracking the Phase (beamswitch) signal
b3 - boolean denoting whether the D2 phase switch was tracking the Phase (beamswitch) signal

4.3 Signal Routing Control and Monitoring for hybrid tee

Currently register RA4Eh controlls the receiver's DCR routing functions. This functionality is being removed, and being reassigned as noted below.

Altering the signal path to the Zpectrometer is accomplished by a control register at RA 4Eh bits 4-7. Setting a bit HIGH (swOn) results in the following signal path change:

b0 - Diff 1 from before hybrid tee
b1 - Sum 1 from before hybrid tee
b2 - Diff 1 18-4 GHz to Zpectrometer (JZ1)
b3 - Sum 1 18-4 GHz to Zpectrometer (JZ2)
b4 - Diff 2 from before hybrid tee
b5 - Sum 2 from before hybrid tee
b6 - Diff 2 18-4 GHz to Zpectrometer
b7 - Sum 2 18-4 GHz to Zpectrometer

Note:

All bits set low results in normal routing to the GBT IF system.
All bits set high results in normal routing to the Zpectrometer system.

The values in register RA 54h can be read to determine status of the routing switches. A message will be asserted if the readings are different from the commanded values.

The manager will provide access to these values by providing a enum parameter for each value, with the following mapping:

Bit	Parameter Name	Port Affected
b0	diff1_bypassHybrid
b1	sum1_bypassHybrid
b2	diff1_toZpectrometer	swOff==J17, swOn==J23
b3	sum1_toZpectrometer	swOff==J18, swOn==J24
b4	diff2_bypassHybrid
b5	sum2_bypassHybrid
b6	diff2_toZpectrometer	swOff==J19, swOn==J25
b7	sum2_toZpectrometer	swOff==J20, swOn==J26

A true value corresponds to setting the bit to a high or '1'. Each value will also be passed onto the IFManager. The enumeration strings are "swOff" (zero) and "swOn" (1).

The following Rcvr26_40 parameter will be renamed: dcrMultiplexer to outputMultiplexer.

4.4 Analog Monitor for Zpec LO Level

The Zpectrometer LO level can be read from an MCB register at RA 1Ah, with a scale factor of 1.0. The rate shall be adjustable, similar to the existing samplers for LO1 levels.

4.5 IF Manager Changes

The additional paths available in the Ka band receiver will need to be incorporated into the IF Manager to keep the simulation in sync with the hardware.

The following IFManager parameters will be deleted: Ka2Dcr_dcrMultiplexerA, Ka2Dcr_dcrMultiplexerB, Ka2Dcr_dcrMultiplexerC, Ka2Dcr_dcrMultiplexerD
The following IFManager parameters will be added: Rcvr26_40_sum1_bypassHybrid, Rcvr26_40_diff1_bypassHybrid, Rcvr26_40_sum1_toZpectrometer, Rcvr26_40_diff1_toZpectrometer, Rcvr26_40_sum2_bypassHybrid, Rcvr26_40_diff2_bypassHybrid, Rcvr26_40_sum2_toZpectrometer, Rcvr26_40_diff2_toZpectrometer

5. Details of Cleo/Manager Interactions

The calState and phaseModState parameters have a new enumeration ctlZpectrometer.
The sampler value for the Zpectrometer LO level is in sampler zspectLOLevel
The new parameter zpectLOLevelRate (similar to the parameter loPowerMonitorRate) controls the sampling rate of the Zpectrometer LO level
The Cleo screen schematic will need to reflect the changes in Ka receiver signal routing. New switches controlled by the parameters listed in section 4.3.

Detailed Changes:

5.1 Rcvr26_40 Manager:

Added enumeration 'ctlZpectrometer' to calState and phaseModState params
Added sampler 'zspectLOLevel' for the Zpectrometer LO level
Added parameter 'zpectLOLevelRate' (similar to the parameter loPowerMonitorRate) to control the sampling rate of the Zpectrometer LO level
Added parameters to control hybrid bypass and zpectrometer routing:
- sum1_bypassHybrid, (swOn == bypassed)
- diff1_bypassHybrid,
- sum2_bypassHybrid,
- diff2_bypassHybrid,
- sum1_toZpectrometer (swOn == signal to J24, off to J18)
- diff1_toZpectrometer (swOn == signal to J23, off to J17)
- sum2_toZpectrometer (swOn == signal to J26, off to J20)
- diff2_toZpectrometer (swOn == signal to J25, off to J19)

5.2 GUI Changes (I'm not 100% sure about this -- Ron, you probably know best)

Add selection for 'Zpectrometer' to the Cal Control and Phase Control popup menus
When Zpectrometer is selected for the phase control, the Sig/Ref track buttons shall become active and selectable to allow the Zpectrometer observer to activate specific phase switches.
When Zpectrometer is selected for the Cal control, the External Track buttons shall become deactive and selected
Add a calibration frequency path to the noise source with an 'LO Level' sampler readout to the screen The value display shall be in the range of 0-9.999 volts, with a format of x.xxx

5.3 IFManager related changes:

Removed all parameters with Ka2Dcr prefix.
Added:
- Rcvr26_40_sum1_bypassHybrid,
- Rcvr26_40_diff1_bypassHybrid,
- Rcvr26_40_sum1_toZpectrometer,
- Rcvr26_40_diff1_toZpectrometer,
- Rcvr26_40_sum2_bypassHybrid,
- Rcvr26_40_diff2_bypassHybrid,
- Rcvr26_40_sum2_toZpectrometer,
- Rcvr26_40_diff2_toZpectrometer,
New IFManager feedback parameters:
- Rcvr26_40_J21,
- Rcvr26_40_J22,
- Rcvr26_40_J23,
- Rcvr26_40_J24,
- Rcvr26_40_J25,
- Rcvr26_40_J26,

6. Deployment Checklist

What has to get done to integrate this completely into the system. This checklist must be completed before Cycle Integration Testing begins.

Communication with Computing group needed? No.
What documentation needs to be updated? Ka band FITS format specification.
Training Needed? Is this being released to staff astronomers or everyone right now? No, the Zpectrometer is currently a PI instrument.
Notification Needed? No
Ron Maddalena needs to be informed of when MR is delivered, along with any interface changes. (Cleo changes described in this MR are for informational purposes only.)

Config-tool needs to be updated to properly configure the new switches in the receiver. This will require input from scientific staff.

7. Test Plan

7.1 Internal Testing

This section covers things like unit testing, simulator testing, and any other tests required to make sure this MR is ready for sponsor/integration/regression testing.

Most of this MR can be tested on the simulator by monitoring the state and value of the cal control and phase control MCB registers. Additional simultation of the Zspectrometer LO level monitoring can be performed by writing different values to the monitored address using the mcbcmd tool.

7.2 Sponsor Testing

This section is for the sponsor. These tests are the prerequisite for sign off for the "accepted/delivered by sponsor" item in the "signatures" section.

Testing will be conducted in the lab, to verify both the hardware and software modifications. All tests are not listed below. Below is a matrix of MR requirement and representative tests. This does not include any hardware testing.

Requirement	Test	Notes
3.1	Using Cleo or devexplorer, can cal be controlled? (i.e. set cal control to every possible value, and verify hardware responds correctly)	[3]
3.2	Using Cleo or devexplorer, can phase monitors be controlled? (i.e. set phase monitor control to every possible value, and verify hardware responds correctly)	[3]
3.3	Using Cleo or devexplorer, are monitored values displayed? (compare monitored value with voltmeter)	[3]
3.4,3.5	New values present in FITS keywords denoting cal and phase control source.	[2]
3.6,3.7	New bypass switch header keywords present and indicate correct values. (set switches and verify hardware is set appropriately)	[3]
3.8	Selection for 'Zpectrometer' to the Cal Control and Phase Control popups exist and are functional	N/A[1]
3.8	Sig/Ref buttons enabled when Zpectrometer is selected as phase control source	N/A[1]
3.8	External track buttons are selected and disabled (i.e. greyed out) when Zpectrometer is selected as cal control source	N/A[1]
(various)	With a bench test setup, can the receiver routing, cal selection and phase switches be controlled? (i.e. general operational tests)	[3]

Notes:

[1] Cleo testing for informative purposes only, not included as criteria for MR acceptance.
[2] By inspection.
[3] During integration, testing will include end-to-end checks to verify register bit mapping and proper polarity.

7.3 Integration/Regression Tests

What do the integration/regression testers need to do in order to test this MR.

I assume the best way to test the device, is to use the Zpectrometer in an observation. Will the unit be available???

Not until mid-September. Perhaps you and Galen can come up with a way to monitor control lines, etc. AmyShelton

Control lines can be manipulated, monitored, tested, etc with lab equipment, no problem not having Zpectrometer. GalenWatts

See Sponsor testing.

Signatures

APPROVED: I acknowledge that my request is fully contained in this MR, and if the SDD delivers exactly what I specified, I will be happy.

ACCEPTED: I acknowledge that I have validated the completed code according to the acceptance tests, and I am happy with the results.

Written	- JoeBrandt - 14 Jul 2006
Checked	- RamonCreager - 20 Jul 2006
Approved by Sponsor	- GalenWatts - 20 Jul 2006
Approved by CCC	- RonMaddalena - 5 Sep 2006
Accepted/Delivered by Sponsor	symbol - name - date

Symbols:

Use %X% if MR is not complete (will display )
Use %Y% if MR iscomplete (will display )

CCC Discussion Area

Topic ModificationRequest1C506 . { Edit | Attach | Ref-By | Printable | Diffs | r1.22 | > | r1.21 | > | r1.20 | More }

Revision r1.22 - 05 Sep 2006 - 20:30 GMT - RonMaddalena Parents: PlanOfRecordC52006	Content copyright © 1999-2007 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.


NRAO Home > Green Bank \| Wiki Topic: GB > Software > PlanOfRecordC52006 > ModificationRequest1C506

Changes \| Index \| Contents \| Search \| Statistics \| Go