gEBM.py

#!/usr/local/bin/python
#
#                               Copyright 2004
#                                     by
#                        The Board of Trustees of the
#                     Leland Stanford Junior University.
#                            All rights reserved.
#


__facility__ = "Online"
__abstract__ = "GLAST EBM functional block"
__author__  = "Selim Tuvi <stuvi@slac.stanford.edu> SLAC - GLAST LAT I&T/Online"
__date__     = ("$Date: 2005/03/05 03:30:23 $").split(' ')[1]
__version__ = "$Revision: 2.10 $"
__release__  = "$Name: R04-12-00 $"
__credits__ = "SLAC"

import LATTE.copyright_SLAC

import gDb
import gAttr

class GEBM(gDb.Gdb):
  """\brief GEBM node.

  """
  __attrs = []

  def __init__(self, client, parent):
    """\brief Initialize child objects.

    """
    self.EBMC = None
    self.EBMST = None
    flags = {'CmdrspFabric': 'On'}
    gDb.Gdb.__init__(self, client, parent, 0, self.__attrs, None, flags)

  def downEBMC(self):
    """\brief Navigate to the GEBMC node.

    \return         The GEBMC object instance
    """
    return self.EBMC

  def existsEBMC(self):
    """\brief Check if the GEBMC instance exists in the schema.

    \return       1 if it exists, 0 if it doesn't.
    """
    return self.EBMC != None

  def downEBMST(self):
    """\brief Navigate to the GEBMST node.

    \return         The GEBMST object instance
    """
    return self.EBMST

  def existsEBMST(self):
    """\brief Check if the GEBMS instance exists in the schema.

    \return       1 if it exists, 0 if it doesn't.
    """
    return self.EBMST != None

## private:

  def __removeEBMC(self):
    self.EBMC = None

  def __addEBMC(self):
    gebmc = GEBMC(self.client(), self)
    self.EBMC = gebmc
    return gebmc

  def __removeEBMST(self):
    self.EBMST = None

  def __addEBMST(self):
    gebmst = GEBMST(self.client(), self)
    self.EBMST = gebmst
    return gebmst


class GEBMC(gDb.Gdb):
  """\brief EBM Controller node.

  Has GEBMC specific registers.

  Valid Registers:
  - \c back_end_config
  - \c front_end_a_config
  - \c front_end_b_config
  - \c address
  - \c sources
  - \c input_enables
  - \c output_enables
  - \c timeout
  - \c tem_statistics
  - \c cr_statistics
  - \c ssr_header

  Dataless Commands:
  - \c cmd_nop
  - \c cmd_reset

  """
  __attrs = [
    # Registers
    gAttr.GattrRaw('back_end_config',     0, 4),
    gAttr.GattrRaw('front_end_a_config',  1, 4),
    gAttr.GattrRaw('front_end_b_config',  2, 4),
    gAttr.GattrRaw('address',             3, 4),
    gAttr.GattrRaw('sources',             4, 4),
    gAttr.GattrRaw('input_enables',       5, 4),
    gAttr.GattrRaw('output_enables',      6, 4),
    gAttr.GattrRaw('timeout',             7, 4),
    gAttr.GattrRaw('tem_statistics',      8, 4),
    gAttr.GattrRaw('cr_statistics',       9, 4),
    gAttr.GattrRaw('ssr_header',         10, 4),
    # Dataless Commands
    gAttr.GattrDlc('cmd_nop',             0, 0),
    gAttr.GattrDlc('cmd_reset',           1, 0),
    ]

  def __init__(self, client, parent):
    """\brief Initialize valid registers as Gattrs
    """
    gDb.Gdb.__init__(self, client, parent, 0, self.__attrs)

  def read(self, reg):
    return self.cmdrsp('EBM_read', gDb.Lem.ADDR_EBM, reg, '!I')

  def load(self, reg, value):
    return self.cmdrsp('EBM_load', gDb.Lem.ADDR_EBM, reg, value)

  def send(self, cmd):
    return self.cmdrsp('EBM_cmd', gDb.Lem.ADDR_EBM, cmd)


class GEBMST(gDb.Gdb):
  """\brief EBM Event Statistics node.

  Has GEBMST specific registers.

  Valid Registers:
  - \c receive_gem
  - \c receive_aem
  - \c receive_siu0
  - \c receive_siu1
  - \c receive_epu0
  - \c receive_epu1
  - \c receive_epu2
  - \c receive_siu2
  - \c receive_tem_mux0
  - \c receive_tem_mux1
  - \c transmit_siu0
  - \c transmit_siu1
  - \c transmit_epu0
  - \c transmit_epu1
  - \c transmit_epu2
  - \c transmit_siu2
  - \c transmit_ssr

  Dataless Commands:
  - \c cmd_reset

  """
  __attrs = [
    # Registers
    gAttr.GattrRaw('receive_gem',          0, 4),
    gAttr.GattrRaw('receive_aem',          1, 4),
    gAttr.GattrRaw('receive_siu0',         2, 4),
    gAttr.GattrRaw('receive_siu1',         3, 4),
    gAttr.GattrRaw('receive_epu0',         4, 4),
    gAttr.GattrRaw('receive_epu1',         5, 4),
    gAttr.GattrRaw('receive_epu2',         6, 4),
    gAttr.GattrRaw('receive_siu2',         7, 4),
    gAttr.GattrRaw('receive_tem_mux0',    16, 4),
    gAttr.GattrRaw('receive_tem_mux1',    17, 4),
    gAttr.GattrRaw('transmit_siu0',       32, 4),
    gAttr.GattrRaw('transmit_siu1',       33, 4),
    gAttr.GattrRaw('transmit_epu0',       34, 4),
    gAttr.GattrRaw('transmit_epu1',       35, 4),
    gAttr.GattrRaw('transmit_epu2',       36, 4),
    gAttr.GattrRaw('transmit_siu2',       37, 4),
    gAttr.GattrRaw('transmit_ssr',        38, 4),
    # Dataless Commands
    gAttr.GattrDlc('cmd_reset',            0, 0),
    ]

  def __init__(self, client, parent):
    """\brief Initialize valid registers as Gattrs.

    """
    gDb.Gdb.__init__(self, client, parent, 0, self.__attrs)

  def read(self, reg):
    return self.cmdrsp('EBM_STAT_read', gDb.Lem.ADDR_EBM, reg, '!I')

  def send(self, cmd):
    return self.cmdrsp('EBM_STAT_cmd', gDb.Lem.ADDR_EBM, cmd)

---