Docklight Scripting - Overview

<< Click to Display Table of Contents >>

Navigation:  Introduction >

Docklight Scripting - Overview

Docklight Scripting is an extended edition of Docklight RS232 Terminal / RS232 Monitor. It features an easy-to-use scripting language, plus a built-in editor to create and run automated test jobs.  A Docklight script allows you to execute all basic Docklight operations (sending predefined data sequences, detecting specific sequences within the incoming data stream, ...) and embed them in your own test code.


Docklight Scripting is network-enabled. Instead of using a serial COM port, Docklight Scripting can establish TCP connections (TCP client mode), accept a TCP connection on a local port (TCP server mode), or act as a UDP peer. It also supports USB HID connections and Named Pipes.


Docklight Scripting gives you both flexibility and simplicity. Within minutes you can build your own automated testing tools and create:

time-controlled test jobs (e.g. sending a diagnostics command every 5 minutes and reporting an error, if the device response is not OK)

repeated test cycles (e.g. endurance testing for a motion control / drive system)

automatic device configuration scripts (e.g. resetting a RS232 device to factory defaults before delivery)

fault analysis tools for service and maintenance tasks (e.g. running a set of diagnostics commands and performing automatic fault analysis)

protocol testers with automatic checksum calculations (e.g. CRC - Cyclic Redundancy Codes)

Docklight startup scripts (e.g. automatically starting a COM port logging task at PC startup)


Docklight Scripting uses the VBScript engine, allowing you to write your tests in a simple, well-known scripting language. Docklight's basic functions and features are made available through a small and convenient set of Docklight script commands.


TIP: For getting started, have a look at the Docklight modem testing script, which demonstrates the usage of Docklight script commands for an automated modem test. A simple demonstration for the TCP/IP capabilities can be found in the TCP client/server sample.