The Racelan Language
The manual for the original radar controller compiler for ESR, racelan can be found here. A new radar controller compiler is now available which is called tarlan_esr. This version is especially made for the new DSP system installed in the summer of 2002. The manual for the racelan compiler will also cover the tarlan_esr compiler except some small differences shown below.
Racelan commands not implemented tarlan_esr
DO n/ ENDDO
New or duplicated command
racelan <-> tarlan_esr
BUFLIP1 <-> BUFLIPI Note: For the ION line DSP box only BUFLIP is implemented. Please look at the ESR receiver block diagram.
BUFLIP2 <-> BUFLIPII Note: BUFLIPII and BUFLIP2 is only implemented in plasma line DSP
ENABM[1-6] <-> CH[1-8]
DISBM[1-6] <-> CH[1-8]OFF
RXBITON[0-31] <-> BRX[0-31]
RXBITOFF[0-31] <-> BRX[0-31]OFF
TXBITON[0-31] <-> BTX[0-31]
TXBITOFF[0-31] <-> BTX[0-31]OFF
AD[1,2][L,R] Set proper AD selection for the channel boards. For example AD1L, route input for AD 1 to channel board 1, 2, 3. AD2R, route AD 2 to channel 4, 5, 6. This is for the ION line box. For the plasma line box we have the split chnanels as 1-4 and 5-8.
NCOSEL[0-1023] Load the frequency defined in the requested memory into the NCO on the channel board.
IF2[AB] Is gone, as the switch for selecting plasma line channel is removed.
HBRX[0-5] Set a bit in the high bit field in the receiver radar controller
HBRX[0-5]OFF Unset a bit in the high bit field in the receiver radar controller
HBTX[0-5] Set a bit in the high bit field in the transmitter radar controller
HBTX[0-5]OFF Unset a bit in the high bit field in the transmitter radar controller
CAUTION! No sanity checks are done on direct bit manipulations done with BRX[0-31], BRX[0-31]OFF, BTX[0-31], BTX[0-31]OFF, HBRX[0-5], HBRX[0-5]OFF, HBTX[0-5], and HBTX[0-5]OFF These commands should be used with great care.
New commands for the plasma line receiver chain
STFIRP Start fir filter. Ion line command STFIR
RXSYNCPON Rx sync on. Ion line command RXSYNCON
RXSYNCPOFF RX sync off. Ion line command RXSYNCPON
NCOPRSP Reset phase registers on NCO’s. Ion line command NCOPRS
STCP Send start compute interrupt. Ion line command STC
AD[1-2]LP Route proper AD to channel boards. Ion line command AD[1-2]L
AD[1-2]RP Route proper AD to channel boards. Ion line command AD[1-2]R
CH[1-8]P Start channel board memory writing. Ion line command Ch[1-8]
CH[1-8]POFF Stop channel board memory writing. Ion line command CH1[1-8]OFF
ALLPOFF Stop channel board memory writing on all channels. Ion line command ALLOFF
NCOSEL[0-1023]P Use a NCO memory location. Ion line command NCOSEL[0-1023]
BRX[0-31]P Set a specific bit in the plasma radar controller. Ion line command BRX[0-31]
BRX[0-31]POFF Unset a specific bit in the plasma radar controller. Ion line command BRX[0-31]OFF
HBRX[0-5]P Set a specific high bit in the plasma radar controller. Ion line command HBRX[0-5]
HBRX[0-5]POFF Unset a specific high bit in the plasma radar controller. Ion line command HBRX[0-5]OFF
AD[1-2]PLA[3-4]2M[U,D] Route plasma IF channels to proper AD converter, for example AD1PLA32MU will route 32m upshifted
IF channel to AD1
These new commands can be used directly inside the tlan code for the 32m antenna, the compiler will give three binaries out. These will be called, for the transmitter xxx_esr.tbin, for the ion line xxx_ionesr.rbin and for the plasma line xxx_plasmaesr.rbin. This binaries can now be loaded in the proper radar controller from the ELAN file. As an exmple firstname.lastname@example.org is shown.
The tarlan_esr Compiler
tarlan_esr [SWITCHES] [OPTIONS] file_name
-f <file name>
-p Switch, to compile for the old DSP crate which is used for the plasma lines. This box have an 10 MHz AD.
The default is to compile for the ion line DSP crate. In this box the AD operate at 15 MHz.
-c Switch, to enable Chx sample window timing output. Example:
<>tarlan_esr -c -f /kst/eros4/exp/arc_slice/
Compiling for ESR
Will write to rx file arc_slice_esr.rbin
Will write to tx file arc_slice_esr.tbin
………. Output cutted here
Total channel on time at BUFLIP
CH1 387840.0 us on CH2 15360.0 us on CH3 0.0 us on CH4 0.0 us on CH5 0.0 us on CH6 0.0 us on BUFLIPCH1=3030 us
………. Output cutted here
RFON=98304 us IPP=1009920 us rf duty=9.73% beam duty=11.28% rxprot duty=13.03%
Longest pulse 384 us
Shortest pulse 384 us
Nr of instr TX=10896 RX=1038
Bytes in controller prog. 0 RX=8320 and TX=87152
Bytes in tx file 87152
Bytes in rx file 8320
Imposed hardware timing limits and default bit patterns
% These are the hardware delay times for the ESR radar. % The delay times are given in usecs. % This file is used by the tarlan_esr compiler. % % 10-May-2002: Default RXBITPATTERN 0x4007FE80 --> 0x4007FEC0 % % Minimum, maximum rf duty cycle % RFDUTYCYCMIN 0.1 % (%) RFDUTYCYCMAX 25.0 % (%) % % Minimum, maximum RF pulse lengths % RFPULSEMIN 0.5 % (us) RFPULSEMAX 2000 % (us) % % Maximum BEAMON time % BEAMONMAX 2000 % (us) % % Minimum, maximum beam duty cycle % BEAMDUTYCYCMIN 0.1 % (%) BEAMDUTYCYCMAX 25.0 % (%) % % Minimum, maximum beam ipp % BEAMIPPMIN 500 % (us) BEAMIPPMAX 50000 % (us) % % Maximum RXPROT duty cycle % RXPROTDUTYCYCMAX 40.0 % (%) % HARDWARE TIMINGS FOR TRANSMITTER RXPROT->BEAMON 10 % RXPROT until BEAMON can be given (us) BEAMON->RFON 10 % BEAMON until RFON can be given (us) PREAMPOFF->BEAMON 10 % Shortest time between PREAMPOFF and BEAMON (us) RFOFF->BEAMOFF 5 % RFOFF until BEAMOFF can be given (us) BEAMOFF->RXPOFF 20 % BEAMOFF until RXPOFF can be given (us) RXPOFF->PREAMPON 5 % Shortest time between RXPOFF and PREAMPON (us) % HARDWARE TIMINGS FOR DSP % STC until END can be given STC->END 15 % Ion DSP (us) STCP->END 15 % Plasma DSP (us) % longest time between STC and BUFLIP STC->BUFLIP 5 % Ion DSP (us) STCP->BUFLIP 5 % Plasma DSP (us) %Default bit pattern for the radar controllers % The TXBITPATTERN and RXBITPATTERN are in hex RXBITPATTERNPLASMA 0x4007FCD0 % Default bit setting for the plasma side RXBITHPATTERNPLASMA 0x3F % High default bit setting for the plasma side RXBITPATTERNION 0x4007FE80 % Default bit setting for ion side RXBITHPATTERNION 0x3F % High default bit setting for the ion side TXBITPATTERN 0x07FBFFF8 % Default bit setting for the transmitter TXBITHPATTERN 0x0 % Default high bit setting for the transmitter % END