/**
* checks firmware versions and gives any necessary warnings to user
*
* @param key
*/
private void checkFirmwareVersion(Devices.Keys key) {
// firmware version check only for ASI devices
if (!devices_.isTigerDevice(key)) {
return;
}
float firmwareVersion = props_.getPropValueFloat(key, Properties.Keys.FIRMWARE_VERSION);
switch (key) {
case PIEZOA:
case PIEZOB:
if (firmwareVersion == 0f) {
// firmware version property wasn't found, maybe device hasn't been selected
} else if (firmwareVersion < (float) 2.829) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": Piezo firmware is old; piezo may not move correctly in sync with sheet."
+ " Contact ASI for updated firmware.");
}
break;
case GALVOA:
case GALVOB:
if (firmwareVersion == 0f) {
// firmware version property wasn't found, maybe device hasn't been selected
} else if (firmwareVersion < (float) 2.809) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": Micromirror firmware is old; wheel control of some scanner axes may not work."
+ " Contact ASI for updated firmware.");
} else if (firmwareVersion < (float) 2.829) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": Micromirror firmware is old; imaging piezo not set correctly the first stack."
+ " Contact ASI for updated firmware.");
} else if (firmwareVersion < (float) 2.859) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": Micromirror firmware is old; not all timing parameters are supported."
+ " Contact ASI for updated firmware.");
}
break;
case PLOGIC:
if (firmwareVersion < 3.069) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": PLogic firmware is old; some features may not work."
+ " Contact ASI for updated firmware.");
}
break;
default:
break;
}
}
/**
* Constructs a special JComboBox with all cameras that have only 1 channel
*
* @param deviceName
* @return
*/
public JComboBox makeSingleCameraDeviceBox(Devices.Keys deviceName, int maximumWidth) {
List<String> singleCameras = new ArrayList<String>();
singleCameras.add(0, "");
String originalCamera = core_.getCameraDevice();
try {
StrVector strvDevices = core_.getLoadedDevicesOfType(mmcorej.DeviceType.CameraDevice);
for (int i = 0; i < strvDevices.size(); i++) {
String test = strvDevices.get(i);
core_.setCameraDevice(test);
if (core_.getNumberOfCameraChannels() == 1) {
singleCameras.add(test);
}
}
} catch (Exception ex) {
MyDialogUtils.showError("Error detecting single camera devices");
} finally {
try {
core_.setCameraDevice(originalCamera);
} catch (Exception e) {
MyDialogUtils.showError(e);
}
}
JComboBox deviceBox = new JComboBox(singleCameras.toArray());
deviceBox.addActionListener(new DeviceBoxListener(deviceName, deviceBox));
deviceBox.setSelectedItem(
devices_.getMMDevice(deviceName)); // selects whatever device was read in by prefs
deviceBox.setMaximumSize(new Dimension(maximumWidth, 30));
return deviceBox;
}
/**
* Constructs a special JComboBox with all cameras that have more than 1 channel, which we expect
* to just be a single Multicamera device
*
* @param deviceName
* @return
*/
public JComboBox makeMultiCameraDeviceBox(Devices.Keys deviceName, int maximumWidth) {
List<String> multiCameras = new ArrayList<String>();
multiCameras.add(0, "");
try {
StrVector strvDevices = core_.getLoadedDevicesOfType(mmcorej.DeviceType.CameraDevice);
for (int i = 0; i < strvDevices.size(); i++) {
// find all Multi-camera devices (usually just one)
String test = strvDevices.get(i);
if (core_.getDeviceLibrary(test).equals(Devices.Libraries.UTILITIES.toString())
&& core_
.getDeviceDescription(test)
.equals("Combine multiple physical cameras into a single logical camera")) {
multiCameras.add(strvDevices.get(i));
}
}
} catch (Exception ex) {
MyDialogUtils.showError("Error detecting multi camera devices");
}
JComboBox deviceBox = new JComboBox(multiCameras.toArray());
deviceBox.addActionListener(new DeviceBoxListener(deviceName, deviceBox));
// if we have one and only one multi-camera then set box to it
if (multiCameras.size() == 2) { // recall we added empty string as the first entry
deviceBox.setSelectedIndex(1);
} else {
deviceBox.setSelectedItem(
devices_.getMMDevice(deviceName)); // selects whatever device was read in by prefs
}
deviceBox.setMaximumSize(new Dimension(maximumWidth, 30));
return deviceBox;
}
private void checkPropertyExists(Devices.Keys devKey, Properties.Keys propKey) {
if (!devices_.hasProperty(devKey, propKey)) {
MyDialogUtils.showError(
"Device \""
+ devices_.getMMDevice(devKey)
+ "\" doesn't have required property \""
+ propKey.toString()
+ "\"");
}
}
private void checkPropertyValueEquals(
Devices.Keys devKey, Properties.Keys propKey, Properties.Values expectedValue) {
if (!(props_.getPropValueString(devKey, propKey).equals(expectedValue.toString()))) {
if (MyDialogUtils.getConfirmDialogResult(
"This plugin may not work if property \""
+ propKey.toString()
+ "\" of device \""
+ devices_.getMMDevice(devKey)
+ "\" is not set to \""
+ expectedValue.toString()
+ "\". Set it now?",
JOptionPane.YES_NO_OPTION)) {
props_.setPropValue(devKey, propKey, expectedValue);
}
}
}
/**
* Constructs a JComboBox populated with devices of specified Micro-Manager type Attaches a
* listener and sets selected item to what is specified in the Devices class.
*
* @param deviceType - Micro-Manager device type (mmcorej.DeviceType)
* @param deviceKey - ASi diSPIM device key (see Devices class)
* @param maximumWidth -
* @return final JComboBox
*/
public JComboBox makeDeviceSelectionBox(
mmcorej.DeviceType deviceType, Devices.Keys deviceKey, int maximumWidth) {
// when editing this method do the same to the one with array argument too
JComboBox deviceBox = new JComboBox();
ArrayList<String> devices = new ArrayList<String>();
StrVector strvDevices = core_.getLoadedDevicesOfType(deviceType);
devices.addAll(Arrays.asList(strvDevices.toArray()));
devices.add(0, "");
deviceBox.removeAllItems();
for (String device : devices) {
deviceBox.addItem(device);
}
deviceBox.addActionListener(new DeviceBoxListener(deviceKey, deviceBox));
deviceBox.setSelectedItem(
devices_.getMMDevice(deviceKey)); // selects whatever device was read in by prefs
deviceBox.setMaximumSize(new Dimension(maximumWidth, 30));
return deviceBox;
}
/**
* checks that the device has correct library, properties that we need, and correct values set as
* needed
*
* @param key
*/
private void checkDeviceLibrary(Devices.Keys key) {
Devices.Libraries deviceLibrary = devices_.getMMDeviceLibrary(key);
if (deviceLibrary == Devices.Libraries.NODEVICE) {
return;
}
switch (key) {
case CAMERAA:
case CAMERAB:
switch (deviceLibrary) {
case HAMCAM:
checkPropertyExists(key, Properties.Keys.TRIGGER_SOURCE);
checkPropertyValueEquals(
key, Properties.Keys.TRIGGER_POLARITY, Properties.Values.POSITIVE);
break;
case PCOCAM:
// trigger polarity not accessible in Micro-Manager, so we have to trust it is correct
checkPropertyExists(key, Properties.Keys.TRIGGER_MODE_PCO);
break;
case ANDORCAM:
// TODO check trigger polarity
checkPropertyExists(key, Properties.Keys.TRIGGER_MODE);
break;
case DEMOCAM:
checkPropertyValueEquals(key, Properties.Keys.PIXEL_TYPE, Properties.Values.SIXTEENBIT);
break;
default:
MyDialogUtils.showError(
"Plugin doesn't support your camera for SPIM yet;"
+ " contact the authors for support (camera must have hardware trigger)");
} // CamA/B case
break;
case GALVOA:
case GALVOB:
if (deviceLibrary == Devices.Libraries.ASITIGER) {
checkPropertyValueEquals(
key, Properties.Keys.INPUT_MODE, Properties.Values.INTERNAL_INPUT);
// PLogic use in the plugin assumes "laser + side" output mode
if (devices_.isValidMMDevice(Devices.Keys.PLOGIC)) {
checkPropertyValueEquals(
key, Properties.Keys.LASER_OUTPUT_MODE, Properties.Values.LASER_SHUTTER_SIDE);
}
} else {
MyDialogUtils.showError("Plugin doesn't support galvo devices other than ASITiger");
}
break;
case PIEZOA:
case PIEZOB:
if (deviceLibrary == Devices.Libraries.ASITIGER) {
checkPropertyValueEquals(
key, Properties.Keys.PIEZO_MODE, Properties.Values.INTERNAL_CLOSEDLOOP_INPUT);
} else {
MyDialogUtils.showError("Plugin doesn't support piezo devices other than ASITiger");
}
break;
case PLOGIC:
if (deviceLibrary == Devices.Libraries.ASITIGER) {
// would like to do below line but we need to change pre-init value and reload config
// checkPropertyValueEquals(key, Properties.Keys.PLOGIC_MODE,
// Properties.Values.DISPIM_SHUTTER);
if (!props_
.getPropValueString(key, Properties.Keys.PLOGIC_MODE)
.equals(Properties.Values.DISPIM_SHUTTER.toString())) {
MyDialogUtils.showError(
"Device "
+ devices_.getMMDevice(key)
+ ": need to set pre-initialization property PLogicMode to "
+ "diSPIM Shutter (use Hardware Config Wizard, then edit device "
+ devices_.getMMDevice(key)
+ " on Step 2). Then reload the "
+ " changed configuration and restart the diSPIM plugin.");
}
checkPropertyValueEquals(
key, Properties.Keys.PLOGIC_TRIGGER_SOURCE, Properties.Values.PLOGIC_TRIGGER_MMIRROR);
// PLogic use in the plugin assumes "laser + side" output mode
for (Devices.Keys galvoKey : Devices.GALVOS) {
if (devices_.isValidMMDevice(galvoKey)) {
checkPropertyValueEquals(
galvoKey,
Properties.Keys.LASER_OUTPUT_MODE,
Properties.Values.LASER_SHUTTER_SIDE);
}
}
} else {
MyDialogUtils.showError("Plugin doesn't support shutter devices other than ASITiger");
}
break;
default:
break;
}
}
