Next:
Contents
Contents
Blu-Ice/DCS Administrator's Manual for Release 4.1
Scott McPhillips
Stanford Synchrotron Radiation Laboratory
cottm@slac.stanford.edu
Contents
Introduction
Software License Agreement
Definitions
What's new for Release 4.1
Improved makefiles and batchbuild project
Simplified file based configuration
Authentication
Impersonation Server
Blu-Ice: Enhanced vs. Original
C++ library for developing new DHS programs
C++ Logging library
Optimized C code for handling DCS protocol
Simulated Detector DHS
Installation
Using CVS for source code control
Obtaining and Building the Software
Testing the Installation
Configuration
Configuring the dcsconfig files
Configuring MyAuthServer
Configuring the Diffraction Image Server
Configuring DCSS
Configuring DCSS's listening ports.
Configuring DCSS's Authentication.
Restricting Remote Access
Configuring DCSS's logging style
Quick introduction to the database.dat file
Configuring your impersonation server
Configuring your crystal screening server
Configuring "enhanced" Blu-Ice
Configuring "original" Blu-Ice
Configuring the detector simulator
Configuring SSRL's DHS
Configuring the DHS to Control Dmc2180 Motion Controllers
Configuring the DHS to Control a Quantum 4 Area Detector
Configuring the DHS to Control a Quantum 315 Area Detector
Configuring the DHS to Control a MAR345 Area Detector
Configuring the DHS to Control a MAR CCD Area Detector
Configuring the DHS to Perform Loop Analysis of Axis 2400 Camera View
Starting and Stopping programs
Starting and Stopping DCSS
Starting the hardware simulator
Starting "enhanced" Blu-Ice
Starting "original" Blu-Ice
Starting the Diffraction Image Server
Starting the MyAuthServer for authentication
Maintaining the
database.dat
file
Dumping the
database.dat
file
Recreating the
database.dat
file
Format of the
database.dat
file
The Real Motor Entry
The Pseudo Motor Entry
The DHS definition
The Ion Chamber Entry
The Shutter Entry
The Run Definition Entry
The Runs Definition entry
The Operation Entry
The Encoder Entry
The String Entry
The Device Permissions Bits
Writing Scripted Devices and Operations
General DCS Scripting Commands
Writing to the log window in BLU-ICE
Querying a motor position
Moving a motor
Inserting/Removing shutters and filters
Waiting for hardware
Using ion chambers
Using encoders
Using Operations
Starting an operation
Obtaining operation results
Scripted Device Family Relationships
Children and Parents
Siblings
Observers
Exception Handling
The legalities of problems with motors
Handling the global abort
Handling DHS Crashes
Throwing your own exceptions
Writing specialized exception handlers
Adding Scripts to the Scripting Engine
Adding New Scripted Devices
Adding New Scripted Operations
Example scripts
Testing the diffractometer
The
energy
device on different beam lines
The DCS Protocol
The DCS Message Structure
The DCS message header
The text section
The binary section
Connection Protocol
Gui to Server Messages (gtos)
gtos_abort_all
gtos_become_master
gtos_become_slave
gtos_configure_device
gtos_read_ion_chambers
gtos_set_motor_position
gtos_set_shutter_state
gtos_start_motor_move
gtos_start_oscillation
gtos_start_operation
Hardware to Server Messages (htos)
htos_client_is_hardware
htos_configure_device
htos_motor_move_completed
htos_motor_move_started
htos_update_motor_position
htos_report_shutter_state
htos_report_ion_chambers
htos_send_configuration
htos_simulating_device
htos_operation_update
htos_operation_completed
Server To GUI Client Messages (stog)
stog_become_master
stog_become_slave
stog_configure_real_motor
stog_configure_pseudo_motor
stog_motor_move_completed
stog_motor_move_started
stog_no_hardware_host
stog_other_master
stog_report_ion_chambers
stog_report_shutter_state
stog_simulating_device
stog_unrecognized_command
stog_update_motor_position
stog_operation_completed
stog_operation_update
Server To Hardware Messages (stoh)
stoh_abort_all
stoh_correct_motor_position
stoh_start_motor_move
stoh_configure_real_motor
stoh_configure_pseudo_motor
stoh_read_ion_chambers
stoh_set_motor_position
stoh_set_shutter_state
stoh_start_oscillation
stoh_start_operation
Example code listings in ASCII
Test Diffractometer BLU-ICE Script
Test Diffractometer Operation Script
Adding new hardware support
Example: Adding MAR CCD support
CVS software projects
Packages needed by BLU-ICE
Document Version Information
Change history
Scott McPhillips 2011-07-06