Docklight / Docklight Scripting V2.2.8
Copyright 2016 Flachmann und Heggelbacher GbR (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 10, Windows 8, Windows 7 or Windows XP operating system.
Docklight Scripting provides an easy-to-use program language and a built-in
editor to create and run automated test jobs. In addition to COM ports (RS232, ...),
Docklight Scripting supports TCP, UDP, USB HID or Named Pipes.
Installation:
- Run DocklightSetup.exe (resp. DocklightScriptingSetup.exe)
Distribution:
- See the fuh_distribute_support_int.txt" file
Version History:
Docklight / Docklight Scripting V2.2.8 (11/2016)
Fixes and Improvements:
- Windows visual style and high DPI awareness. (No "blurry fonts" with display
text size 125% or higher.)
Docklight / Docklight Scripting V2.2.4 (07/2016)
New features and functions:
- Scripting: "_auto.pts" script convention for automatic script loading & execution along with the
project file.
- Scripting: Extended USBHID channnel options for variable Output Report IDs and size.
- Send and Receive Sequence List have now a small lock to protect against accidental
sequence list reordering.
- Special educational and promotional license key scheme combining a license key and the
license holder's name.
- License registration dialog now allows deleting/uninstalling the license.
Fixes and Improvements:
- Scripting: USB HID compatibility in Windows 10 fixed. USB HID is now "Shared Access".
- Scripting: USB HID now correctly indicates when a TX / write output report did not succeed.
- Mouse wheel support in sequence lists.
- Keyboard Console now supports ESC key to send ASCII code 27 (Escape).
- Improved Checksum spec parser and added example for common LRC. "-MOD256" specifier
for "data + checksum = 0" style checksum.
- Fixed bug: On some serial devices with more than 4K serial buffers and high data load,
Docklight could crash with "Internal error 1000 in module
MdCommunication.printAndLogIntCommData Internal comm. processing error".
- Fixed bug: When using a certain sequence of opening, closing and re-opening the
Control Character Shortcuts dialog, Docklight could crash.
- Fixed bug: RTS line corrected for Flow Control "RS485 Transceiver Control"
and "Hardware Handshaking".
- Fixed bug: Keyboard Console line break behavior, now CR/LF (or CR only or LF only)
is always added correctly.
Docklight / Docklight Scripting V2.1.10 (09/2015)
Note:
- New V2.1 project file format for checksum support.
Projects without checksums are stored in the V2.0 format for compatibility.
Fixes and Improvements:
- Faster RTF (colored text) formatting, especially with text that contains a lot of color changes.
- More readable and more up-to-date fonts and layout.
- Improved display overload handling, e.g. when RTF formatting still takes too long. Docklight does
not freeze, but switch to Plain Text Mode automatically and indicate a warning.
- Improved COM port enumeration in the Project Settings dialog:
Should find some rare device types that were previously omitted. Uses now SetupAPI, plus additional
registry readout from HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM.
- Added Receive Sequence comment macros: %_N for Sequence Name, %_I for Sequence Index,
%_X for data direction.
- Adjusted standard baud rate list, includes now 230400 baud.
- Fixed bug: For "RS485 Transceiver Control - Set RTS high while sending", XON/XOFF was enabled, too.
- Fixed bug: Tap Pro time drift correction with Windows Time / fixed "jump to earlier time"
- Fixed bug: Tap Pro baud rates 230.4K and higher, ParityReplacementChar = 0 (ignore)
- Fixed bug: Bitwise comparison operator ('^') would not work after '#' wildcard section.
- Fixed RTS/DTR, XON/XOFF inconsistencies: No temporary RTS/DTR glitches when switching baud rates
or opening port. Corrected XON/XOFF when project setting and not script controlled.
- Ctrl+W (Clear Communications) works now regardless of focus
- Fixed bug: "Repeat Send" button state wrong after switching representation
- Fixed bug: Sequence lists: Delete a row, then use up/down keys - wrong line was marked
- Fixed bug: Rare crash when using Find for Communication Window
- Scripting: Changed name and extended DL.GetEnvironment() function. Added Docklight-specific keywords
for reading Docklight project and version data.
- Scripting: Active Keyboard Console now blocks/disables script editor text box.
- Scripting: Fixed crash when starting with command line option "-r", then closing with Alt+F4.
- Scripting: Fixed #include bug: "Script preprocessor error: Duplicate Include for same file" appeared,
even for unique include paths.
- Scripting: Fixed long script loading times for large scripts (> 100KB).
- Scripting: ConvertSequenceData - new "fromText" argument to convert plain text
to a HEX/Dec/Binary sequence string
New features and functions:
- Checksum calculation (CRC and others) for Send and Receive sequences.
- 'Standard' Docklight now includes Function Characters support (Handshake Monitoring & Control)
- 'Standard' Docklight now includes Docklight Tap Pro / 485 support
- Channel Alias setting for custom data direction labels
- Scripting: New DL.GetReceiveComments() method - chronological list of all receive sequence comments.
- Scripting: New GetCommWindowData() method - evaluate the original comm.window output in your script
- Scripting: USB HID and Named Pipes support
- Scripting: "PROXY:<tcpPort>" - TCP Server that forwards the client's connect/disconnect behavior
- Scripting: DL.InputBox2 for a InputBox that appears on the same screen as the Docklight window
- Scripting: FileInput/FileOutput additions: .Dialog(...), .FileExists(...)
See the \ScriptSamples\Extras\FileDialog_Example folder for an example.
Docklight / Docklight Scripting V2.0.5 (02/2013)
New features and functions:
- New script command "DL.SetHandshakeSignals rts As Boolean, dtr As Boolean", e.g.
DL.SetHandshakeSignals true, false
Fixes and Improvements:
- Improved COM port enumeration for the Project Settings dialog. Fixed freeze / very
slow enumeration on some recent systems, additional port descriptions.
- Fixed issue with program shutdown behavior (e.g. on program close through
Task Manager or setup.exe).
- In "Flow Control = Manual" you can change RTS/DTR states now without opening the
COM port. A "Flow Control = Manual" project now always start with RTS=low and
DTR = low
- DL.SetChannelSettings now allow changing baud rates and other serial parameters
on-the-fly, i.e. without closing the communication channel first.
- Fixed v2.0.1 bug: Communication Filter not correctly maintained after a project
was loaded via DL.OpenProject
Docklight / Docklight Scripting V2.0.1 (08/2012)
New features and functions:
- Support for EZ-Tap Pro and Versa-Tap from www.stratusengineering.com
(see also http://docklight.de/support/support_dl_faq034.htm)
- New setting for COM communication channels:
Baud Rate "None" = Don't set serial communication settings (baud rate, parity ...)
(to avoid problems with virtual COM drivers / Embedded COM stacks that do not support this)
- New OnReceive_GetDateTime() / OnReceive_GetMilliseconds() method
- New DL.ConvertSequenceData() for processing float and integer encoded values
- New DL.SetContentsFilter() to change Communication Filter settings while channel is open
- New Function Character '^' for bitwise comparisons
- New Receive Sequence comment macros (%_L, %_T, %_C, %_A, %_H, %_D, %_B)
- New method D
