Uploaded image for project: 'SAFe Program'
  1. SAFe Program
  2. SP-3777

MID CSP.LMC provides API for the DISH to VCC Mapping Table and correctly handles initalisation and updates

Change Owns to Parent OfsSet start and due date...
    XporterXMLWordPrintable

Details

    • Obs Mgt & Controls
    • Hide

      MID CSP.LMC provides interface to allow TMC to command Mid.CBF to load a particular version of the DISH to VCC Mapping Table, and to obtain the currently used version.
      Without DISH to VCC Mapping Table the MID telescope cannot be functional.

      Show
      MID CSP.LMC provides interface to allow TMC to command Mid.CBF to load a particular version of the DISH to VCC Mapping Table, and to obtain the currently used version. Without DISH to VCC Mapping Table the MID telescope cannot be functional.
    • Hide
      • CSP.LMC provides API that enables TMC to obtain the version of the DISH to VCC Mapping Table currently used by the MID.CBF.
      • CSP.LMC provides API that enables TMC to instruct MID.CBF to load specific version of the DISH to VCC Mapping Table.
      • CSP.LMC takes in consideration the DISH to VCC Mapping Table status when reporting the status of the Controller, Subarrays and resources.
      • CSP.LMC raises warnings and alarms as appropriate to bring issues to the TMC and Operator attention.
      • CSP.LMC is integrated with MID.CBF.

      The demo is provided to show:
      a) TMC can check which version of the table is used (file name).
      b) TMC can instruct the MID.CBF, via CSP.LMC, to load a different version of the DISH to VCC Mapping Table.
      c) What if Mid.CBF uses a different version from the one that was passed by CSP.LMC ?

      Show
      CSP.LMC provides API that enables TMC to obtain the version of the DISH to VCC Mapping Table currently used by the MID.CBF. CSP.LMC provides API that enables TMC to instruct MID.CBF to load specific version of the DISH to VCC Mapping Table. CSP.LMC takes in consideration the DISH to VCC Mapping Table status when reporting the status of the Controller, Subarrays and resources. CSP.LMC raises warnings and alarms as appropriate to bring issues to the TMC and Operator attention. CSP.LMC is integrated with MID.CBF. The demo is provided to show: a) TMC can check which version of the table is used (file name). b) TMC can instruct the MID.CBF, via CSP.LMC, to load a different version of the DISH to VCC Mapping Table. c) What if Mid.CBF uses a different version from the one that was passed by CSP.LMC ?
    • 2
    • 1
    • 10
    • 5
    • Team_CREAM
    • Sprint 3
    • Hide

      Addressing acceptance criteria:

      • CSP.LMC provides API that enables TMC to obtain the version of the DISH to VCC Mapping Table currently used by the MID.CBF. -> this is done via dishVccConfig and sourceDishVccConfig attributes. TMC has the ability to send input argument with link to CAR URI from where Mid.CBF retrieves the mapping or sending the mapping directly. 
      • CSP.LMC provides API that enables TMC to instruct MID.CBF to load specific version of the DISH to VCC Mapping Table. ->this version is specified in the input argument, CSP.LMC passes it to Mid.CBF as instructed from TMC.
      • CSP.LMC takes in consideration the DISH to VCC Mapping Table status when reporting the status of the Controller, Subarrays and resources. -> CSP.LMC healthState of subarrays is affected in case of command failure/incorrect mapping 
      • CSP.LMC raises warnings and alarms as appropriate to bring issues to the TMC and Operator attention. -> CSP.LMC raises an "alarm" flag when there is an issue with command execution or in case of mismatch in the attribute compared to received argument.
      • CSP.LMC is integrated with MID.CBF. -> CSP.LMC release is tested with latest Mid.CBF and integration tests are provided as proof. Partial testing was also done at MID PSI.

       

      Mid CSP.LMC release 0.18.0 implements LoadDishCfg command. This was tested and demoed with Mid.CBF 0.12.15. 

      This version of CSP.LMC implements

      • LoadDishCfg command which is translated internally into InitSysParam command when forwarded to Mid.CBF
      • attribute dishVccConfig, which reads from sysParam attribute of Mid.CBF
      • attribute sourceDishVccConfig, which reads from sourceSysParam attribute of Mid.CBF
      • boolean flag which is tripped in case command is unsuccessful

      Analysis of possible error handling approach is captured in the document: https://docs.google.com/document/d/13hoxvVs6PBcnmlhNSYviKUFqjVZrLGRH2k0UT394Kyg/edit?usp=drive_link (future work)

      Testing:

      X-Ray tests related to this functionality are linked. 

      Testing was also done manually during two sessions documented here:

      https://confluence.skatelescope.org/display/SE/Exploratory+Testing+Session+26-01-2024

      https://confluence.skatelescope.org/display/SE/Exploratory+Testing+Session+12-01-2024

      Show
      Addressing acceptance criteria: CSP.LMC provides API that enables TMC to obtain the version of the DISH to VCC Mapping Table currently used by the MID.CBF. -> this is done via dishVccConfig and sourceDishVccConfig attributes. TMC has the ability to send input argument with link to CAR URI from where Mid.CBF retrieves the mapping or sending the mapping directly.  CSP.LMC provides API that enables TMC to instruct MID.CBF to load specific version of the DISH to VCC Mapping Table. ->this version is specified in the input argument, CSP.LMC passes it to Mid.CBF as instructed from TMC. CSP.LMC takes in consideration the DISH to VCC Mapping Table status when reporting the status of the Controller, Subarrays and resources. -> CSP.LMC healthState of subarrays is affected in case of command failure/incorrect mapping  CSP.LMC raises warnings and alarms as appropriate to bring issues to the TMC and Operator attention. -> CSP.LMC raises an "alarm" flag when there is an issue with command execution or in case of mismatch in the attribute compared to received argument. CSP.LMC is integrated with MID.CBF. -> CSP.LMC release is tested with latest Mid.CBF and integration tests are provided as proof. Partial testing was also done at MID PSI.   Mid CSP.LMC release 0.18.0 implements LoadDishCfg command. This was tested and demoed with Mid.CBF 0.12.15.  This version of CSP.LMC implements LoadDishCfg command which is translated internally into InitSysParam command when forwarded to Mid.CBF attribute dishVccConfig, which reads from sysParam attribute of Mid.CBF attribute sourceDishVccConfig, which reads from sourceSysParam attribute of Mid.CBF boolean flag which is tripped in case command is unsuccessful Analysis of possible error handling approach is captured in the document:  https://docs.google.com/document/d/13hoxvVs6PBcnmlhNSYviKUFqjVZrLGRH2k0UT394Kyg/edit?usp=drive_link  (future work) Testing: X-Ray tests related to this functionality are linked.  Testing was also done manually during two sessions documented here: https://confluence.skatelescope.org/display/SE/Exploratory+Testing+Session+26-01-2024 https://confluence.skatelescope.org/display/SE/Exploratory+Testing+Session+12-01-2024
    • 21.5
    • Stories Completed, BDD Testing Passes (no errors), Outcomes Reviewed, Demonstrated, Satisfies Acceptance Criteria, Accepted by FO
    • PI24 - UNCOVERED

    • Team_CREAM
    • Mid G1

    Description

      Context:
      DISH ID is inserted into data flowing from the DISH to MID.CBF. Each Mid.CBF VCC (Very Coarse Channelizer) handles digitized and packetized data from one dish, and is able to retrieve DISH ID from the received packets. In addition, to ensure that the connections are as expected, MID.CBF receives (or obtains) DISH to VCC Mapping Table via Monitor and Control path. When deployed, during initialization Mid.CBF loads the DISH to VCC Mapping Table via Telescope Model.
      TMC provides interface to allow Operations to command Mid.CBF to load a particular version of the DISH to VCC Mapping Table, and to obtain the currently used version (TMC can obtain that from Mid.CBF via CSP.LMC).
      Without DISH to VCC Mapping Table the MID telescope cannot be functional.
      The design work to determine the format of the DISH to VCC Mappint Table, the location where the table is stored, the file names and the development work required to enable that the table can be accessed via the Telescope Model is responsibility of the MID.CBF team. See https://jira.skatelescope.org/browse/SP-3611.
      TMC provides API to enable Operations to specify which version should be used, and to instruct the Telescope to load a different version when needed. TMC also ensures that CSP uses the correct version (as specified by Operations).
      It has been agreed that TMC, in the same manner as Mid.CBF, will load the "DISH to VCC Mapping Table" during initialization, from a file via Telescope Model.
      In addition, Mid.CBF should be able to receive an instruction (command) to load a particular version of the "DISH to VCC Mapping Table" (it could be the same of different version), and may allow user to specify DISH ID for an individual VCC (via an engineering interface).

      The role of CSP.LMC:

      • MID CSP.LMC provides API to enable TMC to specify which version of the table sjall be used by Mid.CBF.
      • When commanded, CSP.LMC passes the table name and location to Mid.CBF.
      • CSP.LMC provides API that TMC can use to check which versio of the table Mid.CBF is using ( CSP.LMC obtains information from Mid.CBF and passes to TMC).

      Context:
      The purpose of "DISH to VCC Mapping Table" is to tell Mid.CBF which dish is connected to which VCC (Very Coarse Channelizer). Mid.CBF will compare the DISH ID received from the dish with this table and raise ALARM if the actual setup is not as expected. This table will eventually have 197 entries and should be stored under version control, so that we keep historical data, and can, for each observation (SB/scan, establish what was the telescope setup.

      Telescope Level Functionality:

      • The "DISH to VCC Mapping Table" shall be under version control to allow operations to tell TMC and Mid.CBF which version to use.
      • Operations/users shall be able to define different version of the table for different deployments (telescope, ITF, PSI, CI/CD pipelines).
      • Operations shall be able to specify the version to be used for each deployment. The table shall be loaded during the telescope (TMC) initialization.
      • TMC shall provide interface so that the Operations can instruct the Telescope (TMC and Mid.CBF) to load a different version of the "DISH to VCC mapping table" without a need to re-deploy software.
      • It has been agreed that the Telescope Model is the best place to place this table. More precisely, the file containing the table will be stored on CAR, and the access will be via the Telescope Model.

      Attachments

        Issue Links

          Structure

            Activity

              People

                s.vrcic Vrcic, Sonja
                s.vrcic Vrcic, Sonja
                Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Feature Progress

                  Story Point Burn-up: (100.00%)

                  Feature Estimate: 2.0

                  IssuesStory Points
                  To Do00.0
                  In Progress   00.0
                  Complete510.0
                  Total510.0

                  Dates

                    Created:
                    Updated:
                    Resolved:

                    Structure Helper Panel