Software Submittal Notice

For
CSView

P/N 68028-1 Rev. E

Software Rev. 7.2
Creation Date: 07/15/2004

Submittal prepared by: Ethan White Date: 07/15/2004

1. CSView Information.................................................................................................................................3
1.1. Minimum system requirements.....................................................................................................3
2. Changes since last submittal.....................................................................................................................3
2.1. Rev. 7.2 Enhancements.................................................................................................................3
2.2. Rev. 7.2 Bug Fixes........................................................................................................................3
2.3. Rev. 7.2 Known Issues..................................................................................................................5
3. Software Regeneration.............................................................................................................................5
3.1. Tools required and tool versions...................................................................................................5
3.2. C language source files.................................................................................................................6
3.3. Include files...................................................................................................................................7
3.4. Regeneration instructions..............................................................................................................8
3.4.1. Edit CSView.............................................................................................................................8
3.4.2. Install CSView..........................................................................................................................8
4. Revision History.......................................................................................................................................8
4.1. Rev. 7.1 Enhancements.................................................................................................................8
4.2. Rev. 7.1 Known Issues..................................................................................................................9
4.3. Rev. 7.0 Enhancements.................................................................................................................9
4.4. Rev. 7.0 Bug Fixes........................................................................................................................9
4.5. Rev. 7.0 Known Issues..................................................................................................................9
4.6. Rev. 1.00 Enhancements...............................................................................................................9
4.7. Rev. 1.00 Bug Fixes....................................................................................................................10
4.8. Rev. 1.00 Known Issues..............................................................................................................10

2 of 10
1. CSView Information
1.1. Minimum system requirements
 266MHz processor
 64 Megabytes of RAM
 Win98/ME or WinNT4/2k/XP
 RS-232 serial port
 Modem OPTIONAL
 Network interface card OPTIONAL

2. Changes since last submittal

CSView v7.2 and UPS View v2.6 are identical.

2.1. Rev. 7.2 Enhancements

 CSView SCR#194 implemented. CSView has the ability to acknowledge packets sent from the
system.
 CSView SCR#209 implemented. CSView now supports multi-color text tile telemetry.
 CSView SCR#218 implemented. A new option was added to the File menu allowing the user to
open the log directory.
 CSView SCR#287 implemented. The time delay between an event and the generation of the
event log files is now programmable via the log file settings.
 CSView SCR#292 implemented. Pressing the <PAUSE> button will cause the CRC errors , as
detected by CSView, to be printed to the screen. Blue messages must be turned on for this.
 CSView SCR#293 implemented. Initial support for the new CS DC, P3 C2 D7, has been added.
This code has been compiled out for the 7.2 release.
 CSView SCR#300 implemented.
 CSView SCR#301 implemented. Initial support for the new SMS/MMS, P3 C2 D5, has been
added. This code has been compiled out for the 7.2 release.
 CSView SCR#304 implemented. Firmware files for Cyclops have been updated to conform to the
new series 1200 name as opposed to the old series 1000 name.

2.2. Rev. 7.2 Bug Fixes

 CSView SCR#195 and SCR#220 fixed. No longer storing state of control and alt keys. CSView
no longer corrupts the keyboard focus.
 CSView SCR#196 fixed. CSView closes TCP and UDP ports properly when the connection is
interrupted.
 CSView SCR#199 fixed. The log in prompt is handled properly by P3 C4 D255.
 CSView SCR#201 fixed. All binary files created by CSView are located in the log directory.
 CSView SCR#204 fixed. CSView will timeout after five minutes of inactivity when waiting for a
program complete message from the system. The programming dialog will display the error, if
it occurs.
 CSView SCR#207 and SCR#215 fixed. Connections made to the user interface of the Series
1200 UPS product line will have a more detailed log file name indicating if the log file contains
summary data or detailed data. Log files also indicate that they originated from the UI
connection.
 CSView SCR#208 and SRC#267 fixed. CSView no longer automatically displays the node id on
the tiles. This must be manually turned on. Once on, it must be manually turned off.
 CSView SCR#211 fixed. The password dialog is supported in P3 C4 D255 support code.
 CSView SCR#212 fixed. CSView can properly read back and compare firmware from an APC2
PWA.

3 of 10
 CSView SCR#214 fixed. The NULL pointer de-reference that caused CSView to crash has been
removed.
 CSView SCR#217 and SCR#290 fixed. CSView uses a state machine to retrieve data from the
system. The frequency of the data requests and the packet retry timeout are based off the baud
rate of the connection. A three second timeout is used at 38400 baud. All other timeouts scale.
 CSView SCR#252 fixed. Error checking return value of GetNodeIndex().
 CSView SCR#268 fixed. Key commands properly parsed and processed.
 CSView SCR#250 fixed. Event and Dump log files can no longer cause a crash on a buffer
overrun error. The overrun condition has been removed and checks have been added to prevent
overruns in the future.
 CSView SCR#269 and UPS300 SCR#364 fixed. CSView will gracefully de-allocate the
operating parameter menu.
 CSView SCR#270 fixed. CSView is not allowed to read-back data from the user interface of the
series 1200 UPS.
 CSView SCR#285 fixed. CSView will display the “processing calibration” dialog when the abort
is pressed.
 CSView SCR#288 fixed. The MMS/SMS user defined messages are displayed properly.
 CSView SCR#296 fixed. The dump and event logs now report the proper time-stamp in each file.
 CSView SCR#298 fixed. The op params menu gets updated properly when toggling between
CSHVs over a UI connection (series 1200 ups).
 CSView SCR#303 fixed. The pager interface code has been updated to conform with the haze AT
command specification.
 UPS300 SCR#405B fixed. CSView generated acknowledge packets no longer interfere with the
program FLASH state machine.
 CSView SCR#306 fixed. CSView will close the modem port properly if a page attempt fails.
 CSView SCR#307 fixed. Fixed errors in system data request state machine.
 CSView SCR#308 fixed. Receiving data out of order will not interfere with system data request
state machine.
 CSView SCR#309 fixed. CSView now uses an editable modem string to configure the modem.
 CSView SCR#310 fixed. Device menu is no longer de-allocated on a UI connection.
 CSView SCR#311 fixed. The modem string is error checked (for 0 byte buffers and NULL
pointers) before being used, and is properly delivered to the communications thread.

 Fixed bug in the P3 C4 D10, P3 C4 D11, and P3 C4 D14 support of the SNMP configuration code.
I had skipped past the two port numbers when filling the packet.
 Fixed a bug where if the system acks back a flash packet with the abort flag set, UPS View will
display the proper message.
 Added the calibrate wait dialog for when waiting for the abort to be processed. This applies to all
PCDs.
 Added error message to SMTP support.
 Fixed a bug in the key stroke handler that would corrupt non-alpha-character ALT keys (i.e ALT-1,
ALT-!, etc...).
 Fixed a bug in the keystroke handler that allows NULL commands to be executed (NULL key-
strokes still work).
 Fixed bug that allowed the ENTER key to be parsed as a CTRL-M. The bug was that my
CtrlDown flag was not being cleared on a consistent basis (i.e. ATL-CTRL would set the flag,
but not clear it when the CTRL key was lifted).
 Fixed a bug that prevented the menu to be reset when the password had expired AND the user had
opened the menu. The result was a menu that would cause CSView to crash if any menu
options were selected. All product support is affected by this fix.
 Fixed a bug that prevented the factory email dialog from opening after the dialog had been closed
once.
 Fixed a bug that allowed the EVENT and DUMP log files to crash UPS View due to an index
exceeding the buffer.

4 of 10
  Fixed a bug where UPS View could continue to request data from the boot monitor when it should
not (i.e. the system name).
 If a ping fails due to admin issues, the user will be notified.
 Fixed bug that would allow the op param dlg to stay open even after the password expired.
 Fixed a bug where an unknown packet type being sent by UPS View would cause UPS View to
never send another packet out.
 Fixed a bug that prevented UPS View from reading back the flash contents IF the readback button
was selected.
 Made an attempt at fixing the odd bug where UPS View can program a cashed version of firmware
from over the network. Basically, I just turned the buffering off from the source firmware file.
 Fixed bug all P2 support, P3 C2 D3 (SMS/MMS) and P3 C2 D6 (CS-2) that would prevent the
user from requesting the User Defined Messages from the system. If blue messages are on, an
unknown packet type error is printed.
 Modified the graphics master interface dialogs to be more consistent with the UI.
 Fixed a bug where the user could load display settings before UPS View had any tiles to display,
causing UPS View to crash.
 Fixed a bug in protocol 3 support that would not display the correct number of calibration defs in
the blue messages.
 Added a blue message to op param, calibrate, and command definition packets to indicate if a zero
def count packet had been received. If a zero count definition is received, UPS View will free
all memory associated with the definition. I.E. if zero op params, then free the op params menu.

2.3. Rev. 7.2 Known Issues

 CSView no longer supports the Windows 95 operating system.
 Administrator access is required on WinNT/2k/XP for network connections to work.
 Write privileges to the CSView install directory are required for log file creation.
 PC paging should be changed, currently only pages once on Alarm/Notice (if enabled).
 The MMU ID on telemetry tiles should probably not be called MMU ID in the menu (except for
specific products). Should rename MMU ID for the other products.
 View will de-allocate the tile definitions on connection even if the tiles have not changed.
 CSView SCR#202 can not be fixed. CSView can get buffer overrun errors when communicating
via serial port. See SCR for details.
 CSView SCR#210 can not be fixed. This is an Internet Explorer issue. See SCR for details.
 The firewall in WinXP SP1, when enabled, will by default block all UDP traffic to CSView. The
fire wall will allow TCP traffic, so tile definitions will be received, but no telemetry data.
 It is very likely that CSView will have problems running on WinXP SP2. The service pack is not
yet released as of July 15, 2004.

3. Software Regeneration
All project and source files are located in the following directory in Visual Source Safe:
$/Software/68019-1_68028-1_View/

3.1. Tools required and tool versions

File Description Revision
MSDEV Microsoft Visual C++ Developer Studio 6.0
Microsoft Platform SDK February 2003

3.2. C language source files

Changed? File Revision
bf_cbc.c 4
bf_ecb.c 4

5 of 10
 bits.c 4
X Comm_app.c 7
X comm_c1.c 7
X comm_flash.c 9
X comm_flash_atmel.c 7
X comm_flash_gui.c 7
X comm_flash_srec.c 6
X comm_flash_util.c 6
X comm_network.c 5
X comm_p2.c 8
X comm_p2_c2_d3.c 4
X comm_p2_c2_d4.c 4
X comm_p3.c 10
X comm_p3_c2_d255.c 5
X comm_p3_c2_d3.c 4
X comm_p3_c2_d4.c 6
X comm_p3_c2_d5.c 1
X comm_p3_c2_d6.c 4
X comm_p3_c2_d7.c 1
X comm_p3_c3_d255.c 5
X comm_p3_c3_d5.c 7
X comm_p3_c4_d10.c 5
X comm_p3_c4_d11.c 4
X comm_p3_c4_d14.c 4
X comm_p3_c4_d255.c 4
X comm_p3_c5_d1.c 4
X comm_p3_c5_d255.c 4
comm_ping.c 5
X comm_proc.c 5
X comm_protocol.c 7
X comm_serial.c 7
comm_smtp.c 5
comm_thread.c 5
comm_timer.c 5
comm_user.c 5
crc.c 4
deflate.c 4
gzip.c 5
inflate.c 4
X Main_app.c 8
X Main_c1.c 9
X main_c1_p1.c 8
X main_c1_p2.c 8
Main_cal.c 8
X main_command.c 7
main_dialog.c 4
X main_file.c 5
main_graphics.c 5
X Main_log.c 6
X main_menu.c 7
main_mouse.c 4
X Main_p2.c 9
X main_p2_c2_d3.c 9
X main_p2_c2_d4.c 9

6 of 10
 X Main_p3.c 10
X main_p3_c2_d255.c 9
X main_p3_c2_d3.c 10
X main_p3_c2_d4.c 10
X main_p3_c2_d5.c 1
X main_p3_c2_d6.c 10
X main_p3_c2_d7.c 1
X main_p3_c3_d255.c 9
X main_p3_c3_d5.c 10
X main_p3_c4.c 8
X main_p3_c4_d10.c 10
X main_p3_c4_d11.c 10
X main_p3_c4_d14.c 10
X main_p3_c4_d255.c 10
X main_p3_c5_d.c 1
X main_p3_c5_d255.c 1
X main_proc.c 6
X main_protocol.c 8
main_reg.c 4
main_sw_options.c 6
X main_thread.c 5
X main_timer.c 7
X main_user.c 5
X main_util.c 7
X telem_graphics.c 5
telem_mouse.c 4
telem_proc.c 4
X telem_update.c 5
telem_user.c 4
X telem_util.c 5
X tlog_graphics.c 5
tlog_proc.c 4
tlog_util.c 5
trees.c 4
unzip.c 4
zip.c 4
zip_util.c 4

3.3. Include files

Changed? File Revision
bf_locl.h 4
blowfish.h 4
X Comm.h 9
crc.h 4
gzip.h 4
X Main.h 7
ping.h 4
X resource.h 7
X View.h 6

7 of 10
3.4. Regeneration instructions

3.4.1. Edit CSView

Check out the View project using Visual Source Safe (\\Stonehollow\eng_vss\). Run Visual C++ 6.0
to open the projects ($/Software/68019-1_68028-1_View/client.dsp) and edit the source
($/Software/68019-1_68028-1_View/).

3.4.2. Install CSView

Run CSView.exe (in DocControl) to install version 7.2 CSView.

4. Revision History
4.1. Rev. 7.1 Enhancements
 Re-designed the structure of CSView into two threads (communications thread and user interface
thread)
 All source files have been renamed and have had their file version reset to 1
 Layered out product support into a protocol engine
 Menu options are specific to the product
 Added APS 250 protocol 1 support (P1 C1 D2)
 Added APS 250 protocol 2 support (P2 C1 D2)
 Added UPS300 protocol 2 support (P2 C2 D3)
 Added CS-2 protocol 2 support (P2 C2 D4)
 Added UPS300 protocol 3 support (P3 C2 D3)
 Added CSHV protocol 3 support (P3 C2 D4)
 Added CS-2 Protocol 3 support (P3 C2 D6)
 Added APC boot monitor protocol 3 support (P3 C2 D255)
 Added UPS1200 protocol 3 support (P3 C3 D5)
 Added APC2 boot monitor protocol 3 support (P3 C3 D255)
 Added UPS1200 via Graphics Master protocol 3 support (P3 C4 D10)
 Added CSHV via Graphics Master protocol 3 support (P3 C4 D11)
 Added System Summary via Graphics Master protocol 3 support (P3 C4 D14)
 Added Graphics Master protocol 3 support (P3 C4 D255)
 Added Software Only Options support to UPS300 protocol 2
 Added Software Only Options support to UPS300 protocol 3
 Added Software Only Options support to CS-2 protocol 3
 Added text color tags to the text log file
 Modified the log file name format: SN-NODE_YEAR-MONTH-DAY_TYPE_NUM.EXT. Valid
TYPE fields include: telem, 3ph, misc, tlog, user-*, dump-*, and event-*
 Default log file extension is CSV (comma separated variable)
 Creating user defined log files has been greatly simplified. Hold the Shift key down and right-
click the tiles of interest (these tiles will highlight in blue). Once all tiles have been selected,
left-click the telemetry window. A menu will pop-up. Select “Add selected tiles to user log
file” to create the user log file. At any time left-clicking the telemetry window and selecting the
“Select all tiles in the user log file” can select the tiles being logged to the user files. Individual
tiles may be removed from the log file in a similar fashion as they are added.
 Event logging on Alarm is enabled by default
 View has a new field in the PC Email Settings called Mail From Address. This is the address from
which the email is to have been sent from (replaces the old from address of mail@bogus.com, or
something like that).
 PC paging on Alarm/Notice will only page once instead of continuously (until the event cleared).
 Operating parameter menu now displays the value of the operating parameter next to the name.
 Op param dialog now has Apply button. This will apply the change to the system without closing
the dialog. Multiple op param dialogs can be open at the same time.

8 of 10
  Greatly improved the modem support. Any Hayes AT Command compatible modem should work
with CSView for modem connections and paging capability.
 Debug messages (blue text in the text log) is accessible by pressing shift+insert (communications
related debug messages) and/or shift+delete (view related debug messages).

4.2. Rev. 7.1 Known Issues

 CSView no longer supports the Windows 95 operating system.
 Administrator access is required on WinNT/2k/XP for network connections to work.
 PC paging should be changed, currently only pages once on Alarm/Notice (if enabled).
 The MMU ID on telemetry tiles should probably not be called MMU ID in the menu (except for
specific products). Should rename MMU ID for the other products.
 View should remember if the MMU ID has been turned off/on and not toggle if the connection (to
the same system) is toggled.
 View will de-allocate the tile definitions on connection even if the tiles have not changed

4.3. Rev. 7.0 Enhancements

 Changed application name to CSView.
 Changed current version to 7.0
 Changed logo in About Box
 Reorganized the menu by splitting the PC settings away from the UPS/CS-2 settings.
 Removed some menu options when the connection is closed.
 Standardized the system configuration dialog boxes.
 Added SMTP support for PC-side remote notification
 Added code that allows View to read the registry for a list of serial ports available on the
computer.
 Added code to check for locked mutex and code to attempt to free them (on user command, for
debugging only).
 Stopped storing any UPS or CS-2 configuration settings in the Client.ini file.
 On FLASH update, only send heartbeat if the connection is serial or modem.
 Moved the code that logged text strings to disk from process_packet() to newtlogline(). This
allows me to log BLUE messages to disk (if enabled).

4.4. Rev. 7.0 Bug Fixes

 Fixed bug that allowed the user to change the connection settings when View was pinging a
network connection.
 Fixed multi-display with multi-resolution bug.

4.5. Rev. 7.0 Known Issues

 Enabling software only options is not supported.
 When enabled to page, CSView will page continuously until the alarm/notice is cleared.

4.6. Rev. 1.00 Enhancements

 Initial Release.
 Added auto-flush feature to force log files to disk.
 Added CRC error counter (Shift + End). Requires Eng.ini.
 Added support for CS2 (system ID 4).
 Added support for the MPC555 internal FLASH.
 Added a FLASH target filter. This will limit the targets the View software will display depending
on the “system ID” of the system View is connected to. Can be disabled in the Client.ini file.
 Added support for the F10 key.

9 of 10
  Changed the Calibration dialog. The Cancel button has been replaced with an Abort button. Abort
will send the abort request to the system. The ‘x’ box in the upper right hand corner will close
the dialog without sending the abort request.

4.7. Rev. 1.00 Bug Fixes

 Fixed the last connections menu bug when displaying a dial-out number with a comma in it.
 Fixed modem detection bug.
 Removed RAW sockets from WinNT to prevent requiring administration rights for network
connections.
 Performing a full read-back after programming a FLASH memory is no longer default.
 Fixed a bug in the UDP code that prevented the UDP task from logging telemetry data.
 Improved the command line parsing to allow the executable to have any name.
 Improved the FLASH programming and retrying.
 Improved the FLASH read-back by increasing the timeout and increasing the number of retries.
 Fixed the node ID bug in the log files. Detailed connections would always record ID ‘1.’

4.8. Rev. 1.00 Known Issues

 Enabling software only options is not supported for the CS2 as of v1.00.

10 of 10