Docklight Application Note: Docklight Tap Pro and Docklight Tap 485
Contents
1. 4 2 2 Idle Times Resolution Since the time stamp information is generated by the Tap Pro Tap 485 device itself Docklight needs to manually request new time stamps in periodic intervals during communication idle times The resulting update interval is then approx 15 milliseconds So the following Docklight Scripting script DL StartCommunication Do DL AddComment DL GetDocklightTimeStamp Loop will result in output similar to this if there is no serial communication data currently 2 4 SOG 5200S 20307360Z s2013 2OPO7 ESO LOZ 2015 20307236 L02 p2015 ZOO TIS 65118 12015 2007 36 1L18 20L 20Oras LLB s2015 20807 ese LLB 2015 20307536 L18 s2013 ZOO 713S6 5 118 s2015 2O8077 36 134 ol O71 Ot Of Ot Gt OT Ol Of Oi This behavior is by design and does not influence the time stamp accuracy for received serial communication data in any way TT T T Pe o CN E ee Ce Oe Docklight Application Note f Docklight Tap Pro and Docklight Tap 485 2015 10 27 OH Applies to Docklight V2 1 Docklight Scripting V2 1 Docklight V2 1 2015 09 03 OH Docklight Pro Monitor V0 5 2 E 0170220 0 T Page V0 1 First draft 2014 02 12 M y Heggelbacher Docklight Application Note 4 8 Ver Name fruan WWW fuh edv de TS Docklight_Application_Note_TapPro_Tap485 doc 4 3 How to Display and Evaluate Handshake Signals The Tap Pro Tap 485 devices report handshake signal changes from both communicat2. Channel 1 and Receive Channel 2 select the VTP ports available from the dropdown lists e g VTPO and VTP1 Review and adjust the COM Port Settings baud rate parity For the Tap Pro Tap 485 you can additionally set the Signaling Level 0 RS232 TTL 1 RS422 485 2 Inverted RS232 TTL Confirm all settings with OK 5 Press Start Communication F5 in Docklight and start your monitoring application Docklight Tap Pro and Docklight Tap RS485 support very high baud rates up to 921000 baud with maximum monitoring accuracy Depending on your average data traffic and your Docklight program OO T T pe oeno po th OOF OOOO Dock icati ght Application Note a Pe pL of Docklight Tap Pro and Docklight Tap 485 015 10 27 OH Applies to Docklight V2 1 Docklight Scripting V2 1 Dockight v21 2015 0903 OH Pocklight Pro Monitor vo 5 0714 02 20 OH Fachmann amp 014 02 12 MF S Heggelbacher Docklight Application Note Ver Name fomus WWW fuh edv de 2 7 Docklight_Application_Note_TapPro_Tap485 doc settings you can easily run into situations where Docklight is simply not fast enough to display and process all the incoming monitoring data and you will receive a Input Buffer Overflow message by Docklight To avoid such overflows you can either e Switch to a simpler display representation See the Docklight User Manual 2 section How to Increase the Processing Speed for more informa
3. AddComment DL GetDocklightTimeStamp amp GetHandshakeSignals amp DL GetHandshakeSignals DL Pause 200 Loop Example Communication Window output 6 23 2015 10 07 44 244 GetHandshakeSignals 6 23 2015 10 07 44 469 GetHandshakeSignals 6 23 2015 10 07 44 677 GetHandshakeSignals 6 23 2015 10 07 44 884 GetHandshakeSignals RTS and DTR are changing to High in this example NOTE It can take 5 10 milliseconds after DL StartCommunication until DL GetHandshakeSignals reports the correct signal state 4 4 Receive Sequence Comment Macros The following macro keywords can be used to create Docklight comment texts with dynamic data e g the actual data received Comment Macro Description _L Insert a line break _T Insert the time stamp for the data received _C Insert the Docklight channel no data direction 1 or 2 for the data received _A Insert the actual data that triggered this Receive Sequence Use ASCII representation _H Same as _A but in HEX representation D Same as _A but in Decimal representation _B Same as _A but in Binary representation _A 1 4 Extended syntax Insert only the first 4 characters of this Receive Sequence start with Character No 1 sequence length 4 _H 3 1 Extended Syntax Insert everything from the third character until the end of the sequence length 1 Use HEX representation Example for detecting and
4. Docklight_Application_Note_TapPro_Tap485 doc Docklight Application Note Docklight Tap Pro and Docklight Tap 485 Table of Contents Docklight Application Note Docklight Tap Pro and Docklight Tap 485 1 Docklight Tap Pro and Docklight Tap 485 2 Software Options 3 Docklight Pro Monitor 3 1 Quickstart 4 Docklight V2 1 and Docklight Scripting V2 1 cccccecceeceeeceeeeeeeeeeeceeeeeeeaeeeeneeseaeeesaaeeesaaeseeeeeseaeeeseaeeseneeseaes 3 4 1 Quickstart 4 2 Time Stamp Resolution and Processing 4 2 1 Hardware Timing vs Windows Time 4 2 2 Idle Times Resolution 4 3 How to Display and Evaluate Handshake Signals 4 3 1 Signal Function Character l F11 in Tap Pro and Tap 485 mode 4 3 2 Function Character F12 for Bitwise Comparisons 4 3 3 DL GetHandshakeSignals Script Method 4 4 Receive Sequence Comment Macros 5 Driver Installation 6 Copyright 7 References 1 Docklight Tap Pro and Docklight Tap 485 Docklight Tap Pro and Docklight Tap 485 are advanced serial data monitoring tap for the following areas of application e RS232 RS232 and 3 3V 5V TTL voltage levels Docklight Tap Pro and Docklight Tap 485 e RS485 2 wire and RS422 4 wire differential voltage levels Docklight Tap 485 Both tap devices use their own real time clock to timestamp all serial data monitored with internal accuracy ius Latency problems and Windows System Time inaccuracies as described in the Docklight Tap Application Note 3 do not occur and the
5. displaying the Tap Pro and Tap 485 handshake signals changes TT T T Pe o EN E ee Oe Docklight Application Note f Docklight Tap Pro and Docklignt Tap 485 2015 10 27 OH Applies to Docklight V2 1 Docklight Scripting V2 1 Docklight V2 1 2015 09 03 OH Docklight Pro Monitor V0 5 2 E 014 0220 O PES Page Vot Firstdraft 2014 02 12 M gt Heggelbacher Docklight Application Note 6 8 Ver Name susmssaonu WWW fuh edv de o Docklight_Application_Note_TapPro_Tap485 doc Open the Edit Receive Sequence dialog and create a Receive Sequence with a Function Character P F11 followed by a wildcard F7 I In 3 Action add the following Comment text _L _T Handshake Signals 0 0 DTR RTS RING DCD DSR CTS _B 2 1 This Receive Sequence will trigger on any handshake signal change reported and add an extra line to the Docklight Communication Window output 6 22 2015 17 01 32 058 Handshake signals 0 0 DTR RTS RING DCD DSR CTS 00100000 5 Driver Installation Driver download on Windows 10 Windows 8 Windows 7 and Windows Vista is fully automatic via Windows Update After plugging in the Docklight Tap USB cable the device drivers are installed automatically if required _ Driver Software Installation Your device is ready to use USB Composite Device wf Ready to use USB Serial Converter off Ready to use USB Serial Port COM6 J Ready to use For additional instruction
6. ht Application Note 2 8 Ver Name feia WWW fuh edvde Ee Docklight_Application_Note_TapPro_Tap485 doc 7 Copy communication data to clipboard Ctrl C or switch between ASCII HEX Decimal or Binary representation while monitoring amp Docklight Pro Monitor v0 5 File Channels Help O O O Stop Clear Options Help Representation ASCII Hex Decimal Binary Channels Ch 1 My PC VTPO 921600 8 None 1 Ch 2 Device VTP1 921600 8 None 1 Content Data Timestamp Configuration Info CFG Status Lines RTS DTR Break State Errors ERR 2015 1 s 390 Status Lines as Lines 818 Status Lines Options amp Status Lines Date Timestamp 2015 10 26 17 58 53 000 2 o 432 Status Lines Control Characters lt STX gt lt EOT gt lt CR gt 33 Status Lines 4 Docklight V2 1 and Docklight Scripting V2 1 4 1 Quickstart 1 Make sure you have installed the latest Docklight Tap USB drivers FTDI device drivers On Windows 10 Windows 8 Windows 7 and Windows Vista this is fully automatic just plug in the Tap USB cable and Windows Update will download and install the correct drivers if required For details see Section 5 Driver Installation Download and install Docklight V2 1 or Docklight Scripting V2 1 or higher from http docklight de downloads Start Docklight choose the menu Tools gt Project Settings and select Communication Mode Monitoring For Receive
7. ion directions DTE Docklight Receive Channel 1 and DCE Docklight Receive Channel 2 Signal changes can be evaluated as described in the Docklight User Manual 1 section Controlling and Monitoring RS232 Handshake Signals http docklight de manual setandreadhandshake htm 4 3 1 Signal Function Character F11 in Tap Pro and Tap 485 mode The Function Character F11 supports the following parameter values when used in Tap Pro and Tap 485 applications Bit No Character Value Handshake Signal Decimal Mode 001 CTS High DCE side Docklight Receive Channel 2 002 DSR High DCE side Channel 2 004 DCD High DCE side Channel 2 008 RI Ring Indicator High DCE side Channel 2 016 RTS High DTE side Channel 1 032 DTR High DTE side Channel 1 For easy evaluation of bit oriented data like the above handshake signal states two new features have been added to the Docklight Receive Sequence syntax 4 3 2 Function Character F12 for Bitwise Comparisons The Function Character can be added by pressing F12 in the Edit Receive Sequence dialog After the Function Character two additional character values specify which bits to check lt mask gt and which values to expect for these bits lt value gt Receive Sequence Description HEX Mode lt mask gt lt value gt Is a match for the next character received when the followi
8. ng is true lt next Byte received gt XOR lt value gt AND lt mask gt 0 In other words the character picks only the bits marked in lt mask gt and compares them with the corresponding bits in lt value gt See below for examples OF 05 Is a match when for the next character the following is true Bit O 1 Bit 1 0 Bit 2 1 Bit 3 0 Bit 4 7 don t care 10 10 This Receive Sequence triggers when the new handshake signal state says RTS High All other handshake signals can have any state TT T T Pe o EN ee ORME Docklight Application Note pF of f J DocklightTap Pro and Docklight Tap 485 2015 10 27 OH Applies to Docklight V2 1 Docklight Scripting V2 1 Docklight V2 1 2015 09 03 OH Docklight Pro Monitor V0 5 2 2014 02 20 0 ane Page V0 1 First draft 2014 02 12 M y Heggelbacher Docklight Application Note 5 8 Ver NaMe fruarna WWW fuh edv de 2 ai Docklight_Application_Note_TapPro_Tap485 doc TIP This extension is also demonstrated in the Docklight Scripting example project Docklight_TapPro_Demo pip see the folder Extras TapPro in your Script Samples directory 4 3 3 DL GetHandshakeSignals Script Method The script method DL GetHandshakeSignals returns the current handshake signal states as an integer bit field in the same way the function character l works see table in section 4 3 Code Example DL StartCommunication Do DL
9. ons and high data throughput Docklight Pro Monitor is a free addition to Docklight Scripting 3 Docklight Pro Monitor 3 1 Quickstart 1 Make sure you have installed the latest Docklight Tap USB drivers FTDI device drivers On Windows 10 Windows 8 Windows 7 and Windows Vista this is fully automatic just plug in the Tap USB cable and Windows Update will download and install the correct drivers if required For details see Section 5 Driver Installation Download and install Docklight Pro Monitor from http docklight de download DocklightProMonitorSetup exe Start Docklight Pro Monitor and choose Channels gt Configuration Pick the correct Serial Communication Parameters baud rate parity and Signaling Level 0 RS232 TTL 1 RS422 485 2 Inverted RS232 TTL Channel Configuration x Settings Tap Device First Found Ch 1 Alias VTPO Ch 2 Alias VTP1 Baud Rate 921600 Data Bits 8 Parity None Stop Bits 1 RS232 TTL Tap Signal Level RS422 485 Inverted RS232 TTL OK Cancel 5 Confirm and press Start F5 6 On the fly adjustments of the amount of detail displayed can be made using the Content Off On switches r a a A E Docklight Application Note Docklight Tap Pro and Docklight Tap 485 2015 10 27 Applies to Docklight V2 1 Docklight Scripting V2 1 Docklight V2 1 2015 09 03 Docklight Pro Monitor V0 5 2 014 02 20 OH Fiachmann amp Page 2014 02 12 Heggelbacher Docklig
10. re is no need for advanced Docklight V2 1 options like Expert Options External High Priority Process Mode Docklight User Manual 2 How to Obtain Best Timing Accuracy NOTE For sending and receiving data on a RS485 bus use Docklight and a standard USB to RS485 adapter as described in Docklight Application Note RS422 485 communication 4 http docklight de pdf Docklight Application Note RS422 485 pdf er Docklight Application Note Docklight Tap Pro and Docklight Tap 485 2015 10 27 Applies to Docklight V2 1 Docklight Scripting V2 1 V1 1 Docklight V2 1 2015 09 03 Docklight Pro Monitor V0 5 V O Minor corr 20140220 OH To Page 01 Firstdraft 2014 02 12 Heggelbacher Docklight Application Note 148 Ver Name feii WWW fuh edvde Docklight_Application_Note_TapPro_Tap485 doc 2 Software Options For monitoring applications with Docklight Tap Pro and Docklight Tap 485 you can choose between the following Windows software options e Docklight RS232 Terminal RS232 Monitor the solution for advanced data sequence detection and reformatting but with limitations when it comes to high baud rates gt 100 kbps and high data throughput Docklight Scripting an extended edition of Docklight RS232 Terminal RS232 Monitor with built in scripting capabilities for additional post processing and data evaluation Docklight Pro Monitor a lightweight and lightning fast monitoring tool for high speed connecti
11. s and installation details on Windows XP please see the installation guides for the Tap Pro and Tap 485 FTDI chipset as available on the FTDI web site http ftdichip com Documents InstallGuides htm 2015 11 03 OBIME Docklight Application Note pate Ppa a Docklight Tap Pro and Docklight Tap 485 onf Z T ie o ae 2 Docklight V2 1 015 09 03 014 02 20 OH gt tamer V1 Applies to Docklight V2 1 Docklight Scripting V2 1 V1 Docklight Pro Monitor V0 5 V1 0 1 014 02 12 Heggelbacher Docklight Application Note Ver Date Name J rasnsietresnbsae WWW fuh edv de Docklight_Application_Note_TapPro_Tap485 doc 6 Copyright Copyright 2015 Flachmann und Heggelbacher GbR All rights reserved No parts of this work may be reproduced in any form or by any means graphic electronic or mechanical including photocopying recording taping or information storage and retrieval systems without the written permission of the publisher Trademarks Products that are referred to in this document may be either trademarks and or registered trademarks of the respective owners The publisher and the author make no claim to these trademarks Windows is a registered trademark of Microsoft Corporation in the United States and other countries Disclaimer While every precaution has been taken in the preparation of this document the publisher and the author assume no responsibility for errors or omissions or for damages resul
12. ting from the use of information contained in this document or from the use of programs and source code that may accompany it In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document Contact E Mail Support docklight fuh edv de Flachmann amp Heggelbacher Waldkirchbogen 27 D 82061 Neuried Munich Germany http www fuh edv de 7 References 1 Docklight Pro Monitor User Manual from edition 10 2015 http docklight de pdf DocklightProMonitor_manual pdf Docklight Scripting V2 1 User Manual from edition 08 2015 http docklight de pdf docklight scripting manual pdf Docklight Tap Application Note http docklight de pdf Docklight Application Note DocklightTap pdf Docklight Application Note RS422 485 communication http docklight de pdf Docklight Application Note RS422 485 pdf Docklight Tap Pro Product Sheet http www docklight de pdf Docklight Tap Pro pdf Docklight Tap 485 Product Sheet http www docklight de pdf Docklight Tap 485 pdf Cid sd alu Docklight Application Note Docklight Tap Pro and Docklight Tap 485 2 Applies to Docklight V2 1 Docklight Scripting V2 1 7 P Docklight V2 1 Docklight Pro Monitor V0 5 014 02 20 OH T Page 0 1 014 02 12 Heggelbacher Docklight Application Note 818 Ver Name feia WWW MUI edvde o V1 Vi V
13. tion and how to resolve this problem http docklight de manual howtoincreasetheprocessing htm e Use Docklight Pro Monitor instead as described in section 3 NOTE All Docklight Tap devices are hot pluggable when used with Docklight if the device becomes unavailable during a Docklight monitoring session Docklight issues a warning and reconnects to the device when it is plugged back in again 4 2 Time Stamp Resolution and Processing Docklight Tap Pro and Docklight Tap RS485 provide exact hardware microseconds timing Docklight does not expose the full internal resolution of the time tagging and the visible time stamp resolution is milliseconds as in other Docklight applications 4 2 1 Hardware Timing vs Windows Time Docklight provides time stamps that are linked to the Windows local time on the PC It reads the Tap Pro Tap 485 hardware clock for measuring short time intervals below 10 seconds with high accuracy but refers synchs to the Windows local time on communication start or after communication idle times larger than 10 seconds In addition Docklight makes sure that the hardware time provided does not slowly drift away from the Windows local time during long term measurements with continuous data This effectively gives you the best of both worlds true milliseconds accuracy and correct order of data when you need it but also meaningful drift free local time when you are measuring over a long period of time
Download Pdf Manuals
Related Search