Docklight V1.7
Copyright 2007 Flachmann und Heggelbacher (www.fuh-edv.de)

Program Description:
Docklight is a test, analysis and simulation tool for serial communication 
protocols (RS232, RS485/422 and others). It allows you to monitor the 
communication between two serial devices or to test the serial communication
of a single device. Docklight is easy to use and runs on almost any standard 
PC using Windows Vista, Windows XP, Windows 2000, Windows NT or Windows 98 
operating system.
Docklight Scripting provides an easy-to-use program language and a built-in 
editor to create and run automated test jobs. Docklight Scripting is network-
enabled and allows TCP or UDP connections.

Installation:
- Execute the "setup.exe" application. 

Distribution:
- See the "fuh_distribute_int.txt" file

Version History:

Docklight / Docklight Scripting V1.7.33 (04/2007)
New features and functions: 
- Networking: Docklight Scripting can act as TCP client, TCP server or UDP peer
- new FileInput / FileOutput objects for easy and straightforward file I/O
- new DL.CalcChecksum() method for calculating CRCs of any type
- new DL.SetChannelSettings() / DL.GetChannelSettings() methods for changing
  the communication port and settings (baud rate, ...) while running a script.
- new DL.Quit() command to stop script execution
- new DL.GetDocklightTimeStamp() method to return a Docklight-style time stamp

Fixes and Improvements:
- COM1 to COM256 can be selected.
- Project Settings dialog shows available COM ports in dropdown list.
- Timing acurracy in monitoring mode improved.
- Improved transmit and receive buffering, less COM buffer overflows
  on high-speed connections.
- Monitoring mode additionally transmits the received data on the 
  opposite communication port (data forwarding).
- Communications display now buffers up to 128.000 characters.
- "RS485 Transceiver Control" now uses Windows RTS_CONTROL_TOGGLE mode with
  improved timing (Windows NT/2000/XP/Vista only)
- Parity Error Character: "(ignore)" for reading characters with wrong parity bit
- The "Edit Send/Receive Sequence" dialogs show the current cursor position 
  and support cursor keys (Page Up/Down, Cursor Up/Down, Home/End).
- Minimum time for "Send Sequence periodically" now 0.01 sec (before: 0.1 sec)
- Additional operations on sequence lists: Import from a project file, 
  swap receive and send sequence lists.
- Improved behavior for large sequence lists (> 100 sequences).
- Fixed rare crash in Sequence Editor after copying & pasting a sequence 
  using Ctrl+C and Ctrl+V.
- DL.UploadFile() supports raw binary data tranfer mode ("R").
- DL.UploadFile(), DL.StartLogging(), DL.OpenProject() show a file dialog 
  if an empty file path argument is passed.
- DL.StartLogging() closes a previously opened log file automatically, 
  instead of returning an error.
- DL.AddComment with additional formatting options.
- DL.ResetReceiveCounter now additionally resets the Receive Sequence detection
  algorithm, allowing easier resynch in complex protocols.
- Additional "!" function character arguments for temporarily changing the parity 
  settings within one Send Sequence. 
- Receive Sequence supports "&" Delay function character to detect pauses.
- DL.StartLogging uses current script directory by default (same behavior as
  DL.OpenProject or DL.UploadFile).
  
Docklight V1.6.23 / Docklight Scripting V1.6.23 (01/2007)
Fixes and Improvements:
- HTML help instead of Winhelp to prepare Docklight for Windows Vista
- Window size correctly remembered after closing Docklight, even when maximized.
- Font sizes < 10 now allowed (with additional warning) 
- Control characters except CR/LF can be completely suppressed in ASCII display
10:16 02.04.2007- Baud rates up to 9.999.999 Baud can be entered (NOTE: This does not mean
  Docklight can really process any kind of data at that speed.) 
- Fixed bug: A "CR only" produces an additional line break in HEX, Decimal and 
  Binary display
- Fixed bug: The keyboard console tool always sets the RTS line to high when 
  typing characters
- Fixed bug: The DCD line status is not displayed
- Fixed bug in Docklight Scripting: 
  UploadFile() does not send data if the script contains a DL_OnSend() procedure
- Fixed bug in Docklight Scripting: 
  RS485 Tranceiver Control does not reset RTS while a script is executed
- Fixed bug in Docklight Scripting: 
  BREAK state introduces additional spaces in HEX, Decimal and Binary display

Docklight V1.6.8 / Docklight Scripting V1.6.8 (04/2005)
Fixes and Improvements:
- Flow control setting "RS485 Transceiver Control" is now correctly applied for
  the Keyboard Console tool.
- F12 key brings up the notepad window, even if minimized

Docklight V1.6.7 / Docklight Scripting V1.6.7 (03/2005)
New features and functions: 
- "Communication Filter" to hide the original serial data of one or both 
  communication channels
- Notepad (F12 key) for project documentation
- "Drag and Drop" support for project files and scripts
- Docklight Scripting: new method "UploadFile" for file transfer
- Docklight Scripting: new special function characters in Send or 
  Receive Sequences (set/reset handshake signals, add delay between characters, 
  send or detect a "break" state)
Fixes and Improvements:
- Keyboard Shortcuts for ASCII code > 126
- DEL key for Send/Receive Sequence lists
- Docklight Scripting: Increased maximum script size (510KB instead of 64KB)
- Inreased Docklight send/receive queue size to allow character-by-character 
  processing using DL_OnReceive()
- Extended documentation and sample scripts to demonstrate Docklight Scripting's 
  data analysis and manipulation capabilities.
- Fixed bug: Docklight crashes when a USB-to-RS232 device is removed while 
  communication is running. 
- Fixed problem: When using Option "Flow Control: RS485 transceiver control",
  the RTS line is reset too early, especially when the standard 16 byte fifo 
  transmit buffer of the UART is enabled.
- Fixed bug: Missing characters in ASCII window / Formatted Text Output mode,
  when characters are received one-by-one and a single <CR> is used for end-of-line

Docklight Scripting V1.5.2 (09/2004)
New features and functions:
- Extended syntax for the DL.SendSequence command to allow hex, decimal or binary
  Send Sequence parameters or sending custom data sequences.
- DL_OnSend() function to support automatic checksum calculations
- DL_OnReceive() function to support automatic evaluation of the received data,
  including analysing the received wildcard data
Fixes:
- Fixed bug: The DL.OpenProject command did not close the communication

Docklight V1.4.14 / Docklight Scripting V1.4.14  (06/2004)
Fixes:
- Fixed bug: Missing line breaks on Windows 98
- Fixed bug: "Clear Communication Window" does not delete the entire contents of
  all four commmunications window representations (ASCII/HEX/Decimal/Binary)

Docklight V1.4.12 / Docklight Scripting V1.4.12  (05/2004)
New features and functions:
- New Docklight edition "Scripting" with built-in script editor for automated testing.
  Available as an upgrade for Docklight standard users. 
Fixes & Improvements:
- Non-standard baud rates can be used: Type any integer number between 110 and 999999
  in the corresponding dialog box. If the chosen rate is actually applied, depends on 
  the serial UART you are using. Non-standard baud rates may not work correctly when 
  "Flow Control" options are used.
- New Mode "Flow Control: Hardware Handshaking - RTS/CTS (Single Byte Mode):
  A sequence is placed byte-by-byte into the transmit buffer and CTS is checked before 
  each new character.
- New mode "Flow Control: RTS high while sending". This is to support RS485
  converters and related applications where the transceiver requires the PCs RTS signal
  to enable/disable the transmission.
- Improved communication processing and timing accuracy, which makes the "TweakComm" 
  utility provided to some users obsolete.
- ASCII Communication Window: Uniform behavior for different end-of-line standards:
  CR only, CR+LF, LF+CR

V1.3.38 (01/2004)
Fixes:
- Fixed bug: receive sequence detection ignores incoming sequence, 
  if immediately before the sequence a few characters have already been 
  considered as a part of this sequence.   
  See http://www.docklight.de/troubleshooting_en.htm for details.
- Fixed bug: edit sequence dialog crashes when marking a sequence, then 
  moving to the empty sequence at the end of the list (Index ">" button) and
  pasting into the empty sequence.
- Fixed bug: crash when trying to paste a very large document (> 32K) from clipboard.

V1.3 (11/2003)
New features and functions:
- Powerful clipboard support within the sequence lists and the sequence 
  editor: cut, copy & paste entire sequences or parts of it. Copy & paste 
  sequence data from external applications (MS Word, Notepad).
- Wildcard support for send sequences, receive sequences and find function
- New receive sequence actions: insert time stamp, stop communication
- New time stamp options: pause detection, e.g. for RS485 monitoring.
- Keyboard console: keyboard input is directly sent to the COM port.
- New Project settings: optional flow control support, 
  manual RTS/DTR control, hardware handshaking, 
  software handshaking (XON/XOFF).
Fixes & Improvements:
- Fixed bug when printing on HP Laserjet 5M
- Improved sequence list management (reordering, keyboard support)
- Improved find function (ignores date/time stamps and additional comments
  in HEX, decimal and binary mode) 
   
V1.2 (02/2003)
New features and functions:
- Improved performance, especially when monitoring transmissions 
  with a high amount of data
- Time stamps with 1/100s precision
- New display options to further increase processing speed
- New snapshot function to catch a very rare sequence within the protocol data
  plus the preceding and trailing communication
- New demo project and additional documentation for getting started
Fixes:
- Now works on any Windows language edition, especially Asian editions or 
  others using DBCS (double byte character set) 
- Fixed bug when using sequence names which include a comma (",")

V1.1 (09/2002)
New features and functions:
- Creating log files in HTML format
- Communication settings are now stored as project data
- Improved parity error handling
- Disabling the communication window while logging possible (e.g. while 
  monitoring high-speed communication) 
- Revised and streamlined user interface
Fixes:
- 4800 Baud now available in the communication settings dialog

V1.0 (04/2002)
First release