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

RF module channel number and PAN ID settings capability
-------------------------------------------------------
- One of the options for the DomePro azimuth and shutter modules to communicate with each other involves the use of build-in 802.14.4
	2.4GHz ISM band radios.  Thes are programmed by Astrometric to default values using RF channel 0x0C and a PAN ID XBee address of
	0x3334.
- Using the following ATCL commands, these default values can be changed.  This allows multiple domes within RF range of each other, which
	could otherwise interfere with each other, to be set with different RF credentials:
	- HErc EnterRF_ConfigMode.  Puts DomePro into RF config mode.  Requires the parameter "z~x@c#" (without the quotes).
	- HSrc SetRF_Channel.  Must be in RF config mode.  Uses a hexadecimal parameter to specify the new channel that the RF interface
		should use.  The parameter is a hexadecimal number and can range from 0x0C through 0x18.
	- HGrc GetRF_Channel.  Must be in RF config mode.
	- HSrp SetRF_PAN_ID.  Must be in RF config mode.  Uses a hexadecimal parameter to specify the new XBee PAN ID that the RF
		interface should use.  The parameter can range from 0x0000 through 0xFFFF.
	- HGrp GetRF_PAN_ID.  Must be in RF config mode.
- To change RF credentials carefully follow this sequence...
	1) Determine the channel number and PAN ID to be used.  Consider channel numbers that have wide spacings since RF can spill over
		from channel to channel.  Please refer to the "Azimuth/Shutter RF communications" section in the DomeProU-d Installation
		Manual (Astrometric DOC-41A) for details on how 802.14.4 2.4GHz band radio channels relate to classic 2.4GHz Wifi channels.
	Note: raw ATCL commands are shown below.  These are entered in Maestro from the "Send arbitrary ATCL command" text box in the
		Dome Diagnostics window.
	2) Set credentials for the Azimuth module...
		2A) TURN OFF ANY SHUTTER CONTROLLERS THAT COULD POTENTIALLY BE COMMUNICATING WITH THIS CONTROLLER
		2B) Connect Maestro to the Azimuth module
		2C) Send the HErcz~x@c# command to get the Azimuth module into RF config mode.
			At this point the HGrc and HGrp commands can be used to get the present RF channel and PAN ID values.
		2D) Issue the HSRc command with a parameter specifying the new RF channel to use.  For example, the following changes
			the RF channel to 0x18: HSrc0x18
		2E) Issue the HSRp command with a parameter specifying the new PAN ID to use.  For example, the following changes
			the PAN ID to 0x4321: HSrc0x4321
		2F) Use the HGrc and HGrp commands to verify that the channel and PAN ID have been changed to the new values.
	3) Set credentials for the Shutter module...
		3A) TURN OFF ANY AZIMUTH CONTROLLERS THAT COULD POTENTIALLY BE COMMUNICATING WITH THIS CONTROLLER
		3B-3F) Repeat the steps listed above.  Be sure that the credentials for the Shutter module match the Azimuth modules.

Bug fixes

- Fixed a bug where the ShutterODriveOpen and ShutterODriveClose values for shutter 2 (lower shutter on dome systems) would be used for
	shutter 1 (upper shutter) when the shutter module was communicating with the azimuth module.  This was not a problem when the
	shutter module was directly communicating with Maestro (or another client) as in a clamshell or RoR observatory.