Release Notes PN 93000950 Digi Connect Programmer Version 1.6.25.0 04/08/2009 Software PN 40002363 Rev. E CONTENTS 1. Introduction 2. Supported Products 3. Supported Operating Systems 4. Enhancements 5. Bug Fixes 6. Known Limitations 7. System Requirements 8. Release History 1. INTRODUCTION This application is intended for use in a manufacturing environment, in which a Digi Connect (which could be embedded into another product) has to be configured with a customer specific firmware, files, configuration settings and/or factory defaults. Type connectprog /? for information on how to use Digi Connect Programmer. 2. SUPPORTED PRODUCTS Digi Connect Family 3. SUPPORTED OPERATING SYSTEMS Microsoft Windows 2000 Microsoft Windows XP Microsoft Windows Server 2003 Microsoft Windows Vista 4. ENHANCEMENTS o Added new commands: /backup saves the device configuration to a file (config.rci). /querystate saves the device state to a file (state.rci). /info displays current firmware version and memory usage of the device. o Added support for Python file uploads: /upload /python= o Added support for for secure (HTTPS/SSL) connections: /secure o Defer when uploaded configuration settings take effect until the next reboot. Requires that the firmware support the RCI "deferred" set_setting action - firmware version 2.6.5 or higher. o Logfile is only created when "/logging" is specified on the command line. 5. BUG FIXES o Set the HTTP timeout values to known minimum values. This fixes a timeout waiting for the device's response after a configuration file upload. o When /discover found no devices, no errorlevel was returned on exit. o If /destip is provided, allow file uploads even when ADDP can't discover the destination device. 6. KNOWN LIMITATIONS The application uses multicast to communicate with devices. Anything that interferes with multicast will make the application inoperable. Examples of known conflicts: - Having a firewall between (or on) your PC and the target device - Having a router or other network hardware between your PC and the target device when the network hardware does not support multicast. - Running over a VPN or dial up connection that does not support multicast. o There is a known issue with the Connect VPN device -- When the mobile connection is active, changing the IP address without setting the gateway may fail with the following error: "ERROR: Failed to assign IP address to device: Unable to save value" The work-around is set the gateway address as well as the IP address. o Support for CPCONF devices has been removed. Attempting to run this application with CPCONF devices will likely fail ungracefully. 7. SYSTEM REQUIREMENTS You might need to apply a Service Pack or install a newer version of Internet Explorer if you are planning to run this application on older Microsoft operating systems. 8. ERROR CODES On exit, Connect Programmer returns the following error codes: Value Meaning ----- ------------------------------------------------------------- 0 Success 1 Error: File not found 2 Error: Device not found 3 Error: IP address not changed 4 Error: Couldn't connect to the destination device 5 Error: Couldn't write to the log file 6 Error: Memory couldn't be allocated for the request 7 Error: File not uploaded 8 Error: File not deleted 9 Error: Firmware update failed 10 Error: Can't reboot the device 11 Error: Invalid command request 12 Error: Query command failed 13 Error: Couldn't create the output file 14 Error: Couldn't write the output file 15 Error: Backup command failed 16 Error: Timeout waiting for a response 17 Error: Capability not supported by the destination device 18 Error: Invalid configuration file. 9. HISTORY Version 1.6.25.0, 04/08/2009 (Rev E) -------------------------------------------- o Added /secure option to allow HTTPS/SSL connections to the device. o Added /backup command to save the configuration to a file. (backup.rci) o Added /info command to display device information (Firmware version, memory usage, etc.) The output is the equivalent of the CLI's "info device" command. o Added /querystate command to save the device state to a file (state.rci). o Added support for Python file uploads. Requires that the device firmware version be 2.6.3.2 or higher. o Defer when uploaded configuration settings take effect until the next reboot. Requires that the firmware support the RCI "deferred" set_setting action - firmware version 2.6.5 or higher. o Set the HTTP timeout values to known minimum values. This fixes a timeout waiting for the device's response after a configuration file upload. o When /discover found no devices, no errorlevel was returned on exit. o If /destip is provided, allow file uploads even when ADDP can't discover the destination device. o Logfile is only created when "/logging" is specified on the command line. Version 1.3.19.0, 09/27/2005 (Rev D) -------------------------------------------- o Changed the name to connectprog.exe. The former name was dgdcprog.exe. o A mac address is no longer a required parameter. Either /mac or /destip can be used to specify the target device. o Added the /upload command for all file upload types. o Implemented /custom option to allow uploading of customization files. o Implemented /erasecustom to delete customization files. o Remove vertical lines in /discover output, to allow easier scripting. o Allow /gateway=0.0.0.0 as a valid setting. o Fix uploads of large configuration files. o Fix /mac=auto looping forever when the /pause flag isn't set. Now the the first device found will be updated, then the program will exit. o Improve the error reporting. Version 1.2.15.0, 07/29/2004 (Rev C) -------------------------------------------- o Implemented new rci_lib with CPCONF removed. o Fixed /dir o Attempting to upload files with filenames > 64 chars will give an error. o Using a parameter that does not exist will return an error. o /reboot was printing SUCCESS twice. o /firmware would not work if user/passwd were needed. Version 1.1.13.0, 06/25/2004 -------------------------------------------- o Improved the usage message and added full examples o Improved error reporting o Fixed /erasefs o Fixed a missing line feed after a status message o Removed support for CPCONF devices. Version 1.1.9.0, 04/21/2004 (Interim) -------------------------------------------- o Added functionality to configure CPCONF devices. o Fix for uploading large configuration files to CPCONF devices o Fix for /mac=auto option o Fix for /erasefs option o Program exits after attempting to determine configuration type if incorrect username or password is supplied Version 1.0.4.0, 09/25/2003 (Rev. A) -------------------------------------------- o Initial release.