Home

Three-axis Magnetometers THM1176 and TFM1186 User`s Manual

1. eee ee eere 35 e E E E i Ss EE TE 35 o MEIN dm lo E 36 ee ame CALDO MET 37 D EE ee obiil MM KM c IE MIDI D I 37 rs ME EPIC 38 A RITE 38 IT ETR olol iii www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA OA rc 39 SS Ei RESET 40 5 9 MEASure FETCh_READ RTT 40 an I lee 42 5 11 Read SIB W TIMEOU T 42 Se READ WE 42 o EL MEET C T Iu TL R ees 43 1A Revision desea ice M 43 cu SU c 44 dl Kobe LEE 44 E ATI C Rec a 45 e ele E RT m 46 SA TRIGO mr 4T GLAUBE E O70 48 Se EE e Le EE 48 PROGRAMMING THE THM1176 TFM1186 eere 49 SM USB NGM M EE ILLUM 49 e CERE EE 49 6 2 SOIT instrument Mode Lusssesssaptessusuntubin rubi bcUDocm nu Indus cua Dadken vadib dxdcbG Kad brad haa iautanaiensinaeidaadednianusion 50 6 3 IEEE 4898 27 SCPI status e EE 53 6 4 USBTMC USBA88 Controls hee 56 6 5 IEEE 488 2 Common Commandes 57 60 SOCPrCOMMaN
2. Immediate trigger default Approx 6 8 kSa s free running until internal buffer is full Timed trigger Into internal buffer 0 36 Sa s to 5 3 kSa s jitter 0 2 us std dev During USB readout 0 36 Sa s to 2 3 kSa s jitter 1 2 us std dev Bus trigger via USB Up to approx 400 Hz until internal buffer is full Notes 1 sample By By Bj Internal buffer size 4096 samples DC to 1 kHz Resolution THM1176 MF 0 1 mT THM1176 HF HFC 0 3 mT THM1176 LF 2 uT TFM1186 4 nT Notes Averaging of N measurements improves the resolution by approximately NN Accuracy THM1176 MF HF HFC 1 of reading or specified resolution whichever is greater THM1176 LF 20 uT TFM1186 0 5 of reading and 100 nT Notes The accuracy is given for arbitrary field orientation typically it is approximately x10 better along the primary axes T ETR olab 3 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA User offset correction To be performed before each series of measurements in Zero Gauss Chamber supplied Notes Does not apply to TFM1186 see Section 2 4 7 2 INTERFACE USB 2 0 full speed 12 Mbps Class USB driver USBTMC USB Test amp Measurement Class USB488 DFU Device Firmware Upgrade Power USB bus powered 4 3V to 5 25V 35 mA min idle power saver on 90 mA max Wake up time from power 100 ms saver
3. 26 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Zoom Out Zoom Out about Point click a point to zoom out from lt Shift gt see above o Zoom to Fit auto scale x and y scales to show entire graph e Panning Tool Picks up plot and moves it around in graph On the desktop version additional tool palettes can be enabled by right clicking on graph and checking items under Visible Items e Plot Legend Display names and colors of displayed graphs Scale Legend Select manual or auto scaling and change appearance of axes and grid lines Cursor legend manage cursors The cursor palette contains the following tools for each cursor FFT displays only Cursor name Current X and Y values Enable or disable movement with keypad Change the cursor appearance Allow the cursor to move freely snap to the nearest data point or lock onto a field component Keypad for moving the enabled cursor s left right up or down Digital display Raw sDev P P displays only e X Scroll bar Scroll the time axis Note that this display is not intended to make publication quality graphs of your data For this record the data to a file using the File screen and use a program like Excel or Matlab to make your plots Display is affected by settings in Setup and File pages Mm ETR O a 27 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright
4. 2014 Metrolab Technology SA 4 3 FILE DISPLAY PURPOSE Record measurements to a file and review recorded data IHDD Users keller Desktop 4 1THM1176 Record txt CONTROLS Record comment X k See Section 4 1 e a button Choose and or create a Recording file Starting block Record comment Optional comment describing current measurement Record Start stop recording Starting Ending block Range of blocks to review Delay Delay between blocks reviewed e 0s 0 1s 15 3 s Delay as specified e Hold Hold after each block Review Start stop review mode Review mode plays back the data as when measuring live All display and alarm options are available Units Hold See Section 4 1 DISPLAYS Record file Name of recording file Record light Recording in progress B Rate See Section 4 1 NOTES To enter a comment or starting ending block number on a PDA press the k button to bring up the on screen keyboard Remember that Windows Mobile offers multiple input methods including handwriting recognition Recording to an existing file appends the new data By default the entire file is reviewed but you can review only a part by setting the Start and Stop block numbers me TR olaly 28 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA The thermometer graphically displays the Start and Stop block numbers You can
5. o Comment as entered on the File panel Every line is terminated by an end of line marker s Some PDA USB Host adaptor cables may not have a power connector Plug the AC adaptor into the DC in connector on the PDA instead e f you plug the THM1176 TFM1186 into the PDA before the PDA completes its initial boot procedure you will see an Unidentified USB Device dialog oimply unplug the THM1176 TFM1186 cancel the dialog and plug the THM1176 TFM1186 back in when you see the PDA s Today screen e f you are using a Windows PC the Windows Mobile Device Center or Microsoft ActiveSync software will simplify file transfers between the PDA and your PC Please refer to the SoMo Quick Start Guide The PDA Reinstall directory on the THM1176 installation CD contains the files and instructions required to reinstall the PDA software IT ETR olol 15 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 77 USING THE THM1176 TFM1186 3 Overview This chapter provides a quick overview of what you can do with the THM1176 family of instruments Additional details are provided in subsequent chapters 3 1 MEASUREMENT e Three axes Simultaneous measurement of all three axes of the magnetic field provides the total field no matter the orientation of the probe Field sensitive volume On the THM1176 MF HF and HFC a microscopic Hall sensor volume provides localization to a fr
6. The parameters in the command contain an unmatched single or double quote Standard Commands for Programmable Instruments see Section 6 1 for the complete reference T ETR olol 84 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 2 6 171 Invalid expression The parameters in the command contain an unmatched bracket 9 3 200 EXECUTION ERRORS 9 3 1 221 Settings conflict Indicates that a legal program data element was parsed but could not be executed due to the current device state e Starting an acquisition when trigger is not enabled e Sending a bus trigger when trigger is not enabled when the trigger source is not BUS or when the expected number of triggers have already been received e Sending a CALibration INITiate FETCh INITiate IMMediate ALL READ or SENSe FLUX RANGe command when triggers were enabled in BUS trigger mode e Sending an INITiate CONTinuous command when in IMMediate trigger mode e Sending SYSTem SLEEp when trigger is enabled 9 3 2 222 Data out of range Indicates that a legal program data element was parsed but could not be executed because the interpreted value was outside the legal range as defined by the device s A numeric parameter is smaller than the allowable minimum or larger than the maximum Acharacter parameter does not match one of the allowable choices e FETCh fetching more data than what was
7. 27 2000 available from http www usb org developers docs usb20 docs usb 20 031114 zip e USBTMC and USBTMC USB488 oee Universal Serial Bus Test and Measurement Class Specification USBTMC Revision 1 0 April 14 2003 and Universal Serial Bus Test and Measurement Class Subclass USB488 Specification USBTMC USB488 Revision 1 0 April 14 2003 available from http www usb org developers devclass docs USBTMC 1 006a zip e SCPI See Standard Commands for Programmable Instruments SCPI VERSION 1999 0 May 1999 available from http www ivifoundation org docs scpi 99 pdf me TR olab 49 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA IEEE 488 2 see IEEE Standard Codes Formats Protocols and Common Commands for Use With IEEE Std 488 1 1987 IEEE Standard Digital Interface for Programmable Instrumentation IEEE Std 488 2 1992 available from http standards ieee org reading ieee std public description im 488 2 1992 desc html VISA see VPP 4 3 The VISA Library VPP 4 3 2 VISA Implementation opecification for Textual Languages VPP 4 3 3 VISA Implementation Specification for the G Language VPP 4 3 4 VISA Implementation Specification for COM all Revision 2 2 March 17 2000 by the VXI plug amp play Systems Alliance available from http www ivifoundation org Downloads Specifications htm 6 2 SCPI INSTRUME
8. Apply Apply modifications without closing dialog IT ETR O a 31 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA OK Apply modifications and close dialog DISPLAYS Current parameter values when dialog is opened NOTES To enter parameter values on a PDA press the blue keyboard button at the bottom of the screen to bring up the on screen keyboard Remember that Windows Mobile offers multiple input methods including handwriting recognition To fix error conditions indicated by red Rate light Buffer overrun increase block size Timer overrun reduce Timer rate and or Averaging count Lossy compression reduce compression The Timer Period rather than Rate is the quantity used by the instrument The period is rounded to the nearest processor clock cycle 24 MHz The Block size rather than Block Rate is the quantity used by the instrument The size is limited to that allowable by the instrument For all trigger modes except Timer Continuous the software enables Hold after each block For Bus triggers this behavior can be overridden By default bus triggers are generated manually By modifying a single sub VI the trigger can be synchronized with external events Data averaging reduces the noise the peak to peak noise level will be reduced by approximately the square root of the Averaging setting The data points are acquired
9. Error in no error Error out status code Jf Oo status code E dp source ican source 9 14 REVISION QUERY Revision Query ViSAresource Dup VISA resource M THM1176 Description Info FW version l 0 Cal Date Cal gt 18 mo di Instrument Driver Revision Error in no error status code 4 ZE source MetTrrRo lab Reset the instrument to startup settings Averaging 1 Acquisition buffer empty Trigger source Immediate Trigger count 1 Trigger timer 100 ms Range Auto Calibration state On Units Tesla Format ASCII Status cleared enable registers reset Queries the current instrument firmware revision and instrument driver revision THM1176 Description In Description string returned by IDN command If empty an IDN command is performed automatically Info Out Instrument information returned by IDN command formatted to be legible F W version Out The revision of the instrument firmware Cal Date Out Date of the last calibration Cal 18 mo Out True if the instrument was last calibrated more than 18 months ago the recommended calibration period Instrument Driver Revision Out The revision of the instrument driver software 43 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 15 SELF TEST Self Test Run instrument self test Note
10. The USB bus trigger command can be used to synchronize the acquisition with external events The instrument allows up to about 400 bus triggers per second e Acquisition buffer The THM1176 TFM1186 contains a local memory capable of holding 4096 samples allowing data to be acquired more quickly than it can be read out by the USB interface e Averaging Averaging can reduce measurement noise The degree of averaging is controllable since long integration periods might be beneficial for static fields but counterproductive for time varying fields The THM1176 family uses a simple arithmetic mean and performs N measurements of each axis in succession for example for N 3 the measurement sequence would be Bx Bx By By By By Bz Bz Bz T where T is temperature When performing multiple measurements into the acquisition buffer the temperature is also averaged in order to take into account temperature drift during a lengthy measurement sequence e User offset correction not for TFM1186 see Section 2 4 To guarantee the specified accuracy the measurement offset should be checked before each measurement sequence using the zero gauss chamber supplied If needed the offset correction procedure will measure and correct this offset The correction value is written to flash memory so IT ETR O au 17 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA that the same c
11. TleTmo o Magnetic precision has a name Three axis Magnetometers THM1176 and TFM1186 User s Manual Version 1 3 Revision 1 3 November 2014 THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA REVISION HISTORY v 1 0r 1 0 May 2008 v 1 0r 1 1 May 2008 v 11r 10 July 2008 December 2009 Updates for version 3 x of software Updates for version 2 x of firmware Updates for THM1176 LF Various fixes v 1 2 r 1 1 February 2010 Add notice concerning WEEE Directive v 1 2r 1 2 July 2010 Restore formatting of HF dimensions Update for software release 4 0 and firmware release 3 0 Update links for external documentation Add documentation for THM1176 HFC April 2014 Add documentation for THM1176 MF TFM1186 Adapt documentation for SoMo 655 Remove references to electronic newsletter Update links to USB documentation Update for LabVIEW Mobile Module end of life Miscellaneous clean ups November 2014 Update for different versions of THM1176 MF and THM1176 HFC sensor Correct section numbering in Chapter 5 IT ETR O a li www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA CONTENTS GETTING STARTED siscravia eR dA RODERRORUE E ed CIE RUE OC CERO UD AER CR E D CER d ER a RR ERR dA 6 t oh de e TT d Le 1 EE D GETTING STARTED NEEN 8 2 Quick Start Guide NENNEN ENNEN ENNEN ENKEN 8 2 1 Using the THM1176 TFM1186 with
12. contain units as specified by the UNIT command In addition some units can have prefixes N nano 10 U micro 10 M milli 107 K kilo 10 MA mega 10 The table below lists the units supported by the THM1176 family Note that different models recognize different ranges of magnetic field strength units depending on their measurement range all model recognize T Tesla Mm ETR olol 58 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Magnetic field strength Tesla default MAHZP Megahertz proton Gauss Gauss Other JL L3 La The following tables list the legal commands for the THM1176 family in alphabetical order oem Reset the trigger system Aborts acquisition in progress Disables trigger Disables continuous trigger CALCulate AVERage Ge MAXimum DEFault Command Parameters Description scabibration ff I INITiate Initiate the offset correction procedure in zero gauss chamber correction eege Set calibration state whether or not temperature and gain calibration is applied ON by default boolean DEFault IT ETR olol 59 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description DIAGnostic Initiate a firmware upgrade UPGROOS The instrument will Lea puei
13. electronics torn cable etc We do not assume responsibility for consequential damage for example to your PC IT ETR olol 23 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA USING THE THM1176 TFM1186 4 Software User Interface The THM1176 TFM1186 can be used as a laboratory instrument plugged into a Personal Computer PC or optionally as a handheld instrument The display of the handheld instrument will vary slightly from the illustrations below however the utilization is the same except when noted 4 1 NUMERIC DISPLAY PURPOSE Numerical display of last measurements CONTROLS X Quit Help k Display hide on screen keyboard PDA only Max When checked capture and hold the absolute maximum of the associated display This allows you to find the approximate maximum field strength in a volume Bx By Bz Selects the axis along which to orient the vector display Target F Approximate frequency of peak to be measured Zero finds highest peak other than DC FFT displays only Data display selector Raw last measurement sDev Standard deviation of last block of measurements P P Peak to Peak amplitude of last block of measurements FFT FFTx FFTy FFTz amplitude and frequency of selected peak of FFT B Bx By or Bz respectively In addition shows last B value Units The units in which to display the m
14. in a single burst at the maximum acquisition rate mM ETR O a 32 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 4 6 ALARM SETUP DIALOG PURPOSE SetupAlarm vi Aaa Set field limits for visual and or audio Alarm UT di alarms Raw sDev P P Z Audio Enable or disable audio alarm in Min Min J 20 9 H S Raw sDev P P Each column provides the Max Max limits for the corresponding display p J OFF B Bx By Bz Whether to enable corresponding alarm and whether the limits apply to B Bx By or Bz Min Max lower and upper limits in currently selected units Help Open this help window Cancel Close dialog without modification Apply Apply modification without closing dialog OK Apply modification and close dialog DISPLAYS Current parameter values when dialog is opened Units Currently selected units NOTES To enter parameter values on a PDA press the blue keyboard button at the bottom of the screen to bring up the on screen keyboard Remember that Windows Mobile offers multiple input methods including handwriting recognition IT ETR olol 33 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 4 7 BUS TRIGGER DIALOG WaitForBusTrigger vi Triggers 2 No requested 8 Help Cancel PR Trigger MetTrrRo lab PURPOSE Generate triggers in Bus triggered
15. move the thumbs When recording Stop displays the last block recorded Recording is affected by settings in Setup page Mm ETR olol 29 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 4 4 SETUP DISPLAY PURPOSE Sets up all measurement parameters ___ 0000160 me nfo Metrolab Instruments SA THM1176 LF 0000160 CONTROLS elC1 prC1 fw3 0 X k See Section 4 1 a Pate lee Serial no Select active instrument Software REV 4 0 01 2012 LabVIEW 2010SP1 Range Select range or auto ranging HERR 0 008T Measure Setup Open dialog to set up measurement parameters alarms Offset zero Place probe in a zero Gauss chamber to measure and correct this instrument s zero offset ae NN Alarm Setup Open dialog to set up Recall reet Save Recall Save recall software and instrument settings Reset Reset settings to the factory defaults Units Hold See Section 4 1 DISPLAYS Info Information returned by instrument Cal date Date of last calibration Red if recommended calibration interval has expired Software Versions of this software and support library Thermometer Field strength as fraction of selected range Not shown when auto ranging B Rate See Section 4 1 NOTES me TR olab 30 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 4 5 M
16. probe cap can be removed reducing the thickness to 4 1 mm If needed the THM1176 MF or HF sensor only 2 3 mm thick can be separated from the probe plastic note however that the sensor wires are delicate and can easily be broken For even smaller gaps use a THM1176 HFC whose probe is only 0 5 mm thick Stationary installation THM1176 MF and HE only Removing the cap also reveals a mounting point that allows the probe to be permanently mounted or attached to a scanning arm The exact position of the field sensitive point can be determined by optical sighting T ETR olaob 19 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA 3 4 DESKTOP KIT Acomplete magnetic field measurement kit The desktop kit includes everything except the computer the THM1176 TFM1186 instrument calibration a zero Gauss chamber not for TFM1186 see Section 2 4 the National Instruments VISA runtime library and USBTMC driver turn key measurement software all the LabVIEW source code software licenses from Metrolab as well as National Instruments and this manual Measurements out of the box Install the VISA Runtime library and measurement software and plug in the THM1176 TFM1186 The software allows you to o Display B Bx By and or Bz either numerically or on a graphical display o Display either the raw data or computed peak to peak standard deviation or spectra
17. to the unlocked position up and 2 pressing the Power button on the top right hand corner of the front of the PDA e f you have not done so yet plug the short USB Host adaptor cable into the USB synchronization cable connector on the bottom of the PDA Plug the THM1176 TFM1186 into the USB Host adaptor cable 2 2 2 Handheld Measurement Press the big button on the right side of the PDA to start the measurement software Alternatively you can use the THM1176 icon in the Programs folder of the Start menu Press the big button on the left side of the PDA to bring up the virtual keyboard Press it again to hide the keyboard The software should show and hide the keyboard automatically when appropriate Besure to stop the measurement software using the Stop button before turning off the PDA or unplugging the THM1176 TFM1186 see the note below e Manipulate the probe and check the offset as described in Section 2 1 3 2 3 SOFTWARE DEVELOPMENT e Insert the installation CD e Copy the Source folder to your hard drive The API subfolder contains the Application Programming Interface see 5 Application Programming IT ETR olol 10 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Interface The UIF folder contains the source code of the THM1176 measurement software e Modify the THM1176 measurement software or write a measurement system from sc
18. value in list One or more values in a numeric list parameter are invalid e g floating point when not allowed 9 5 2 103 Wrong units for parameter A parameter within the command has the wrong type of units for the command 9 6 200 INSTRUMENT DEPENDENT EXECUTION ERRORS 9 6 1 200 Software Error The firmware has encountered an unexpected error IT ETR olol 86 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA e the User Offset Zero file has been corrupted e the ADC driver returned an unknown error code s the command parser or dispatcher returned an unknown error code encountered an error formatting a result e could not open one of the data files file unable to perform reset encountered an unknown choice for character data e encountered something other than a value MINimum MAXimum or DEFault for a numeric parameter encountered something other than a Boolean or DEFault for a Boolean parameter or e encountered an unknown parameter type Please report to Metrolab the circumstances under which you received this error 9 6 2 204 Data buffer was overrun In timed trigger mode data was lost because the read out did not keep up with the acquisition 9 6 3 205 Measurements were over range The field value exceeded the selected range 9 6 4 206 Timer was overrun In timed trigger mode a measurement was still in progress when the timer t
19. verify that the instrument identifies itself as a THM1176 TFM1186 Reset In Reset the instrument after opening a session to it THM1176 Out Instrument identified itself as THM1176 TFM1186 Only valid if ID Query is selected THM1176 Description Out Instrument description returned by IDN command Only valid when ID Query is selected Ranges Out List of the ranges supported by this instrument in T Only valid when ID Query is selected Units Out List of the units supported by this instrument Only valid when ID Query is selected Divisors Out List of the divisors for each of the units supported by this instrument If you fetch the measurement values in INTeger FORMat you have to divide by this number to convert to the given units Only valid when ID Query is selected Performs a measurement and parses the result Function In Selects the function to be performed MEASure Abort any pending triggers and perform measurements using the default acquisition parameters o Continuous trigger initiation off o Trigger source immediate o Apply calibration correction o No averaging READ Abort any pending triggers and perform a measurement with the existing parameters FETCh Fetch data values acquired during last MEASure READ or INITiate Note The following actions invalidate 40 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Tec
20. which makes the amplitude questionable As shown in the figure below taken from the IEEE 488 2 standard each of the registers above is actually a set of three registers S2 1 0 Condition Register Transition Filter TN oN Selects which transitions of Condition bits will set event bils Event Enable Register Selects which Events can set the Summary Message J or 1 or both Event Register Latched Conditions Logical AND of latched event condition bit with corresponding event enable bil Logical OR Summary Message o Condition Register Read only register that is constantly updated to reflect the current state of the instrument o Event Register Transitions in a Condition Register are latched in the corresponding Event Register The THM1176 TFM1186 only latches transitions from O to 1 Event Registers are cleared when read T ETR olols 55 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Event Enable Register A mask indicating what bits in the Event Register are included in the Summary bit The enable mask of the Status Byte is called the Status Enable register and it determines which bits cause an RQS ReQuest for Service 6 4 USBTMC USB488 CONTROLS The following functions are supported directly by the USBTMC USB488 protocol Historically these correspond to dedicated hardware signals in IEEE 488 1 HPIB or GPIB INITIAT
21. 7 3 OPERATING CONDITIONS Operating temperature 0 C to 40 C Storage temperature 20 C to 60 C Operating magnetic field Instrument electronics 3 T max Mm ETR O a 14 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 7 4 MECHANICAL THM1176 MF HF Dimensions Instrument electronics 76 x 22 5 x 14 mm Probe with housing 113 x 16 x 10 mm Probe without housing 10 mm thick 4 1 mm thick 16 mm Cable length THM1176 MF 3 m optionally 6 m THM1176 LF 6m Notes Includes 1 m of USB cable Weight 160 g 3 m cable 290 g 6 m cable Stationary mounting point For M2 5 screw not included Note to avoid breaking the mounting point use a spacer and do not over tighten the screw T ETR olab 19 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Sensor dimensions THM1176 HF THM1176 MF Probe version C17 Probe version A0 Probe version A1 Probe version BO Notes Notes Notes Notes marks the centre of the field r marks the center of the field r marks the center of the field marks the center of the field sensitive volume sensitive volume sensitive volume sensitive volume All dimensions are in mm All dimensions are in mm All dimensions are in mm All dimensions are in mm Tolerances are 0 4mm Tolerances are 0 4mm Tolerances are 0 1mm except the Tol
22. CE 9 Error Codes Error codes returned by the USB Interface are numbered according to the SCPI standard Sections 21 8 9 through 21 8 16 of Volume 2 of the SCPI manual Command Reference provide a generic description of all possible error codes In general the codes are between 800 and 300 This chapter describes only the error codes produced by the THM1176 TFM1186 and the circumstances that might produce each error In addition to the SCPI errors the THM1176 Application Programming Interface might produce additional errors in the range of 1073807360 to 1073807192 and 1073676290 to 1073676457 OxBFFFOOxx and 3FFF00xx the former are errors and the latter are warnings These are VISA error codes and are not documented here See the LabVIEW on line help under VISA Error Codes or right click on the error indicator and select Explain error 9 1 0 NO ERROR Zero indicates no error 9 2 100 COMMAND ERRORS 9 2 1 102 Syntax error The command header did not match any of the known commands 9 2 2 104 Data type error A parameter within the command was of a type invalid for the command 9 2 3 115 Unexpected number of parameters The wrong number of parameters was given in the command 9 2 4 123 Exponent too large The command contains a numeric parameter that was too large to be stored internally This occurs if the value has an exponent greater than 43 9 2 5 151 Invalid string data
23. E CLEAR Clears the device input and output buffers TRIGGER Assert bus trigger SRQ Requests service from host READ STATUS BYTE Read status byte REN CONTROL Remote Enable no effect GO TO LOCAL Enable local controls no effect LOCAL LOCKOUT Disable local controls no effect IT ETR olol 56 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 6 5 IEEE 488 2 COMMON COMMANDS As any IEEE 488 2 compliant instrument the THM1176 family supports the following commands Clap Clear status Clear all event registers and queues not enable registers and error buffer ESE Program event Program standard event enable register lt NRI gt enable TESE Event enable query Read standard event enable register ESR Event status query Read standard event register and clear it TDN Identification query Returns the following information manufacturer model serial number and version of electronics probe and firmware Note that this query returns Arbitrary ASCII Response Data see IEEE488 2 standard and cannot be followed by another query in the same command sequence OPG Set operation Set the operation complete bit in the complete standard event register after all commands have been executed OPC Operation complete Returns an ASCII 1 after all commands query have been executed ROI Reset device to power on configuration SORE lt NRf gt Program s
24. EASURE SETUP DIALOG Setup THM1176 vi PURPOSE Period s Rate Hz Timer 10 00m 100 0 Size Rate Hz Block 10 10 00 CONTROLS Timer Period Rate Measurement acquisition rate Set up measurement parameters Timeout ms Averaging e Timed trigger Specify desired period or rate Trigger Timer cont Immediate trigger Empirically Timer determined acquisition rate is shown and cannot be changed Bus trigger Meaningless since the rate is determined by the triggers However an approximate rate can be given for calculating time stamps Block Size Number of measurements buffered in the instrument s local memory before transferring to the computer Immediate Bus Compression 1 1 1 2 t Block rate Rate of transfer of data blocks Depends on both the acquisition rate and block size can be used to set the block size Timeout Timeout period for an acquisition Averaging Number of data points that are averaged together for each measurement Trigger What starts an acquisition e Timer cont a timer at the specified rate Triggers continuously Timer a timer at the specified rate Triggers stop when one block has been filled Immediate free running acquires as quickly as possible and stops when one block has been filled Bus acquires when triggered via USB Triggers stop when one block has been filled Help Open this help window Cancel Close dialog without modifications
25. FM1186 If upgrades become available you will be able to download them from the Metrolab website download metrolab com To build your own handheld applications you will need the LabVIEW Mobile Module from National Instruments www ni com LabVIEW 2011SP1 or earlier 5 1 GENERAL The VIs in the programming API have two standard inputs VISA resource VISA resource name that specifies the instrument with which we want to communicate e Error in a standard error structure describing errors in previous VIs and two standard outputs e Dup VISA resource a copy of VISA resource number Error out describes errors that occurred in this VI or in previous ones As is common practice in LabVIEW the connectors for these standard inputs and outputs are located on the four corners of the VI s icon In a sequence of VIs the standard outputs of each VI are wired to the standard inputs of the succeeding VI as shown in the example below T ETR olab 35 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Error ih no error o SENSe Y NITiate Dup VISA resource VISA resource dr TIMer e Ergor out Period s This chaining serves two purposes it forces the VIs to be executed in the given order and it stops the execution of the chain if an error occurs In fact each VI checks whether its Error in input indicates that an error has occ
26. NT MODEL The THM1176 TFM1186 complies with the Standard Commands for Programmable instruments SCPI standard SCPI uses a standard instrument model to organize the command structure The diagram below shows the subsystems concerning the signal flow Measurement Function signal NPut SENSe CALC FORMat 9 Routing ulate 4 r1 nee TRIGger MEMory Signal OUTput SOURce CALC FORMat Routing ulate Signal Generation Mm ETR olol 50 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA The following table provides a summary of the instrument capabilities organized according to the SCPI instrument model The supported commands include IEEE 488 2 Common Commands start with as well as SCPI commands Many commands have additional options or query forms to return the currently set value see later sections for details In addition to ASCII commands the THM1176 TFM1186 also supports certain USBTMC USB488 controls also noted in this table Functional Commands Block Measurement MEAGure Measure with standard settings Function Equivalent to RST READ Measure with custom settings Equivalent to ABORt INITiate FETCh Fetch measurem
27. Note that during calibration Metrolab use a bend radius of 20 mm using the entire length of the sensor PCB The gold conductive traces should be on the inside of the bend SPECIAL NOTICE FOR THE TFM1186 T ETR olab 13 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA SPECIAL NOTICE FOR THE TFM1186 gt Do not use the zero offset correction feature with the TFM1186 In fact the fluxgate sensor is so sensitive that most zero gauss chambers are completely inadequate and the zero offset procedure will introduce a large offset error If the zero offset procedure is accidentally executed the factory offset can be restored using the CAL ZERO command see Section 6 6 2 5 NOTES e he orientation of the axes relative to a THM1176 probe is as follows X For the TFM1186 the axis orientations are printed on the sensor e Arecording file is an ASCII file organized into columns delimited by tabs o Block sequential number for block of measurements o B total field o Bx By Bz X Y and Z components of field respectively me TR olol 14 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Units as selected when the data was recorded o Temperature the units are arbitrary i e not calibrated in degrees o Timestamp date and time with 1 ms resolution o Serial No instrument serial number
28. OS csie e a E a Erran aea 57 O E Giele ie EMU miri TEE Um 70 REFERENC E 73 7 Technical Specifications 1 eeeeeeeeee eee eee esee enne nena nnn nnns 73 TM ME un EU nec cake ees eee ene sneer coe eos titan 73 ME ice ETE S 74 7 3 Operating ee re Le 74 7 4 Mechanical THM1176 MF HF sssssesssssesseeeeee eee nn nnn nnns iren nnn nnne nnn nnns 15 7 5 Mechanical THM1176 HFC a 77 7 0 Mechanical THM 1176 LF 78 l Mechanical TFM T180 snares aA A EEE E E EESE RARES 78 y DESKOD EE 79 7 9 Handheld KEE 79 7 10 Warranty Calibration Certification and Mamtenance nennen nnne 80 pa gl ao aly Oo Seen ee en een ee ee eee E EE 81 8 THM1176 MF HF HFC Sensor Details 81 REFERENCE E 84 9 ENO COGS mec M 84 IT ETR O a iv www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA FT ING MON RR Tm eem 84 9 2 2100 Command e e 84 E OZ 70 4 1170 MEC 84 D222 SPOR VIIa Ty DO C11 OF qe 84 9 2 3 115 Unexpected number Of poarameierg esses sees eene nn ases a anna nnns a nna 84 9 2 4 123 X eei uics io m 84 E WEE ee Nee SUING ONG m R a 84 9 20 171 Invalid CXDICSSION PE 85 9 3 200 Exec tion E e 85 so MEME ust uoo CONT mm PEN 85 DE HEB q
29. R O a 22 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA failure may render the instrument unusable Metrolab has made every effort to make the process foolproof but please take your time and follow the instructions provided with the upgrade carefully e Upgrades to the PDA software To comply with the license associated with the LabVIEW Mobile Module Metrolab distributes upgrades to the PDA software in an encoded file You need to contact Metrolab for the password for this file Please send an e mail with your instrument s serial number to contacts metrolab com The serial number is printed on the label located on the instrument electronics It is also displayed on the Setup page of the measurement software e Repairs Due to the highly integrated construction of the THM1176 family Metrolab cannot replace individual electronic components If you send an instrument back for repair we will send you a replacement unit at a standardized exchange price please contact Metrolab for a quotation The replacement unit may contain parts recovered from units previously sent in for repair however it will of course be fully tested calibrated and guaranteed e Warranty The standard warranty period is two years from the date of purchase During this period Metrolab will replace a failing unit free of charge unless it is clear that the unit has been abused crushed probe or
30. Response returned by neut CURED oa instrument when command was executed 10000 Status code r T omm status code P e ser i o 4 amp Error description Out List of error cb 1024 descriptions returned by instrument Status Bytes Out If querying currently selected units returns the currently selected units Mm ETR olol 48 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA PROGRAMMING THE THM1176 TFM1186 6 USB Interface 6 1 GENERAL The THM1176 family instruments communicate with a host either a Personal Computer PC or a Personal Digital Assistant PDA via a Universal Serial Bus USB interface If you use the LabVIEW driver or programming API it is generally not necessary to refer to the information in this chapter You may however want to write a LabVIEW program optimized for your application bypassing or complementing the general purpose API provided by Metrolab This chapter will provide you with the information necessary to do so The THM1176 family was designed to plug and play with a Virtual Instrument ooftware Architecture VISA compliant software library in particular the NI VISA library from National Instruments see http www ni com If you are not using NI VISA you will probably need information that is not provided in this chapter e USB 2 0 See Universal Serial Bus Specification Revision 2 0 April
31. T TEMIL2 67 XD T MINimum MAXimum DEFault setting AUTO lt boolean gt DEFault Set auto ranging ON or OFF ON by default ALL Return a list of all the ranges supported by this instrument in T Command Query set OPERATION MEN gt OPEReation BN eee event register a Parameters Read operation condition SCONDITETODn 0 by default register sets Read operation condition register Query enable register SCONDTETOnDn ENABle numeric value Set enable register 0 by default PRESet Reset OPERation and registers EVENCt Read and clear operation event register E IT ETR O a 67 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description SYSTem E WE Eer NEXT tery error queue S uRSt on Query SCPI version 1999 ot HEADers a List all available commands SYNTax List syntax for a command SLEEp Power down the acquisition electronics Power up is automatic at the next acquisition but takes approximately 100 ms IT ETR olol 68 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description TRIGger RSR RE COUNT MINimum MAXimum Query trigger count DEFault COUNC value MINimum Set the number of triggers MAXimum DEFault required to complete an a
32. TR olab 6 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA You can also download the latest firmware software and manual free of charge We post all updates on our website Section 3 6 provides some additional details We hope the THM1176 TFM1186 will help you perform your magnetic field measurements easily and accurately If you have problems and your reseller cannot help you further the Metrolab team is ready to help Even if you don t have problems we are always interested in knowing more about how our instruments are used Feel free to contact us at any time at contacts metrolab com IT ETR O a www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA GETTING STARTED 2 Quick Start Guide 2 1 USING THE THM1176 TFM1186 WITH A DESKTOP COMPUTER 2 1 1 2 1 2 PC Software Installation Insert the installation CD Install the National Instruments LabVIEW Runtime Engine 2010 SP1 by double clicking on PC LVRTE2010sp1std exe Install the National Instruments VISA Runtime Library by double clicking on PC visa51 1runtime exe Install the THM1176 software by double clicking on PC THM1176 setup exe Mac Software Installation Insert the installation CD and open the Mac directory Install the National Instruments LabVIEW Runtime Engine 2010 SP1 by double clicking on Mac mac LabVIEW 2010sp1 Ru
33. TR olol 19 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA PDA type PDA size PDA weight Display Input Device Connectors Power jack 2 5mm audio headset jack 26 pin connector for ActiveSync USB 1 1 host and USB 2 0 client CompactFlash and SDIO expansion slots Audio Memory Wireless LAN Bluetooth Minimum 3 hours neg Battery life with probe Minimum 3 hours THM1176 LF ASCII tab delimited compatible with Desktop file format Pre loaded software Acquisition software same functionality as desktop software Word Mobile Excel Mobile PowerPoint Mobile Outlook Mobile IE Mobile MSN Messenger Client Windows Media Player 10 2 Mobile ActiveSync Client Socket Mobile Wi Fi Companion Programmable Home Screen Calculator Utility programs PDA operating temperature 0 to 50 C PDA operating magnetic 1T max The PDA may experience forces as high as 50 N field Note The touch screen of the PDA will cease to function The power of the PDA must be cycled to restore full operation 7 10 WARRANTY CALIBRATION CERTIFICATION AND MAINTENANCE Recommended calibration 18 months 3 Axis Hall Probe only interval Note that for logistical reasons Metrolab recalibrates the THM1176 in batches Four weeks in the year are fixed to perform batch calibrations Week 10 Week 24 Week 37 Week 50 To benefit from the discounted pricing for th
34. This allows precise position determination as well as consistent measurements of all three components even in highly inhomogeneous fields me TR olol 81 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA But MAG3D contains much more than the Hall elements To build a Hall magnetometer we need to supply a current and measure a voltage By increasing Bonding connectic Ami d Sensing part x x AE v de T VH single Y HH VH single Y i i FS enge 3 I VH single Y Z VH single Y PAG i DEHE AL I electronics f SHP 2 Lp a yo e sh x 200um Read out electronics and buffers La the current and or amplifying the voltage one can increase the sensitivity All this is done on the IC the external electronics only supplies 5V power and two digital lines to select one of four ranges This represents a tremendous simplification of the magnetometer as a whole Image courtesy of Senis GmbH But there s more All Hall magnetometers suffer from measurement offset in other words the instrument measures a non zero result even in a zero field What s more this offset varies with time and temperature One should calibrate the instrument in a zero gauss chamber before each use and the instrument has to continuously correct the measurement for temperature variations Even so offset remains a significant source of error Where
35. a desktop Computer 8 2 1 1 PG Software Installation EE 8 2 1 2 Mac Software lnstallaton nhenh nnne hnsemeenseseensese esset e sese e seen 8 2 1 3 PC or Mac Measurenment nen hehnne nh hensetenssn se ensesss sensa tes tasses sees teas annann 9 2 2 Using the THM1176 TFM1186 with the Handheld nnn 9 EIE E eet Ee 9 2 2 2 E elle Ee MEET TE 10 2 3 Software Development 10 2 4 PLOCAWM ONS EE 11 e Te 14 USING THE THM1176 TFM11860 0 0 cc ccce cece eee ceeeceeeeececececececececececececeeeaeeeness 16 3s J OVeEFVIOW EEN 16 3 4 ERT e EE 16 CM nitidi e RR 18 3 3 Probe Mechanical Design P 19 F TCSII We E 20 Go leiere H EEN 21 3 6 Calibration Maintenance Repair and Warrenty ccccccccecccceeceeeeeeeeeeeeeeeeaeeesaeeeseeesseeeseeeeseeeeseeeeaes 22 USING THE THM1176 TFM11860 Leeeeeeeeeeeer enne 24 4 Software User Interface 1seeeeeeeeeeeeeee enne nennen nnn nn nnn 24 Many len e D cS AT E 24 e A VOI Sl AY rae e 26 Aea E Ee RM TE 28 4 4 Setup Display 30 4 5 Measure Setup Dialog AANEREN 31 4 6 Alarm Setup Dialog BEEN d s di BUS TNgger DIOT RICETTE 34 PROGRAMMING THE THM1176 TFM119860 eren nen 35 5 Application Programming Interface
36. a0 41 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 5 10 MMEMORY MMEMory Read the instrument s FLASH memory O What In What to read What Response CATalog a list of files stored in FLASH J CATalog DATA the contents of the file chosen Filename In The filename for What DATA Response Out The returned list of filenames or file contents Error in no error status Error out 4 code FS fs ja E status code E source 5 11 READ STB W TIMEOUT Read STB w Timeout Read the status byte with the given As lee VISA resource name out timeout value l en name byte This VI is only used as a sub VI for Write and Read vi STB timeout In Timeout value in ms Status byte Out Returned status source 9 12 READ Performs a VISA Read and a VISA Clear Dup VISA tescUrb in case of error Ignores VISA warning E o s 1073676294 The number of bytes Byte count uffer transferred is equal to the requested input E count More data might be available This VI is only used as a sub VI for Write status code D and Read vi Oo NEN source o source oo See VISA Read for a definition of the parameters Error in no error T ETR o aob 42 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 13 RESET RESET VISA resource Dup VISA resource k e
37. ab Technology SA Initiate firmware upgrade Questionable Status Register and Error Event Queue The diagram below taken from the SCPI standard provides a good summary This section describes how the THM1176 TFM1186 uses these status registers QUEStionable Status VOLTage CURRent TIME POWer TEMPerature FREQuaency PHASe MOOu ation CALIb ation Available to designer Avaliable to designer Available to designer Available Io designer INSTrument Summary Command Warning NOT USED OPERation CAL Brating SETTing RANGing SWEaping MEASunng Waiting for TRIGger Summary Waiting for ARM Summary CORRecting Avaliable to designer Available to designer Avaliable to designer Available to designer Available to designer INSTrument Surnmary PROGram Running SE A En An P Gab O F NW Standard Event Status Register Available to designer Operation Compiate 0 Request Contro 1 Ermor Event Queue or Available to designer Query Enor 2 MAV Davice Dapendent Error 3 LB Execution Error 4 Command Error 5 User Request 3 Power On 7 Error Event Queue Summary of IEEE 488 2 Status Structure Registers The use of Bit 15 is not allowed since some controllers may have difficulty reading a 16 bit unsigned integer The value of this bit shall always be O TlecTmo ab 53 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Stat
38. acquired e FORMat DATa length specified for ASCii or INTeger e MEAGSure READ the expected value is too large e MMEMory DATa the file does not exist e SENSe the requested range does not exist or e SYSTem HELP requesting help for a non existent command IT ETR olol 85 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 3 3 225 Out of memory The device has insufficient memory to perform the requested operation when writing the new User Offset Zero file to Flash 9 4 400 QUERY ERRORS 9 4 1 400 Query error Generic query error Device being cleared when query was received On the THM1176 TFM1186 no other conditions should generate this error If this is not the case please report to Metrolab the circumstances under which you received this error 9 4 2 410 Query INTERRUPTED The host has sent a new command before finishing reading the response to a preceding query 9 4 3 420 Query UNTERMINATED The host is trying to read a response without having sent a complete query 9 4 4 440 Query UNTERMINATED after indefinite response Indicates that a query was received in the same program message after a query requesting an indefinite response was executed On the THM1176 TFM1186 the only command returning an indefinite response Arbitrary ASCII Response Data is IDN 9 5 100 INSTRUMENT DEPENDENT COMMAND ERRORS 9 5 1 101 Invalid
39. action of a mm and a self consistent measurement of the three axes even in highly inhomogeneous fields The active field volume of the THM1176 LF and TFM1186 is much larger on the order of several mm but this is usually sufficient for weak fields e Range accuracy and resolution Consult these key specifications and choose the probe most appropriate for your application o IHM1176 MF general purpose up to 3 T o IHM1176 HF superconducting magnets to 14 T o THM1176 HFC sub millimeter gaps and o THM1176 LF millitesla fringe fields o IFM1186 nanotesla range perturbations e Bandwidth of DC to 1 kHz The 1 kHz bandwidth allows measuring AC fields generated for example by transformers and motors e Trigger modes Three trigger modes allow the acquisition procedure to be fine tuned for the measurement T ETR olab 16 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Immediate trigger mode Immediate trigger mode the default starts an acquisition sequence immediately upon receiving the measurement command o Timed trigger mode Timed trigger mode is suitable for measuring rapidly varying fields The maximum sample rate writing data into the acquisition buffer is approximately 5 kSa s where one sample is a triplet Bx By Bz With a simultaneous readout via USB the maximum sample rate is approximately 2 3 kSa s o Bus triggered mode
40. ain calibration source STATe OFF Do not apply temperature amp gain calibration otate Out Displays the current calibration state for a STATe query 5 4 CLOSE Close Closes the current session VISA resource yz e Error in no error Error out MetTrrolabh 37 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 5 5 ENUMERATE Enumerate the VISA resource names of the instruments currently connected The resource names must be some pattern Prefix pattern followed by the instrument s serial number followed by another pattern Postfix pattern If the currently selected instrument is still connected its index in the list is returned else an index of zero is returned Serial number In Serial number of selected instrument Enumerate DEE via augur Prefix pattern In The part of the search 7 pattern that precedes the serial number Prefix pattern SIN Offset Serial numbers US8 0x 1BFA 0x0498 E d Postfix pattern In The part of the search Postfix pattern Serial No Pattern Index pattern that follows the serial number INSTR Xx D Enim dio soon Deg Serial No Offset In Byte offset of serial Piet code Tide number in VISA resource name 4 fo 4 o SS poures Serial No Pattern In Format of serial number Serial numbers Out The returned list of instrument serial numbers that match the searc
41. ameters Description READ Abort pending triggers and perform a measurement with existing parameters Note cannot be used when TRIGger SOURCe is BUS SCALar Perform a single measurement Set the range for the expected value if provided use the previously selected range if not Return at least the requested number of significant digits gt FLUX lt expected_value gt min OT max 20T def 0T lt digits gt min 1 max 5 def 3 ds bin value Return x component of flux lt digits gt density measurement T value Return y component of flux como Emm D dui value Return z component of flux NM Perform a series of size measurements The other parameters are as for BEAD SCALar FLUX size min 1 max 2048 def 1 expected value min OT max 20T def 0OT lt digits gt min 1 max 5 def 3 em Return x component of flux Eeer Kg density measurement More nett NEN Return y component of flux Mori nete size Return z component of flux expected value gt density measurement lte Eech IT ETR olol 66 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description SENSe Egg o ranee LL pU EE S MINimum MAXimum Query the current range DEFault setting LEER THM1176 MF Set the range Select DSL TOO Lp E highest range by default THM1176 HF or HFC Uus one T THMLL7 6 LF 0 006
42. anual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA SPECIAL NOTICE FOR THE HANDHELD gt Due to a bug in the VISA library the PDA version of the THM1176 software cannot handle disconnecting the THM1176 while it is measuring This has two implications o You must stop the measurement software before unplugging the THM1176 TFM1186 You must also stop the measurement software before placing the PDA in sleep mode The PDA can be placed in sleep mode manually by pressing the Power button The PDA can also be placed in sleep mode automatically by the power saver see Start Settings System Power Advanced By default Metrolab disables automatic sleep Failure to follow these instructions will hang the measurement software in such a way that it cannot be stopped The only way to reactivate it is to reset the PDA by using the stylus to press the Soft reset button on the bottom of the PDA When exposed to a strong magnetic field the touch screen of the PDA will cease to function The power of the PDA must be cycled to restore full operation SPECIAL NOTICE FOR THE THM1176 HF and THM1176 HFC Remember that the THM1176 HF is only calibrated to 14 1 T formerly 3 T and the THM1176 HFC only to 1 5 T Consequently the 20 T range on these instruments is only calibrated up to these limits You should try to use the lower ranges whenever possible the best is to leave the instrument in auto ranging mode
43. apply to the TFM1186 See Section 2 4 After an INITiate command with TRIGger SOURce BUS the instrument expects TRIGger COUNt triggers before resuming normal operation During this interval the following commands are illegal CALibration INITiate FETCh INITiate IMMediate ALL SENSe FLUX RANGe UPPer SENSe FLUX RANGe AUTO The following commands are legal but cause an ABORt and therefore terminate the acquisition sequence RST ABORt MEASure READ NITiate CONTinuous is used for TRIGger SOURce TIMer or BUS to avoid losing triggers while data is read out Using the OPC command you can generate a ReQuest for Service RQS when a measurement or any other action is complete Set bit O of the Standard Event Enable register and the ESB Event Summary Bit in the Status Enable register Now the execution of an OPC command will generate an RQS Alternatively set bit 4 MAV Message AVailable in the Status Enable register and append the OPC command to the previous commands This will generate an RQS because OPC places a 1 on the output f you program the instrument to generate an RQS it is very important to Enable Service Requests on the host This posts a read on the appropriate USB endpoint the Interrupt endpoint In the USB protocol the host initiates all transfers so if the host has not posted a read the instrument cannot complete its RQS transfer This will block the Interrupt endpoint and any
44. ber of significant digits E value Return x component of flux and perform measurements using the default acquisition Continuous initiation off FLUX expected value min OT max 20T def 0T EE uH digits density measurement ee peter value gt Return y component of flux 5093155 density measurement measurements The other parameters are as for bye Return x component of flux expected value density measurement ires betes nost Return y component of flux expected Value density measurement eier parameters digits Scie value Return z component of flux lt digits gt density measurement ARRay MEASure SCALar o Return z component of flux L expected value density measurement e Immediate trigger min 1 max 5 def 3 M Perform a series of size FLUX size min 1 max 2048 def 1 expected value min OT max 20T def 0T digits min 1 max 5 def 3 T1 ETR olol 64 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description smMEMozy _ Read the FLASH memory CATalog Read the file directory Returns Total bytes used Total bytes available File entries consisting of File name File type File size given file Mm ETR olol 65 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Par
45. bilities of an IEEE488 instrument on the USB bus IEEE488 derived from HPIB GPIB is the world s most widely used instrumentation protocol IEEE488 compliance allows any VISA library Virtual Instrument software Architecture to control every aspect of the instrument The software supplied with the instruments includes the National Instruments VISA Runtime library Mm ETR olol 18 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Standardized instrument command protocol The SCPI standard Standard Commands for Programmable Instruments is the standard developed and used by large instrumentation manufacturers such as Tektronix and HP Agilent and provides a programming interface familiar to many instrumentation system programmers 3 3 PROBE MECHANICAL DESIGN Protection for the sensor Magnetic sensors are sensitive electronic components The plastic cover of the THM1176 MF HF and LF protects their Hall sensors from the bumps and scrapes of normal use For the THM1176 MF and HF the sensor packaging provides effective protection even with the cap removed see below However the THM1176 HFC lacks all such protection please note the special handling precautions in Section 2 4 Precautions The TFM1186 sensor is relatively large and mechanically very robust omall gaps The THM1176 MF HF and LF probes are 10 mm thick To measure in a smaller gap the THM1176 MF or HF
46. ckage on Windows systems provides a very useful tool to explore the command set Select the THM1176 TFM1186 under System Peripherals amp Interfaces USB Devices and click the Open VISA Test Panel icon This opens a window from which you can try all functions available through NI VISA Here are a few notes on how the command set is intended to be used For simple measurements with the standard settings in single channel mode use the MEASure command MEASure ARRay returns a time series Use the UNIT and FORMat commands to change the format in which the results are returned Use the READ commands for measurements with non standard trigger parameters or to return raw measurement data without applying calibration corrections As with MEASure READ ARRay returns a time series Use the FETCh command to retrieve all data corresponding to a preceding MEASure READ or INITiate command or FETCh ARRay for the data IT ETR olol 70 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA corresponding to a MEASure ARRay READ ARRay or INITiate with TRIGger COUNt gt 1 For the THM1176 try to build a CALibration sequence with a zero gauss chamber into the beginning of any lengthy measurement sequence The THM1176 is designed to have very low offset and offset drift but as with any Hall device these remain a significant source of error Note that this does not
47. cquisition value min 1 max 2048 def 1 Note resets the trigger system DEFault SOURCE IMMediate TIMer Trigger source BUS DEFault IMMediate no wait TlMer periodic trigger BUS USB488 TRIGGER IMMediate by default Note resets the trigger system TIMer MINimum MAXimum Query trigger timer DEFault TIMer meas time MINimum Set period for periodic MAXimum DEFault trigger meas time min 122 us max 2 79 s def 0 1 s Note 1 resets the trigger system Note 2 if the specified trigger period is too short a timer overrun error will be returned when the results are fetched see Section 9 6 4 IT ETR olol 69 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA DEFault UNIT T MT UT NT Set units in which flux GAUSS KGAUSS density measurements are MGAUss MAHZp returned if FORMat is DEFault ASCII T by default Note not all models support all units Use UNIT ALL to determine which units are supported d EE Return a list of all the units supported by this instrument followed by the divisor for each set of units The divisor converts the instrument s base units uT for the THM1176 MF HF HFC mG for the THM1176 LF and nT for the TFM1186 to the associated units 6 7 PROGRAMMING HINTS Note that National Instruments Measurement amp Automation Explorer part of the full NI VISA pa
48. data where lt length gt is the number of bytes per sample 1 or 2 2 by default The data will be returned as an IEEE488 2 definite length block consisting of a 7 byte header of the form Honnnnn and followed by nnnnn bytes of binary data The first byte is lt length gt encoded in ASCII the following four bytes are the first field value in the same format as for INTeger and the following 8 or 16 bit signed integers represent the remaining data samples as a delta relative to the previous sample Mm ETR O a 62 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Command Parameters Description NNPMate oIMMeddate ll dE Enable the trigger where the trigger source trigger count and trigger period are set with TRIGger commands CONTinuous DEFault vai continuous trigger state CONTINUOUS lt boolean gt DEFault Set continuous trigger mode where the trigger is automatically re enabled after each acquisition OFF by default Continuous trigger is only allowed if the TRIGger SOURCe is TIMer IT ETR olol 63 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA Averaging count 1 Calibration state on 5 Default range SCALar Perform a single measurement Set the range for the expected value if provided auto range if not Return at least the requested num
49. disconnect from the USB bus and reconnect as a DFU Device Firmware Upgrade device with the following alternate settings CODE DATA RESERVED and HWINFO NOTICE The DIAGnostic UPGRade INITiate command is intended for use by the manufacturer only It can cause your instrument to become nonoperational el SCALar Fetch data values acquired during last MEASure READ or INITiate The following actions invalidate previously acquired data Reset Continuous trigger initiation and Changing trigger parameters Return at least the requested number of significant digits le SOLO IUS Fetch x component of flux density measurement digits min 1 max 5 def 3 lt digits gt Fetch y component of flux density measurement lt digits gt min 1 max 5 def 3 SOIOIUS Fetch z component of flux density measurement digits min 1 max 5 def 3 See Universal Serial Bus Device Class Specification for Device Firmware Upgrade Version 1 1 Aug 5 2004 available from http www usb org developers devclass docs DFU 41 1 pdf T ETR olaly 60 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA TIMestamp Fetch time stamp Returns number in ns Note that the timer resolution is 16 ns Fetch temperature Returns meer mme 1 unsigned integer between 0 and 64K with arbitrary units gt ARRay Fetch values acquired during the last MEASu
50. does offset come from One common source is misalignment of the terminals As shown in the ag figure the effect can be modeled with a resistance network where the longer current paths result in higher resistances and vice versa In our example the resulting offset voltage would be negative But if we exchange the current and voltage leads thereby functionally rotating the Hall element by 90 the offset voltage becomes positive It is important to note that the Hall voltage is unaffected by this rotation The MAG3D exploits this effect in two ways The spinning current technique where the voltage and current leads are rapidly switched back and forth and the results averaged compensates for manufacturing imperfections such as terminal misalignment In addition by wiring orthogonally oriented pairs of sensors in series the MAG3D increases its sensitivity while at the same time compensating for dynamic offset errors This includes the planar T ETR olol 82 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Hall effect whose magnitude changes sign when the current direction is rotated by 90 The combination of these techniques results in a sensor with significantly reduced offset offset drift and sensitivity to planar Hall effect Mm ETR O a 83 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA m REFEREN
51. easurement results Any one probe supports only some of the following units e T Tesla T ETR olol 24 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA MT milli Tesla 1T 10 mT UT micro Tesla 1T 10 uT NT nano Tesla 1T 10 nT GAUSs Gauss 1T 10 G ad KGAUss kilo Gauss 1T 10 kG MGAUSs milli Gauss 1T210 mG MAHZp NMR equivalent proton m frequency 1T 42 5775 MHz p ADC raw ADC values without any calibration corrections Max Hold Freeze measurement or review DISPLAYS Vector display 3D compass arrow becomes fatter and longer when selected probe axis is aligned with magnetic field B Total field strength Red on over range orange on alarm Bx By Bz X Y and Z components of field strength Red on over range orange on alarm Raw sDev and P P displays only Peak A F Amplitude and frequency of selected peak FFT displays only Thermometer Field strength as fraction of selected range Not shown when auto ranging Rate e Red Buffer overrun trigger overrun or lossy compression Yellow Reviewing a recording file NOTES To enter the target frequency on a PDA press the k button to bring up the on screen keyboard Remember that Windows Mobile offers multiple input methods including handwriting recognition For the FFT displays if Target F is non zero the frequency range searched is 1 of t
52. ection of the B vector relative to probe Select units for displayed results Capture maximum field value Hold freeze a given measurement Record data to a file either continuously or point by point Display a recorded file On line help Settings saved upon exit restored at restart Setup page Select one of many THM1176 TFM1186 Display model serial and version numbers date of last calibration Display version information about the software Select measurement parameters including sample rate internal buffer size averaging and data compression Select measurement range or auto ranging nitiate user offset correction procedure Define alarms for when measurements exceed specified bounds Record file format ASCII tab delimited compatible with Handheld file format 7 9 HANDHELD KIT Contents Contents of the desktop kit plus Industrial quality PDA Heavy duty Li lon battery 2600 mAh AC adaptor charger 100 240 VAC 50 60 Hz 500 mA with wall socket adaptor plugs for Europe UK USA Australia USB Host adaptor cable to connect PDA to THM1176 TFM1186 USB Device adaptor cable to connect PDA to PC Pre installed acquisition software with licenses from Metrolab including free updates and from National Instruments CD with acquisition software for PC Mac and PDA Windows Mobile LabVIEW source code for all PC and PDA software and user s manual Carrying Case T E
53. ent results previously acquired with MEASure READ or INITiate CALCulate Control averaging s Signal Not used owa oo mm senso tdem TRIGger TRG Generate a trigger USBIMC USB488 INITiate Enable triggers mM ETR O au 51 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Functional Commands Block ABORt Abort triggers TRIGger Select trigger source and characteristics Signal Not used Generation STATus Clear status STB SRE Read and enable bits in Status Byte USBTMC USBA488 USBTMC USB488 Request service from host ESR ESE Read and enable bits in Standard Event Status Register OPC WA Detect and wait for operation complete STATus Read and enable bits in OPERation and QUEStionable registers USBTMC USBA88 Remote local control ineffective since mcus THM1176 TFM1186 has no local controls Perform self test not supported oYSTem SLEEp Power down analog subsystem MMEMory MMEMoOry Manipulate FLASH memory files IT ETR O a 52 www metrolab com THM1176 TFM1186 User s Manual Functional Block DiAGnosti DIAGnostic v1 3 r1 3 11 14 Command s 6 3 IEEE 488 2 SCPI STATUS REGISTERS IEEE 488 2 compliant instruments have at least two registers the Status Byte and the Standard Event Status Register SCPI adds the Operation Status Register Copyright 2014 Metrol
54. erances are 0 4mm 2 5mm thickness which is 0 3mm Sensitive volume Sensitive volume 200umx200umx5um 150umx150umx10um The probe version is part of the descriptor returned by the IDN query displayed by the THM1176 software in the Info field See Sections 4 4 5 8 and 6 5 Note Some units were incorrectly programmed as probe version C1 This will be corrected at the next factory calibration in the meantime the two may be distinguished visually T ETR olab 76 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 7 5 MECHANICAL THM1176 HFC Dimensions Instrument electronics 76 x 22 5 x 14 mm Probe top view 10 0 0 1 R2 F A PCB 200 3 connector DETAIL A CaH Cable SCALE 5 1 Probe side view 0 5 0 1 DETAIL B 15 x 0 1 DETAIL B SCALE 4 M 0 15 Probe bottom view 1 3 0 2 PROMUS AUI Te MEL c3 TUN 15 0 2 GNIS Becke m DETAIL C 2 00 m 0 1 DETAIL C Pe EE SCALE 4 1 WW o s j Field sensitive point Cable length 3 m optionally 6 m Notes Includes 1 m of USB cable Location of field sensitive Marked by in DETAIL A above With the proper lighting the point sensor IC structures can be seen under a microscope and the exact location of the Hall elements can be ascertained visually The image below identifies the major structures on the IC Driving part The drawing sho
55. h VISA resource Out VISA resource name of instrument now active Index Out The index of the selected instrument If one of the entries in VISA resource names match Serial number the index of that entry is returned Otherwise zero is returned i e the first entry in the list is selected by default 5 6 EXPAND DATA Expand compressed data Only used as subVI for MEASure FETCh READ vi ExpandData Input In Data to be expanded E Data length In Degree of data ca rm SE EE Jo E compression Data length d 1 1 byte per data point 2 2 bytes per data point else 4 bytes per data point Output Out Decompressed data IT ETR olol 38 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 5 7 FORMAT Sets the output format for measurements or gets the current setting The output format can be text ASCiI uncompressed binary INTeger or compressed binary PACKed1 or PACKed2 The output format is further affected by the CALibration STATe and UNIT settings FORM ASC CAL STAT ON Measurement in text selected units FORM ASC CAL STAT OFF Measurement in text raw ADC values FORM 7INT CAL STAT ON Measurement in 32 bit binary uT FORM 7INT CAL STAT OFF FORMat Measurement in 32 bit binary raw ADC values VISA resource Dup VISA resource FORM ZPACKed1 CAL STAT ON SP Measurement in 8 bit binary delta uT Fu
56. he sample frequency Display is affected by settings in Setup and File pages T ETR olab 25 www metrolab com THM1176 TFM1186 User s Manual 4 2 PLOT DISPLAY Amplitude 500 750 F Hz MetTrrolab v 1 3 71 3 11 14 Copyright 2014 Metrolab Technology SA 1000 125 PURPOSE Graphical display of last measurements CONTROLS X k Data display selector See Section 4 1 B Bx By Bz Enables or disables display of corresponding data Desktop version only disabled in FFT displays Graph palette provides tools to move cursors zoom and pan Desktop version only Units Hold See Section 4 1 DISPLAYS Graph Displays selected data graphically In Raw sDev P P displays also displays alarm limits B Rate See Section 4 1 NOTES The y axis uses the selected units and is by default auto ranging The x axis uses the following units e Raw sDev P P time using the time stamp Scrolls at 6 s screen Exception Raw data plots on PDA use sample number s FFT frequency The graph palette includes Cursor Movement Tool Move cursor on display Cursors must first be created using the Cursor legend Zoom Zoom in and out of graph o Zoom to Rectangle click and drag to cover Zoom area o X zoom zoom in along the x axis o Y zoom zoom in along the y axis o Zoom In about Point click a point to zoom into Press and hold Shift to switch between Zoom In and
57. hnology SA previously acquired data o Reset o Continuous trigger initiation o Changing trigger parameters Sleep In If set the THM1176 TFM1186 will switch off the analog power after executing the command The microcontroller also puts itself to sleep whenever it can but this happens automatically The resulting power savings are significant in battery powered applications Switching the analog power back on happens automatically before the next measurement note however that this takes approximately 100 ms Select In Select the values to be returned 0 X por 2 7 Z 3 Temperature 4 Timestamp Size In Number of measurements Digits In Number of significant digits in measurement result Timeout ms In The delay between the write and when the read should occur This gives devices time to respond Output Out The returned measurement values if any The form of X Y Z depends on the settings of FORMat CALibration STATe and UNIT CAL STAT ON FORM ASC selected units CAL STAT ON FORME INT PACKed1 or PACKed2 uT THM1176 HF or mG LF CAL STAT OFF raw ADC values The temperature value is in arbitrary units The time stamp in seconds since startup refers to the end of the acquisition If FORM ASC and Select includes X Y or Z the Digits output returns the number of digits behind the decimal point to allow displays to be correctly formatted Mm ETR O
58. instrument has started up Place the probe into the magnet On the THM1176 MF and THM1176 HF you can remove the probe cap to access narrow gaps see Chapter 3 Overview See Chapter 4 Software User Interface for details on using the software Does not apply to TFM1186 see Section 2 4 Check the offset before each series of measurements by placing the probe in the Zero Gauss Chamber If the offset is higher than desired leave the probe in the Zero Gauss Chamber and perform the User Offset Correction procedure using the Offset ZERO button on the Setup page 2 2 USING THE THM1176 TFM1186 WITH THE HANDHELD 2 2 1 Handheld Assembly e Install the battery in the PDA and charge it You can charge the battery in three ways T ETR olab 9 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Lift the rubber cover covering the DC in connector on the bottom left side of the PDA and plug in the AC adaptor o Plug the short USB Host adaptor cable into the USB synchronization cable connector on the bottom of the PDA and plug the AC adaptor into the power connector on the USB Host adaptor cable o Plug the 1 2 m long USB Device adaptor cable that plugs into the USB synchronization cable connector on the bottom of the PDA and plug the other end of the adaptor cable into the USB port of a PC Turn on the PDA by 1 sliding the Hold switch on the left side of the PDA
59. is batch operation you must ensure that your instrument arrives at Metrolab the week before Certification CE approved Firmware upgradable by end user IT ETR olol 80 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA vu REFERENCE 8 THM1176 MF HF HFC Sensor Details This chapter is adapted from an article by Philip Keller of Metrolab in the June July 2008 issue of Magnetics Business amp Technology http www MagneticsMagazine com To measure the total field we need three orthogonally oriented Hall sensors Typically three individual sensors are glued into a cube roughly five to ten millimeters on a SOTTO side But now there is another way a single IC containing one conventional planar Hall element and two sets of vertical Hall elements The vertical elements can be thought of as plates of N type silicon inserted vertically into a P type substrate If a current is injected into the center terminal and extracted from the two end terminals the currents in the two halves of the plate flow in opposite directions resulting in a Hall voltage on the remaining terminals A team at the EPFL in Switzerland led by Dr Popovic applied this technique to design a 3 axis sensor on an IC called the MAG3D The array of Hall elements measures 150 x 150 x 10 um a million fold reduction in active volume compared to a conventional approach
60. l values o Visualize the direction of the B vector relative to one of the probe s axes o Setthe units in which the results are displayed including raw ADC value o Capture the maximum field value o Hold freeze a given measurement o Record data to a file and o Replay a recorded file A Setup page allows you to o Choose amongst multiple instruments plugged into your PC o Display information about your instrument such as model and serial numbers version numbers of the electronics probe and firmware and the date of the last calibration o Display version information about the software IT ETR olol 20 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA o Select the measurement parameters including the trigger source sample rate internal buffer size averaging and data compression o Set the measurement range or auto range o Setup audio and or visual alarms when the measured field values exceed specified bounds and o lnitiate the user offset correction procedure On line help explains the use of all controls and displays All relevant settings are saved when you quit the application and restored the next time when you restart it Customized measurement software A powerful and easy to use LabVIEW Application Programming Interface API allows instrumentation system programmers to readily integrate the THM1176 TFM1186 into their measurement sy
61. mode CONTROLS Help Open this help window Cancel Abort the trigger sequence and close the dialog Hold Whether or not to Hold after acquiring this block Trigger Trigger a single acquisition DISPLAYS Triggers Counts number of triggers in current block No requested Requested number of triggers per block NOTES When the acquisition timeout expires the acquisition sequence is aborted and the dialog is closed Use the Measurement Setup dialog in the setup page to set the number of triggers and timeout period Modify this sub VI to synchronize bus triggers with external events 34 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA PROGRAMMING THE THM1176 TFM1186 _5 Application Programming Interface The LabVIEW programming Application Programming Interface API for the THM1176 family allows users to easily write instrument control programs Most but not all of the functions provided by the instruments USB interface are made available through this API Some logically related functions in the USB interface have been regrouped in the API A standard low level I O utility function guarantees robust instrument communications and allows programmers to easily add any command or combination of commands that they require Both the LabVIEW API and User Interface UIF are included in source code format on the CD that came with your THM1176 T
62. n Time Engine dmg and then double clicking on the installation package LabVIEW 2010 Runtime Engine mpkg Install the VISA Runtime Library by double clicking on Mac NI VISA Runtime 5 1 1 Beta dmg and then double clicking on the installation package nivisaruntimei mpkg Install the THM1176 application by decompressing Mac THM1176 zip and copying the application to your Applications folder T ETR olab 8 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA NOTICE gt f needed for example if you install a new operating system on your computer you can download and install more recent versions of the VISA Runtime Library from the National Instruments website http www ni com You may already have NI VISA installed for example if you use LabVIEW 2 1 3 PC or Mac Measurement e Start the THM1176 measurement software In Windows if you used the standard installation options a THM1176 link is located in the Metrolab THM1 176 program group of the All Programs menu e Plugin the THM1176 TFM1186 The measurement software should automatically recognize the instrument and start measuring In Windows XP the New Hardware Wizard will run the first time you plug in the instrument requiring access to an Administrator account Choose not to connect to Windows Update and to install the software automatically Subsequently chimes will indicate when the
63. nction Response FORM PACKed1 CAL STAT OFF J Query Measurement in 8 bit binary delta raw error in no error error out ADC values status code FORM PACKed2 CAL STAT ON 41 n source Measurement in 16 bit binary delta uT FORM PACKed2 CAL STAT OFF Measurement in 16 bit binary delta raw ADC values Note that MEASure FETCh READ parses binary packed as well as text output Function In Function to be performed Query Get current setting ASCii Select ASCII output format INTeger Select binary output format PACKed1 Select 1 byte packed format PACKedq2 Select 2 byte packed format Response Out Returns current setting for a Query IT ETR olol 39 www metrolab com THM1176 TFM1186 User s Manual 9 8 INITIALIZE Initialize VISA resource Dup VISA resource E THM1176 E THM1176 Description Ranges Divisors f IA Fa 7 0 ri 0 d A d v1 3 r1 3 11 14 Error in no error Error out status code 4 Lo source 5 9 MEASURE_FETCH_READ MEASure FETCh READ VISA resource Dup VISA resource k k Function Sleep Select MEASure gt gt C e ox Y 2z 1 5 1000 Output X Y Z d J bas je Frae Temperature Timestamp Digits jo jo Error in no error Error out status code di o source Tlecrmo ab Copyright 2014 Metrolab Technology SA Initialize the THM1176 LabVIEW API ID Query In Use the IDN command to
64. o e EE 85 HE Uode ee e Pc 86 9 4 cea dcs EU UU UU m 86 ec s A UC EN OF area Ee 86 9 4 2 410 Query INTER ROP EBD ases eesttczoss sniutencasdenovncesrinsstaesadibedandseduossaedaiaced slnentnceduessarevadseasancd es 86 9 3 420 Query UNTERMINA TED s E 86 9 4 4 440 Query UNTERMINA TED after indefinite response 86 9 5 100 Instrument Dependent Command Errors enne nnns 86 9 5 1 101 Invalid value mist 86 9 5 2 103 Wrong units for Da rameier 86 9 6 200 Instrument Dependent Execution Error 86 uou O owane EE 86 9 6 2 204 Data buffer Was OVGITON iiss i acascnssedasnscacarecipnasansieamaupuadiss iaceeiecepdectsecacusocashossndieuhaeseiecshedeseeesessd 87 9 6 3 205 Measurements were Over rangde 87 9 6 4 206 Timer was OVOSTUN 1c ccccecccccceccsuccscceussuessusauensessuccuessucsuessusauensussueseessuessessusauensesauessesnsseesans 87 9 0 9 Z207 Bag dala CO Des SIDE TEE 87 T Cc T I o a 6D V www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA GETTING STARTED 1 Introduction Metrolab s Three axis Magnetometers are used to measure magnetic field strength Their unique extraordinarily compact design allows them to be used as a portable instrument or directly connected to a PC Simultaneous measurement of all three components of the magnetic field provides the total field no matter the orientation of the probe which greatly facilitates many measurement tasks
65. o start the next measurement expired The next measurement was skipped 9 6 5 207 Bad data compression When returning data in PACKed FORMat the true dynamic range of the data could not be accurately represented by the delta values The maximum delta value was used while attempting to correct the error on the subsequent sample s It is recommended to use a lesser degree of compression Mm ETR O a 87 www metrolab com
66. orrection will be applied the next time the instrument is powered up e Readout options The three field components are always acquired but the readout can be limited to any selected components The readout can include a single measurement or an entire array of measurements and can be formatted as an ASCII message or as a binary block Binary data may be compressed by a factor of two or four for example to help reduce the traffic on a busy USB hub Depending on the model the field values can be returned in Tesla mTesla uTesla nTesla Gauss kGauss mGauss equivalent proton NMR frequency or raw ADC values A timestamp in ns and temperature arbitrary units not calibrated can also be read out 3 2 INTERFACE e USB interface Compliance with the USB 2 0 mechanical electrical and protocol standard provides basic connectivity with any USB capable computer The instrument supports USB full soeed communication 12 Mbps e Standardized USB class driver Compliance with the USB Test amp Measurement Class USBTMC allows the instrument to be connected without installing a custom USB driver All that is required is a generic class driver for test and measurement equipment as provided by suppliers of instrumentation software The software supplied with this instrument includes the National Instruments USBTMC driver e Standardized IEEE488 2 protocol Compliance with the USB488 protocol specification for USBTMC provides all the capa
67. other commands using this endpoint notably the USBTMC USB488 Read Status Byte function will fail IT ETR O a0 71 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Be sure to check the status after every command The Standard Event OPERation and QUEStionable Status registers provide a general idea of what went wrong and the status message on the Error Event Queue retrieved by SYSTem ERRor provides a detailed diagnostic See Chapter 9 Error Codes for the exact interpretation of these error messages It may be convenient to set up the Enable bits to generate a ReQuest for Service RQS when an error is encountered IT ETR O a 2 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA REFERENCE 7 Technical Specifications 7 1 MEASUREMENT Ranges THM1176 MF 100 mT 300 mT 1T 3T THM1176 HF 100 mT 500 mT 3T 20T calibrated to 14 1 T THM1176 HFC 100 mT 500 mT 3T 20T calibrated to 1 5 T THM1176 LF 8 0 mT TFM1186 100 uT Notes Ranging may be performed automatically or manually Data output Bx By B ASCII or binary single point or array calibrated or not Temperature uncalibrated Time stamp 167 ns resolution Units THM1176 MF HF HFC T mT uT G KG MHz p proton NMR frequency THM1176 LF T mT uT G mG TFM1186 T mT uT nT G mG Sample rate
68. r Get the current value of the event STATus enable register VISA resource Dup VISA resource 2 E Set the event enable register Function Enable Status Byte query J 0000 In addition for the OPERation and Response Enable out QUEStionable Status registers you can Get the current value of the condition register Error in no error status erie mem c Finally you can Retrieve the next entry in the error event queue Clear all event registers and queues and Reset the OPERation and QUEStionable enable registers to their default values Enable In The new value when setting the value of an enable register Response Out Response to command Enable out Out The current value when retrieving the current value of an event or event enable register IT ETR olol 45 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 18 STRAIGHTEN Compensate measurements for possible Straighten VISA resource S E Rotation matrix Jo lo D By in J 0 00000 By out 0 000000 T 0 00000 Bx out 0 000000 Error in no error status code d A TH O E source feet MetTrrRo lab Dup VISA resource I Bz in 1 0 00000 Bz out 0 000000 Error out status code dp source 46 angular misalignments of the sensor ICs Bx in By in Bz in In X Y and Z components respecti
69. ratch using the LabVIEW development system Developing software for the handheld version requires the optional LabVIEW Mobile Module LabVIEW 2011SP1 or earlier 2 4 PRECAUTIONS High magnetic field gradients as found for example around an MRI or NMR spectroscopy magnet will subject the USB connector and the PDA to strong forces To prevent injury from flying objects or whiplashing cables be sure to hold these components securely when you are around a strong magnet NOTICE gt Do not bend the probe cable sharply This is a special cable with individually shielded signal wires in order to minimize induction artifacts Sharp bends break the shielding This product conforms to the WEEE Directive of the European Union 2002 96 EC and belongs to Category 9 Monitoring and Control Instruments For proper environment friendly disposal you can return the instrument free of charge to us or our local distributor SPECIAL NOTICE FOR THE HANDHELD gt For details about using the PDA please refer to the SoMo 650 655 Quick Start Guide This includes important safety instructions On the SoMo 650 take care to squeeze the two release buttons on the side of the connector when removing the adaptor cables from the bottom of the PDA Else you will destroy the cable locking mechanism and in the future the connector can accidentally slip loose T ETR olol 11 www metrolab com THM1176 TFM1186 User s M
70. re ARRay or READ ARRay lt size gt must be no greater than the acquisition size If FORMat is ASCii returns a comma separated list of values The other parameters are as for FETCh SCALar Wn RS DX lt size gt lt digits gt Fetch x component of flux density measurement lt size gt min 1 max 2048 def 1 lt digits gt min 1 max 5 def 3 eg SSczeci SdTgrtse Fetch y component of flux density measurement size min 1 max 2048 def 1 lt digits gt min 1 max 5 def 3 lt S1 26 gt S01 91s Fetch z component of flux density measurement lt size gt min 1 max 2048 def 1 lt digits gt min 1 max 5 def 3 Mm ETR O a 61 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Description FORMat OS DATA Query data output format KSE ADOLE A INTSgSE Set format for returned flux PACKed lt length gt density measurement data DEFault ASCii by default INTeger returns an IEEE488 2 definite length block consisting of an 8 byte header of the form 6nnnnnn and followed by nnnnnn bytes of binary data The data consists of a 32 bit big endian signed integer for each flux density value containing the 16 bit big endian raw measurement value if calibration correction is disabled or otherwise the flux density value in uT THM1176 MF HF HFC mG THM1176 LF or nT TFM1186 PACKed lt length gt returns compressed
71. s with a periodic trigger Response Out Response to any of the query functions T ETR o a 6D 47 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 20 UNIT Sets the units in which measurements are UNIT returned or queries the currently selected units VISA resource _ Dup VISA resource E Note that units are only used if FORMat is roe Units out Ascii and CALibration STATe is On J Units query Function In Function to perform set units or get currently selected units Ge emnt Units In If setting units selects units in status code Ill Rcx which measurement results are to be FS returned HEX Units out Out If querying currently selected units returns the currently selected units source 5 21 WRITE AND READ Write a command to the instrument and read the response Write amp Read mM Nearly all the commands issued by the VISA resource mg instrument API pass through this VI I 4 Bag It is highly recommended that any custom commands also use this utility VI Command In Command to write Status Bytes jo f Timeout In The delay between the write and when the read should occur This gives devices time to respond Era danaa Num bytes In Size of transfer buffer If the response is longer than this value the response will be read in multiple transactions 4 Response Out
72. stem This manual provides complete documentation of the API and command interface The source code for the turnkey measurement software is also provided 3 5 HANDHELD KIT Everything the PC software can do in a portable instrument A compact lightweight and rugged handheld computer Personal Digital Assistant or PDA allows you to take measurements in the field The PDA software has the same functionality interface and file recording format as the PC software e Includes the entire desktop kit You can choose to connect the THM1176 TFM1186 either to the PDA included in the handheld kit or to a PC In the second scenario you can do everything you can do with the desktop kit e A full featured PDA The PDA has many features that can be combined in creative ways to enhance your use of the magnetometer For example a recording file can be inspected in Word Mobile or imported manipulated and plotted in Excel Mobile Alternatively you can transfer the files to a PC using the IT ETR O a 21 www metrolab com THM1176 TFM1186 User s Manual v1 3 11 3 11 14 Copyright 2014 Metrolab Technology SA included USB Device cable via a CompactFlash or SDIO flash card or via the 802 11 or Bluetooth wireless networks Customized handheld applications As with the PC software you have all the source code so you can write your own portable magnetic measurement application or to modify the standard one The only thing you need is
73. such as field mapping This manual covers the entire THM1176 family including the following models e HM1176 MF Three axis Hall Magnetometer Medium Field e HM1176 HF Three axis Hall Magnetometer High Field e HM1176 HFC Three axis Hall Magnetometer High Field Compact e HM1176 LF Three axis Hall Magnetometer Low Field and e FM1186 Three axis Fluxgate Magnetometer For an overview of each of these instrument s capabilities please see Chapter 3 Overview Chapter 7 Technical Specifications and Chapter 8 THM1176 MF HF HFC Sensor The THM1176 family instruments resemble other standard USB devices it and its software are easy to install and easy to use Nonetheless please take a moment to browse through Chapter 2 Quick Start Guide and Chapter 4 Software User Interface Pay particular attention to the cautionary notes in Chapter 2 Quick Start Guide It is easy to develop custom software for the THM1176 family especially in LabVIEW Please see Chapter 5 Application Programming Interface Chapter 6 USB Interface and Chapter 9 Error Codes Finally keep your instrument accurate and up to date by having it recalibrated at regular intervals The recommended calibration interval is 18 months You can benefit from a discounted price for the calibration if you return your instrument to Metrolab at a time that corresponds to our batch calibrations please see Section 7 10 for details T E
74. tatus Program status enable register enable Important you must also enable service requests on the host See Section 6 7 for details SRE Status enable query Read status enable register STB Status byte query Read status byte register TRG Generate bus trigger ATS self test Query Perform complete self test return 0 if successful 1 if not WAT Wait to Continue Wait until previous commands have completed 6 6 SCPI COMMANDS In the command definitions below the following conventions are used optional keywords or parameters gt value IT ETR O a0 57 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA The abbreviated form of each command is written in capital letters For example the MEASure command can be written as MEASURE or MEAS or since capitalization doesn t matter measure or meas Each command is presented with its subcommand s indented below it For example SCALar NENNEN values acquired during last READ or INITiate mm ise curenient measurement According to this table the following commands are legal FETC SCAL FLUX Y FETC same as above omitting optional keywords FETC X fetches x component of flux density measurement The following special parameters are recognized MINimum MAXimum DEFault Numeric parameters usually require units Analogously the values returned by queries
75. the LabVIEW Mobile Module LabVIEW 2011SP1 or earlier 3 6 CALIBRATION MAINTENANCE REPAIR AND WARRENTY Calibration procedure The THM1176 family instruments can only be calibrated by Metrolab This is because special magnets tooling and software are required to calibrate all three axes at multiple fields and temperatures and write the results to flash memory Recommended calibration interval All customers are of course free to fix the intervals at which they send their instrument back for calibration within the context of their quality assurance policy Metrolab s recommendation is to send the instrument back for calibration at least once every eighteen months Recommended calibration dates To minimize costs Metrolab establishes a limited number of dates in the year when batches of THM1176 family magnetometers will be calibrated To avoid substantial extra charges you should ship the unit back to Metrolab in order to coincide with one of these dates Please see Section 7 10 for a list of these dates Upgrades Via its website Metrolab will make available improvements and bug fixes for the THM1176 firmware software and manual The Download page of the Metrolab website http download metrolab com will always contain the latest versions Firmware upgrades The THM1176 family instruments are designed such that you can upgrade the firmware yourself Firmware upgrades are a delicate procedure as a IT ET
76. the THM1176 family instruments VISA resource Dup VISA resource sl x currently do not support self test el Self test response Self test response Out Response from TST self test command Error in no error Error out status code J o o Status Code J L Ga eur source 9 16 SENSE sets the measurement range or gets the currently selected range Note that it can SENSe be very useful to get the currently selected range after performing an auto pe ranging measurement Functio R j pare Function In Whether to set the range or EE SS to get the currently selected range Range In The range for when setting pos the range x e Eu Ges source Range out Out Returns the currently a a a Error in no error Error out selected range in response to a query Auto Out Returns whether or not auto ranging is selected when querying the currently selected range T ETR olol 44 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 17 STATUS Collects all commands concerning the IEEE488 2 SCPI status system in the THM116 See Section 6 3 for more details about the status registers Function In The function to perform For each of the four status registers Status Byte Standard Event Status Register OPERation Status and QUEStionable Status you can Get and clear the current value of the event registe
77. the default T ETR olol 12 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA SPECIAL NOTICE FOR THE THM1176 HFC Sensor PCB Sensor IC gt The probe is very fragile Be extremely careful when handling even the weight of the instrument cable is sufficient to damage the probe Damage to either the sensor IC or PCB will destroy the sensor We strongly suggest storing the probe in its protective case when not in use gt The probe cable is also fragile Avoid pulling on it or bending it sharply especially near the junction of the instrument and probe cables Do not let the protective case hang by the sensor cable The sensor is sensitive to Electrostatic Discharge ESD Be sure to ground yourself and follow proper procedure when handling the sensor gt The probe is supplied with two ceramic plates that can be glued to the top and bottom of the sensor PCB The benefits are that the sensor PCB is protected and rendered rigid and that the ceramic provides a flat reference surface The disadvantages are that the sensor becomes thicker and that it cannot be recalibrated Because of this trade off Metrolab have decided to leave it to the customer to decide whether or not they want to use the ceramic plates Without the ceramic plates the sensor PCB can be bent anywhere in the front 15 mm of the sensor PCB The minimum bend radius is 3 4 mm
78. urred in a previous VI if so instead of its normal function it simply copies Error in to Error out In this fashion the Error out at the end of the chain indicates the precise error that caused the rest of the chain not to execute The sections below describe each Virtual Instrument VI with its inputs and outputs The standard inputs and outputs described above are not documented for each VI 5 2 AVERAGE Set or retrieve the averaging count AVERage VISA resource __ Dup VISA resource Function In Function to perform Function AVERage COUNt Set the averaging J AVERag e COUNt query COU nt Count i Count out Jo fo AVERage COUNt query retrieve the averaging count Error in no error Erfer adt MERE A i cod a dg are GER In The new averaging count to be E Count Out The current averaging count returned by the query IT ETR olaob 36 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 3 CALIBRATION Collects all functions dealing with the device calibration CALibration Function In Function to perform VISA resource Dup VISA resource KH Function State ZERO Restore factory offset J INITiate correction INITiate Initiate offset correction procedure in zero gauss chamber Error in no error STATe query Get current calibration status code state 0 STATe ON Apply temperature amp g
79. us Byte Contains a 1 byte status summary The THM1176 TFM1186 uses the following bits Bit Name Description Error AVailable in Error Event Queue Questionable Summary Bit 4 MAV Message AVailable response ready to be read Event Summary Bit 6 ROS ReQuestfor Service Operation Summary Bit o Standard Event Status Register Latches certain standardized events The THM1176 TFM1186 uses the following bits Dn Name Description Operation OPC has flagged operation complete puer r lee Besse Error Error in Evorinpeceinagucy query 3 Device Errors specific to the THM1176 family Dependent Error including internal errors Execution Error Error detected during command execution Error in preceding command Instrument has been powered up o OPERation Status Captures conditions which are part of the instrument s normal operation The THM1176 TFM1186 uses the following bits Bit Name Description 00 o CALibrating Measuring zero offset Changing range o QUEStionable Status Indicates conditions that may reduce the quality of the measurement The THM1176 TFM1186 sets the following bits IT ETR O a 54 www metrolab com THM1176 TFM1186 User s Manual v 1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA Bit Name Description B FREQuency The acquisition buffer or the timed trigger has been overrun which makes the frequency questionable The measurement was over range
80. vely of the measured field vector Bx out By out Bz out Out X Y and Z components respectively of the corrected field vector Rotation matrix Out Rotation matrix for this instrument The matrix transforms the measured field vector to an orthogonal coordinate system fixed relative to the outside of the probe The field vectors are considered column vectors www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 9 19 TRIGGER Manages all functions of trigger system Function In Select function to be performed Setup set up the trigger system with the parameters given Setup query get current trigger setup TRIGger INI Tiate enable the trigger VISA resource Dup VISA resource H g Source In Trigger source for Setup Function Source function Setup query IMMediate ABORt abort any pending triggers MMediate no wait Count Period s Timeout ms Continuous 1 0 1 J 1000 TIMer periodic trigger Response BUS USB488 trigger Error in no error Error out l Count In Trigger count for Setup eh Em function aE o Period In Trigger period for Setup function source Timeout ms In The delay between the write and when the read should occur This gives devices time to respond Continuous In Continuous initiation mode for Setup function Note continuous initiation only work
81. ws probe version DO Probe version D1 differs from DO in that the thickness is 0 5 mm along the full 42 mm length rather than 0 5 mm 0 15 mm and 0 25 mm Also see footnotes 2 and 3 T ETR olol 11 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 7 6 MECHANICAL THM1176 LF Dimensions Instrument electronics 76 x 22 5 x 14 mm Probe with housing 113 x 16 x 10 mm Field sensitive point 6x3 4 x 3mm Cable length 3 m optionally 6 m Notes Includes 1 m of USB cable 160 g 3 m cable 290 g 6 m cable Sensor locations THM1176 LF Y A E 7 7 MECHANICAL TFM1186 Dimensions Instrument electronics 76 x 22 5 x 14 mm Probe housing 70 x 30 x 32 mm Cable length 3m Notes Includes 1 m of USB cable Weght 139 Sensor package TFM1186 T ETR olab 78 www metrolab com THM1176 TFM1186 User s Manual v1 3 r1 3 11 14 Copyright 2014 Metrolab Technology SA 7 8 DESKTOP KIT Contents 3 Axis Magnetometer Probe with 3 or 6 meter cable Zero Gauss Chamber except for TFM1186 Calibration as specified in Section 7 1 CD with acquisition software for PC and Mac LabVIEW source code and user s manual Software license from Metrolab including free updates Software functions Display B B B and or B either numerically or graphically Display raw data or computed peak to peak RMS or FFT values Visualize dir

Three-axis Magnetometers THM1176 and TFM1186 User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents