White Light Source
- The halogen light source HL-2000-HP-232R sends no acknowledgement after reception of a command. Therefore, the programmer is never sure if the command was accepted and executed successfully by the device.
- The device lacks a mechanism to query the lamp status. The programmer is unable to tell for sure if the lamp is on or off.
- In order to ensure that the lamp is turned off, the device should be powered off. It is insufficient to send a command to the device for turning the lamp off (CO). The reason for this is the lack of acknowledgement for commands. It is possible that the device is unable to turn off the lamp. Futhermore, the command CO could be lost if the communication with the device goes over an ethernet-to-serial server and the device is quickly deattached and reattached from this server.
- Ocean Optics engineer Patrick Zeller wrote in an e-mail that "there is some uncertainty in position regulation. So I allow a deviation of +-2 steps in position. [...] Sometimes small movements are not carried out. This is caused by the above mentioned uncertainty in positioning. This means movements of less than ~3 +steps may be carried out or not. If you need to do single steps then I would suggest to move back 10 steps and then go to the desired position."
- Often, the under-voltage error bit is set. This happens even with the official power supply. Ocean Optics engineer Patrick Zeller: I'm not sure why the Undervoltage bit is set. There could be a problem with the supplied voltage breaking down for short periods, but that's only a guess.
The following serial port settings are required:
| Baud rate
| Data bits
| Stop bits
| Flow control
Property Tree Configuration
A complete example of a property tree configuration file
can be in the repository.
The basda device for the white light source requires the following properties in the configuration file:
* NAME : string (e.g. "white Light Source SX")
* CONNECTION : chat connection string (e.g. "!tcp://nport-luci3:4001")
- the name of the white light source device.
- the location of the device given as a chat location. If there is a direct serial line connection, the location is of the format "tty:/<device path>:<baud rate>:<number of bits>:<parity used> (e.g. "tty:/dev/ttyS0:9600:8:no"). If the device is accessible via a serial device server the location has the format "tcp://<hostname or IP address>:<TCP port number>" (e.g "tcp://192.168.0.1:4001").
Automatically Generated Properties
Every white light source basda device created the following properties during construction:
* ABSOLUTE_MOTION.POSITION_IN_STEPS : int
* ABSOLUTE_MOTION.COMMAND : Completion
* CLOSE_SHUTTER_FULLY : Completion
* ERROR_MESSAGE : string ("no errors" if the hardware has no problems)
* IS_HARDWARE_REACHABLE : boolean
* LAMP_STATUS : string ("ON", "OFF", "probably ON", "probably OFF", or "UNKNOWN")
* OPEN_SHUTTER_FULLY : Completion
* PRESENT_POSITION_IN_STEPS : int
* RELATIVE_MOTION.POSITION_IN_STEPS : int
* RELATIVE_MOTION.COMMAND : Completion
* RESET : Completion
* SHUTTER_MOTOR_START_POSITION_IN_STEPS: int
* SHUTTER_MOTOR_END_POSITION_IN_STEPS: int
* SHUTTER_STATE : string ("closed", "fully opened", "partially opened" or "unknown")
* TURN_LAMP_ON : Completion
* TURN_LAMP_OFF : Completion
- the argument for the absolute motion command in unit step.
- the Completion node for triggering one absolute motion.
- the Completion node for closing the shutter fully.
- the Completion node for opening the shutter fully.
- the fault status in a human-readable format.
- the status property for hardware reachability.
- the status property for the lamp status.
- the status property for the current position in unit step.
- the argument for the relative motion command in unit step.
- the Completion node for executing one relative motion.
- the completion node to reset the hardware driver.
- the status property for the shutter.
- the absolute motor position where the shutter is fully closed.
- the absolute motor position where the shutter is fully open.
- the command property for turning the lamp on.
- the command property for turning the lamp off.
- The sleep duration before updating the property values by reading out the hardware.