User manual MSC STK-TDC10000, Rev. 4.0
Contents
1. MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 10 of 25 3 3 7 Exit button The exit button disconnects the starter kit and closes the application All information like I O history or protocol box will be lost 3 3 8 Input line The input line allows the user to control the TDC starter kit by input of commands described in chap 3 4 Furthermore this line allows controlling some features of the host software Input line command Function GLOBALDEBUGLEVEL Filter the debug outputs by change the debug level between X and Y HELP Show all available commands for the input line Table 2 Additional input line control commands The input line supports line editing and history scrolling function by the cursor keys 3 3 9 Protocol box The protocol box shows information of the software The text types of the protocol box text can be Text type Color Text Type Color Titles DarkCyan Data input DarkMagenta Information DarkGreen Data output Brown Errors Red I O history Black Debug DarkGray Help MidnightBlue Table 3 Protocol box text types The protocol box is scrollable and supports select and copy functions The copy supports RTF styles Example 2 Protocol box Connected with UART starter kit MSCSTK TDC10000 OSC_EN LED OFF te PIN DISABLE A PIN DISABLE B 1 aV AV RT AV Determination of the TDC10000 resolution by 10 calibration measurements tCAL 0 25 us lt gt lt ke lt gt lt g2. User Manual MSC STK TDC10000 Rev 4 0 Date 2011 10 27 MSC Vertriebs GmbH Industriestra e 16 76297 Stutensee Germany Author AP AKL Phone 49 7249 910 288 Fax 49 7249 910 4388 Email AP msc ge com MSC All rights reserved Although great care has been taken in preparing this document MSC can not be held responsible for any errors or omissions All information in here is subject to change without notice All hardware and software names used are trade names and or trademarks of the respective owners tdc msc ge com WWW MScC ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 2 of 25 Contents C NOU CIO Mic ee EE EEE 5 Se EE ENE 6 3 Installing and running the Software rarrrnnnnnrrnnrnnnrrnnnnnernnnnnnrrnrnnnernnnnnernnnnnnsnnnnnnsnnnnnneennnnnssnnnnnssennnnessesnene 7 3 1 Host software installation rrsrrnnrrrnnnnnrnnrrnnnrrnnnnnnnnsrnnnrrnnnnnsnssrnnnvnnnnnnensssrnnnvnnnnnsesssnnnnrnnnnnssssssnnnsnnnn 7 3 2 TDC starter kit measurement software OVerVieWw rrrrnnrrrnnnnnnnnrnnnvrrnnnnnnnsrrnnnrnnnnnnnnsrsnnnrrnnnnssssssnnssnnne 8 3 3 Application software functions vvs de 8 3 3 1 Connect Disconnect button ssssesssensssesssersssrsssrrerersrrresrresrrnsrrrestreserrestresernseressrresernsereeerrese 8 3 3 2 VOMS 0 eg OE ee ee 9 3 3 3 1 O DOLOCO CHEN ETE EE 9 3 3 4 Hardware setting ENE 9 3 3 5 TDE PENN 9 3 3 6 er TENT ve 9 3 3 7 Rv re 10 3 3 8 Mile 2 SN 10 3 3 9 POOL OG ERE ee
3. 5 1 3 Power Supply Standard universal power supply connected to J5 min 9V up to max 12 V AC DC Maximum current consumption of the board approx 200 mA To guarantee a high degree of signal integrity the board provides two independent supply voltages one for the TDC chip and one for the microprocessor So the power supply of the TDC chip is not affected and disturbed by other components The TDC s supply voltage is adjustable via the potentiometer R40 within the voltage range of 2 7V up to 5 5V The supply voltage of the microprocessor and all other components is adjustable via the potentiometer R45 within the voltage range of 3 0V up to 5 5V Caution The values of the two supply voltages may not differ from each other more than 0 5V 5 1 4 Reset When the board is connected to the power supply the board s reset chip runs a power on reset cycle This resets the microprocessor and the TDC chip as well If the supply voltage of the microprocessor drops to values less than 3 0V a reset may occur too The application software was tested using Windows XP Professional Edition 32 bit and Windows 7 Professional 64 bit MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 24 of 25 5 2 Layout Diagrams Schematics Figure 7 shows the top view of the board s layout diagram and figure 8 shows its schematic The board s connector X1 is conn
4. Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 5 of 25 1 Introduction In combination with a PC the STK TDC10000 starter kit is an easy to use evaluation tool for the MSC Time to Digital Converter TDC10000 The starter kit consists of the evaluation board and the necessary accessories Figure 1 shows the block diagram of the evaluation board The evaluation board consists of a H8 3048F processor which controls the communication between the TDC and the PC using a RS232 interface Four SMB connectors are provided for high precision time difference measurements between the start and stop inputs of both TDC channels With the RC measuring ports resistance and capacitance measurements can be performed All important sig nals of the TDC chip are accessible for analyses e g logic analyser via two connectors Start RS232 Data bus Stop Channel 1 H8 interface processor TDC10000 C Control lines Stop E Channel 0 RC ports Figure 1 Evaluation board block diagram The starter kit provides the following components 1 power supply unit Imin 500 MA 1 evaluation board 1 cable 9 pole for serial interface 1 1 connection 1 extender 9 pole 25 pole 1 CD including software and documentation 4 measurement cables 1 user manual MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc
5. ee 10 33 10 NONNE 11 3 4 TDC starter kit measurement software commandsS cccccccceesesseeeccceccsaeesseeecccesssaaasseeeeeeessuaaeees 11 3 5 Federer dn 12 3 5 1 PREGETINEA TUN CHIONS EEE EE E N E 12 4 Creating your own measurements PLOPLaINS cccsccceccsecceccsccceccsececeseccuctseceeceseceuceseeeeceseeeeceseeeeeneeeeees 16 4 1 SOW eregue meN ae narnia EE EEE 16 4 2 Create VDUF OWNER Nr 16 4 3 EDIT MISESTE DB EEE 16 4 4 Function calls rom MSCSTK LIB u een ice eh 17 4 4 1 Communication with the starter kit rrrsrrrrrrrnnnrrrnnnnnnrrrnnnvrnnnnnnnssrnnnnrnnnnnnnsssnnnnvnnnnnnnsssnnnnsnnnn 17 4 4 2 VER CHE DIO LOCO DON ee ennerde 18 4 4 3 Initialisation the hardware and control the behaviour of the MSCSTKForm form elements 19 4 4 4 Working WICH tne 010 OG ff nn 21 4 5 Implementing your program into the GUl wrunnnnnunrnnnnrnnnnnnnnnnnrnnnnnrnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnsnennne 21 NNN 23 SOC ICG NOM EE EN EN 23 MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 5 1 1 ENN 5 1 2 Minimum System Requirements rrrarnnarnnnrrnnrnnarrnnnnnnnrnnsrnnsrnnnennnennsennsennsvnnnsnneene 5 1 3 POWER SUPD IV ee ee ee een 5 1 4 KN 5 2 Layout Diagrams Schematics urerrrnnnnrrrrnnnnnrrnnnnnnnnnnnnnrrnnnnnnnnnnnnnrvnnnnnnnnnnnnnnvnnnnnssuneene Figures Figure 1 Evaluation board block diagram cccscccccssseccccseceeces
6. functions OSC DIS Disables the TDC calibration clock 3 5 User defined Functions On the right side of the application window you find ten User defined functions buttons Some of them are predefined all other are provided for creating your own measurement programs see chap 4 3 5 1 Predefined functions 3 5 1 1 Channel resolution Clicking on the channel resolution button will find out the TDC s resolution Therefor the number of calibration measurements has to be entered within a pop up window The calibration values CAL1 CAL2 and the actual resolution of each measurement are displayed in the protocol box for both channels together with the value of their characteristic quantity MO At the end of the measurements all averages are displayed The calibration measurements are performed in Measurement mode 2 with a calibration clock period of tea 250ns Note To prevent disruption of the calibration measurements no start or stop pulses may occur at the measurement inputs connectors X1 X2 X3 and X4 MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 13 of 25 3 5 1 2 Single shot mode 0 Clicking on the single shot mode O button will start a single shot time difference measurement with automatic calibration in measurement mode O measurement of short times The automatic calibration measurement is performed wi
7. history button 3 3 4 Hardware setting checkboxes The hardware setting checkboxes define the current status of the TDC control pins the green Run LED and the starter kit oscillator Enabled checkboxes result in a 1 value of the related pin or control line e g ticking the LED on checkbox will light the green Run LED on the starter kit e LED on Switches on and off the green Run LED of the microprocessor e OSC enable Enables and disables the TDC calibration clock oscillator e PINENAO Enables TDC pin ENAO 1 and disables TDC pin ENAO 0 measurements on channel 0 e PINENA1 Enables TDC pin ENA1 1 and disables TDC pin ENA1 0 measurements on channel 1 Default settings after software connection are Run LED off the oscillator and both channels disabled 3 3 5 TDCreset button The reset button resets the TDC by sending a high active reset pulse on the PURES pin of the TDC This button does not neither synchronise the software with the hardware nor manipulate any hardware setting Default setting after software connection is TDC reset pin inactive TDC pin PURES 0 3 3 6 User defined function buttons The user defined buttons are for the example programs delivered with the software or appended by the starter kit user Here you can add your own functionality MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com
8. is done by increase the value of the progress bar Table 21 variable WorkingProgressBar MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 double CalClkPeriod Description This variable is predefined with 250 ns and corresponds with the used 4MHz oscillator on the starter kit board Table 22 variable CalClkPeriod Page 20 of 25 Variable int GlobalTimeOutValue This variable is to modify the time out behaviour of the application The default value is 10000 MS Table 23 variable GlobalTimeOutValue Description This structure stores all settings of all supported TDC starter kits Additionally all selections made in the Opt ionDialog Form are stored in this structure The following values are the predefined values which can be always set by InitTDC Value Default Description Starter kit Connection status TOG NotInitialized TOC TDC TE POG Starter kit hardware settings TDC Ke Ge TEL ENSPI MODEO Il DL NOEN NS TA sNS TP EN STOP A EN STOP B THC TOC TOC TEC TOC TOC TDC TDC TDC TOC POG Connected Ty UART Name LED SEL PINENAO PINENAL OptionsDialog variables TDC NumberOfMeasurements TDC TD ChannelaASelect ChannelBSelect To reso lucion Connection status boolean Initialisation status boolean TDC number e g 5
9. resp B for channel 1 within a pop up window the program waits for one rising edge on both the start input STARTO resp START1 connector X1 resp X3 and the stop input STOPO resp STOP1 connector X2 resp X4 The program executes a waiting loop The waiting loop will be exited if either a start stop event takes place correct execution or a predefined waiting time has exceeded error message If a start stop event takes place the channel s FIFO is read out the measurement result is calculated and displayed in the protocol box together with the measurement values VAL1 VAL2 CAL1 CAL2 and PRE The maximum measurement period is approx tmax Ims the minimum measurement period is approx tun 650ns 5V typ Note Remove jumpers JP4 and JP5 before measurement on channel 0 because the signal lines leading to the RC measurement circuit act as additional stubs during the time measurement This will decrease the quality of the signal edges and avoid a high precision time difference measurement 3 5 1 4 Resistor measurement Clicking on the resistance measurement button will start a resistance measurement cycle in measurement mode 3 Resistor values between 10 and 40kQ may be determined Note Close jumpers JP4 and JP5 before measurement and remove all measurement cables from the connectors X1 and X2 Fit a capacitor of 100nF into jumper J8 J7 has to be fitted with the reference resistor Rrer 1KQ J6 is intended for the measurem
10. the characteristic quantity MO of 16 Bit Hex rd channel 0 RDK1MO Reads the value of the characteristic quantity MO of 16 Bit Hex rd channel 1 EXOSZON Enables the TDC s calibration clock input CALCLK wr EXOSZOFF Disables the TDC s calibration clock input CALCLK wr Table 4 TDC10000 opcodes for input line or user defined functions MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 12 of 25 Description Return value Hex Access Mode RD HW STATUS Reads the TDC status pins bit5 CALM bit4 VALID1 bit3 16 Bit Hex VALIDO bit2 READY1 bit1 READYO bitO SYSERR MESS REF CAP Measurement cycle Mode 3 for reference capacitor on channel 0 gt Opcode RD_TDC_DATA 10 times afterwards MESS_CAP Measurement cycle Mode 3 for unknown capacitor on channel 0 gt Opcode RD TDC DATA 10 times afterwards MESS REF WID Measurement cycle Mode 3 for reference resistance on channel 0 gt Opcode RD TDC DATA 10 times afterwards MESS WID Measurement cycle Mode 3 for unknown resistance on wr channel 0 gt Opcode RD_TDC_DATA 10 times afterwards z i READ_TDC_DATA Generates a read strobe for reading out the FIFO of 16 Bit Hex rd channel O or channel 1 depending on the preceding Opcode RDKO RDK1 MESS_CAP MESS_REF_CAP MESS WID or MESS REF WID Table 5 TDC10000 hardware specific opcodes for input line or user defined
11. 02 TDC502 UART or USB connection boolean TDC name string e g TDC502 Green Run LED on true Starter kit oscillator on true Use SPI TDC MACH 3 0 Enable SPI TDC MACH 3 0 MODEO TDC501 MSDI TDC501 NOEN TDC501 NSTA TDC501 NSTP TDC501 Enable STOP A TDC502 Enable STOP B TDC502 Enable channel 0 TDC10000 Enable channel 1 TDC10000 OptionsDialog variable OptionsDialog variable TDC10000 TDC502 OptionsDialog variable TDC10000 TDC502 OptionsDialog variable TDC502 Clock divider variable TISIP Clock divider setting Table 24 structure TDC If connected with a starter kit these variables get their starter kit specific value This variable is only for the software and is not the same as the clock divider setting within the TDC MSCSTKTDC10000RefManEng docx Rev 4 0 tdc msc ge com www msc ge com Author AP AKL MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 21 of 25 4 4 4 Working with the OptionDialog form void GenericOptionsDialog bool Channel bool Resolution bool Measurements Description This function shows the OptionDialog The dialog form has to be initialised using the parameters Parameter Channel Shows radio button box Select channel with selection between channel A and B only one channel can be activated TDC10000 TDC502 Resolution Shows the radio button box Select resolution with 4 values 1 half O normal 2 high 4 smart TDC
12. 10000RefManEng docx Rev 4 0 tdc msc ge com www msc ge com Page 3 of 25 Author AP AKL MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 4 of 25 TVEDT 18 Table 15 NNN 19 Table 16 T nction RestorePinSettinest aussen nenne 19 Table 17 function SavePinSettings J rrrrrnnrrnnnnnnnnnrnnnrnnnnnnrnnnnnnnvnnnrnnrnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnennnnnnsnennnnnsnennnnenee 19 TENNE 19 Table PENNEN 19 Table 20 variable VersionLabel rrrnnnrrrrrnnnnnnnnnnnrnensssnnnnnnnnnnnrnnnnnnnnnnnnnsnnenssnnnnnnnnnvnvnnnnnnnnnnnsnsnsnsennnnnnnnsssnnnnnnns 19 Table 21 variable WorkingPr gressBar uvenn 19 Table 22 Varlabie Cali Cl 0 0 EEE EE an 20 Table 23 variable GlobalTimeOutValue rrrrrrrrrrrrrrrrrrnnnnnnnvvrnnnnnnnnnnnnnnnsssssnnnnnnnnnvnrnnnnnnnnnnnensnssssnnnnnnnnsnrnnnnnnes 20 TET ET bee ee ee 20 Table 25 function GenericOptionsDialog cccccscesscccccesecsceesecsceeecseeeeeeeseeuseceeeuuecseeeeeeseceueceseeneceseeeeeess 21 Table 26 function ShowConfiguration c ccceeeeeccccceeseeccccceeeccccceueeececeeeeseceseesueseccesseueseccesseueaeceeseageeeceeees 21 Examples Example 1 I O history FE PONNI Example 3 Place a program on user function button 9 rannnnnannnnnnnrnnnnnrnnnnnnnnnnnnnnnnennnnnnnnnnnvnnnnnnnnnnennnnnenennnene Example 4 button 9 output in protocol box rnrrrrnnrrnrnnrnnrnnrnnvnnrnnsnnrnnnnnrnnnnennnnnennnnnnnnnnnnnnnnnvnnnnnnnnnnsnnnnnsnennnene MSCSTKTDC10000RefManEng docx
13. 502 Measurements Shows a text input line to set the number of measurements Return value n a Example see figure 6 select options dialog GenericOptionsDialog true true true Table 25 function GenericOptionsDialog void ShowConfiguration int Mode Description This function shows the configuration selected by the OptionDialog form and the hl selected measurement mode Mode in the protocol box Shows the selected measurement mode Mode of Example ShowConfiguration 7 Your selected configuration Channel s A Resolution smart Measurements 10 Mode 1 Table 26 function ShowConfiguration 4 5 Implementing your program into the GUI The delivered template file UserButtons cs can be used to implement your own measurement application in the starter kit application software This file initialises an own MSCSTK Form MyMSCSTKForm with 10 additional UserFunctionButton user function buttons To initialise the buttons a UserConnectButtonHandler handler is started with the AutoConnectButton button click The UserConnectButtonHandler handler defines the button text according to the used starter kit if it is connected Otherwise all user function buttons are set invisible If a user function button was clicked the UserFunctionButtonHandler handler is called According to the pressed user button and the used TDC a measurement function is called There are a number of predefined function calls for the user fun
14. Crer 100nF J6 is intended for the unknown capacitor Cmess During the capacitance measurement first of all the discharging time trer of the RC combination reference capacitor resistor is measured and displayed After this the discharging time tyes of the RC combination unknown capacitor resistor is determined and displayed With the ratio tye_ss trer the capacitance of the unknown capacitor Cmess is calculated as follows tmess Cmess Oper F3 REF 3 5 1 6 N times single shots mode 0 Clicking on the n times single shots mode 0 button will start a cycle of n single shot time difference measurements using measurement mode O measurements of short times with automatic calibration and auto noise All calibration measurements are performed with a calibration clock period of tca 250ns After selecting the channel A for channel O resp B for channel 1 and the number of measurements n lt 2000 within a pop up window the program awaits n start stop measurements with rising edges on both the start input STARTO resp START1 connector X1 resp X3 and the stop input STOPO resp STOP1 connector X2 resp X4 Before each measurement the program executes a waiting loop Each waiting loop will be exited if either a start stop event takes place correct execution or a predefined waiting time has exceeded error message If all n start stop events take place all the n measurement results are calcu
15. EADYS na 10K N R23 9 LED 14 GND 10K B OSC EN 7 RESET VALDE VALIDA HEAD YS 3 READYA DAIRDREADY 40 a VOCHE 65 9 98 CHARGESTP PTRA pe er PA2 S8 STARTZ PAI aa STARTS R24 PAD 10K 17 9 nu HE P8 4 080 35 CS RLOCKON peanas au STOINHO pe P8 2 CS2 1AQ2 STOINK1 P8 1 IRQ1 F8 wIRO0 gr 1wt6v o 1u 16V us 63 nPURESET a ri RES TOKOUTO F GND 64 TOKOUT1 TOKINO 36 4 TOKINI VOCHS voc c22 1001 16MHz SGI IWIGY ug Twt6v 1k2 Ra 1K2 bei fix SV 1K5 bei variabler Spannung C47 104 16V Figure 8 Schematic of the TDC10000 starter kit Rev 4 0 Author AP AKL Page 25 of 25 Vokmeteranschluf zur Pr fung won VTDC 1 2 3 4 5 6 7 8 9 Di HEADER10X2 HEADER 10X2 ur MAX821 SUS SOT143 Cc us L ngs u Querbest ckung m glich L2 5 6uH 1 DSUB 9 Female 1u 16v MSC Verriebs GmoH Entwicklungsabteikung Warner von Siemans Sv 1 76297 Sutansoe Tel 07249 910 170 The Starter Kit f r die TDC1000x Document Number Far STK TDC10001 ale esday Ma z Bheet it p
16. Installer Setup Choose Components Choose which features of MSC TDC Starterkit SW Installer you want to install Welcome to the MSC TDC Starterkit amp SW Installer Setup Wizard This wizard will quide you through the installation of MSC Check the components you want to install and uncheck the components you don t want to TDC Starterkit SW Installer install Click Next to continue It is recommended that you dose all other applications before starting Setup This will make it possible to update relevant system files without having to reboot your Select components to install computer Starter kit software Click Next to continue Software source code Space required 669 0KB Figure 3 MSCSTKTDC Installer software The starter kit software is started by double clicking on the file TDC Starter Kit Measurement Software exe The program s application window appears Be TDC Starter Kit Measurement Software not connected type HELP to get a short command list Copyright MSC Vertriebs GmbH 2010 2011 MSCSTK LIB 0 9 4 15289 Programm 0 9 4 18731 Protocol box PEN E 1 0 Protocol Figure 4 Start up screen of the starter kit host software If the starter kit is powered and connected to the host the software connects to the kit itself Otherwise you can connect the starter kit to the software by pressing the Connect button MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL
17. ble 6 MSCSTK LIB defined forms MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 17 of 25 A TDCStruct structure is implemented in MSCSTK LIB This structure contains the complete setting of the TDC and some program options Furthermore the following functions are available from MSCSTK LIB 7 int Cmd string message Int32 TimeOutValue 7 int Cmd string message void GenericOptionsDialog bool OneChannel bool Resolution bool Measurements void InitTDC int Mode void RestorePinSettings void SavePinSettings void ShowConfiguration int Mode m void Wait Int32 ms void WriteDebug string message void WriteText string message Color color void WriteText string message Color color FontStyle style At least anumber of variables and all necessary form elements are marked as public Form elements Global variables AutolonnectButton double CalClkPeriod VersionLabel int GlobalTimeOutValue WorkingProcessBar int Result bool DebugMode pool RunProgram CLoOLOY DbgColor WOolor Errlolor Color HisColor Color intColor Color InpColor Color Out olor Coler TIitColor Lor HloColor TOCS Cruce TDC Table 7 MSCSTK LIB defined form elements and variables 4 4 Function calls from MSCSTK LIB 4 4 1 Communication with the starter kit Function call int Cmd string command Int32 TimeOutValue Description Th
18. cceceesececeueeceeseesecesaeeceseuneceesees 2 TE NN Figure 3 MSCSTKTDC Installer software rrrrrrnrnanrrrnnnnrrnnnnnnrrnnnnnernnnnnernnnnnnernnnnnevnnnnnssnnnnnsseeene Figure 4 Start up screen of the starter kit host software rrrnranrrrnnnnrrrnrnnnrrnrnnnernnnnnerrnnnnnenenne Figure 5 Host software connected with a TDC10000 starter Kit rrrrnrnnrrrnrnnnrrrnnnnrrnnnnnrrrnrnnnsrnnnn Fig r 6 ENN NN Figure 7 Layout diagram TDC10000 starter kit top view rrrvrrrrrnnrnnnnrrrnnrnnnnrrnnnnnnnnrrnnnrnnnneenne Figure 8 Schematic of the TDC10000 starter kit rrrrrranrrnnnnnnrnnnnnnrrnnnnnrrrnrnnnrrnnnnnernnnnnerrnrnneseennn Tables Table 1 0 history line deseriptlion ze ken Table 2 Additional input line control commands ccceccceeececesecceenecceeeeseeuececeuecseeueceeeneeeeeass Table 3 Protocol box text TYP rinnen Table 4 TDC10000 opcodes for input line or user defined functionS sssessseressrrrerrererrrerrens Table 5 TDC10000 hardware specific opcodes for input line or user defined functions Table 6 MSCSTK LIB defined forms rrrrrrnrnnnnrrnnnnnrnnnrnnnrrnnnnnnnssnnnnrnnnnneenssnnnvnnnnnnessssnnnsnnnnnnessssene Table 7 MSCSTK LIB defined form elements and Variables ccccccccccssssssseececeessaeeseeeeeeeeeeas Table 3 Tune VONICH ne ee E Table NENNE Table 10 variable RUDNPTOST ee N TE 0 CH RE OU ee een Table 12 f nction WiiteDebig ee Table 13 variable color NN MSCSTKTDC
19. ct First step is adding a link to the MSCSTK LIB mscstk lib dll which is found in the source code directory of the install CD Then add the existing elements Program cs TDC300 cs TDC330 cs TDC501 cs TDC502 cs TDC10000 cs and UserButtons cs which can be found also in the source code directory of the install CD Please overwrite the already Program cs by the delivered one Now you should be able to compile the basic program for the first time After starting the executable a window like figure 4 should appear If this window does not appear check if the file Program cs initialises the right application form Application Run new MyMSCSTKForm The form1 which is initialised with the new Project is not necessary and may be deleted 4 3 Library MSCSTK LIB To create your own test programs you have the complete language range of C with all NET functions available Additionally we have included some functions in our MSCSTK LIB to enhance your programming success This library has to be linked to your project Otherwise you don t have the main application form and all the functions to communicate with the starter kit Following forms are available in MSCSTK LIB Standard application form as shown in figure 5 OptionDialog Options dialog to set up various TDC or program parameters gt U Select channel A Select resolution Half Figure 6 Select options dialog Ta
20. ction buttons MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 22 of 25 Example 3 Place a program on user function button 9 Add to the function UserFunctionButtonHandler case 9 Program control variable must be activated RunProgram true Title WriteText Environment NewLine My first user measurement program TitColor Output the connected TDC Type and some settings WriteText Get settings InfColor FontStyle Underline WriteText Connected TDC from starter kit is TDC Name InfColor WriteText The oscillator is TDC 0SC on off InfColor Switch on the oscillator if TDC OSC Cmd OSC EN WriteText Now the oscillator is TDC OSC on off TnfColor 10 times LED blink WriteText Take a look at the blinking green LED InfColor for int myTempInt 0 myTempInt lt 10 myTempInt if TDC LED Cmd LED OFF else Cmd LED ON Wait 100 wait for 0 5s to see a blinking LED Switch the LED on finally if TDC LED Cmd LED ON WriteText Now the green LED is TDC LED on off InfColor ff Finish break Add to the function UserConnectButtonHandler under the if constructif TDC Connected My user function button 9 UserFunctionButton 9 Text My 1st function If the compile
21. d application runs press the Connect button and afterwards the user function button 9 You should see a blinking green LED on the starter kit and the following text in the protocol box Example 4 button 9 output in protocol box My first user measurement program Get settings Connected TDC from starter kit is TDCI0000 The oscillator LS SIT Now the oscillator is on Take a look at the blinking green LED Now the green LED is on Program execution was successful MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 23 of 25 5 Appendix 5 1 Specification 5 1 1 Common 16 MHz H8 3048F microprocessor Time to Digital Converter TDC10000 Control pins of the TDC are configurable via microprocessor 4SMB measurement inputs for high precision time difference measurements 4 MHz oscillator used as TDC calibration clock 30ppm Red LED for power on indication Green LED for indication of correct microprocessor operation Communication between PC and evaluation board via RS232 with standard DB 9S connector protocol fixed to 9600 baud 8 data bits 1 stop bit no parity 5 1 2 Minimum System Requirements PC with 9 25 pol serial RS232 interface Operating system Windows XP Windows Vista Windows 7 with NET framework 3 5 or later gt Measurement inputs with 3 3V 5V compatible ports for start and stop
22. e function Cmd sends the command to the starter kit and receives the reply The function call without a TimeOutValue uses the GlobalTimeOutValue The time out value is used for the port communication Parameter a valid opcode optionally with parameters see table 4 and table 5 TimeOutValue Time out value in ms Return value 2 The function was not executed because the global variable RunProgram Was false The function fails Usually there is an error description message in the protocol box others The function was executed successfully The number of results which are stored in the integer array variable Result is returned Table 8 function Cmd MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 18 of 25 Description This array contains the result values from the last successfully executed command Attention Only the number of values are updated which returns from the function Cmd Table 9 variable Result MN Description This variable is used to control the function call executions If it turns to false a function call was unsuccessfully and all further function calls of the MSCSTK LIB will not be executed Table 10 variable RunProgram 4 4 2 Using the protocol box Function call void WriteText string message Color color FontStyle style Description The function WriteText outputs the string m
23. e with the starter kit hardware After the kit is connected the software and the hardware are synchronised The pin check boxes show the current status of the control pins and the button changed its function to Disconnect MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 9 of 25 3 3 2 I O history button The I O history button shows a list of all transactions between the host software and the starter kit Each entry has following information 19 192568 629 0007 Com G O 0006 LED OFF Time stamp List entry Com Command Data Command number or Transferred number port status direction command reference data G Good Input F Fail O Output Unknown Table 1 I O history line description Example 1 I O history 224094 223 9 22 029 ATEN 0012 ACK 0012 0013 ACK 0013 GOI ESET_OFF COT Gol GII R WRGREGO 0010 it This example shows the both commands RESET OFF and WRGREGO 0010 send from the host software to the starter kit and the received acknowledge from the starter kit 3 3 3 I O protocol checkbox If this checkbox is enabled each data transfer between host software and starter kit is shown in the protocol box Please consider that this function will slow down the application It should be used only for debug purposes Otherwise all data transfers could be displayed using the I O
24. ected to the TDC s pin STARTO X2 is connected to STOPO X3 is connected to START1 and X4 is connected to STOP1 or Eee N Zu ron vie FR er OD Ba X1 ero IH 99 C SB G x2 C 9 38 R42 n TE X4 Q R21 oa Eo Fo FY 7 Hille jo U10 i a zei J2 FeO MBREAYSUS 5 LED1 N 5 ii Figure 7 Layout diagram TDC10000 starter kit top view MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH x Gleiche Lebungsl ngen f r START STOP Zweig x JPS ON2 x2 NB CHARGESTP STARTA 1 OP TARTE 23 Exe vi PIN ENA PIN ENB X3 x amp c C16 c r C18 C19 100n 100n 100n 100n NPO Keramik 0806 c43 GND 2n2 Pad 74HC00 Widerstandsmessung Kapazit tsmessung Referenzwiderstand Asferenzkondensator J7 MSCSTKTDC10000RefManEng docx STARTO STOPO START STOP PINENAO PINENA User Manual MSC STK TDC10000 voc 700 i TAJO voc cs ch TAJDE M VOCHE D c10 ci2 C13 cts cn Toon Toon 100n 10wt6V ii Bussis H gi BUSDIR 33 Hev3048 RON Mao He as p WAN 5 CSN 55 42 TDO E 81 ELEREN 80 45105 N CHEETA D J 77 VOCHS 43 TD 76 Ha VOCHE DE EZ 5 17 Did 16 58 D L 58 TON R20 14 T RXDO 38 DN 14 or JET BEN 7 T TXDO D ps2 Ibis N 10 TDJ0 15 LED guen 74 AL DA gt VALDB VOCHE 1 ERA Cc CALM READYA R
25. ent resistor R mess During the resistance measurement first of all the discharging time trer of the RC combination reference resistor parallel capacitor is measured and displayed After this the discharging time tmess of the RC MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 14 of 25 combination un known measurement resistor parallel capacitor is determined and displayed In theory the unknown measurement resistor Rmeas is calculated as follows mess Ruess 01778 Rrer Fl REF When calculating the resistance of the unknown resistor via formula F1 the 22 kQ pull down resistor R18 which is in parallel to the measurement and reference resistors at the stop input of channel 0 is ignored For a more accurate calculation of Rmeas R18 has to be taken into account as follows Rrer Rig Rmess Inn F2 REF 3 Rper Rig Reer mess In this predefined function Rueas is calculated via formula F2 3 5 1 5 Capacitance measurement Clicking on the capacitance measurement button will start a capacitance measurement on channel 0 in measurement mode 3 Capacitor values between 5nF and 220nF may be determined Note Close jumpers JP4 and JP5 before measurement and remove all measurement cables from the connectors X1 and X2 Fit a resistor of 1kQ into jumper J8 JZ has to be fitted with the reference capacitor
26. essage to the protocol box The text color color is necessary using a font style is optionally Parameter Output string Color setting for the output text Font style setting for the output text Return value n a Table 11 function WriteText Function call void WriteDebug string message The function WriteDebug outputs the string message to the protocol box Return value n a Table 12 function WriteDebug AER enue Description The colour variables are used as the predefined colours for the output messages on the protocol box The values are changeable Predefined are following colours DogColor DarkGray Debug outputs Example If an Error occurs you will see this with the colour ErrColor The normal text output is done usign the colour IntColor If you press the history button the history is printed with HisColor Usually the title drawed usign TitColor is on the top of your measurement application Table 13 variable color This variable is to enable you a debug mode e g for additional outputs Table 14 variable DebugMode MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 19 of 25 4 4 3 Initialisation the hardware and control the behaviour of the MSCSTKForm form elements Function call v id IniCTDO Description The function InitTDC has to be used to initialise the sta
27. ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 6 of 25 2 Installing the hardware First of all the evaluation board has to be connected to a COM port of the PC using the provided 9 pole cable If only a 25 pole connector is available at the PC the provided extender can be used After this the evaluation board has to be powered by connecting the provided power supply to the connector J5 see figure 7 The Power LED LED2 and the Run LED LED1 showing the correct operation of the H8 processor turn on The evaluation board is ready to operate 1 Connect to a PC 2 Connect to power supply pO 3 Connect your measurement environment or your application Figure 2 Connect the starter kit MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 7 of 25 3 Installing and running the software 3 1 Host software installation The software is delivered on the starter kit CD Driver software libraries and source codes are provided The starter kit software with driver and all provided sources can be installed by starting the installer executable MSCSTKTDC Installer exe You must have administration rights Follow the instructions of the install program Afterwards the software is ready to operate P MSC TDC Starterkit SW Installer Setup asus SN MSC TDC Starterkit SW
28. lated and displayed in the protocol box together with the mini mum the maximum and the average measurement time and the standard deviation MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 15 of 25 The maximum measurement period of each measurement in mode 0 is approx tmax 6us the minimum measurement period is approx tmn Ans 5V typ Note Remove jumpers JP4 and JP5 before measurements on channel 0 because the signal lines leading to the RC measurement circuit act as additional stubs during the time measurement This will decrease the quality of the signal edges and avoid a high precision time difference measurement 3 5 1 7 N times single shots mode 3 Clicking on the n times single shots mode 3 button will start a cycle of n single shot time difference measurements using measurement mode 3 measurements of long times with automatic calibration and auto noise All calibration measurements are performed with a calibration clock period of tea 250ns After selecting the channel A for channel O resp B for channel 1 and the number of measurements n lt 2000 within a pop up window the program awaits n start stop measurements with rising edges on both the start input STARTO resp START1 connector X1 resp X3 and the stop input STOPO resp STOP1 connector X2 resp X4 Before each measurement the program executes a
29. rter kit and to synchronise the application software with the starter kit The default settings are described in table 24 Table 15 function InitTDC Function call void RestorePinSettings Description The function RestorePinSettings loads the saved TDC structure program settings to the GUI an initialised the starter kit afterwards with this settings Table 16 function RestorePinSettings Parameter Return value Function call void SavePinSettings Description The function SavePinSettings has to be used to save current program settings in the TDC structure Parameter Table 17 function SavePinSettings Function call void Wait Int32 ms The function Wait can be used to stop the current software process and to wait a defined time ms Table 18 function Wait Variable Button AutoCGonnectBultton Description This is the Connect Disconnect Button of the GUI It s useful to combine the initialisation of your special GUI elements and settings with this button Table 19 varianle AutoConnectButton label VersionLabel Description This label is partly predefined It contains the version information of MSCSTK LIB You can use this element to mark your software version It is displayed below the GUI title Table 20 variable VersionLabel Variable ProgressBar WorkingProgressBar Description The progress bar is used to show that a measurement program or others are running This
30. t lt PIN DISABLE A it PIN DISABLE B it RESET ON it RESET OFF it WRGREGO 0010 it MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 11 of 25 3 3 10 Clear protocol button The clear button clears the protocol box contents Furthermore it clears the I O and commands history 3 4 TDC starter kit measurement software commands After connection with the starter kit hardware the host software allows the user to operate with the hardware The user can input commands using the input line or can run a collection of commands written as a function for one of the user defined function buttons Each command has the following structure Opcode Parameter To communicate with the starter kit the following list of opcodes is available for the input line and the program source code Other data send to the starter kit are misinterpreted and result in an error message Opcode Parameter Description Return value Access mode wr WRGREG1 16 BitHex Writes Global Register GLOBREG1 WROFFO 16 Bit Hex Writes Offset Register OFFSETO of channel 0 wr RDKO Read the measurement results of FIFO channel 0 gt wr Opcode RD_TDC_DATA n times afterwards RDK1 Read the measurement results of FIFO channel 1 gt wr Opcode RD_TDC_DATA n times afterwards RDMREG1 Reads MODREG1 of channel 1 16 Bit Hex rd RDKOMO Reads the value of
31. tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 8 of 25 After successful connection the software shows you the connected kit The green LED turns off and the MSC STK TDC10000 application window sets up as shown in figure 5 TDC Starter Kit Measurement Software Copyright MSC Vertriebs GmbH 2010 2011 MSCSTK LIB 0 9 4 15330 Programm 0 9 4 15352 input line TDC Starter Kit Measurement Software Protocol box Search for connected starter kit hardware Connected with UART starter kit MSCSTK TDC10000 E 1 0 Protocol Clear Protocol Hardware settings LED on C PINENA1 T OSC enabled PINENAO E Debug User defined functions Channel resolution Single shot mode 0 Single shot mode 3 Resistor measurement Capacitance measurement Niimes single shots mode 0 Niimes single shots mode 3 Figure 5 Host software connected with a TDC10000 starter kit 3 2 TDC starter kit measurement software overview The application window of the host software provides the following information and functions Information about the connection status upper left corner Program switches and hardware settings on the right User defined programs on the right Command input line on the top Protocol box for information debug and dataflow outputs 3 3 Application software functions 3 3 1 Connect Disconnect button The Connect button connects the softwar
32. th a calibration clock period of tri 250ns After selecting the channel A for channel O resp B for channel 1 within a pop up window the program waits for one rising edge on both the start input STARTO resp START1 connector X1 resp X3 and the stop input STOPO resp STOP1 connector X2 resp X4 The program executes a waiting loop The waiting loop will be exited if either a start stop event takes place correct execution or a predefined waiting time has exceeded error message If a start stop event takes place the channel s FIFO is read out the measurement result is calculated and displayed in the protocol box together with the measurement values VAL CAL1 and CAL2 The maximum measurement period in mode 0 is approx tmax Bus the minimum measurement period is approx tmn Ans 5V typ Note Remove jumpers JP4 and JP5 before measurement on channel 0 because the signal lines leading to the RC measurement circuit act as additional stubs during the time measurement This will decrease the quality of the signal edges and avoid a high precision time difference measurement 3 5 1 3 Single shot mode 3 Clicking on the single shot mode 3 button will start a single shot time difference measurement with automatic calibration in measurement mode 3 measurement of long times The automatic calibration measurement is performed with a calibration clock period of te 250ns After selecting the channel A for channel 0
33. waiting loop Each waiting loop will be exited if either a start stop event takes place correct execution or a predefined waiting time has exceeded error message If all n start stop events take place all the n measurement results are calculated and displayed in the protocol box together with the mini mum the maximum and the average measurement time and the standard deviation The maximum measurement period of each measurement is approx tymax Ims the minimum measurement period is approx tmn 675ns 5V typ Note Remove jumpers JP4 and JP5 before measurements on channel 0 because the signal lines leading to the RC measurement circuit act as additional stubs during the time measurement This will decrease the quality of the signal edges and avoid a high precision time difference measurement MSCSTKTDC10000RefManEng docx Rev 4 0 Author AP AKL tdc msc ge com www msc ge com MSC Vertriebs GmbH User Manual MSC STK TDC10000 Page 16 of 25 4 Creating your own measurements programs 4 1 Software requirements To create your own measurement programs you have to fulfil the system requirements of the starter kit software and to install a C development suite In the following chapter we apply to the Microsoft Visual C 2008 Express Edition 4 2 Create your own C project First you have to set up a new project using the predefined template Windows Form application Afterwards you have to add the necessary files to your proje
Download Pdf Manuals
Related Search