Note: when upgrading from older firmware versions to v.40 (or later) BE SURE to upgrade both the azimuth and shutter modules since starting with v.40 there is a new module-to-module communications scheme

This document provides instructions on upgrading DomePro firmware and provides release notes on the associated firmware version.

The minimum Maestro4 version which works with this version of DomePro firmware is 0.09.008. Assure that Maestro4 is upgraded to at least this version before upgrading DomePro firmware.

Installation instructions

1. Assure that the DomePro controller is attached via USB to the Windows PC.
2. Using the Device Manager on the Windows PC, determine the COM port number for the DomePro controller connection.
3. Run the DomePro_N.exe file. 'N' is the firmware version number.
4. The "Astrometric Firmware Upgrader" will run. Follow the steps in the user interface. Step #1 will be pre-completed for you. Step #2 is to select the COM port number for the attached controller and click "Connect". Finally, step #3 is to click "Upgrade Firmware". The upgrade will commence and status on progress will be provided.
   Note: DomeProU and DomePro2 products shipped prior to 1-Apr-2022 cannot be upgraded with the "Astrometric Firmware Upgrader" HOWEVER, contact us and we will assist in conveniently upgrading your firmware.
5. Upgrade the other controller (e.g. shutter) if this is a classic dome system.
6. Power-cycle DomePro and it should now boot into using the new firmware and connect to Maestro.

================================= This file best viewed with fixed-font at this screen width or greater ===================================

New this version

Features

Support for ATCL Command Collections
------------------------------------
DomePro now provides faster status polling using ATCL "Command Collections".  These use the new SendCommandCollection (HScc) ATCL command that accepts between one
and four ATCL commands in a "collection" with the responses to each bundled in one reply.

The SendCommandCollection format is: HSccXXxx|XXxx|XXxx|XXxx where:
	- Each XXxx is one of the ATCL commands in the collection.  Any violation of this format will result in the SendCommandCollection command replying with NACK.
	- Normally, the SendCommandCollection replies with: ppp|ppppp|pp|pppp;   Where...
		- Each command's reply is pp*
		- These replies will be one of...
			- Text reply to a get command
			- An ATCL_ACK represented with the character faux code 0x06 (to distinguish it from a normal 0x8F ATCL_ACK)
			- An ATCL_NACK represented with the character faux code 0x15 (to distinguish it from a normal 0xA5 ATCL_ACK)
		- The last character is the ATCL_END character (semicolon)
	- For example, here is the SendCommandCollection command to get DomeFW_Version, SerialNumber, DomeAzCPR and DomeAzPosition...
			!HScc|DGfv|HGsn|DGcp|DGap;
		Which will result in a reply like this...
			0x002B|0x01FA|0x00002710|0x00001A00;

Bug fixes

None