DuPont M2 Software Documentation

The Observatories of the Carnegie Institution for Science (Carnegie Observatories), Pasadena, CA

Version 1.3

Christoph C. Birk (birk AT obs DOT carnegiescience DOT edu)

Location of this document: http://instrumentation.obs.carnegiescience.edu/Software/DuPont/dupontm2.html

News
GUI Documentation
TCP/IP interface
Hardware Documentation

How-To change the lamp setup

News

2024-12-12: The code has been moved to GitHub

v1.3.6 (2020-11-16)
  • Increased the wait time after power-up of the Galil controllers from 1.5 to 2.5 seconds.
    • v1.3.5 (2020-02-25)
  • Fixed a bug that prevented the "auto-power-down" feature to work when the setup of the Galil controller failed.
    • v1.3.4 (2020-02-19)
  • Deployment target macOS 10.13 (HighSierra).
  • Updated the default lamp list (fflamps.xml):
    • LED, t02, t03, t04, Apg, Lsr, HeAr, Ne
  • Reduced logging of I/O with the Galil motor controller.
    • v1.3.3 (2017-08-24)
  • Updated the default lamp list (fflamps.xml):
    • t01, t02, t03, t04, Apg, Lsr, HeAr, Ne
  • The GUI appends the name of the axis to the error string that causes a conflict when commanded via the TCP/IP interface.
    • "ERROR: INVALID" --> "ERROR: INVALID Lateral1"
    v1.3.2 (2017-04-11)
  • Fixed a memory leak in the TCP/IP server code.
    • The problem occured when a program opened a TCP/IP connection to the M2-GUI and kept it open for a long time while sending commands.
    v1.3.1 (2017-03-21)
  • Fixed a bug that overwrote the focus,tip/tilt,colx,coly edit controls
    • everytime a "status" command was received via the TCP/IP interface, even if the user was currently editing the control.
  • Fixed a bug that prevented the auto-power-down feature to work properly
    • when the GUI received frequent "status" commands via the TCP/IP interface.
    v1.3 (2017-02-15)
  • Copy 'fflamps.html' from the .app folder to the shared '/Users/Shared/Application Support/DuPontM2' folder if it does not exist there.
    This allows for easier modification of the lamp setup.
    APOGEE would like to add control of a laser.
    • Release Notes

    Screen Shots and GUI Documentation

    Startup Window - M2 Window - Main Menu - Preferences Window - Galil Hardhat

    Startup Window

    Set the online status and IP numbers of the Galil motor controllers and the Acromag digital I/O device.
    The TCP/IP server should run on its default port (52001).

    M2 Window

    Galil/Power: {off, On}
    Manually switch the power to the Galil controller.
    FF Lamps: Switch the power to the flat-field lamps.
    Collimation: change the x,y position of the secondary mirror [mm]
    Tip/Tilt: change the tip,tilt of the sec.mirror [arcsec]
    Focus: change the focus of the sec. mirror [um]

    How-To change the lamp setup:

    1. select the File--Show_AppSupport entry from the main menu.
    2. open 'fflamps.xml' in a text editor.
    3. make the appropriate changes; eg. replace the first '-' label by 'Lsr'.
      Only 3 characters will fit into the button.
      A '-' label denotes unused and the button will be disabled.
    4. save the file.
    5. close the M2-GUI and re-open it.
    If you want to reset to the default setup (t01,t02,t03,t04,Apg,Lsr,HeAr,Ne), just delete the 'fflamps.xml' file from the Application_Support folder. It will be re-created (from the master version in the .app folder) at the next program startup.

    Main Menu

    Open Logfile: opens the GUI logfiles in the Console application:
    /Users/Shared/Library/Logs/DuPontm2/DuPont_YYYY_WW.log
    /Users/Shared/Library/Logs/DuPontm2/galilYYYY_WW.log
    Show AppSupport: opens the shared application support folder in a Finder window:
    /Users/Shared/Library/Application Support/DuPontM2/
    This folder contains the 'fflamps.xml' file that defines the current flat-field lamp setup.
    M2: open the main GUI window.
    Hardhat: open the Galil Hardhat window.
    GUI Documentation: open this website in a web browser.

    Preferences Window

    AutoStart: Skip the Startup window (above) and open the GUI right away.
    The settings from the last session are restored.
    AutoPowerUp: Automatically power up the Galil controller when the GUI opens.
    AutoPowerDown: Power down the Galil motor controllers after # seconds.

    Galil Hardhat

    Encoder/MoveTo: Current encoder reading.
    Pressing Enter on this edit box moves the axis to the absolute position.
    R/F: Status of the limit switches.
    Stop: Decelerate this axis until stopped.
    +/-: Start a relative motion by StepRelative steps.
    StepRelative: Number of steps to move.
    Jog: Sliding this control initiates a motion until the mouse button is released.
    Left does move reverse. Right moves forwared (larger encoder numbers).
    Speed: max. speed of the motion profile (trapezoid).
    Acc: Acceleration of the motion (velocity) profile.
    Dec: Deceleration of the motion (velocity) profile.

    Axis: Select the axis for the Command edit box.
    Update: Update all axes from the Galil controller.
    Command: Send a string to Galil controller of the selected axis.
    Stop: Emergency STOP (all axes, inf. deceleration).

    Instrument Software Documentation Index

    2016-03-21, Christoph C. Birk, Carnegie Observatories