Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
test-and-measurement:guides:waveforms-data-logger [2022/09/12 17:55] – changed forum.digilentinc.com to forum.digilent.com Jeffrey | test-and-measurement:guides:waveforms-data-logger [2024/02/29 04:27] (current) – moved AD3 updates over to live reference page Fausto Soares | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Using the Data Logger ====== | ||
+ | ~~TechArticle~~ | ||
+ | |||
+ | {{reference: | ||
+ | |||
+ | ===== Introduction ===== | ||
+ | [[https:// | ||
+ | ---- | ||
+ | ===== Prerequisites ===== | ||
+ | * A Digilent Test & Measurement Device with Analog Input and Output Channels: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * [[test-and-measurement: | ||
+ | * A Computer with WaveForms Software Installed | ||
+ | |||
+ | ---- | ||
+ | ===== Guide ===== | ||
+ | ====1. Opening the Logger==== | ||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | === 1.1 === | ||
+ | Plug in the Test & Measurement Device, then start WaveForms and make sure the device is connected. | ||
+ | |||
+ | If no device is connected to the host computer when WaveForms launches, the **Device Manager** will be launched. Make sure that the device is plugged in and turned on, at which point it will appear in the Device Manager' | ||
+ | |||
+ | **Note:** //" | ||
+ | |||
+ | **Note:** //The Device Manager can be opened by clicking on the " | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ reference: | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group>< | ||
+ | === 1.2 === | ||
+ | Once the Welcome page loads, in the instrument panel at the left side of the window, click on the **Logger** button to open the //Data Logger// instrument. | ||
+ | </ | ||
+ | {{ reference: | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===1.3=== | ||
+ | Once the //Data Logger// instrument opens, the window contains the data plot on the right side and the default data measurements listed on the left side. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ reference: | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | |||
+ | ====2. Using the Data Logger==== | ||
+ | //This section walks through setting up the //Data Logger// to capture data from the Oscilloscope Channels.// | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===2.1 Hardware Setup=== | ||
+ | |||
+ | Connect the Test and Measurement Device' | ||
+ | |||
+ | For devices using MTE cables, the input channel uses an orange wire and the output channel uses a yellow wire. | ||
+ | |||
+ | For devices that use differential input channels, such as the Analog Discovery Studio with MTE cables, make sure to connect the Oscilloscope Channel 1 negative pin to the ground pin associated with Wavegen Channel 1. | ||
+ | |||
+ | **Note:** //The analog input channels can be used with BNC Cables. For more information, | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===2.2 Software Setup=== | ||
+ | In WaveForms' | ||
+ | |||
+ | For more detail on how to use the //Wavegen// instrument, please see the [[test-and-measurement: | ||
+ | |||
+ | Return to the //Data Logger// instrument by clicking on its tab in the bar at the top of the screen. | ||
+ | |||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{: | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===2.3 Run the Data Logger=== | ||
+ | Click the Run button in the control bar near the top of the window to begin capturing data on the Oscilloscope Channels. Captured data will appear in the plot pane as a set of colored lines. Each colored line corresponds to one of the default measurements listed on the left side of the window. For example: the orange line is the measurement named C1 DC, meaning the DC voltage of the Channel 1 input. Since the signal going into Channel 1 is AC and centered about 0 volts, the data this measurement is collecting should be theoretically zero but will appear as a voltage in the low mV range next to the measurement name. | ||
+ | |||
+ | A variety of different measurements can be seen for each of the device' | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===2.4 Plot Plane Axes=== | ||
+ | By default, measurement 1 (named C1 DC) is selected and therefore the vertical axis will automatically display an appropriate range for viewing that particular logged signal data in the same color associated with that data (orange for C1 DC). | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | Selecting a different measurement in the list to the left of the plot plane (for example, measurement 2) will adjust the vertical axis such that the selected measurement will be displayed along with all the other desired measurements with an appropriate range for viewing the logged signal data magnitude and change its color to reflect the currently selected data (dark blue for measurement 2). | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | To manually set the range for a measurement: | ||
+ | - Click the Utilities ({{reference: | ||
+ | - Uncheck the //Auto// box | ||
+ | - Enter desired //Top// and //Bottom// values | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | The bottom axis default is time in seconds with a minute long window where zero seconds is on the right side of the bottom axis and sixty seconds is on the left. The default sampling frequency is one second, which means that the displayed data will update once every second. Increase or decrease this displayed time window using the **History** drop-down menu, located at the top of the data plot. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | Increase or decrease sampling frequency using the **Update** drop-down menu. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | ==== Note: Using Multiple Instruments ==== | ||
+ | The //Data Logger// instrument can be used with other WaveForms instruments. Using multiple instruments at the same time is helpful in a wide variety of situations. One example would be to use the //Waveform Generator// to stimulate a circuit under test, the //Power Supplies// to provide power to the circuit, and view the response with the //Data Logger//, all at the same time. More information on how instruments can be operated together can be found in the [[test-and-measurement: | ||
+ | |||
+ | It should be noted that the analog input channels cannot be shared by multiple instruments. When the Voltmeter is enabled, any other instruments using the analog input channels are disabled. Other instruments that use the analog input channels include the // | ||
+ | ---- | ||
+ | ====3. Data Logger User Interface Overview==== | ||
+ | //This section walks through the wide variety of controls and features present in the //Data Logger// instrument.// | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.1 Control Buttons=== | ||
+ | As seen in Section 2, the control bar near the top of the window can be used to stop and start the capturing of data from the analog input pins. In addition to the Run/Stop button, the **Single** button can be used to start data acquisition and run for the time specified under the History drop-down menu. In the //Data Logger// window, these buttons both start the data acquisition but a second click on the **Single** button will simply restart the acquisition whereas the **Run** button will now display Stop and a second click will stop the data acquisition. These options can also be accessed in the **Control** drop-down menu located above the control bar. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.2 Data Export=== | ||
+ | To export data from the //Data Logger// tool, click the Export ({{learn: | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | The **Data** tab allows for export of a .csv file containing all of the current data points in the plot plane with comments, headers, and labels as default or an image of the current plot plane. Remove comments, headers, and/or labels by unchecking the corresponding box located in the upper left section of this window. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | The **Image** tab allows for saving of an image of the //Data Logger// tool interface including the plot plane, measurements list, and the control bar with the option of displaying the device, serial number, and time that the image was taken. To change the background color of the plot for printing, see Plot Utilities in section 3.8. | ||
+ | |||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.3 Measurement Maximum/ | ||
+ | To the left of the Single acquisition button described in section 3.1 is a drop-down menu that says **Show**. Click on this to select whether or not to add columns to display the minimum, maximum, and/or average measurements. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group>< | ||
+ | ===3.4 Measurements Pane=== | ||
+ | The Measurements Pane, on the left side of the screen, displays a table containing measurements of each of the signals captured on the analog input channels. Each measurement corresponds to a line in the plot pane. The Measurements Pane is used to view a summary of measurements currently being tracked, as well as to define what measurements are to be tracked as data is logged. | ||
+ | </ | ||
+ | {{ : | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.4.1 Measurements - Add and Edit (Basic)=== | ||
+ | To edit an existing measurement, | ||
+ | ?nolink}}) (to the left of the " | ||
+ | |||
+ | Alternatively, | ||
+ | |||
+ | The Item tab contains commonly used, predefined measurements for each channel: DC voltage, True RMS voltage, and RMS voltage. These are the default measurements that are displayed when opening the //Data Logger// instrument, but if they were to be deleted they can be quickly added again from here. | ||
+ | </ | ||
+ | {{ : | ||
+ | </ | ||
+ | <WRAP group>< | ||
+ | The Function tab by default displays the script editor window. It can be used to manually type a mathematical function or click on a one of the desired functions displayed below the //Insert// checkbox to add them to measurement function. To hide the built in functions, uncheck the //Insert// box. | ||
+ | |||
+ | (**NOTE:** //all trigonometric functions operate on radian values, not degrees// | ||
+ | |||
+ | Click the Evaluate Script button ({{learn: | ||
+ | |||
+ | To change the color of the measurements, | ||
+ | </ | ||
+ | {{ : | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group>< | ||
+ | ===3.4.2 Measurements - Add and Edit (Advanced)== | ||
+ | Within the Function tab of //Add Measurements//, | ||
+ | in the script editor window. The Debug button launches a script debugger, which provides an environment to step through complex scripts to ensure proper functionality, | ||
+ | </ | ||
+ | {{ : | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.4.3 Measurements - Remove=== | ||
+ | The far left side of the control bar has a green plus ({{learn: | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.5 Sampling Utilities=== | ||
+ | To the right of the **Update** drop-down menu on the control bar is a Utilities Icon ({{learn: | ||
+ | |||
+ | **Important: | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.6 Plot Plane Cursors=== | ||
+ | To add a vertical bar cursor to the plot plane, click the Add Cursor ({{learn: | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.7 Quick Measure Tools=== | ||
+ | Additional cursor types are available by clicking either the Free ({{learn: | ||
+ | |||
+ | Click the Free icon once and the mouse cursor will display the time and magnitude values of the selected measurement as it hovers over the plot plane. Click on the plot plane to place a cursor point at the desired position, then drag the mouse horizontally and/or vertically to place a differential cursor point. Click again to replace the original cursor point and so on. Click the Free icon again to exit this mode. | ||
+ | |||
+ | Click the Vertical icon once and the mouse will display a vertical cursor on the plot plane at the cursor position. Click on the plot plane to place the vertical cursor and display a differential cursor, then click again to place the differential vertical cursor. Click again to replace the original vertical cursor and so on. Click the Vertical icon again to exit this cursor mode. | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.8 Plot Utilities=== | ||
+ | The Utilities Icon ({{learn: | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | ---- | ||
+ | |||
+ | <WRAP group> | ||
+ | <WRAP column half> | ||
+ | ===3.9 Other Plot Plane Options=== | ||
+ | To clear the plot plane of all data without removing measurements, | ||
+ | </ | ||
+ | <WRAP column half> | ||
+ | {{ : | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ---- | ||
+ | ==== Next Steps ==== | ||
+ | |||
+ | For more guides on how to use the Digilent Test & Measurement Device, return to the device' | ||
+ | |||
+ | If voltage values seen in the //Data Logger// are significantly different from the expected voltage output of the // | ||
+ | |||
+ | For more information on WaveForms visit the [[software: | ||
+ | |||
+ | For technical support, please visit the [[https:// |