Note: It is recommended that both the azimuth and shutter module's firmware is upgraded.
This document provides instructions on upgrading DomePro firmware and provides release notes on the associated firmware version.
The recommended minimum Maestro4 version to use with this version of DomePro firmware is 0.09.016. We recommend that Maestro4 is upgraded to at least this version before upgrading DomePro firmware.
================================= This file best viewed with fixed-font at this screen width or greater ===================================
Features Expanded support for IsoIn input signals ---------------------------------------- The following commands set which function is assigned to the IsoIn inputs: SetDomeIsoInAssignment DSin <-- new v.44 GetDomeIsoInAssignment DGin <-- new v.44 SetShutterIsoInAssignment DSiy <-- new v.44 GetShutterIsoInAssignment DGiy <-- new v.44 The following functions can be assigned to the IsoIn inputs: - "None" - "ShutdownAux" Sets up IsoIn as an auxiliary (second) Shutdown input. - "InhibitShutter1" When IsoIn is asserted, shutter 1 motion is inhibited. Note: only available on a shutter or clamshell/RoR module. - "InhibitShutter2" When IsoIn is asserted, shutter 2 motion is inhibited. Note: only available on a shutter or clamshell/RoR module. - "InhibitShutters" When IsoIn is asserted, all shutter motion is inhibited. The following commands report the state of the IsoIn inputs regardless of the function assigned: GetDomeIsoIn DGii <-- in v.43 however v.44 fixed a bug where the state read was incorrect polarity. Correct is "Yes" means the input is asserted. GetShutterIsoIn DGij <-- new v.44 Expanded support for IsoOut output signals ------------------------------------------ - The following commands set which function is assigned to the IsoOut outputs: SetDomeIsoOutAssignment DSix <-- in v.43 GetDomeIsoOutAssignment DGix <-- in v.43 SetShutterIsoOutAssignment DSiu <-- new v.44 GetShutterIsoOutAssignment DGiu <-- new v.44 - The following functions can be assigned to the IsoOut outputs: - "None" - "Flag" - "IsClosed" - "IsOpened" - "IsHomed" Note: only available on azimuth modules. - "IsParked" Note: only available on azimuth modules. - "Brake1" Shutter1 brake. Only available on a shutter or clamshell/RoR module. - "Brake2" Shutter2 brake. Only available on a shutter or clamshell/RoR module. - The following commands are used with the "Flag" assignment for IsoOut: SetDomeFlagOut DSfo <-- in v.43 GetDomeFlagOut DGfo <--- new v.44 SetShutterFlagOut DSfu <--- new v.44 GetShutterFlagOut DGfu <--- new v.44 Expanded support for Shutdown and PowerGood inputs -------------------------------------------------- - For DomeProU systems, the shutter module's Shutdown and PowerGood inputs are now relayed to the azimuth module. These now work in parallel with the azimuth module functions. Note: Shutter features only work when the shutter module is connected to the azimuth module. This is because the azimuth module must enforce the "auto close disable" feature. - The following ATCL command has been modified to support the power good input on the shutter module in classic dome systems... GetDomePowerGoodState DGpi FLAG Returns DomePro's PowerGood state: "No" if any power good input, which is enabled, is de-asserted and "Yes" otherwise. For classic dome systems there is a power good input on both the azimuth and the shutter modules. Note: this command was named GetDomePowerGoodInputState in v.43 - Note: Power good inputs can be enabled/disabled with the Set*PowerGoodInputEnabled commands. - The following commands were added in support of the shutter controller's power-good inputs... GetShutterPowerGoodInputRaw DGpp FLAG Indicates the state of the power good input on the DomeProU-d shutter controller. SetShutterPowerGoodInputEnabled DSpy FLAG Enables Power Good checking (and shutter closure on absence of Power Good) from DomePro's shutter module PowerGood input. GetShutterPowerGoodInputEnabled DGpy FLAG - The following ATCL command has been modified to support the shutdown input on the shutter module in classic dome systems... GetDomeShutdownState DGsi FLAG Returns DomePro's Shutdown input state: "Yes" if any shutdown input is active and "No" otherwise. For classic dome systems, there is a shutdown input on both the azimuth and the shutter modules, either of which, when asserted, will result in this command returning "Yes". Furthermore, when the IsoIn is assigned to "ShutdownAux", and it is asserted; this command will return "Yes". Note: this command was named GetDomeShutdownInputState in v.43 - The following commands were added to get the state of the controller's physical shutdown inputs... The following new ATCL commands are provided for the base controller: GetDomeShutdownInputRaw DGsr FLAG Indicates the state of the shutdown input on the DomeProU-d base controller. GetDomeShutdownAuxInputRaw DGsu FLAG Indicates the state of the IsoIn input, on the DomeProU-d base controller, when it is assigned to the "ShutdownAux" function. The following new ATCL commands are provided for the shutter controller: GetShutterShutdownInputRaw DGsh FLAG Indicates the state of the shutdown input on the DomeProU-d shutter controller. GetShutterShutdownAuxInputRaw DGsv FLAG Indicates the state of the IsoIn input, on the DomeProU-d shutter controller, when it is assigned to the "ShutdownAux" function. - Added the following ATCL command to combine several status flags into one ATCL command: GetDomeStatusFlags DGsf HEX Returns 32-bit HEX value with the following bit field definitions... Bit 0: ShutdownState Bit 1: ShutdownInputRaw Bit 2: ShutdownAuxInputRaw Bit 3: ShutterShutdownInputRaw Bit 4: ShutterShutdownAuxInputRaw Bit 5: PowerGoodState Bit 6: PowerGoodInputRaw Bit 7: ShutterPowerGoodInputRaw Bit 8: PowerDownDetected Bit 9: ShuttersInhibit Bit 10: Shutter1_Inhibit Bit 11: Shutter2_Inhibit Bit 12: IsoInInput Bit 13: ShutterIsoInInput Bit 14: Azimuth motor #1 fault (for DriveType "StepDir") Bit 15: Azimuth motor #2 fault (for DriveType "StepDir") Bit 16: Shutter1 motor is running Bit 17: Shutter2 motor is running This command can be used instead of the following individual commands GetDomeShutdownState DGsi <-- Was GetDomeShutdownInputState. Renamed in v.44 GetDomeShutdownInputRaw DGsr <-- new v.44 GetDomeShutdownAuxInputRaw DGsu <-- new v.44 GetShutterShutdownInputRaw DGsh <-- new v.44 GetShutterShutdownAuxInputRaw DGsv <-- new v.44 GetDomePowerGoodState DGpi <-- Was GetDomePowerGoodInputState. Renamed in v.44 GetDomePowerGoodInputRaw DGpx <-- Was GetDomePowerGoodInputStateRaw. Renamed in v.44 GetShutterPowerGoodInputRaw DGpp <-- new v.44 GetDomePowerDownDetected DGpd <-- in v.43 GetDomeShuttersInhibit DGsb <-- new v.44 GetDomeShutter1_Inhibit DGs1 <-- new v.44 GetDomeShutter2_Inhibit DGs2 <-- new v.44 GetDomeIsoIn DGii <-- in v.43 GetShutterIsoIn DGij <-- new v.44 - Retired the following older (DomePro2) commands since their functionality is now replaced by the ShuttersInhibit IsoIn function: SetDomeShutterEnableEnabled DSse GetDomeShutterEnableEnabled DGse GetDomeShutterEnableInputState DGsa - The GetDomeShutterStatus (DGsx) will now return 0x1E if the azimuth module detects that the shutter module has a firmware version mismatch. Improvements to the Azimuth CPR "gauging" feature ------------------------------------------------- - Concerning the values returned by the following two commands: - "DGgr", // GetDomeAzGaugedRight - "DGgl", // GetDomeAzGaugedLeft Previously, the above two commands did not update until gauging was complete. New behavior is that prior to the first pass by the Home Index these values are zero. After the Home Index is first found, and gauging has thus begun, these values increment (as an indicator of progress) until the Home Index is found a second time signaling the end of gauging. Misc ---- - The status LED's brightness can now be changed using the following ATCL command... - DSlb SetLED_Brightness 0x0 (off) through 0x8 (brightest). Note: the default power-on value is 0x04. If a shutter module is attached then this setting propagates up to the shutter module over the RF link. - For supply voltage measurement, added compensation for fixed voltage drop "offset". The supply voltage now reported by Maestro is more accurate and, generally, about 0.33V above the reading provided with previous firmware versions. - On the physical display for DomeProU's azimuth module, the PowerGood indication on the Diagnostics page now indicates the combination of azimuth and shutter PowerGood inputs rather than just azimuth in previous firmware versions. Note: this will always indicate "No" unless one or both of the PowerGood inputs is enabled. - The following commands have been renamed (ATCL mnemonics remain unchanged): DomeSetE-ParkEnabled DSee --> SetDomeE-ParkEnabled DomeGetE-ParkEnabled DGee --> GetDomeE-ParkEnabled DomeStartE-ParkSequence DSek --> StartDomeE-ParkSequence DomeStartE-UnParkSequence DSeu --> StartDomeE-UnParkSequence DomeGetE-ParkStatus DGet --> GetDomeE-ParkStatus DomeGetE-ParkComError DGex --> GetDomeE-ParkComError - The following are not longer able to be set for Clamshell or RoR systems: - "Close on shutter module power-fail" using the DSpy: SetShutterPowerGoodInputEnabled ATCL command - "Close on radio link timeout" using the DSts: SetDomeShutCloseLinkTimeOutEnabled ATCL command Bug fixes - Fixed a bug where the low-power shutter limit switch sampling would not work. This feature is enabled with the SetLimitLowPowerSampling (DSlp) ATCL command. - Fixed a bug for the StepDir Drive Type where after a motor fault occurs if the motor is re-enabled too quickly then there was decelerating motion issued out of DomeProU that caused the motor to move until the motion finished decelerating.Contact Astrometric support with any questions or issues.