Epics@GSI Webhome

HadCon 2 Multipurpose Controls Protocol Cmnd Apfel

Introduction

Command descriptions of command APFEL

    General Operation

    The APFEL command set allows to talk to (several instances of) the APFEL ASIC. It uses a subset of the the I/O-Ports of the ATMEL μController to facilitate the communication to the proprietary protocol of the asic.
    • Logically
      • Output:
        • CLK
          • quasi clock, only the level changes are important
        • DOUT
          • data out
        • Side Select
          • position
      • Input:
        • DIN
          • data in
      • GND
    • Electrical:
      • 3.3 Volt
    • Physically:
      • per default:
        • JDINOUT1/2, JADC
          • I/O ports:
            I/O port A C F
            Connector JDINOUT1 JDINOUT2 JADC
            pins DIN1 1 DIN1 1 DIN1 1
            DOUT1 2 DOUT1 2 DOUT1 2
            CLK1 3 CLK1 3 CLK1 3
            SS1 4 SS1 4 SS1 4
            DIN2 5 DIN2 5 DIN2 5
            DOUT2 6 DOUT2 6 DOUT2 6
            CLK2 7 CLK2 7 CLK2 7
            SS2 8 SS2 8 SS2 8

      Main Commands

        Overview Main

          overall main command structure

          APFEL <command> %ADDRESS%  [<Argument(s)>]

          command address arguments comment
          "channel" value(s)
          d/dac <portLetter>
          A,B,C,D,E,F,G
          <pinSetId>
          [ 1, 2 ]
          <sideSelectId>
          [ 1, 2 ]
          <chipId>
          [ 0 ... 7, 8 ... FE, FF]
          0xFF: generic call to all available chip Ids
          see command chipIdIgnoreMask for limiting the chipId range
          <dacId>
          [ 1 ... 4 ]
          < 4, e.g. 0xA: all DACs get value vDAC1
          [vDAC1[vDAC2[vDAC3[vDAC4]]]]
          [ 0 ... 0x3FF ]
          read/writes up to 4 DAC channels (if set with sign, incr/decr relatively)
          a/autoCalib     auto calibration of the DAC channels
          t/testPulse <channelId>
          [ 1 ... 2 ]
          < 4, e.g. 0xA: both channels
          height1 [height2]
          [ 0 ... 0xF ]
          initiate test pulse
          ampl <channelId>
          [ 1 ... 2 ]
          < 4, e.g. 0xA: both channels
          [ amplification1 [amplification2] ]
          [ 0,1, H,L ]
          0,L: low amplification (× 16)
          1,H: high amplification (× 32)
          get/set amplification mode
          l/list       lists all addresses of available ids


        APFEL d/dac

          Task
          Format
          • NOTE: setting <chipId> to 0xFF loops over all avaiable chip IDs
          • read
            • single DAC at port/pos/chipId:
              APFEL dac %ADDRESS% <dacId>
              APFEL d   %ADDRESS% <dacId>
            • all 4 DACs at port/pos/chipId:
              APFEL dac %ADDRESS%
              APFEL d   %ADDRESS%
            • all 4 DACs of all available chipIds at port/pos:
              APFEL dac <portId> <sideSelectId>
              APFEL d   <portId> <sideSelectId>
          • write
            • single DAC at port/pos/chipIds:
              APFEL dac %ADDRESS% <dacId ≤ 4 > <value>
              APFEL d   %ADDRESS% <dacId ≤ 4 > <value>
            • all 4 DACs at port/pos/chipId with same value:
              APFEL dac %ADDRESS% <dacId > 4> <value>
              APFEL d   %ADDRESS% <dacId > 4> <value>
            • all 4 DACs at port/pos/chipId with individual values:
              APFEL dac %ADDRESS% <(dummy)> <valueDAC1> <valueDAC2> <valueDAC3> <valueDAC4>
              APFEL d   %ADDRESS% <(dummy)> <valueDAC1> <valueDAC2> <valueDAC3> <valueDAC4>
          Response
          • single dac channel access
            RECV APFEL dac %ADDRESS% <dacId> <value>
          • any other plots per found chip
            RECV APFEL dac %ADDRESS% <dacId> <valueDAC1> <valueDAC2> <valueDAC3> <valueDAC4>
          Description

          read or write values from/to DAC channel(s) (if set with sign, incr/decr relatively)
          Arguments
          • <portId>
          • <posId>
          • <chipId>
          • <dacId>
          • <value>
          Comments
        ---

        APFEL a/autocalib

          Task
          Format
          Response
          Description
          Comments
        ---

        APFEL t/testPulse

          Task
          Format
          Response
          Description
          Comments
        ---

        APFEL ampl

          Task
          Format
          Response
          Description
          Comments
        ---

        APFEL l/list

          Task
          Format
          Response
          Description
          Comments
        ---

    Configuration


      Overview Configuration

        overall configuration command structure

        APFEL <command> [<Argument(s)>]

        command arguments comment
        pasem/portAddressSetEnableMask [<addressSetEnableMask>]
        [ 0, FFFF ]
        mask to enable address sets, where the bit position in the 16bit word corresponds to the address set index [default: 0x1]
        epas/enablePortAddressSet [<Address Set Index>]
        [ 0, F ]
        enable (all) address set(s)
        dpas/disablePortAddressSet [<Address Set Index>]
        [ 0, F ]
        disable (all) address set(s)
        apas/addPortAddressSet <PORTx> <CLK Pin> <DOUT Pin> <DIN Pin> <SS Pin> [ <enable> ]
        [ 0, FF], [ 0, FF], [ 0, FF], [ 0, FF], [ 0, FF], [ 0, 1]
        add port address set for CLK, DIN/DOUT, SS
        rpas/removePortAddressSet [<address Set Index> ]
        [ 0, F ]
        remove (all) port address set
        spas/showPortAddressSet [<address Set Index> ]
        [ 0, F ]
        show (all) port address sets


      APFEL pasem/portAddressSetEnableMask

        Task
        Format
        Response
        Description
        Comments
      ---

      APFEL epas/enablePortAddressSet

        Task
        Format
        Response
        Description
        Comments
      ---

      APFEL dpas/disablePortAddressSet

        Task
        Format
        Response
        Description
        Comments
      ---

      APFEL apas/addPortAddressSet

        Task
        Format
        Response
        Description
        Comments
      ---

      APFEL rpas/removePortAddressSet

        Task
        Format
        Response
        Description
        Comments
      ---

Warning: Can't find topic Epics.HadConMultipurposeControlsProtocolCmndApfelFirstTestResults


-- PeterZumbruch - 26 Jan 2015
-- PeterZumbruch - 2015-01-26

  • apfel.tar.gz: Shell scripts used for testing the basic functionality before implementation
Topic attachments
I Attachment Action Size Date Who Comment
apfel.tar.gzgz apfel.tar.gz manage 33.6 K 2014-05-06 - 08:35 PeterZumbruch Shell scripts used for testing the basic functionality before APWI implementation
Edit | Attach | Print version |  PDF | History: r23 | r4 < r3 < r2 < r1 | Backlinks | View wiki text | Edit WikiText | More topic actions...
Topic revision: r3 - 2015-01-26, PeterZumbruch
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding GSI Wiki? Send feedback
Imprint (in German)
Privacy Policy (in German)