ACSIS Correlator Crate Software HIA/DRAO ACSIS Correlator Crate - - PowerPoint PPT Presentation

National Research Council Canada Conseil national de recherches Canada

ACSIS Internal Design Review 21-23 June 1999 Dominon Radio Astropyhsical Observatory Herzberg Institute of Astrophysics

ACSIS Correlator Crate Software

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

Outline

• System Overview
• System Interfaces
• Observing Protocol: How ACSIS is used
• Software components and structure

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

Main Functions

• Configure and control correlator modules in a crate
• Provide test facilities
• Readout lag and status data from correlator modules
• Sum lag data
• Send correlator module data to DRAMA tasks that are

monitoring it.

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

The Context Diagram

AC SIS C orrelator RTS Reduction Sy stem TODD Com m and File Xilinks Program File(s) Hardware Conf iguration File Seq # Export D ata C om m ands | Param eters Com m ands | Param eters D V SV C orrRdy XilinksProgram D ata H dwConf igParm s

• r other program (s)
• r other DRAMA program

Project Nam e: Project Path: Chart File: Chart N am e: Created On: Created By : Modif ied On: Modif ied By : ACSIS Correlator c:\proj\acsis\corr\case\ context.trg Context Diagram May -30-1999 Gary H ov ey Jun-03-1999 Gary H ov ey

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

The Data Flow Diagram

1 H ost Interf ace 2 C rate Controller 3 Process D ata 4 Send D ata SV DV Com m ands | Param eters Export D ata Seq # CorrR dy Raw Correlator Module D ata Correlator Module D ata Crate C om m and + Param eters Processing Com m and + Param eters XilinksProgram Data HdwConf igParm s Export D ata Project N am e: Project Path: Chart File: Chart N am e: Created On: Created By : Modif ied On: Modif ied By : AC SIS Correlator c:\proj\acsis\corr\case\ trg00001.trg AC SIS Correlator May -30-1999 Gary H ov ey Jun-03-1999 Gary H ov ey

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

External Interfaces

• Configuration and observing parameters passed in ASCII

space-delimited text files.

– Parameters can also be modified, sent, retrieved using DRAMA set and get commands.

• Control Commands sent using DRAMA obeyw commands

– REBOOT – CHECK_HEALTH – INITIALISE – START – STOP

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

• Data “Exported” to Reduction system using DRAMA

parameter monitoring facilities. Data tagged with sequence numbers.

• Integration and readout controlled using RTS signals

– Sequence Number – Sequence Valid – Data Valid – Subsystem Ready

External Interfaces (continued)

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

Observing Protocol

• Steps needed to use the correlator during an observation.
• Ingredients:

– Low-level Crate configuration file – DRAMA obeyw INITIALISE – DRAMA set StartSeq x EndSeq y – obeyw START

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

• Procedure:

1) Generate configuration text file. 2) Send a DRAMA obeyw INITIALISE. Completion means the configuration file was read. 3) Optionally, send DRAMA set commands to modify any parameters. 4) Send a DRAMA set commands to set the start and end sequence. 5) Send a DRAMA obeyw START command. 6) Setup and run RTS so it generates sequence numbers. 7) When the End Sequence is reached quit or continue at step 2, 3, or 4.

Observing Protocol (continued)

ACSIS Internal Design Review, 21-23 June 1999

HIA/DRAO ACSIS Correlator Crate Software

Crate software components:

• Tasks

– Host Interface Task – Correlator Controller Task – Process Data Task – Send Data Task

• Support Modules

– Parameter data handling module – RTS driver module – Interprocess Communications Module – Crate and correlator driver module

HostIFtsk A IPC:Wait4Event Crate:start Parm::GetHostName Parm:GetBufSizes Crate:stop Crate:init HostName BufSizes HostName BufSizes CmdList DataList Status Status Status Status Project Name: Project Path: Chart File: Chart Name: Created On: Created By: Modified On: Modified By: ACSIS Correlator c:\proj\acsis\corr\case\ stc00001.stc HostIF_Task Jun-03-1999 Gary Hovey Jun-06-1999 Gary Hovey

Crate:init RTS Interface Logic RTS_IF:init SIOInterrupt RTS_IF:hndl_interrupt VxWorks:postq SIO Port VxWorks:InitSIO VxWorks:malloc VxWorks:rdSIO SIO Port rtsparm rtsstatus eventBuf Que:cratetsk SIOparm sizeof(eventBuf) eventBuf seqNum DV SV Project Name: Project Path: Chart File: Chart Name: Created On: Created By: Modified On: Modified By: ACSIS Correlator c:\proj\acsis\corr\case\ stc00007.stc RTSModule Jun-02-1999 Gary Hovey Jun-06-1999 Gary Hovey

HostIF_Task Parm::GetHostName Parm:GetBufSizes Parm:GetCrateParm HostIF_Task Crate:init Parm:GetCrateState Parameters Crate:init Crate:start Parm:SetCrateState Crate:stop Crate:stop Crate:start Crate:init corrprm.txt Clib:fscanf Parameters Parm:SetCrateParm Parm:LoadDefaults Clib:fopen CrateControllerTask crateparm cratestate cratestate cratestate HostName BufSizes cratestate cratestate cratestate crateparm FileName:corrprm.txt fd fd val

DRAMA:SdpCreate IPC:Wait4Event DRAMA:DitsMainLoop DRAMA:DitsStop DRAMA:SdpInit DRAMA:DitsInit DRAMA:DitsPutActionHandlers DRAMA:DitsPutParSys A HostIF_Task CmdList NumCmds Status BufSizes HostName Status Status ParmSysId Status SdpGet SdpPut Status ParmSysId Status DataList NumData ParmSysId HostName Status Statu HostName BufSizes CmdList DataList Status Project Name: Project Path: Chart File: Chart Name: Created On: Created By: Modified On: Modified By: ACSIS Correlator c:\proj\acsis\corr\case\ stc00006.stc IPCModule Jun-02-1999 Gary Hovey Jun-06-1999 Gary Hovey

IPC:updateCMdata DRAMA:DitsUpdate CMData SendDataTask Status CMbuf Status