Inheritance diagram for timing.shells.tlu.TLUShell:

Collaboration diagram for timing.shells.tlu.TLUShell:

Public Member Functions
	getAX3Slave (self)

	getUIDSlave (self)

	resetI2CnPll (self)

	resetLockMon (self)

	configureExpanders (self)

	configure_pllSwing (self)

	configure_dacs (self)

	reset (self, soft, forcepllcfg)

Public Member Functions inherited from timing.shells.boards.BoardShell
	soft_reset (self)

	enableI2CSwitch (self)

	readUID (self)

	scanI2C (self)

	pingI2CSlaves (self)

	measureClockFrequency (self)

	status (self)

	pllstatus (self, verbose=False)

Static Public Attributes
int	kTLURev1 = 6

dict	kUIDRevisionMap

dict	kClockConfigMap

list	i2cMasters

Additional Inherited Members
Public Attributes inherited from timing.shells.boards.BoardShell
	i2cMasters = lIO.getNode(lI2CName)

Detailed Description

docstring for PC059Shell

Definition at line 20 of file tlu.py.

Member Function Documentation

◆ configure_dacs()

timing.shells.tlu.TLUShell.configure_dacs ( self )

Definition at line 113 of file tlu.py.

    def configure_dacs(self):
        lI2CBusNode = self.device.getNode("io.i2c")
 
        lDAC1 = DACSlave(lI2CBusNode, lI2CBusNode.get_slave('DAC1').get_i2c_address())
        lDAC2 = DACSlave(lI2CBusNode, lI2CBusNode.get_slave('DAC2').get_i2c_address())
 
        # BI signals are NIM
        lBISignalThreshold = 0x589D
 
        lDAC1.set_interal_ref(False);
        lDAC2.set_interal_ref(False);
        lDAC1.set_dac(7, lBISignalThreshold);
        lDAC2.set_dac(7, lBISignalThreshold);
 
        secho("DAC1 and DAC2 set to " + hex(lBISignalThreshold), fg='cyan')

◆ configure_pllSwing()

timing.shells.tlu.TLUShell.configure_pllSwing ( self )

Definition at line 105 of file tlu.py.

    def configure_pllSwing(self):
        lI2CBusNode = self.device.getNode("io.i2c")
        lSIChip = SI534xSlave(lI2CBusNode, lI2CBusNode.get_slave('SI5345').get_i2c_address())
 
        lSIChip.write_i2cArray(0x113, [0x9, 0x33])

◆ configureExpanders()

timing.shells.tlu.TLUShell.configureExpanders ( self )

Definition at line 74 of file tlu.py.

    def configureExpanders(self):
 
        lI2CBusNode = self.device.getNode("io.i2c")
 
        lIC6 = I2CExpanderSlave(lI2CBusNode, lI2CBusNode.get_slave('Expander1').get_i2c_address())
        lIC7 = I2CExpanderSlave(lI2CBusNode, lI2CBusNode.get_slave('Expander2').get_i2c_address())
 
        # Bank 0
        lIC6.set_inversion(0, 0x00)
        lIC6.set_io(0, 0x00)
        lIC6.set_outputs(0, 0x00)
 
        # Bank 1
        lIC6.set_inversion(1, 0x00)
        lIC6.set_io(1, 0x00)
        lIC6.set_outputs(1, 0x88)
 
 
        # Bank 0
        lIC7.set_inversion(0, 0x00)
        lIC7.set_io(0, 0x00)
        lIC7.set_outputs(0, 0xf0)
 
        # Bank 1
        lIC7.set_inversion(1, 0x00)
        lIC7.set_io(1, 0x00)
        lIC7.set_outputs(1, 0xf0)

◆ getAX3Slave()

timing.shells.tlu.TLUShell.getAX3Slave ( self )

Definition at line 36 of file tlu.py.

    def getAX3Slave(self):
        lIO = self.device.getNode('io')
        return lIO.getNode('i2c').get_slave('AX3_Switch')

◆ getUIDSlave()

timing.shells.tlu.TLUShell.getUIDSlave ( self )

Definition at line 43 of file tlu.py.

    def getUIDSlave(self):
        lIO = self.device.getNode('io')
        return lIO.getNode('i2c').get_slave('UID_PROM')

◆ reset()

timing.shells.tlu.TLUShell.reset	(	self,
		soft,
		forcepllcfg )

Perform a hard reset on the timing master, including

\b
- ipbus registers
- i2c buses
- pll and pll configuration

\b
Fanout mode:
0 = local master
1 = sfp

Definition at line 131 of file tlu.py.

    def reset(self, soft, forcepllcfg):
        '''
        Perform a hard reset on the timing master, including
 
        \b
        - ipbus registers
        - i2c buses
        - pll and pll configuration
 
        \b
        Fanout mode:
        0 = local master
        1 = sfp
        '''
 
        lDevice = self.device
        lBoardType = self.info.boardType
        lCarrierType = self.info.carrierType
        lDesignType = self.info.designType
 
        echo('Resetting ' + click.style(lDevice.id(), fg='blue'))
 
        lIO = lDevice.getNode('io')
 
        # Global soft reset
        self.soft_reset()
 
        if not (soft or lBoardType == kBoardSim):
            
            time.sleep(0.1)
            
            # PLL and I@C reset 
            self.resetI2CnPll()
 
            # Enable I2C routing on carrier
            self.enableI2CSwitch()
 
            lUniqueID = self.readUID()
 
            try:
                lRevision = self.kUIDRevisionMap[lUniqueID]
            except KeyError:
                raise click.ClickException("No revision associated to UID "+hex(lUniqueID))
 
            # Access the clock chip
            lI2CBusNode = lDevice.getNode("io.i2c")
            lSIChip = SI534xSlave(lI2CBusNode, lI2CBusNode.get_slave('SI5345').get_i2c_address())
            lSIVersion = lSIChip.read_device_version()
            echo("PLL version : "+style(hex(lSIVersion), fg='blue'))
 
            # Ensure that the board revision has a registered clock config
            if forcepllcfg is not None:
                lFullClockConfigPath = forcepllcfg
                echo("Using PLL Clock configuration file: "+style(basename(lFullClockConfigPath), fg='green') )
            else:
                try:
                    lClockConfigPath = self.kClockConfigMap[lRevision]    
                except KeyError:
                    raise ClickException("Board revision " << lRevision << " has no associated clock configuration")
 
                echo("PLL Clock configuration file: "+style(lClockConfigPath, fg='green') )
 
                # Configure the clock chip
                lFullClockConfigPath = expandvars(join('${TIMING_SHARE}/config/etc/clock', lClockConfigPath))
 
            lSIChip.configure(lFullClockConfigPath)
            echo("SI3545 configuration id: {}".format(style(lSIChip.read_config_id(), fg='green')))
 
            self.configureExpanders()
 
            # Tweak the PLL swing
            lI2CBusNode = lDevice.getNode("io.i2c")
            self.configure_pllSwing()
 
            self.configure_dacs()
 
            self.resetLockMon()
# ------------------------------------------------------------------------------
 

◆ resetI2CnPll()

timing.shells.tlu.TLUShell.resetI2CnPll ( self )

Definition at line 49 of file tlu.py.

    def resetI2CnPll(self):
        lIO = self.device.getNode('io')
        
        # PLL and I@C reset 
        lIO.getNode('csr.ctrl.pll_rst').write(0x1)
        lIO.getNode('csr.ctrl.rst_i2c').write(0x1)
        lIO.getClient().dispatch()
 
        lIO.getNode('csr.ctrl.pll_rst').write(0x0)
        lIO.getNode('csr.ctrl.rst_i2c').write(0x0)
        lIO.getClient().dispatch()

◆ resetLockMon()

timing.shells.tlu.TLUShell.resetLockMon ( self )

Definition at line 64 of file tlu.py.

    def resetLockMon(self):
        lIO = self.device.getNode('io')
 
        lIO.getNode('csr.ctrl.rst_lock_mon').write(0x1)
        lIO.getNode('csr.ctrl.rst_lock_mon').write(0x0)
        lIO.getClient().dispatch()

Member Data Documentation

◆ i2cMasters

list timing.shells.tlu.TLUShell.i2cMasters

static

Initial value:

= [
        'i2c',
    ]

Definition at line 32 of file tlu.py.

◆ kClockConfigMap

dict timing.shells.tlu.TLUShell.kClockConfigMap

static

Initial value:

=  {
        kTLURev1: "wr/TLU_EXTCLK_10MHZ_NOZDM.txt"
    }

Definition at line 28 of file tlu.py.

◆ kTLURev1

int timing.shells.tlu.TLUShell.kTLURev1 = 6

static

Definition at line 22 of file tlu.py.

◆ kUIDRevisionMap

dict timing.shells.tlu.TLUShell.kUIDRevisionMap

static

Initial value:

=  {
        0x5410ecbb9426: kTLURev1,
    }

Definition at line 24 of file tlu.py.

The documentation for this class was generated from the following file:

/github/workspace/dunedaq/sourcecode/timing/python/timing/shells/tlu.py

Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ configure_dacs()

◆ configure_pllSwing()

◆ configureExpanders()

◆ getAX3Slave()

◆ getUIDSlave()

◆ reset()

◆ resetI2CnPll()

◆ resetLockMon()

Member Data Documentation

◆ i2cMasters

◆ kClockConfigMap

◆ kTLURev1

◆ kUIDRevisionMap