Docklight V2.3 User Manual 12/2019 Copyright 2019 Flachmann und Heggelbacher GbR Table of Contents 2 1. Copyright 5 2. Introduction 7 2.1 Docklight - O verview ...................................................................................................... 8 2.2 Typical Applications ....................................................................................................... 8 2.3 System Requirements ................................................................................................... 10 3. User Interface 11 3.1 Main Window ............................................................................................................... 12 3.2 Clipboard - Cut, Copy & Paste ..................................................................................... 13 3.3 Documentation Area .................................................................................................... 13 4. Features and Functions 14 4.1 How Serial Data Is Processe d and Displayed .............................................................. 15 4.2 Editing and Managing Sequences ................................................................................ 15 5. Working with Docklight 17 5.1 Testing a Serial Device or a Protocol Implementation ............................................... 18 5.2 Simulating a Serial Device ............................................................................................ 19 5.3 Monitoring Serial Communications Between Two Devices ....................................... 21 5.4 Catching a Specific Sequence and Taking a Snapshot of the Communication ......... 23 5.5 Logging and Analyzing a Test ....................................................................................... 23 5.6 Checking for Sequences With Random Characters (Receive Sequence Wildcards) ..................................................................................................................... 24 5.7 Saving and Loading Your Project Data ........................................................................ 26 6. Working with Docklight (Advanced) 28 6.1 Sending Commands With Parameters (Send Sequence Wildcards) .......................... 29 6.2 How to Increase the Processing Speed and Avoid "Input Buffer Overflow" Messages ....................................................................................................................... 30 6.3 How to Obtain Best Timing Accuracy .......................................................................... 31 6.4 Calculating and Validating Checksums ....................................................................... 31 6.5 Controlling and Monitoring RS232 Handshake Signals .............................................. 33 6.6 Creating and Detecting Inter-Character Delays .......................................................... 37 6.7 Setting and Detecting a "Break" State ........................................................................ 38 7. Examples and Tutorials 40 7.1 Testing a Modem - Sample Project: ModemDiagnostics.ptp ..................................... 41 7.2 Reacting to a Receive Sequence - Sample Project: PingPong.ptp .............................. 42 7.3 Modbus RTU With CRC checksum - Sample Project: ModbusRtuCrc.ptp ................. 43 Docklight V2.3 User Manual 12/2019 Copyright 2019 Flachmann und Heggelbacher GbR Table of Contents 3 8. Reference 46 8.1 Menu and Toolbar ........................................................................................................ 47 8.2 Dialog: Edit Send Sequence ......................................................................................... 48 8.3 Dialog: Edit Receive Sequence ..................................................................................... 49 8.4 Dialog: Start Logging / Create Log File(s) .................................................................... 50 8.5 Dialog: Customize HTML Output ................................................................................. 51 8.6 Dialog: Find Sequence .................................................................................................. 53 8.7 Dialog: Send Sequence Parameter .............................................................................. 53 8.8 Dialog: Project Settings - Communication .................................................................. 54 8.9 Dialog: Project Settings - Flow Control ....................................................................... 56 8.10 Dialog: Project Settings - Communication Filter ......................................................... 56 8.11 Dialog: Options ............................................................................................................. 57 8.12 Dialog: Expert Options ................................................................................................. 58 8.13 Keyboard Console ........................................................................................................ 59 8.14 Checksum Specification ................................................................................................ 60 9. Support 63 9.1 Web Su pport and Troubleshooting ............................................................................. 64 9.2 E-Mail Support .............................................................................................................. 64 10. Appendix 65 10.1 ASCII Ch aracter Set Tables ........................................................................................... 66 10.2 Hot Keys ........................................................................................................................ 68 10.3 RS232 Connectors / Pinout .......................................................................................... 69 10.4 Standard RS232 Cables ................................................................................................. 71 10.5 Docklight Monitoring Cable RS232 SUB D9 ................................................................. 74 10.6 Docklight Tap ................................................................................................................ 75 10.7 Docklight Tap Pro / Tap 485 ........................................................................................ 76 11. Glossary / Terms Used 78 11.1 Action ................................ ............................................................................................ 79 11.2 Break ............................................................................................................................. 79 11.3 Character ....................................................................................................................... 79 11.4 CRC ................................................................................................................................ 79 11.5 DCE ................................................................................................................................ 80 11.6 DTE ................................................................................................................................ 80 11.7 Flow Control ................................................................................................................. 80 11.8 LIN .................................................................................................................................. 80 Docklight V2.3 User Manual 12/2019 Copyright 2019 Flachmann und Heggelbacher GbR Table of Contents 4 11.9 Modbus ......................................................................................................................... 80 11.10 Multidrop Bus (MDB) ................................................................................................... 81 11.11 Receive Sequence ......................................................................................................... 81 11.12 RS232 ............................................................................................................................. 81 11.13 RS422 ............................................................................................................................. 81 11.14 RS485 ............................................................................................................................. 82 11.15 Send Sequence .............................................................................................................. 82 11.16 Sequence ....................................................................................................................... 82 11.17 Sequence Index ............................................................................................................. 83 11.18 Serial Device Server ...................................................................................................... 83 11.19 Snapshot ....................................................................................................................... 83 11.20 Trigger ........................................................................................................................... 83 11.21 UART .............................................................................................................................. 83 11.22 Virtual Null Modem ...................................................................................................... 84 11.23 Wildcard .......................................................................................................................