Next:
Contents
Contents
Blu-Ice/DCS Administrator's Manual for Release 3.2
Scott McPhillips
Stanford Synchrotron Radiation Laboratory
scottm@slac.stanford.edu
Contents
Introduction
Software License Agreement
Using CVS for source code control
Accessing SSRL's CVS repository
CVS software projects
CVS management policies
CVS naming conventions for tags and branches
Installation
Installing the libraries
Installing the XOS library
Installing the auth library
Installing the diffimage library
Building the jpegsoc library
Installing the newmat10 library
Building the tcl_clibs library
Installing the dcs_tcl_packages library
Installing the widgets library
Installing the mysql client libraries
Installing DCSS
Creating the mysql database schema
Configuring DCSS
Miscellaneous show-stoppers
Quick introduction to the database.dat file
Configuring DCSS' server ports
Configuring the beam line console (NEW for Release 3.2!)
Configuring the mysql User permissions tables
Starting and Stopping DCSS
Installing and configuring the hardware simulator
Installing and Starting the Diffraction Image Server
Installing BLU-ICE
Configuring BLU-ICE
Installing SSRL's DHS
Configuring SSRL's DHS
Miscellaneous show-stoppers for DHS
Starting and Stopping DHS
Installing the detector simulator
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
Document Version Information
Change history
Scott McPhillips 2003-03-11
