From 00099e088de72af43f1184eac193ec75d9795af5 Mon Sep 17 00:00:00 2001 From: AlexandraTrifan Date: Fri, 20 Dec 2024 14:44:06 +0200 Subject: [PATCH] docs: add initial migration of test cases for m2k and swiot Signed-off-by: AlexandraTrifan --- docs/tests/plugins/index.rst | 6 + docs/tests/plugins/m2k/digital_io_tests.rst | 106 +++ .../plugins/m2k/logic_analyzer_tests.rst | 624 +++++++++++++++++ .../plugins/m2k/network_analyzer_tests.rst | 433 ++++++++++++ docs/tests/plugins/m2k/oscilloscope_tests.rst | 642 ++++++++++++++++++ docs/tests/plugins/m2k/power_supply_tests.rst | 114 ++++ docs/tests/plugins/swiot1l/swiot1l_tests.rst | 65 ++ 7 files changed, 1990 insertions(+) create mode 100644 docs/tests/plugins/m2k/digital_io_tests.rst create mode 100644 docs/tests/plugins/m2k/logic_analyzer_tests.rst create mode 100644 docs/tests/plugins/m2k/network_analyzer_tests.rst create mode 100644 docs/tests/plugins/m2k/oscilloscope_tests.rst create mode 100644 docs/tests/plugins/m2k/power_supply_tests.rst create mode 100644 docs/tests/plugins/swiot1l/swiot1l_tests.rst diff --git a/docs/tests/plugins/index.rst b/docs/tests/plugins/index.rst index 10efe54c4..f395a56ea 100644 --- a/docs/tests/plugins/index.rst +++ b/docs/tests/plugins/index.rst @@ -11,4 +11,10 @@ Contents :maxdepth: 3 dac/dac_tests + swiot1l/swiot1l_tests + m2k/digital_io_tests + m2k/logic_analyzer_tests + m2k/network_analyzer_tests + m2k/oscilloscope_tests + m2k/power_supply_tests diff --git a/docs/tests/plugins/m2k/digital_io_tests.rst b/docs/tests/plugins/m2k/digital_io_tests.rst new file mode 100644 index 000000000..ea34bf09b --- /dev/null +++ b/docs/tests/plugins/m2k/digital_io_tests.rst @@ -0,0 +1,106 @@ +.. _digital_io_tests: + +Digital IO - Test Cases +======================== + +Initial Setup +------------- + +In order to proceed through the test case, first of all delete the Scopy *.ini file (saves previous settings made in Scopy tool) from the following path on Windows: ``C:\Users\your_username\AppData\Roaming\ADI``. + +Open the DigitalIO instrument. The interface should look like the picture below: + +Press multiple times on the “Run” button to check if the instrument works. + +Test Title +---------- + +A. IO Operation +--------------- + +Description +----------- + +Checking individual digital pin state +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Set DIO 0-7 and DIO 8-15 as individual pins. + - The interface should look like in the “Step Resources” picture (left side). + +2. Set channel 0 as output. + - The interface should look like in the “Step Resources” picture (left side). + +3. Set channel 7 as input. + - The interface should look like in the “Step Resources” picture (left side). + +4. Connect digital channel 0 to channel 7 via wires. + +5. Change the logic state of channel 0 (0/1) multiple times and monitor channel 7 state. + - When channel 0 is set to logic one, channel 7 will be automatically set to logic 1. When channel 0 is set to logic one, channel 7 will be automatically set to logic 1. + +6. Connect the channel 0 to voltmeter and channel 7 to the positive power supply. + +7. Set channel 0 to logic state 0. + - The interface should look like in the “Step Resources” picture (left side). + +8. Monitor the voltage value via voltmeter. + - On the voltmeter the voltage displayed is be between -0.050V and 0.4V. + +9. Set channel 0 to logic state 1. + - The interface should look like in the “Step Resources” picture (left side). + +10. Monitor the voltage value via voltmeter. + - On the voltmeter the voltage displayed should be between 2.9V and 3.4V. + +11. Set positive power supply to voltage level between 0V and 0.8V. + - The interface should look like in the “Step Resources” picture (left side). + +12. Monitor the channel 7 logic state. + - Channel 7 indicates logic 0 level. + +13. Set positive power supply to voltage level between 2V and 3.3V. + - The interface should look like in the “Step Resources” picture (left side). + +14. Monitor the channel 7 logic state. + - Channel 7 indicates logic 1 level. + +15. In step 2 replace by turn channel 0 with channels from 1 to 6 and from 8 to 15. Then, for each replacement repeat steps from 3 to 13. + +16. In step 2 replace with channel 7 and in step 3 by turn channels from 0 to 6 and from 8 to 15. Then, for each replacement repeat steps from 4 to 13. + +B. Group Operation +------------------ + +Set DIO 0-7 and DIO 8-15 groups as Group pins: + +Description +----------- + +Checking grouped digital pin states +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Set DIO 0-7 and DIO 8-15 as Group pins. + - The interface should look like in the “Step Resources” picture (left side). + +2. Connect DIO 0-7 to DIO 8-15 via wires. + +3. Set DIO 0-7 as output. + - The interface should look like in the “Step Resources” picture (left side). + +4. Set DIO 8-15 as input. + - The interface should look like in the “Step Resources” picture (left side). + +5. Set DIO 0-7 at value 0. + - The same value of DIO 0-7 group must be displayed on the DIO 8-15 group. + +6. Set DIO 0-7 at value 128. + - The same value of DIO 0-7 group must be displayed on the DIO 8-15 group. + +7. Set DIO 0-7 at value 170. + - The same value of DIO 0-7 group must be displayed on the DIO 8-15 group. + +8. Set DIO 0-7 at value 255. + - The same value of DIO 0-7 group must be displayed on the DIO 8-15 group. + +9. Set DIO 0-7 as input and DIO 8-15 as output. Repeat step 2. + - For each value set for the DIO 8-15 group, the same value must be displayed on the DIO 0-7 group. \ No newline at end of file diff --git a/docs/tests/plugins/m2k/logic_analyzer_tests.rst b/docs/tests/plugins/m2k/logic_analyzer_tests.rst new file mode 100644 index 000000000..a7dae574a --- /dev/null +++ b/docs/tests/plugins/m2k/logic_analyzer_tests.rst @@ -0,0 +1,624 @@ +.. _logic_analyzer_tests: + +Logic Analyzer - Test Cases +=========================== + +In order to proceed through the test case, first of all delete the Scopy *.ini file (saves previous settings made in Scopy tool) from the following path on Windows: ``C:\Users\your_username\AppData\Roaming\ADI``. + +Open the Logic Analyzer instrument. The interface should look like the picture below: + +Press multiple times on the “Run” button to check if the instrument works. + +Test Title +---------- + +A. Individual Pin Operation +---------------------------- + +Description +----------- + +Checking Channel's Trigger Function +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0 and DIO1 on Logic analyzer, on the settings menu set sample rate to 50ksps and add a delay ex. -142 samples. On Pattern generator, enable DIO1, set the following parameter: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 50%. On Digital IO instrument, set DIO0 as output. + - The interface should look like in the “Step Resources” picture (left side). Additional signals from the pattern generator and Logic analyzer from DIO2 to DIO15 at different frequencies will be better. + +Rising edge trigger +~~~~~~~~~~~~~~~~~~~ + +2. Set DIO0’s trigger to rising edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 0 to 1 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Falling edge trigger +~~~~~~~~~~~~~~~~~~~~~ + +3. Set DIO0’s trigger to falling edge configuration and run both pattern generator and logic analyzer. Change DIO0’s output from 1 to 0 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Any edge trigger +~~~~~~~~~~~~~~~~ + +4. Set DIO0’s trigger to any edge configuration and run both pattern generator and logic analyzer. Change DIO0’s output either from 1 to 0 or 0 to 1 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Low trigger +~~~~~~~~~~~ + +5. Set DIO0’s Low configuration and run both pattern generator and logic analyzer. Set DIO0’s output to 0. + - The logic analyzer should continuously capture the signal. + +High Trigger +~~~~~~~~~~~~ + +6. Set DIO0’s trigger to high configuration and run both pattern generator and logic analyzer. Set DIO0’s output to 1. + - The logic analyzer should continuously capture the signal. + +7. Repeat steps 1 to 6 using DIO1 to DIO15 as triggers in the logic analyzer and Digital IO instrument and the remaining DIO channel as the signal to be captured of using Pattern generator. + - The results should all be the same. + +Testing External Triggers +~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. On Digital IO instrument set DIO0 as output. No changes on Pattern Generator. On Logic Analyzer’s trigger menu, turn on the External trigger. Select source as External Trigger In. + - The interface should look like in the “Step Resources” pictures. Turning on the External Trigger should automatically turn off the triggers set on every DIO channels if there are any. + +2. Connect Trigger in 1 to DIO0. + +Rising Edge Trigger +~~~~~~~~~~~~~~~~~~~ + +3. Set External 1’s trigger to rising edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 0 to 1 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Falling Edge Trigger +~~~~~~~~~~~~~~~~~~~~~ + +4. Set External 1’s trigger to falling edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 1 to 0 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Any Edge Trigger +~~~~~~~~~~~~~~~~ + +5. Set External 1’s trigger to any edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 1 to 0 or 0 to 1 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Low Trigger +~~~~~~~~~~~ + +6. Set External 1’s trigger to low trigger configuration, run Digital IO, pattern generator and logic analyzer instrument. Set DIO0’s output to 0 from the Digital IO instrument. + - The logic analyzer should continuously capture the signals. + +High Trigger +~~~~~~~~~~~~ + +7. Set External 1’s trigger to high trigger configuration, run Digital IO, pattern generator and logic analyzer instrument. Set DIO0’s output to 1 from the Digital IO instrument. + - The logic analyzer should continuously capture the signals. + +Testing Oscilloscope Source External Trigger +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +8. In Logic analyzer enable External trigger and set Source to Oscilloscope. + - The logic analyzer should initiate a capture when the Oscilloscope is triggered. + +9. Connect W1 to 1+ and GND to 1- and generate a Sine Waveform with 2V peak-to-peak amplitude and 200Hz frequency. Set the Oscilloscope trigger to normal and Condition to Rising Edge. + - The Oscilloscope should be triggered when the two blue Trigger cursors are intersected on the rising edge of the signal. + +10. Run Signal Generator, Oscilloscope and Logic analyzer and verify if the Logic analyzer is triggered at the same time with the Oscilloscope. + - If you drag the horizontal cursor in the Oscilloscope window above or below the signal, it should be in Waiting state, and Logic analyzer will be Waiting too. + +11. Repeat steps 9-10 for each condition of the trigger available in Oscilloscope. + - Logic Analyzer and Oscilloscope should capture signals simultaneously and be in Waiting state at the same time. + +Testing the Trigger Modes +~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. On Pattern Generator, enable DIO2 and then set it to clock pattern 5KHz frequency. On Logic Analyzer, enable DIO0, DIO1, and DIO2. Set DIO0 and DIO1 trigger to both HIGH. Disable External trigger. + - The interface should look like in the “Step Resources” pictures. Turning on the External Trigger should automatically turn off the triggers set on every DIO channels if there are any. + +2. On Digital IO instrument set DIO0 and DIO1 as output. + +OR Mode +~~~~~~~ + +3. On Logic Analyzer’s trigger configuration, set the trigger logic to OR. On Digital IO instrument, Set DIO0’s output to 0 and DIO1’s output to 0. Run Digital IO, Pattern Generator and Logic Analyzer Instrument. + - The logic analyzer should be on waiting mode and not capture any signal. + +4. On Digital IO instrument, Set DIO0 or DIO1’s output to 1. + - The logic analyzer should start capturing signal when either of the DIO0 or DIO1 is HIGH. + +AND Mode +~~~~~~~~ + +5. On Logic Analyzer’s trigger configuration, set the trigger logic to AND. On Digital IO instrument, Set DIO0’s output to 0 and DIO1’s output to 1. Run Digital IO, Pattern Generator and Logic Analyzer Instrument. + - The logic analyzer should be on waiting mode and not capture any signal. + +6. On Digital IO instrument, Set DIO0’s and DIO1’s output to 1. + - The logic analyzer should start capturing signal only when DIO0 and DIO1 are HIGH. + +Checking Channel's Clock Signal Measurement Accuracy +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0, on the settings menu set sample rate to 50ksps, enable the cursor. On Pattern generator’s DIO0, set the following parameter: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 50%. + - Refer to the step resource picture. + +2. Move the cursors to the consecutive rising edges or consecutive falling edges. + - The data measured by the cursor should be close to ∆t: 10ms and 1/∆t: 100Hz. + +3. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 10ms and 1/∆t: 100Hz. + +4. Set logic analyzer’s settings to sample rate: 100Msps, position: 0s. Set pattern generator DIO0’s parameters to: Pattern: clock, Frequency: 2.5MHz, Phase: 0 degrees and Duty Cycle: 50%. + - Refer to the step resource picture. + +5. Move the cursors to the consecutive rising edges or consecutive falling edges. + - The data measured by the cursor should be close to ∆t: 400ns and 1/∆t: 2.5MHz. + +6. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 400ns and 1/∆t: 2.5MHz. + +7. Set logic analyzer’s settings to sample rate: 20ksps. Set pattern generator DIO0’s parameters to: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 70%. + - Refer to the step resource. + +8. Move the cursors to the rising and falling edge of the upper limit. + - The data measured by the cursor should be close to ∆t: 7ms. + +9. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 7ms. + +10. Move the cursors to the falling and rising edge of the lower limit. + - The data measured by the cursor should be close to ∆t: 3ms. + +11. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 3ms. + +12. Repeat steps 1 to 11 using DIO1 to DIO15 of both pattern generator and logic analyzer. + - The results should all be the same. + +B. Group Operation +------------------- + +Description +----------- + +Parallel Mode +~~~~~~~~~~~~~ + +1. In logic analyzer, add a parallel decoder. Set Clock line to DIO8 and set Data lines 0-7 to DIO0 to DIO7. In pattern generator, group DIO0 to DIO7 set as number pattern. Enable DIO8 and set to Clock with 500Hz frequency. + - The interface should look like in the “Step Resources” picture (left side). + +2. Run the Pattern Generator and Logic analyzer instrument. Set in the pattern generator’s instrument the desired decimal value. + - On the logic analyzer plot, the reading is in hex format. For reference, 50 decimal = 32 hex, 100 decimal = 64 hex and 250 decimal = FA. + +3. In logic analyzer, add another parallel decoder. Set Clock line to DIO8 and set Data lines 0-6 to DIO9 to DIO15. In pattern generator, group DIO9 to DIO15 set as number pattern. + - The interface should look like in the “Step Resources” picture (left side). + +4. Run the Pattern Generator and Logic analyzer instrument. Set in the pattern generator’s instrument the desired decimal value of both groups. + - On the logic analyzer plot, the reading is in hex format. For reference, 50 decimal = 32 hex, 100 decimal = 64 hex and 250 decimal = FA. + +SPI Mode +~~~~~~~~ + +5. In logic analyzer set sample rate: 50ksps, group DIO0 to DIO3. Add an SPI decoder, set DIO0: CLK, DIO1: MISO, DIO2: CS# and DIO3: MOSI, set DIO2’s trigger to falling edge. In the pattern generator group DIO0 to DIO2, set Pattern: SPI, Frequency: 5kHz, Bytes per frame: 2, Interframe space 4, Data: insert 4 bytes in hex form e.g: AB CD EF 15. + - The interface should look like in the “Step Resources” picture (left side). + +6. Connect DIO1 to DIO3. + +7. Run Pattern Generator and Logic analyzer. + - In the logic analyzer the plotted MISO and MOSI data should have a similar data and 2 bytes per frame. + +8. Repeat step 5 to 7 using different groups in the logic analyzer, DIO4:DIO7, DIO8:DIO11 and DIO12:DIO15. + - The results should be the same. + +UART Mode +~~~~~~~~~ + +9. In logic analyzer set time base: 1ms, group DIO0 to DIO1, set DIO0: TX and DIO1: RX, set DIO0’s trigger to falling edge, set Baud rate: 9600, data bits: 8, parity type: none, stop bits: 1.0, bit order: lsb-first, data format: ASCII. In the pattern generator, group DIO0, set Pattern: UART, Baud: 9600, Stop bit: 1, Parity: none. + - The interface should look like in the “Step Resources” picture (left side). + +10. Connect DIO0 to DIO1. + +11. Run the Pattern Generator, set in the pattern generator’s instrument the desired ASCII value. + - On the logic analyzer plot, the TX and RX data should be the same. + +12. In step 9, change the Baud rate to 115200 for both pattern generator and logic analyzer. + - Refer to the step resource picture. + +13. Repeat step 9 to 12 using different groups in the logic analyzer, DIO1:DIO2, DIO2:DIO3 . . . . . DIO14:DIO15. + - The results should be the same. + +PWM Mode +~~~~~~~~ + +14. In Logic Analyzer, Group DIO0, Set DIO0: Data, Polarity: active-high. In pattern generator, set pattern: Clock, Frequency: 10Hz. + - Refer to the step resource image. + +15. Run pattern generator and logic analyzer. Set the duty cycle of the clock signal to 5%, 30%, 50%, 75% and 95%. + - The Data should follow the phase degrees set in the pattern generator. + +16. In step 14 change the polarity of the PWM to active-low and repeat step 15. + - The data should follow (100% - phase shift set). + +17. Repeat step 14 to 16 for DIO1. . . .DIO15. + - The result should be the same. + +C. Additional Features +---------------------- + +Description +----------- + +Customizing the channel’s visual representation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0, in the menu there are options for name and trace height. + - Refer to the step resource picture. + +2. Change the name using the text box in the setting. + - The name should change accordingly. See step resource image for reference. + +3. Change the trace height of each pin. + - The height of the signal should change accordingly. See step resource image for reference. + +4. Repeat steps 1 to 3 for DIO1 to DIO15. + - The results should be the same. + +Reset instrument +~~~~~~~~~~~~~~~~ + +5. In the Preferences menu click Reset Scopy. + - All the changes made from name, thickness and color should return to default. See step resource image for reference. + +Testing the Export Functionality +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. In the pattern generator, set two consecutive channel with similar configuration: DIO0 and DIO1: Pattern: Clock, Frequency: 100Hz, Phase: 0 and Duty Cycle: 50%. DIO2 and DIO3: Pattern: Clock, Frequency: 300Hz, Phase: 0 and Duty Cycle: 50%. DIO4 and DIO5: Pattern: Clock, Frequency: 500Hz, Phase: 0 and Duty Cycle: 50%. DIO6 and DIO7: Pattern: Clock, Frequency: 150Hz, Phase: 0 and Duty Cycle: 80%. DIO8 and DIO9: Pattern: Clock, Frequency: 200Hz, Phase: 0 and Duty Cycle: 20%. Group DIO10 to DIO15: Pattern: Number Pattern and Data: 50. Run Logic Analyzer and Pattern Generator. + - Refer to the step resource picture. + +2. On the settings menu, click export button. + - A File menu box should appear allowing the user to choose the file destination. + +3. On the settings menu, click export button. + - A File menu box should appear allowing the user to choose the file destination. + +4. Choose the desired file destination and save the file on all formats. Choose the desired configuration on different file formats. + - The files should appear in the specified folder. + +Print Plot +~~~~~~~~~~ + +1. In logic analyzer, group DIO0 to DIO7, set DIO0 : DIO0 . . . . DIO7:DIO7, set time base: 5ms. In pattern generator, group DIO0 to DIO7 set as binary counter. Run both instruments. In the Logic Analyzer, press “Print” button and save the file. + - The file obtained should be similar to: + +Decoder Table +~~~~~~~~~~~~~ + +1. In pattern generator add and set channel 0 to UART with Baud rate “9600” and Data to Send “123”. In logic analyzer add UART decoder with RX on channel 0, Baud rate “9600” and Data format “ascii”. In general settings set Sample Rate 1Msps and Nr of samples to 10k samples. Run pattern generator and logic analyzer. + - Plot should look like the resource image. + +2. Open decoder table, open settings. Set Group by “RX data”, Group size “3”, disable all rows except for “RX data” in Filter. + - This should result in each table row having 3 annotations of RX data (only count the ones directly under the sample/time info box). + +3. Set Group offset to each multiple of 3 (the input should automatically top out at the total number RX data annotations). For each offset, search for "^3$" (make sure to press enter in the search box after each offset change). + - Every time there should be at least one “3” value annotation on each table row and look similar to the resource image. + +4. Set the offset to “9”, click on each table row and double click annotations on plot. You can zoom out by right clicking the plot. + - Clicking rows should zoom in the plot, centering it on the equivalent group. Double clicking on the plot should scroll and select the equivalent table row annotation (this will reset the Group by combo box). + +5. Add a Gray code decoder and set Sample Rate to 1Msps and Nr of samples to 4M samples. Run pattern generator and logic analyzer and open decoder table settings. + - The decoder table settings will be disabled and a “waiting for plot …” label should appear while the plot is loading. + +6. In settings set Decoder to “Gray code”, Group by “Increments”, Group size “3”, Group offset “1”, Filter out all except for Phases and press Export. Perform 2 exports, using .csv and .txt formats. + - “Logic Analyzer - Test Case +========================== + +Initial Setup +------------- + +In order to proceed through the test case, first of all delete the Scopy *.ini file (saves previous settings made in Scopy tool) from the following path on Windows: ``C:\Users\your_username\AppData\Roaming\ADI``. + +Open the Logic Analyzer instrument. The interface should look like the picture below: + +Press multiple times on the “Run” button to check if the instrument works. + +Test Title +---------- + +A. Individual Pin Operation +---------------------------- + +Description +----------- + +Checking Channel's Trigger Function +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0 and DIO1 on Logic analyzer, on the settings menu set sample rate to 50ksps and add a delay ex. -142 samples. On Pattern generator, enable DIO1, set the following parameter: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 50%. On Digital IO instrument, set DIO0 as output. + - The interface should look like in the “Step Resources” picture (left side). Additional signals from the pattern generator and Logic analyzer from DIO2 to DIO15 at different frequencies will be better. + +Rising edge trigger +~~~~~~~~~~~~~~~~~~~ + +2. Set DIO0’s trigger to rising edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 0 to 1 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Falling edge trigger +~~~~~~~~~~~~~~~~~~~~~ + +3. Set DIO0’s trigger to falling edge configuration and run both pattern generator and logic analyzer. Change DIO0’s output from 1 to 0 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Any edge trigger +~~~~~~~~~~~~~~~~ + +4. Set DIO0’s trigger to any edge configuration and run both pattern generator and logic analyzer. Change DIO0’s output either from 1 to 0 or 0 to 1 from the Digital IO’s instrument. + - The logic analyzer should initiate a capture. + +Low trigger +~~~~~~~~~~~ + +5. Set DIO0’s Low configuration and run both pattern generator and logic analyzer. Set DIO0’s output to 0. + - The logic analyzer should continuously capture the signal. + +High Trigger +~~~~~~~~~~~~ + +6. Set DIO0’s trigger to high configuration and run both pattern generator and logic analyzer. Set DIO0’s output to 1. + - The logic analyzer should continuously capture the signal. + +7. Repeat steps 1 to 6 using DIO1 to DIO15 as triggers in the logic analyzer and Digital IO instrument and the remaining DIO channel as the signal to be captured of using Pattern generator. + - The results should all be the same. + +Testing External Triggers +~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. On Digital IO instrument set DIO0 as output. No changes on Pattern Generator. On Logic Analyzer’s trigger menu, turn on the External trigger. Select source as External Trigger In. + - The interface should look like in the “Step Resources” pictures. Turning on the External Trigger should automatically turn off the triggers set on every DIO channels if there are any. + +2. Connect Trigger in 1 to DIO0. + +Rising Edge Trigger +~~~~~~~~~~~~~~~~~~~ + +3. Set External 1’s trigger to rising edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 0 to 1 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Falling Edge Trigger +~~~~~~~~~~~~~~~~~~~~~ + +4. Set External 1’s trigger to falling edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 1 to 0 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Any Edge Trigger +~~~~~~~~~~~~~~~~ + +5. Set External 1’s trigger to any edge configuration, run Digital IO, pattern generator and logic analyzer instrument. Change DIO0’s output from 1 to 0 or 0 to 1 from the Digital IO instrument. + - The logic analyzer should initiate a capture. + +Low Trigger +~~~~~~~~~~~ + +6. Set External 1’s trigger to low trigger configuration, run Digital IO, pattern generator and logic analyzer instrument. Set DIO0’s output to 0 from the Digital IO instrument. + - The logic analyzer should continuously capture the signals. + +High Trigger +~~~~~~~~~~~~ + +7. Set External 1’s trigger to high trigger configuration, run Digital IO, pattern generator and logic analyzer instrument. Set DIO0’s output to 1 from the Digital IO instrument. + - The logic analyzer should continuously capture the signals. + +Testing Oscilloscope Source External Trigger +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +8. In Logic analyzer enable External trigger and set Source to Oscilloscope. + - The logic analyzer should initiate a capture when the Oscilloscope is triggered. + +9. Connect W1 to 1+ and GND to 1- and generate a Sine Waveform with 2V peak-to-peak amplitude and 200Hz frequency. Set the Oscilloscope trigger to normal and Condition to Rising Edge. + - The Oscilloscope should be triggered when the two blue Trigger cursors are intersected on the rising edge of the signal. + +10. Run Signal Generator, Oscilloscope and Logic analyzer and verify if the Logic analyzer is triggered at the same time with the Oscilloscope. + - If you drag the horizontal cursor in the Oscilloscope window above or below the signal, it should be in Waiting state, and Logic analyzer will be Waiting too. + +11. Repeat steps 9-10 for each condition of the trigger available in Oscilloscope. + - Logic Analyzer and Oscilloscope should capture signals simultaneously and be in Waiting state at the same time. + +Testing the Trigger Modes +~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. On Pattern Generator, enable DIO2 and then set it to clock pattern 5KHz frequency. On Logic Analyzer, enable DIO0, DIO1, and DIO2. Set DIO0 and DIO1 trigger to both HIGH. Disable External trigger. + - The interface should look like in the “Step Resources” pictures. Turning on the External Trigger should automatically turn off the triggers set on every DIO channels if there are any. + +2. On Digital IO instrument set DIO0 and DIO1 as output. + +OR Mode +~~~~~~~ + +3. On Logic Analyzer’s trigger configuration, set the trigger logic to OR. On Digital IO instrument, Set DIO0’s output to 0 and DIO1’s output to 0. Run Digital IO, Pattern Generator and Logic Analyzer Instrument. + - The logic analyzer should be on waiting mode and not capture any signal. + +4. On Digital IO instrument, Set DIO0 or DIO1’s output to 1. + - The logic analyzer should start capturing signal when either of the DIO0 or DIO1 is HIGH. + +AND Mode +~~~~~~~~ + +5. On Logic Analyzer’s trigger configuration, set the trigger logic to AND. On Digital IO instrument, Set DIO0’s output to 0 and DIO1’s output to 1. Run Digital IO, Pattern Generator and Logic Analyzer Instrument. + - The logic analyzer should be on waiting mode and not capture any signal. + +6. On Digital IO instrument, Set DIO0’s and DIO1’s output to 1. + - The logic analyzer should start capturing signal only when DIO0 and DIO1 are HIGH. + +Checking Channel's Clock Signal Measurement Accuracy +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0, on the settings menu set sample rate to 50ksps, enable the cursor. On Pattern generator’s DIO0, set the following parameter: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 50%. + - Refer to the step resource picture. + +2. Move the cursors to the consecutive rising edges or consecutive falling edges. + - The data measured by the cursor should be close to ∆t: 10ms and 1/∆t: 100Hz. + +3. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 10ms and 1/∆t: 100Hz. + +4. Set logic analyzer’s settings to sample rate: 100Msps, position: 0s. Set pattern generator DIO0’s parameters to: Pattern: clock, Frequency: 2.5MHz, Phase: 0 degrees and Duty Cycle: 50%. + - Refer to the step resource picture. + +5. Move the cursors to the consecutive rising edges or consecutive falling edges. + - The data measured by the cursor should be close to ∆t: 400ns and 1/∆t: 2.5MHz. + +6. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 400ns and 1/∆t: 2.5MHz. + +7. Set logic analyzer’s settings to sample rate: 20ksps. Set pattern generator DIO0’s parameters to: Pattern: clock, Frequency: 100Hz, Phase: 0 degrees and Duty Cycle: 70%. + - Refer to the step resource. + +8. Move the cursors to the rising and falling edge of the upper limit. + - The data measured by the cursor should be close to ∆t: 7ms. + +9. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 7ms. + +10. Move the cursors to the falling and rising edge of the lower limit. + - The data measured by the cursor should be close to ∆t: 3ms. + +11. Enable Lock cursor feature and measure the next edges. + - The data measured by the cursor should be close to ∆t: 3ms. + +12. Repeat steps 1 to 11 using DIO1 to DIO15 of both pattern generator and logic analyzer. + - The results should all be the same. + +B. Group Operation +------------------- + +Description +----------- + +Parallel Mode +~~~~~~~~~~~~~ + +1. In logic analyzer, add a parallel decoder. Set Clock line to DIO8 and set Data lines 0-7 to DIO0 to DIO7. In pattern generator, group DIO0 to DIO7 set as number pattern. Enable DIO8 and set to Clock with 500Hz frequency. + - The interface should look like in the “Step Resources” picture (left side). + +2. Run the Pattern Generator and Logic analyzer instrument. Set in the pattern generator’s instrument the desired decimal value. + - On the logic analyzer plot, the reading is in hex format. For reference, 50 decimal = 32 hex, 100 decimal = 64 hex and 250 decimal = FA. + +3. In logic analyzer, add another parallel decoder. Set Clock line to DIO8 and set Data lines 0-6 to DIO9 to DIO15. In pattern generator, group DIO9 to DIO15 set as number pattern. + - The interface should look like in the “Step Resources” picture (left side). + +4. Run the Pattern Generator and Logic analyzer instrument. Set in the pattern generator’s instrument the desired decimal value of both groups. + - On the logic analyzer plot, the reading is in hex format. For reference, 50 decimal = 32 hex, 100 decimal = 64 hex and 250 decimal = FA. + +SPI Mode +~~~~~~~~ + +5. In logic analyzer set sample rate: 50ksps, group DIO0 to DIO3. Add an SPI decoder, set DIO0: CLK, DIO1: MISO, DIO2: CS# and DIO3: MOSI, set DIO2’s trigger to falling edge. In the pattern generator group DIO0 to DIO2, set Pattern: SPI, Frequency: 5kHz, Bytes per frame: 2, Interframe space 4, Data: insert 4 bytes in hex form e.g: AB CD EF 15. + - The interface should look like in the “Step Resources” picture (left side). + +6. Connect DIO1 to DIO3. + +7. Run Pattern Generator and Logic analyzer. + - In the logic analyzer the plotted MISO and MOSI data should have a similar data and 2 bytes per frame. + +8. Repeat step 5 to 7 using different groups in the logic analyzer, DIO4:DIO7, DIO8:DIO11 and DIO12:DIO15. + - The results should be the same. + +UART Mode +~~~~~~~~~ + +9. In logic analyzer set time base: 1ms, group DIO0 to DIO1, set DIO0: TX and DIO1: RX, set DIO0’s trigger to falling edge, set Baud rate: 9600, data bits: 8, parity type: none, stop bits: 1.0, bit order: lsb-first, data format: ASCII. In the pattern generator, group DIO0, set Pattern: UART, Baud: 9600, Stop bit: 1, Parity: none. + - The interface should look like in the “Step Resources” picture (left side). + +10. Connect DIO0 to DIO1. + +11. Run the Pattern Generator, set in the pattern generator’s instrument the desired ASCII value. + - On the logic analyzer plot, the TX and RX data should be the same. + +12. In step 9, change the Baud rate to 115200 for both pattern generator and logic analyzer. + - Refer to the step resource picture. + +13. Repeat step 9 to 12 using different groups in the logic analyzer, DIO1:DIO2, DIO2:DIO3 . . . . . DIO14:DIO15. + - The results should be the same. + +PWM Mode +~~~~~~~~ + +14. In Logic Analyzer, Group DIO0, Set DIO0: Data, Polarity: active-high. In pattern generator, set pattern: Clock, Frequency: 10Hz. + - Refer to the step resource image. + +15. Run pattern generator and logic analyzer. Set the duty cycle of the clock signal to 5%, 30%, 50%, 75% and 95%. + - The Data should follow the phase degrees set in the pattern generator. + +16. In step 14 change the polarity of the PWM to active-low and repeat step 15. + - The data should follow (100% - phase shift set). + +17. Repeat step 14 to 16 for DIO1. . . .DIO15. + - The result should be the same. + +C. Additional Features +---------------------- + +Description +----------- + +Customizing the channel’s visual representation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Enable channel DIO0, in the menu there are options for name and trace height. + - Refer to the step resource picture. + +2. Change the name using the text box in the setting. + - The name should change accordingly. See step resource image for reference. + +3. Change the trace height of each pin. + - The height of the signal should change accordingly. See step resource image for reference. + +4. Repeat steps 1 to 3 for DIO1 to DIO15. + - The results should be the same. + +Reset instrument +~~~~~~~~~~~~~~~~ + +5. In the Preferences menu click Reset Scopy. + - All the changes made from name, thickness and color should return to default. See step resource image for reference. + +Testing the Export Functionality +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. In the pattern generator, set two consecutive channel with similar configuration: DIO0 and DIO1: Pattern: Clock, Frequency: 100Hz, Phase: 0 and Duty Cycle: 50%. DIO2 and DIO3: Pattern: Clock, Frequency: 300Hz, Phase: 0 and Duty Cycle: 50%. DIO4 and DIO5: Pattern: Clock, Frequency: 500Hz, Phase: 0 and Duty Cycle: 50%. DIO6 and DIO7: Pattern: Clock, Frequency: 150Hz, Phase: 0 and Duty Cycle: 80%. DIO8 and DIO9: Pattern: Clock, Frequency: 200Hz, Phase: 0 and Duty Cycle: 20%. Group DIO10 to DIO15: Pattern: Number Pattern and Data: 50. Run Logic Analyzer and Pattern Generator. + - Refer to the step resource picture. + +2. On the settings menu, click export button. + - A File menu box should appear allowing the user to choose the file destination. + +3. On the settings menu, click export button. + - A File menu box should appear allowing the user to choose the file destination. + +4. Choose the desired file destination and save the file on all formats. Choose the desired configuration on different file formats. + - The files should appear in the specified folder. + +Print Plot +~~~~~~~~~~ + +1. In logic analyzer, group DIO0 to DIO7, set DIO0 : DIO0 . . . . DIO7:DIO7, set time base: 5ms. In pattern generator, group DIO0 to DIO7 set as binary counter. Run both instruments. In the Logic Analyzer, press “Print” button and save the file. + - The file obtained should be similar to: + +Decoder Table +~~~~~~~~~~~~~ + +1. In pattern generator add and set channel 0 to UART with Baud rate “9600” and Data to Send “123”. In logic analyzer add UART decoder with RX on channel 0, Baud rate “9600” and Data format “ascii”. In general settings set Sample Rate 1Msps and Nr of samples to 10k samples. Run pattern generator and logic analyzer. + - Plot should look like the resource image. + +2. Open decoder table, open settings. Set Group by “RX data”, Group size “3”, disable all rows except for “RX data” in Filter. + - This should result in each table row having 3 annotations of RX data (only count the ones directly under the sample/time info box). + +3. Set Group offset to each multiple of 3 (the input should automatically top out at the total number RX data annotations). For each offset, search for "^3$" (make sure to press enter in the search box after each offset change). + - Every time there should be at least one “3” value annotation on each table row and look similar to the resource image. + +4. Set the offset to “9”, click on each table row and double click annotations on plot. You can zoom out by right clicking the plot. + - Clicking rows should zoom in the plot, centering it on the equivalent group. Double clicking on the plot should scroll and select the equivalent table row annotation (this will reset the Group by combo box). + +5. Add a Gray code decoder and set Sample Rate to 1Msps and Nr of samples to 4M samples. Run pattern generator and logic analyzer and open decoder table settings. + - The decoder table settings will be disabled and a “waiting for plot …” label should appear while the plot is loading. + +6. In settings set Decoder to “Gray code”, Group by “Increments”, Group size “3”, Group offset “1”, Filter out all except for Phases and press Export. Perform 2 exports, using .csv and .txt formats. + - “ \ No newline at end of file diff --git a/docs/tests/plugins/m2k/network_analyzer_tests.rst b/docs/tests/plugins/m2k/network_analyzer_tests.rst new file mode 100644 index 000000000..8d57debba --- /dev/null +++ b/docs/tests/plugins/m2k/network_analyzer_tests.rst @@ -0,0 +1,433 @@ +.. _network_analyzer_tests: + +Network Analyzer - Test Cases +============================= + +Initial Setup +------------- + +In order to proceed through the test case, first of all delete the Scopy \*.ini file (saves previous settings made in Scopy tool) from the following path on Windows: `C:\Users\your_username\AppData\Roaming\ADI`. + +Open the Network Analyzer instrument. The interface should look like the picture below: + +Press multiple times on the “Run” button to check if the instrument works. + +Test 1 - Low Pass Filter Test +----------------------------- + +Low Pass Filter: fc = 340Hz + +1.1 Create a first-order low pass RC filter with the following components: R = 470 Ohms, C = 1uF. This will have a cut-off frequency of approximately 340 Hz. + - The set up must look like the image in the Steps Resources picture on the left. + +1.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 10Hz, Stop – 500kHz, Sample Count – 100 + - c. Display: Min. Magnitude – -90dB, Max. Magnitude – 10dB, Min. Phase – -150°, Max. Phase – 60° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. + +1.3 Enable the “Cursor” by clicking the box at the lower right corner of the interface. + - The interface must look like the image in the Steps Resources picture. + +1.4 Move the cursor from left to right. + - The values displayed on the screen must follow accordingly. + +1.5 Move the cursor to find the -3dB point on the trace. + - The magnitude must indicate -3dB at approximately 340 Hz. The phase corresponding to the same frequency must also be indicated. + +1.6 Disable the cursor by clicking the box again. + - The cursor controls must disappear from the interface. + +1.7 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -70dB, Max. Magnitude – 50dB, Min. Phase – -120°, Max. Phase – 60° + - The plot must change accordingly as you change the values by either using the buttons or by entering the values. The plot must now look like the image in the Steps Resources. + +1.8 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +1.9 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 340 Hz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +1.10 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2 and then repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Low Pass Filter: fc = 15.9kHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +2.1 Create a first-order low pass RC filter with the following components: R = 100 Ohms, C = 0.1uF. This will have a cut-off frequency of approximately 15.9kHz. + - The set up must look like the image in the Steps Resources picture on the left. The frequency response may change due to the type of components used. + +Reference: CH1 +~~~~~~~~~~~~~~ + +2.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 10Hz, Stop – 1MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -70dB, Max. Magnitude – 5dB, Min. Phase – -120°, Max. Phase – 60° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable and move your cursor to find the -3dB point of your trace. It must be around 15.9 kHz. + +2.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -45dB, Max. Magnitude – 10dB, Min. Phase – -100°, Max. Phase – 20° + - The plot must now look like image in the Steps Resources. The plot must change accordingly as you change the values. + +2.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +2.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 15.9 kHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +2.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 10Hz to 1MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Low Pass Filter: fc = 1.59MHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +3.1 Create a first-order low pass RC filter with the following components: R = 1 kOhms, C = 100 pF. This will have a cut-off frequency of approximately 1.59MHz. + - The set up must look like the image in the Steps Resources picture on the left. The frequency response may change due to the type of components used. + +Reference: CH1 +~~~~~~~~~~~~~~ + +3.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 50Hz, Stop – 30MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -45dB, Max. Magnitude – 10dB, Min. Phase – -100°, Max. Phase – 20° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable and move your cursor to find the -3dB point of your trace. It must be around 1.59MHz. + +3.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -35dB, Max. Magnitude – 5dB, Min. Phase – -100°, Max. Phase – 35° + - The plot must change accordingly as you change the values. + +3.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the image in the Steps Resources. + +3.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 1.59 MHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +3.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 50Hz to 30MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + + +Test 2 - High Pass Filter Test +------------------------------ + +High Pass Filter: fc = 340 Hz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1.1 Create a first-order high pass RC filter with the following components: R = 470 Ohms, C = 1uF. This will have a cut-off frequency of approximately 340 Hz. + - The set up must look like the image in the Steps Resources picture on the left. + +Reference: CH1 +~~~~~~~~~~~~~~ + +1.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 1Hz, Stop – 1MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -90dB, Max. Magnitude – 10dB, Min. Phase – -180°, Max. Phase – 180° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 340 Hz. + +1.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -40dB, Max. Magnitude – 5dB, Min. Phase – -100°, Max. Phase – 150° + - The plot must change accordingly as you change the values by either using the buttons or by entering the values. The plot must now look like the image in the Steps Resources. + +1.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images in the Steps Resources. + +1.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 340 Hz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +1.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2 and then repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +High Pass Filter: fc = 15.9kHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +2.1 Create a first-order high pass RC filter with the following components: R = 100 Ohms, C = 0.1uF. This will have a cut-off frequency of approximately 15.9kHz. + - The set up must look like the image in the Steps Resources picture on the left. The frequency response may change due to the type of components used. + +Reference: CH1 +~~~~~~~~~~~~~~ + +2.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 100Hz, Stop – 10MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -70dB, Max. Magnitude – 5dB, Min. Phase – -100°, Max. Phase – 150° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable and move your cursor to find the -3dB point of your trace. It must be around 15.9 kHz. + +2.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -50dB, Max. Magnitude – 5dB, Min. Phase – -180°, Max. Phase – 150° + - The plot must change accordingly as you change the values by either using the buttons or by entering the values. The plot must now look like the image in the Steps Resources. + +2.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images in the Steps Resources. + +2.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 15.9 kHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +2.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2 and then repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +High Pass Filter: fc = 1.6MHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +3.1 Create a first-order high pass RC filter with the following components: R = 1 kOhms, C = 100pF. This will have a cut-off frequency of approximately 1.6MHz. + - The set up must look like the image in the Steps Resources picture on the left. The frequency response may change due to the type of components used. + +Reference: CH1 +~~~~~~~~~~~~~~ + +3.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 10Hz, Stop – 30MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -70dB, Max. Magnitude – 5dB, Min. Phase – -120°, Max. Phase – 60° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable and move your cursor to find the -3dB point of your trace. It must be around 1.6MHz. + +3.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -60dB, Max. Magnitude – 5dB, Min. Phase – -150°, Max. Phase – 180° + - The plot must change accordingly as you change the values. The plot must now look like the image in the Steps Resources. + +3.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the image in the Steps Resources. + +3.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move it to find the -3dB point of your trace. It must be around 1.6MHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +3.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 10Hz to 1MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Test 3 - Band Pass Filter Test +------------------------------ + +Band Pass Filter: fcl = 1.59kHz, fch = 15.9kHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1.1 Create a first-order band pass RC filter with the following components: R1 = 100 Ohms, C1 = 1uF, R2 = 100 Ohms, C2 = 0.1uF. This will have a low cut-off frequency at around 1.59kHz and a high cut-off frequency of approximately 15.9 kHz. + - The set up must look like the image in the Steps Resources picture on the left. + +Reference: CH1 +~~~~~~~~~~~~~~ + +1.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 50Hz, Stop – 5MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -90dB, Max. Magnitude – 10dB, Min. Phase – -180°, Max. Phase – 180° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable and move your cursor to find the -3dB points of your trace. It must be around 1.59 kHz and 15.9 kHz. + +1.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -50dB, Max. Magnitude – 5dB, Min. Phase – -180°, Max. Phase – 180° + - The plot must now look like the image in the Steps Resources. The plot must change accordingly as you change the values. + +1.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +1.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move them to find the -3dB points of your trace. They must be around 1.59kHz and 15.9kHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +1.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 10Hz to 1MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Band Pass Filter: fcl = 3.4kHz, fch = 723kHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +2.1 Create a first-order band pass RC filter with the following components: R1 = 470 Ohms, C1 = 0.1uF, R2 = 2.2 kOhms, C2 = 100pF. This will have a low cut-off frequency at around 3.4kHz and a high cut-off frequency of approximately 723kHz. + - The set up must look like the image in the Steps Resources picture on the left. The frequency response may change due to the type of components used. + +Reference: CH1 +~~~~~~~~~~~~~~ + +2.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 50Hz, Stop – 10MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -50dB, Max. Magnitude – 5dB, Min. Phase – -180°, Max. Phase – 180° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable the “Cursor” and move them to find the -3dB points of your trace. They must be around 3.4 kHz and 723 kHz. + +2.3 Change the “Display” settings’ parameters to view the plot effectively by clicking ± button or by entering these values: + - Display: Min. Magnitude – -40dB, Max. Magnitude – 5dB, Min. Phase – -150°, Max. Phase – 150° + - The plot must change accordingly as you change the values by either using the buttons or by entering the values. The plot must now look like the image in the Steps Resources. + +2.4 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +2.5 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. + - The plot must look like the image in the Steps Resources. Enable the “Cursor” and move them to find the -3dB points of your trace. They must be around 3.4 kHz and 723 kHz. + +Reference: CH2 +~~~~~~~~~~~~~~ + +2.6 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2 and then repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Band Stop Filter Test +--------------------- + +Notch Filter: fN = 795Hz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1.1 Create a band stop notch filter with the following components: R1 = 100 Ohms, 2xC1 = 1uF, 2xR2 = 200 Ohms, C2 = 2uF. For C2, since it is not a standard value, you might use a capacitor box or connect two 1uF capacitors in parallel to achieve the value of the capacitance. This will have a notch frequency of approximately 795Hz. At this frequency, it will be highly attenuated. + - The set up must look like the image in the Steps Resources picture on the left. + +Reference: CH1 +~~~~~~~~~~~~~~ + +1.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 20Hz, Stop – 10MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -50dB, Max. Magnitude – 5dB, Min. Phase – -180°, Max. Phase – 180° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable the “Cursor” and move it to find the lowest point of your trace. It must be around 795Hz where the frequency is highly attenuated. + +1.3 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +1.4 Change the plot back to Bode plot and switch to “Linear” frequency scale by selecting Linear under frequency sweep settings. Change the sweep’s stop frequency to 10kHz by using the ± button. + - The plot must look like the image in the Steps Resources. + +Reference: CH2 +~~~~~~~~~~~~~~ + +1.5 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 10Hz to 1MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + +Notch Filter: fN = 16.9kHz +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +2.1 Create a band stop notch filter with the following components: R1 = 100 Ohms, 2xC1 = 0.047uF, 2xR2 = 200 Ohms, C2 = 0.094uF. For C2, since it is not a standard value, you might use a capacitor box or connect two 0.047uF capacitors in parallel to achieve the value of the capacitance. This will have a notch frequency of approximately 16.9kHz. At this frequency, it will be highly attenuated. + - The set up must look like the image in the Steps Resources picture on the left. + +Reference: CH1 +~~~~~~~~~~~~~~ + +2.2 Set these configurations on the Network Analyzer: + - a. Reference: Channel 1, 1V Amplitude, 0V Offset + - b. Sweep: Logarithmic, Start – 20Hz, Stop – 10MHz, Sample Count – 100 + - c. Display: Min. Magnitude – -50dB, Max. Magnitude – 5dB, Min. Phase – -180°, Max. Phase – 180° + - d. Run the Network Analyzer. + - Check the frequency response in the Bode plot. It must look like the image in the Steps Resources picture on the left. Enable the “Cursor” and move it to find the lowest point of your trace. It must be around 16.9kHz where the frequency is highly attenuated. + +2.3 View the Nyquist and Nichols plots by going to the General Settings and choose the type of plot by clicking the dropdown box: “Nyquist” or “Nichols” (aside from “Bode”). + - The plot must look like the images from the Steps Resources. + +2.4 View back to Bode plot. Switch to Linear frequency scale by selecting Linear under frequency sweep settings. Change the sweep’s stop frequency to 200kHz by using the ± button. + - The plot must look like the image in the Steps Resources. + +Reference: CH2 +~~~~~~~~~~~~~~ + +2.5 Change the placement of the scope channels (please see the picture on the left for the setup). Switch the reference channel to Channel 2. Set these sweep values: 10Hz to 1MHz. Repeat the test steps done with CH1. + - The results must be the same with CH1’s. + + + +Test 4 - Print Plot +------------------- + +1.1 Repeat the steps 1.1 and 1.2 from Section A - Low Pass Filter. Press the “Print” button and save the file. + - The resulted file must correspond to the plot presented in the resources column. + +Test 5 - Buffer Previewer +------------------------- + +2.1 Repeat Step 1.1 from Section A - Low Pass Filter and set the configurations from Step 1.2. Change the sweep’s start and stop frequencies to 10Hz and 5kHz respectively. + - The set up must look like image from the Steps Resources picture on the left. + +2.2 Turn the Buffer Previewer “on” and click “Run.” + - The waveform above the plot must portray the current frequency being read. The Sample Count, Current Frequency, and the instantaneous DC Voltage must all start simultaneously. Check frequency response in Bode plot, the plot must look like in steps resources picture. + +2.3 Slide the blue slider from the start to the end of the Bode Plot. + - The waveform changes with regards to the Bode Plot. + +2.4 Place the blue slider on the 1kHz mark. Run the Network Analyzer. + - The waveform will stop displaying the instantaneous frequency at 1kHz. The sample count, current frequency, and DC voltage will continue to display instantaneous readings. + +Test 6 - Gain Mode +------------------ + +3.1 Under Response in the Settings, change the Gain Mode from “Automatic” to “High.” Run network analyzer and then “Print” and save plot as “high_lpf.” + - Check the frequency response in the Bode plot and it must look like the images from the Steps Resources. + +3.2 Back in Settings, change the Gain Mode to “Low.” Run the Network Analyzer. “Print” and save the plot as “low_lpf.” + - Check frequency response in Bode plot, the plot should look like in steps resources picture. + +3.3 Compare the two saved plots - the “high_lpf” plot and the “low_lpf” plot. + - The plots with gain mode set to Low have more spikes than that of the plots with gain mode set to High. + +3.4 Change the Gain Mode from “Low” to “Automatic.” Run the Network Analyzer and observe the plot. + - Scopy would use the appropriate gain mode for the circuit. In this case, the plot must be similar to that of the High Gain Mode. + +Test 7 - DC Filtering, Off +-------------------------- + +4.1 Set the offset to 1V and the gain mode to High. Run the Network Analyzer. + - The plot must be similar to the image in the Step Resource. + +4.2 Set the sweep to “Linear.” Run the Network Analyzer. + - The plot must be similar to that of the Step Resource picture. It must have a jagged and noisy plot. + +Test 8 - DC Filtering, On +------------------------- + +4.3 Turn DC Filtering “On” and set the sweep back to “Logarithmic.” Click Run. + - The plot must be similar to that of the Step Resource picture. It must be smoother than the plot in step 4.1. + +4.4 Set the sweep to “Linear.” Run the Network Analyzer. + - The plot must be similar to that of the Step Resource picture. It must be less spiky than its step 4.2 counterpart. + + +Test 9 - Reference: Export/Import +--------------------------------- + +5.1 Repeat Step 1.1 from Section B - High Pass Filter and set the configurations from Step 1.2. Turn the Buffer Previewer “On” and run “Single” on the Network Analyzer. + - The setup and plot must look like the images from the Steps Resources. + +5.2 Click the General Settings button (the one that looks like a gear) and “Export” the plot. A dialog box will open, set “automatic_hpf” as its filename and click “Save.” + - The plot must look identical to the Step Resource picture. + +5.3 In Settings, change the Gain Mode from “Automatic” to “Low” and run the Network Analyzer. + - See the Step Resource picture for reference. + +5.4 Back in the General Settings, click “Import” and select the file you exported earlier. + - Waveforms in red will be superimposed on the Bode Plot both to the Magnitude and Phase. It will serve as a reference for future plots. + +5.5 To remove the imported reference waveform, click “Remove Reference.” + - The waveforms in red will disappear. See step resource picture for reference. + +Test 10 - Reference: Snapshot +------------------------------ + +6.1 Repeat Step 1.1 from Section B - High Pass Filter and set the configurations from Step 1.2. Turn the Buffer Previewer “On” and run “Single” on the Network Analyzer. + - The plot must look similar to the step resource picture. + +6.2 On General Settings, click “Snapshot.” + - Waveforms in red will be superimposed on the Bode Plot both to the Magnitude and Phase. It will serve as a reference for future plots. + +6.3 Go back to Settings and change the Gain Mode to “Low.” Run the Network Analyzer. + - The plot readings will be superimposed on the reference waveform from Snapshot. This will make it easier to compare waveforms. \ No newline at end of file diff --git a/docs/tests/plugins/m2k/oscilloscope_tests.rst b/docs/tests/plugins/m2k/oscilloscope_tests.rst new file mode 100644 index 000000000..0b8a6c07c --- /dev/null +++ b/docs/tests/plugins/m2k/oscilloscope_tests.rst @@ -0,0 +1,642 @@ +.. _oscilloscope_tests: + +Oscilloscope ~ Test cases +========================= +The following test cases are designed to verify the functionality of the Oscilloscope plugin. + +Initial Setup +~~~~~~~~~~~~- + +In order to proceed through the test case, first of all delete the Scopy *.ini file (saves previous settings made in Scopy tool) from the following path on Windows: ``C:\Users\your_username\AppData\Roaming\ADI``. + +Open the Oscilloscope instrument. The interface must look like the picture below: + +Press multiple times on the “Run” button to check if the instrument works. + +Test 1 - Channel 1 operations +----------------------------- + +Checking the Increment/Decrement Knobs: Time Base and Volts/div +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Open Channel 1’s settings. Set the knob to large increment (without an orange dot in the center). Change the Time base and Volts/div value using the ± button. + - The time base value must change accordingly with a high increment/decrement from 2us/div to 5us/div. The volts/div value must change accordingly with a high increment/decrement from 2V/div to 5V/div, so must the graph follow, too. + +2. Set the knob to ±1 unit interval (with an orange dot in the center) by clicking the dot in the middle of the knob. Change the Time base and Volts/div value using the ± button. + - The time base and volts/div value must change accordingly. + +Checking the Increment/Decrement Knobs: Position +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +3. Open Channel 1’s settings. Set the knob to large increment (without an orange dot in the center). Change the position value using the ± button. + - The position value and graph must follow accordingly. The increment value is dependent to the value set in Time Base and Volts/div. + +4. Open Channel 1’s settings. Set the knob to small increment (with an orange dot in the center) by clicking the dot in the middle of the knob. Change the position value using the ± button. + - The position value and graph must follow accordingly. The increment value is dependent to the value set in Time Base and Volts/div. + +Waveform Readout Verification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +5. Connect AWG CH1 to scope CH1+ and scope CH1- to GND. + +Constant +~~~~~~~~ + +6. Signal Generator’s Configuration: + - a. Constant, 3.3V + - Oscilloscope’s Configuration: + - a. Select Channel 1. + - b. Trigger Settings: Trigger mode – Auto + - c. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. + +7. Enable “Measure”, open Measure Settings’ Menu, and turn on “Display All” to show all built~in signal measurements. + - The interface must look like the image in the “Step Resources” picture on the left side. Within the list of readings, the RMS reading must be within 3.2V to 3.4V. + +8. Change the value and monitor it on the oscilloscope. + - The reading must be approximately close to the set value. + +Sine Wave +~~~~~~~~~ + +9. Signal Generator’s Configuration: + ~ a. Sine wave, 2Vpp, 200Hz, 0V Offset, 0deg Phase + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 500us/div, Position – 0ms + ~ c. Vertical: Volts/Div – 500mV/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto + ~ e. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 1.5 cycle sine wave. Period: 5ms, Frequency: 200 Hz, Peak~peak: 1.9Vpp to 2.1Vpp, RMS: 0.6Vrms to 0.8Vrms + +10. Change the amplitude to 5V and the frequency to 500Hz. + ~ The oscilloscope must display 4 cycles of sine wave. Period: 2ms, Frequency: 500 Hz, Peak~peak: 4.9Vpp to 5.1Vpp, RMS: 1.74Vrms to 1.78Vrms + +Square Wave +~~~~~~~~~~~ + +11. Signal Generator’s Configurations: + ~ a. Square wave, 5Vpp, 500Hz, 0V Offset, 0deg Phase + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 500us/div, Position – 0ms + ~ c. Vertical: Volts/Div – 1V/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto + ~ e. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 8 square waves. Period: 2ms, Frequency: 500 Hz, amplitude: 4.9Vpp to 5.1Vpp, RMS: 2.4Vrms to 2.6Vrms + +12. Change the amplitude to 8V and the frequency to 2 kHz. On the oscilloscope change the time base to 200us/div. + ~ The oscilloscope must display 6 cycles of square wave. Period: 500us, Frequency: 2 kHz, amplitude: 7.9Vpp to 8.1Vpp, RMS: 3.9Vrms to 4.1Vrms + +Triangle Wave +~~~~~~~ + +13. Signal Generator’s Configurations: + ~ a. Triangle wave, 4Vpp, 2kHz, 0V Offset, 0deg Phase + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 200us/div, Position – 0ms + ~ c. Vertical: Volts/Div – 1V/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto + ~ e. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 6 triangle waves. Period: 2ms, Frequency: 2 kHz, Peak~peak: 3.9Vpp to 4.1Vpp, RMS: 1.0Vrms to 1.2Vrms + +14. Change the amplitude to 5V and the frequency to 20kHz. On the oscilloscope, change the time base to 50us/div and the volts/div to 1V/div. + ~ The oscilloscope must display 6 cycles of square wave. Period: 50us, Frequency: 20 kHz, amplitude: 4.9Vpp to 5.1Vpp, RMS: 1.3Vrms to 1.5Vrms + +Rising/Falling Ramp Sawtooth Wave +~~~~~~~~~~~~~~~~~~~~~ + +15. Signal Generator’s Configurations: + ~ a. Rising Ramp Sawtooth, 8Vpp, 20kHz, 0V Offset, 0deg Phase + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 10us/div, Position – 0ms + ~ c. Vertical: Volts/Div – 2V/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto + ~ e. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak~peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +16. Change waveform to Falling Ramp Sawtooth. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak~peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +Cursors’ Reading Verification +~~~~~~~~~~~~~~~~~ + +17. Signal Generator’s Configurations: + ~ a. Sine wave, 2Vpp, 200Hz, 0V Offset, 0deg Phase + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 1ms/div, Position – 0ms + ~ c. Vertical: Volts/Div – 500mV/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto + ~ e. Turn “Cursors” on. Turn “Measure” off. + ~ f. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak~peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +18. Adjust the horizontal cursors such that the left cursor, CurT2, is on the positive~going zero crossing point and the right cursor, CurT1, is located on the adjacent positive~going zero crossing point. This corresponds to one period of the signal. + ~ The interface must look like the image in the “Step Resources” picture on the left side. ΔT must be around 5ms. And 1/ΔT must correspond to the frequency around 200Hz. + +19. Adjust the vertical cursors such that the upper cursor, CurV1, is on the crest of the sine wave and the lower cursor, CurV2, is on the trough. This corresponds to the peak~peak amplitude of the sine wave. + ~ The interface must look like the image in the “Step Resources” picture on the left side. ΔV must be around 2V. + +20. Turn off the horizontal and the vertical cursors on the Cursor’s settings. + ~ The cursors seen on the plot as well as the readouts must disappear. + +21. Turn off “Cursors.” + ~ The interface must look like the image in the “Step Resources” picture on the left side. + +Statistics +~~~~~~~~~~ + +22. Enable “Measure.” Go to its settings and turn “Statistics” on. Under the “Custom Selection”, click on the horizontal dropdown, select “Period” and “Frequency” under the “Stats” column. On the vertical dropdown, select peak~peak, RMS, and amplitude. + ~ The interface must look like the image in the “Step Resources” picture on the left. The Min, Max, and Avg value of the measurement is shown in statistics feature. + +23. Turn off the Measure feature. + ~ The interface must look like the image in the “Step Resources” picture on the left. + +Trigger Function Verification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +24. Trigger Settings’ Configuration: + ~ a. Internal (Analog): Level – ±500mV, Hysteresis – ±50mV + ~ b. Set the knob to large increment (without an orange dot in the center). + ~ c. Change the values using the ± button. Its interval is dependent to the Volts/div value set. In order to have a ± 500mV and ±50mV intervals, set the volts/div to 500 Volts/div. + ~ The level and hysteresis value and the graph must follow accordingly. + +25. Trigger Settings’ Configuration: + ~ a. Internal (Analog): Level – ±50mV, Hysteresis – ±5mV + ~ b. Set the knob to small increment (with an orange dot in the center) by clicking the dot in the middle of the knob. + ~ c. Change the values using the ± button. + ~ The level and hysteresis value and the graph must follow accordingly. + +26. Signal Generator’s Configurations: + ~ a. Triangle wave, 5Vpp, 200Hz + ~ Oscilloscope’s Configurations: + ~ a. Select Channel 1. + ~ b. Horizontal: Time Base – 1ms/div, Position – 0ms + ~ c. Vertical: Volts/Div – 1V/div, Position – 0V + ~ d. Trigger Settings: Trigger mode – Auto, Internal – ON, Source – Channel 1, Condition – Rising Edge, Level – 0V, Hysteresis – 50mV + ~ e. Run the Signal Generator and the Oscilloscope. + ~ The interface must look like the image in the “Step Resources” picture on the left. At the origin, the graph must start at the rising edge of the triangle wave. The signal must be static and must not be “dancing.” + +27. Change condition to “Falling Edge.” + ~ At the origin, the graph must start at the falling edge of the triangle wave. The signal must be static and must not be “dancing.” + +28. Change Trigger Settings’ Configuration (Hysteresis’ Minimum Range): + ~ a. Trigger Settings: Condition – Rising Edge, Hysteresis – 10mV (minimum) + ~ b. Move the trigger level cursor until the trace is unstable. + ~ As you move the trigger level cursor, the trace is triggered in all of the rising edge parts. + +29. Change Trigger Settings’ Configuration (Hysteresis’ Middle Range): + ~ a. Trigger Settings: Condition – Rising Edge, Hysteresis – 1.25V (midrange) + ~ b. Move the trigger level cursor until the trace is unstable. + ~ As you move the trigger level cursor, the trace must be triggered from ~1.3 V to +2.5V. Below ~1.3V, the trace must not be triggered. + +30. Change Trigger Settings’ Configuration (Hysteresis’ Maximum Range): + ~ a. Trigger Settings: Condition – Rising Edge, Hysteresis – 2.5V (maximum range) + ~ b. Move the trigger level cursor until the trace is unstable. + ~ As you move the trigger level cursor, the trace must be triggered from 0 V to +2.5V. The trace must not be triggered below and above the said range. + + +Test 2 - Channel 2 operations +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Checking the Increment/Decrement Knobs: Time Base and Volts/div +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~- + +1. Open Channel 2’s settings. Set the knob to large increment (without an orange dot in the center). Change the Time base and Volts/div value using the ± button. + - The time base value must change accordingly with a high increment/decrement from 2us/div to 5us/div. The volts/div value must change accordingly with a high increment/decrement from 2V/div to 5V/div, so must the graph follow, too. + +2. Set the knob to ±1 unit interval (with an orange dot in the center) by clicking the dot in the middle of the knob. Change the Time base and Volts/div value using the ± button. + - The time base and volts/div value must change accordingly. + +Checking the Increment/Decrement Knobs: Position +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +3. Open Channel 2’s settings. Set the knob to large increment (without an orange dot in the center). Change the position value using the ± button. + - The position value and graph must follow accordingly. The increment value is dependent to the value set in Time Base and Volts/div. + +4. Open Channel 2’s settings. Set the knob to small increment (with an orange dot in the center) by clicking the dot in the middle of the knob. Change the position value using the ± button. + - The position value and graph must follow accordingly. The increment value is dependent to the value set in Time Base and Volts/div. + +Waveform Readout Verification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +5. Connect AWG CH1 to scope CH2+ and scope CH2- to GND. + +Constant +~~~~~~~~ + +6. Signal Generator’s Configuration: + - a. Constant, 3.3V + - Oscilloscope’s Configuration: + - a. Select Channel 2. + - b. Trigger Settings: Trigger mode – Auto + - c. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. + +7. Enable “Measure”, open Measure Settings’ Menu, and turn on “Display All” to show all built-in signal measurements. + - The interface must look like the image in the “Step Resources” picture on the left side. Within the list of readings, the RMS reading must be within 3.2V to 3.4V. + +8. Change the value and monitor it on the oscilloscope. + - The reading must be approximately close to the set value. + +Sine Wave +~~~~~~~~- + +9. Signal Generator’s Configuration: + - a. Sine wave, 2Vpp, 200Hz, 0V Offset, 0deg Phase + - Oscilloscope’s Configurations: + - a. Select Channel 2. + - b. Horizontal: Time Base – 500us/div, Position – 0ms + - c. Vertical: Volts/Div – 500mV/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto + - e. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 1.5 cycle sine wave. Period: 5ms, Frequency: 200 Hz, Peak-peak: 1.9Vpp to 2.1Vpp, RMS: 0.6Vrms to 0.8Vrms + +10. Change the amplitude to 5V and the frequency to 500Hz. + - The oscilloscope must display 4 cycles of sine wave. Period: 2ms, Frequency: 500 Hz, Peak-peak: 4.9Vpp to 5.1Vpp, RMS: 1.74Vrms to 1.78Vrms + +Square Wave +~~~~~~~~~~- + +11. Signal Generator’s Configurations: + - a. Square wave, 5Vpp, 500Hz, 0V Offset, 0deg Phase + - Oscilloscope’s Configurations: + - a. Select Channel 2. + - b. Horizontal: Time Base – 500us/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto + - e. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 8 square waves. Period: 2ms, Frequency: 500 Hz, amplitude: 4.9Vpp to 5.1Vpp, RMS: 2.4Vrms to 2.6Vrms + +12. Change the amplitude to 8V and the frequency to 2 kHz. On the oscilloscope change the time base to 200us/div. + - The oscilloscope must display 6 cycles of square wave. Period: 500us, Frequency: 2 kHz, amplitude: 7.9Vpp to 8.1Vpp, RMS: 3.9Vrms to 4.1Vrms + +Triangle Wave +~~~~~~~~~~~~- + +13. Signal Generator’s Configurations: + - a. Triangle wave, 4Vpp, 2kHz, 0V Offset, 0deg Phase + - Oscilloscope’s Configurations: + - a. Select Channel 2. + - b. Horizontal: Time Base – 200us/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto + - e. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 6 triangle waves. Period: 2ms, Frequency: 2 kHz, Peak-peak: 3.9Vpp to 4.1Vpp, RMS: 1.0Vrms to 1.2Vrms + +14. Change the amplitude to 5V and the frequency to 20kHz. On the oscilloscope, change the time base to 50us/div and the volts/div to 1V/div. + - The oscilloscope must display 6 cycles of square wave. Period: 50us, Frequency: 20 kHz, amplitude: 4.9Vpp to 5.1Vpp, RMS: 1.3Vrms to 1.5Vrms + +Rising/Falling Ramp Sawtooth Wave +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~- + +15. Signal Generator’s Configurations: + - a. Rising Ramp Sawtooth, 8Vpp, 20kHz, 0V Offset, 0deg Phase + - Oscilloscope’s Configurations: + - a. Select Channel 2. + - b. Horizontal: Time Base – 10us/div, Position – 0ms + - c. Vertical: Volts/Div – 2V/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto + - e. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak-peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +16. Change waveform to Falling Ramp Sawtooth. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak-peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +Cursors’ Reading Verification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +17. Signal Generator’s Configurations: + - a. Sine wave, 2Vpp, 200Hz, 0V Offset, 0deg Phase + - Oscilloscope’s Configurations: + - a. Select Channel 2. + - b. Horizontal: Time Base – 1ms/div, Position – 0ms + - c. Vertical: Volts/Div – 500mV/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto + - e. Turn “Cursors” on. Turn “Measure” off. + - f. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left side. The oscilloscope must display 3 sawtooth waves. Period: 50us, Frequency: 20 Hz, Peak-peak: 7.9Vpp to 8.1Vpp, RMS: 2.2Vrms to 2.4Vrms + +18. Adjust the horizontal cursors such that the left cursor, CurT2, is on the positive-going zero crossing point and the right cursor, CurT1, is located on the adjacent positive-going zero crossing point. This corresponds to one period of the signal. + - The interface must look like the image in the “Step Resources” picture on the left side. ΔT must be around 5ms. And 1/ΔT must correspond to the frequency around 200Hz. + +19. Adjust the vertical cursors such that the upper cursor, CurV1, is on the crest of the sine wave and the lower cursor, CurV2, is on the trough. This corresponds to the peak-peak amplitude of the sine wave. + - The interface must look like the image in the “Step Resources” picture on the left side. ΔV must be around 2V. + +20. Turn off the horizontal and the vertical cursors on the Cursor’s settings. + - The cursors seen on the plot as well as the readouts must disappear. + +21. Turn off “Cursors.” + - The interface must look like the image in the “Step Resources” picture on the left side. + +Statistics +~~~~~~~~~~ + +22. Enable “Measure.” Go to its settings and turn “Statistics” on. Under the “Custom Selection”, click on the horizontal dropdown, select “Period” and “Frequency” under the “Stats” column. On the vertical dropdown, select peak-peak, RMS, and amplitude. + - The interface must look like the image in the “Step Resources” picture on the left. The Min, Max, and Avg value of the measurement is shown in statistics feature. + +23. Turn off the Measure feature. + - The interface must look like the image in the “Step Resources” picture on the left. + +Trigger Function Verification +~~~~~~~~~~~~~~~~~~~~~~~~~~~~- + +24. Trigger Settings’ Configuration: + - a. Internal (Analog): Level – ±500mV, Hysteresis – ±50mV + - b. Set the knob to large increment (without an orange dot in the center). + - c. Change the values using the ± button. Its interval is dependent to the Volts/div value set. In order to have a ± 500mV and ±50mV intervals, set the volts/div to 500 Volts/div. + - The level and hysteresis value and the graph must follow accordingly. + +25. Trigger Settings’ Configuration: + - a. Internal (Analog): Level – ±50mV, Hysteresis – ±5mV + - b. Set the knob to small increment (with an orange dot in the center) by clicking the dot in the middle of the knob. + - c. Change the values using the ± button. + - The level and hysteresis value and the graph must follow accordingly. + +26. Signal Generator’s Configurations: + - a. Triangle wave, 5Vpp, 200Hz + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 1ms/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Trigger Settings: Trigger mode – Auto, Internal – ON, Source – Channel 1, Condition – Rising Edge, Level – 0V, Hysteresis – 50mV + - e. Run the Signal Generator and the Oscilloscope. + - The interface must look like the image in the “Step Resources” picture on the left. At the origin, the graph must start at the rising edge of the triangle wave. The signal must be static and must not be “dancing.” + +27. Change condition to “Falling Edge.” + - At the origin, the graph must start at the falling edge of the triangle wave. The signal must be static and must not be “dancing.” + +28. Change Trigger Settings’ Configuration (Hysteresis’ Minimum Range): + - a. Trigger Settings: Condition – Rising Edge, Hysteresis – 10mV (minimum) + - b. Move the trigger level cursor until the trace is unstable. + - As you move the trigger level cursor, the trace is triggered in all of the rising edge parts. + +29. Change Trigger Settings’ Configuration (Hysteresis’ Middle Range): + - a. Trigger Settings: Condition – Rising Edge, Hysteresis – 1.25V (midrange) + - b. Move the trigger level cursor until the trace is unstable. + - As you move the trigger level cursor, the trace must be triggered from -1.3 V to +2.5V. Below -1.3V, the trace must not be triggered. + +30. Change Trigger Settings’ Configuration (Hysteresis’ Maximum Range): + - a. Trigger Settings: Condition – Rising Edge, Hysteresis – 2.5V (maximum range) + - b. Move the trigger level cursor until the trace is unstable. + - As you move the trigger level cursor, the trace must be triggered from 0 V to +2.5V. The trace must not be triggered below and above the said range. + + +Test 3 - Math channel operations +--------------------------------- + +C. Math Channel Operation +------------------------- + +Description +----------- + +1. Connect AWG CH1 to scope CH1+ and scope CH1- to GND. Connect AWG CH2 to scope CH2+ and scope CH2- to GND. + +2. Signal Generator’s Configurations: + - a. For Channel 1: Sine wave, 5Vpp, 500Hz + - b. For Channel 2: Square wave, 2Vpp, 500Hz + - Oscilloscope’s Configurations (For Channels 1 and 2): + - a. Horizontal: Time Base – 500us/div, Position – 0ms + - b. Vertical: Volts/Div – 1V/div, Position – 0V + - c. Trigger Settings: Trigger mode – Auto + +Adding Math Channel 1 using CH1 +------------------------------- + +3. Click on the plus sign beside Channel 2 to add the Math channel. In the box, input the following: `sqrt(t0*t0)`. Note that “t0” is the signal in CH1. + - Oscilloscope must display the absolute values of Channel 1. + +4. Turn on the “Display All” Measurement feature on for CH1 and Math CH1. + - CH1 peak-peak: 4.9Vpp to 5.1 Vpp, Math CH1 peak-peak: 2.4Vpp to 2.6Vpp since there is no negative part. + +Adding Math Channel 2 using CH2 +------------------------------- + +5. Click on the plus sign to add another Math channel. In the box, input the following: `2*(t1+t1)`. Note that “t1” is the signal in CH2. + - The interface must look like the image in the “Step Resources” picture on the left. The amplitude of CH2 must increase 4 times based on the function. + +6. Turn on the “Display All” Measurement feature on for CH2 and Math CH2. + - CH2 peak-peak: 1.9Vpp to 2.1 Vpp, Math CH2 peak-peak: 7.9Vpp to 8.1Vpp. The amplitude of CH2 must increase 4 times based on the function. + +Adding Math Channel 3 using both CH1 and CH2 +-------------------------------------------- + +7. Click on the plus sign to add another channel. Set these Signal Generator’s Configurations: + - a. For Channel 1: Sine wave, 5Vpp, 500Hz + - b. For Channel 2: Sine wave, 2Vpp, 1kHz + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 500us/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Add Math CH3: `t0+t1`. + +Adding Math Channel 4 using both CH1 and CH2 +-------------------------------------------- + +8. Click on the plus sign to add another channel. Add math channel 4: `t0*t1`. + - The interface must look like the image in the “Step Resources” picture on the left. The math pad panel will automatically close after adding the fourth math channel. This indicates that you have reached the number of math channels to be added. The plus sign on the bottom also disappears. + + +FFT Function +------------ + +1. Open the General Settings. Turn on FFT. Set the Signal Generator to the following: + - a. For Channel 1: Square wave, 5Vpp, 1kHz + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 5ms/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - The interface must look like the image in the “Step Resources” picture on the left. + +X-Y Plot +-------- + +2. Plot the current vs voltage characteristics of a PN junction diode. Use 1k-ohm resistor and a 1N914 small signal diode. Refer to the Steps Resources picture for the circuit and breadboard connections. + +3. Signal Generator’s Configuration: + - a. For Channel 1: Triangle wave, 6Vpp, 100Hz, 0V Offset + - Oscilloscope’s Configurations: + - a. General Settings: XY (View) – ON (to plot the voltage across the diode (scope CH1) on the X axis against the current in the diode (scope CH2) on the Y axis) + - The XY plot must look like the image in the Steps Resources on the left. + +Export Feature +-------------- + +4. Remove the connections to the previous circuit. Set these configurations to the Signal Generator: + - a. For Channel 1: Sine wave, 2Vpp, 200Hz + - b. For Channel 2: Square wave, 5Vpp, 500Hz + - c. Connect W1 to scope CH1 and W2 to scope CH2. Monitor this on the Oscilloscope. + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 1ms/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Run both instruments. + - The interface must look like the image in the Steps Resources column. + +Export Channel 1 +---------------- + +5. Open General Settings and turn off “Export All.” Export only Channel 1 by selecting it in the channel choices. Click “Export.” + - The interface must look like the image in the Steps Resources column. + +6. A window will pop up for saving the file in .csv format. Set the file name as Channel1.csv. Save the file. + - The interface must look like the image in the Steps Resources column. + +7. Open the file. + - The interface must look like the image in the Steps Resources column. + +Export Channel 2 +---------------- + +8. To export Channel 2, repeat the steps done in Channel 1 and save it as Channel2.csv. + - The interface must look like the image in the Steps Resources column. + +Exporting All Channels +---------------------- + +9. Add Math Channel 1, (2*t0). To export all channels including the Math channel, turn on the “Export All.” All the channels will be included in the file. Repeat the same steps of exporting a channel and save the file as allchannels.csv. + - The interface must look like the image in the Steps Resources column. + +Snapshot and Reference Waveform +------------------------------- + +10. Add a reference waveform by clicking the ‘+’ button, just as you would add a Math channel. Click “Reference” and browse for Channel1.csv that was exported earlier. The channels available for import must only be Channel 1. Click import. Do the same to Channel 2. + - The loaded waveform must be the same as what had been saved earlier. This is now a reference waveform. + +11. Add another reference waveform; select allchannels.csv. The channels available for import must now be Channel 1, Channel 2, and Math Channel 1. Select only Math Channel 1. Click import. + - The waveform must load the same as what has been saved earlier. This is now a reference waveform. + +12. Add another reference waveform using Snapshot. Increase the amplitude of the waveform in Signal Generator’s CH1. Monitor CH1 of the oscilloscope, then click “Snapshot.” + - REF 4 must be added. The waveform must correspond to the signal set in signal generator. + +Preferences +----------- + +13. Click “Preferences” at the bottom of the instrument list, go to the “Oscilloscope” section, and check the box for “Enable labels on the plot”. + - The plot must look like the image in the Steps Resources on the left. Labels must be seen respectively in each channel and math channels. The labels must follow accordingly as the time base or volts/div is changed. + +Software AC Coupling +-------------------- + +14. Set these configurations in the Signal Generator: + - a. For Channel 1: Sine wave, 2Vpp, 1kHz, 3V Offset + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 200us/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Run both instruments. + - The plot must look like the image in the Steps Resources on the left. It shows that there is a 3-volt offset. + +15. Turn on “AC Software Coupling” on oscilloscope CH1. + - The trace must slowly move towards 0V until it looks like the image in the Steps Resources on the left. + +16. Repeat steps 14 and 15 for oscilloscope Channel 2. + - The same result must show. + +Probe Attenuation +----------------- + +17. Turn on “Measurement” and turn on “Display All.” Change the probe attenuation to 0.1X, 10X, 100X, respectively. + - As the probe attenuation is changed, the measurement must change respectively i.e. 2Vpp with 10X must be shown as 20Vpp. Labels on the plot as well as the Volts/div must also change. + +External Trigger +---------------- + +18. Connect the pins as shown in the Steps Resources on the right. + +19. Pattern Generator’s Configuration: + - a. Enable DIO-0 and set as clock with 5kHz frequency. + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 200us/div, Position – 0ms + - c. Vertical: Volts/Div – 1V/div, Position – 0V + - d. Trigger Settings: Internal (Analog) – OFF, External Trigger – ON; Digital: Source – Channel 1, Condition – Rising Edge; Set to Auto (?) + - The interface must look like the image in the “Step Resources” picture on the left. Trace is triggered at rising edge. + +20. Change the condition to “Falling Edge.” + - Trace is triggered at falling edge. When changing the condition, the plot must follow accordingly. + +21. Disconnect T1 and replace it with T0. Change channel source to Channel 2. Repeat steps 18 and 19. + - The trace must still be triggered the same as with T1. + +Autoset +------- + +22. Disconnect the connections from the previous steps. Connect Scope CH1+ to W1 and Scope CH1- to GND. Set these on the Signal Generator: + - a. For Channel 1: Sine wave, 2Vpp, 5MHz + - b. Run Signal Generator and Oscilloscope. On the Oscilloscope, click “Autoset.” + - After clicking, wait until the signal/waveform is properly displayed. Trigger must be automatically set to (max-min)/2 - at 50%. Vertical and Horizontal values must automatically be adjusted. + +23. Change signal to a 5V, 500kHz sinewave. Click “Autoset” again. + - After clicking, wait until the signal/waveform is properly displayed. Trigger must be automatically set to (max-min)/2 - at 50%. Vertical and Horizontal values must automatically be adjusted. + +24. Change the signal to a 10V, 500 Hz sinewave. Click “Autoset” again. + - After clicking, wait until the signal/waveform is properly displayed. Trigger must be automatically set to (max-min)/2 - at 50%. Vertical and Horizontal values must automatically be adjusted. + +25. Repeat steps with Channel 2. + +Print Plot +---------- + +26. Connect Oscilloscope’s CH1 to Signal Generator’s CH1+. Connect Oscilloscope’s CH2 to Signal Generator’s CH2. Set these on the Signal Generator: + - a. For Channel 1: Sine wave, 10Vpp, 1kHz + - b. For Channel 2: Square wave, 5Vpp, 1kHz + - Oscilloscope’s Configurations (For Channels 1 and 2): + - a. Horizontal: Time Base – 200us/div, Position – 0ms + - b. Vertical: Volts/Div – 1V/div, Position – 0V + - c. Press the “Print” button in the top left of the Oscilloscope instrument and save the file in pdf format. + - The expected result must be a pdf file: plotscreenshot.pdf + +Curve Style +----------- + +27. On the Signal Generator, set Channel 1’s frequency to 2MHz and Channel 2’s to 5MHz. Monitor both channels in the Oscilloscope. Change curve styles of both channels. + - The waveform must correspond to the changes set on the curve style. + +Gating +------ + +28. Signal Generator’s Configurations: + - a. For Channel 1: Sine wave, 10Vpp, 10kHz + - b. For Channel 2: Sine wave, 5Vpp, 1Hz + - Oscilloscope’s Configurations: + - a. Enable the “Measure” feature and turn the “Gating Settings” on. + - b. For Channel 1: Move the gating sliders to ~0s and ~50us. + - c. For Channel 2: Move the gating sliders to ~0s and ~500us. + - The peak-to-peak reading must be half the set amplitude. Channel 1 peak-peak = ~5V, channel 2 peak-peak = ~2.5V. + +Histogram +--------- + +29. Open the General Settings and turn the “Histogram” on. Change the waveform of both channels to square. + - A window must be displayed showing the histogram of the waveform. For this case, the histogram must show the high and low value of the square waves. + +ADC Digital Filters +------------------- + +30. Refer to the following document for ADC digital Filter calibration. + - Compensation using the digital filters + +31. Set these on the Signal Generator: + - a. For Channel 1: Square wave, 2Vpp, 1kHz + - Oscilloscope’s Configurations: + - a. Select Channel 1. + - b. Horizontal: Time Base – 200ms/div, Position – 0ms + - c. Vertical: Volts/Div – 500mV/div, Position – 0V + - d. Calibrate the signal with the hardware trimmers. + - The interface must look like the image in the “Step Resources” picture on the left side. + +32. Set the Oscilloscope’s Volt/Div to 1V/Div (high gain mode). + - The waveform was adjusted in low gain mode and in high gain mode it must look similar to the step resources picture. + +33. Enable the ADC Filters (Filter 1 Filter 2) from channel settings and set the parameters as follows: Filter 1: TC=60, gain=-0.025, Filter2: TC=9, gain=0.047. + - The result must be like in the step resources picture where signals are as follows: Initial signal (green), Filter 1 signal (cyan), cascaded filters signal (orange). + +34. Now if you switch between high gain (±2.5V) and low gain (±25V), you must see a Square waveform in both cases. + - The filters must be active in the mode they were enabled. + +35. Repeat steps 31-34 for Signal Generator and Oscilloscope’s Channel. \ No newline at end of file diff --git a/docs/tests/plugins/m2k/power_supply_tests.rst b/docs/tests/plugins/m2k/power_supply_tests.rst new file mode 100644 index 000000000..875bc4f92 --- /dev/null +++ b/docs/tests/plugins/m2k/power_supply_tests.rst @@ -0,0 +1,114 @@ +.. _power_supply_tests: + +Power Supply - Test Cases +========================= + +Initial Setup +------------- + +In order to proceed through the test case, first of all delete the Scopy \*.ini file (saves previous settings made in Scopy tool) from the following path on Windows: ``C:\Users\your_username\AppData\Roaming\ADI``. + +Open the Power Supply instrument. The interface should look like the picture below: + +Press multiple times on the “Enable” buttons to check if the instrument works. + +Test Title +---------- + +A. Independent Controls +------------------------ + +Description +----------- + +Checking positive voltage output +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Set Tracking ratio control to Independent Controls. + - The interface should look like in the “Step Resources” picture (left side). + +2. Connect the power supply and voltmeter with the following pins: V+ power supply pin (red) to Scope Ch 1 (orange). + +Setting values +~~~~~~~~~~~~~~ + +3. Set the value to 3.3V and click enable. + - The interface should look like in the “Step Resources” picture (left side). + +4. Monitor the power supply output with voltmeter. + - The voltmeter should read values between 3.25V and 3.35V. Just like shown on the left. + +Changing set values +~~~~~~~~~~~~~~~~~~~ + +5. Change the power supply output value to 1.8V. + - The voltmeter should read values between 1.75V and 1.85V. + +6. Change the power supply output value to 2.5V. + - The voltmeter should read values between 2.45V and 2.55V. + +7. Change the power supply output value to 5V. + - The voltmeter should read values between 4.95V and 5.05V. + +Checking Increment/Decrement Value; ±1V +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +8. Set the knob to ±1V interval. No orange dot on the center. + - The interface should look like in the “Step Resources picture (left side). + +9. Set value to 3V. Then use +/- sign to change value with ±1V interval. + - The value should change accordingly. Set Value ± 1V = the new value. + +Checking Increment/Decrement Value; ±100mV +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +10. Set the knob to ±100mV interval. Orange dot seen on the center. + - The interface should look like in the “Step Resources picture (left side). + +11. Set value to 300mV. Then use +/- sign to change value with ±100mV interval. + - The value should change accordingly. Set Value ± 100mV = the new value. + +Checking Negative Voltage Output +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +12. Change pin connections to the following: V- power supply pin (white) to Scope Ch 1 (orange). + +13. Repeat Steps 3 to 11. Set the values mentioned to negative in checking negative output. + +B. Tracking +----------- + +Description +----------- + +Checking output when in Tracking mode +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +1. Set Tracking ratio control to Tracking. + - The interface should look like in the “Step Resources” picture (left side). + +2. Connect the following pins: V+ power supply pin (red) to Scope Ch 1 (orange); V- power supply pin (white) to Scope Ch 2 (blue). + +Setting tracking ratio +~~~~~~~~~~~~~~~~~~~~~~ + +3. Set value of positive output to 5V. Set tracking ratio to 50%. + - The negative output value should be set automatically following the equation: V- = -(ratio * V+). For 50% tracking ratio, V- = -2.5V. + +4. Monitor the power supply output with voltmeter. + - The voltmeter should read the following values: V+ = 4.95V to 5.05V; V- = -2.55V to -2.45V. + +Changing tracking ratio +~~~~~~~~~~~~~~~~~~~~~~~ + +5. Set tracking ratio to 10%. + - Negative output Value should be set to -500mV. The voltmeter should read the following values: V+ = 4.95V to 5.05V; V- = -505mV to -495mV. + +6. Set tracking ratio to 25%. + - Negative output Value should be set to -1.25V. The voltmeter should read the following values: V+ = 4.95V to 5.05V; V- = -1.30V to -1.20V. + +7. Set tracking ratio to 66%. + - Negative output Value should be set to -3.3V. The voltmeter should read the following values: V+ = 4.95V to 5.05V; V- = -3.35V to -3.25V. + +8. Set tracking ratio to 100%. + - Negative output Value should be set to -5V. The voltmeter should read the following values: V+ = 4.95V to 5.05V; V- = -5.05V to -4.95V. \ No newline at end of file diff --git a/docs/tests/plugins/swiot1l/swiot1l_tests.rst b/docs/tests/plugins/swiot1l/swiot1l_tests.rst new file mode 100644 index 000000000..7515d9bf2 --- /dev/null +++ b/docs/tests/plugins/swiot1l/swiot1l_tests.rst @@ -0,0 +1,65 @@ +.. _swiot1l_tests: + +SWIOT Plugin - Test Cases +========================= + +The SWIOT plugin tests are a set of tests that are used to verify the functionality of the SWIOT plugin. +The tests are designed to be run in a specific order to ensure that the plugin is functioning correctly. +The tests are divided into two main categories: **CONFIG** AND **RUNTIME**. + +The following apply for all the test cases in this suite. +If the test case has special requirements, they will be listed in the test case section. + +Depends on: + - Test TST.EMU.CONNECT + - Test TST.PREFS.RESET + +Prerequisites: + - Scopy v2.0.0 or later with SWIOT plugin installed on the system. + - Tests listed as dependencies are successfully completed. + - Reset .ini files to default using the Preferences "Reset" button. + +Test 1 - TST.SWIOT.COMPAT +------------------------- + +Title: + Test SWIOT plugin compatibility with device. + +UID: + TST.SWIOT.COMPAT + +Description: + This test verifies that the SWIOT plugin is compatible with the + selected device and that the plugin is able to correctly parse it. + +Steps: + 1. Open Scopy. + 2. Start the IIO-EMU process and connect to **swiot_config**. + 3. Open the SWIOT plugin - Config Instrument. + 4. Select the device from the device list. + +Test 2 - TST.SWIOT.CONFIG +------------------------- + +Title: + Test SWIOT plugin configuration. + +UID: + TST.SWIOT.CONFIG + +Description: + This test verifies that the SWIOT plugin is able to configure the device + correctly. + +Steps: + 1. Open Scopy. + 2. Start the IIO-EMU process and connect to **swiot_config**. + 3. Open the SWIOT plugin - Config Instrument. + 4. Configure the device with the following settings: + - **Setting 1**: Value 1 + - **Setting 2**: Value 2 + - **Setting 3**: Value 3 + + + +