Flachmann und Heggelbacher Docklight V2.2, User Manual

Page: 37 / 83

37
Docklight V2.2 User Manual 07/2016 Copyright 2016 Flachmann und Heggelbacher GbR
Working with Docklight (Advanced)
Bit 2 = 1
Bit 3 = 0
Bit 4-7 = (don’t care)
! | ^ | 04 | 04 This Receive Sequence triggers when the new handshake signal
state says
DCD = High. All other handshake signals can have any state.
NOTE: This Receive Sequence will trigger for any change of any
handshake signal, in case DCD still remains High.
TIP: This extension is also demonstrated in the Docklight Scripting example project
Docklight_TapPro_Demo.ptp (see the folder Extras\TapPro in your \Samples
directory)
6.6 Creating and Detecting Inter-Character Delays
Some applications, especially microcontroller applications without a dedicated serial
data buffer, require an extra delay between individual characters to avoid buffer overflows
and allow the microcontroller to execute other code.
In Docklight you can implement inter-character delays by inserting one or several
Function Characters '&' (F9 key) in your Send Sequence data, followed by a character
specifying the desired delay time from 0.01 seconds to 2.55 seconds.
You can also use the '&' delay character inside a Receive Sequence to specify a
minimum silent time where no further characters should be received. This is useful for
detecting pauses in the data stream that indicate the beginning/end of a telegram,
especially for protocols where there is no dedicated start or end character.
Preconditions
· Docklight is ready to run a test as described in testing a serial device or a protocol
implementation .
· The Docklight project already contains one or several Send Sequences , but an
additional delay at certain character positions is required.
Sending Data With Inter-Character Delays
As an example, we use a microcontroller application which understands a "get"
command. In ASCII Mode, the Send Sequence would be:
g | e | t | r
("r" is a terminating <CR> Carriage Return character)
The following steps describe how to add an additional delay of 20 milliseconds between
each character and avoid buffer overflows on the microcontroller side.
A) Modifying the existing Send Sequence
1. Open the Edit Send Sequence dialog .
2. Switch Edit Mode to Decimal . Our "get" example looks like this in decimal mode:
103 | 101 | 116 | 013
3. Insert a delay function character between the first and the second character: Press
F9 , or open the context menu using the right mouse button , and choose
Function character '&' (delay... . The example sequence now reads:
103 | & | 101 | 116 | 013