Merge pull request #79 from VektrexElectronicSystems/development

Development v1.17.0

Author: eljayg

application_specific_examples/README.md

@@ -7,7 +7,8 @@ These sequences address specific scenarios in which SpikeSafe functionality is u
 - [Fixed Pulse Count Using Software Timing](fixed_pulse_count_using_software_timing)
 - [Making Tj Measurements](making_tj_measurements)
 - [Making Transient Dual Interface Measurements (JESD51-14)](making_transient_dual_interface_measurement)
-- [Measuring DC Staircase Voltages](measuring_dc_staircase_voltages)
+- [Measuring Hardware Based DC Staircase I/V Sweep](measuring_hardware_based_dc_staircase_iv_sweep)
+- [Measuring Software Based DC Staircase Voltages](measuring_software_based_dc_staircase_voltages)
 - [Measuring Wavelength Spectrum](measuring_wavelength_spectrum)
 - [Pulse Tuning](pulse_tuning)
 - [Running LIV Sweeps](running_liv_sweeps)

application_specific_examples/fixed_pulse_count_using_software_timing/FixedPulseCountUsingSoftwareTimingExample.py

@@ -108,11 +108,11 @@
     tcp_socket.send_scpi_command('OUTP1 0')
 
     # wait until the channel is fully discharged
-    if spikesafe_info.supports_discharge_query:
-        spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(tcp_socket, channel_number=1)
-    else:
-        wait_time = spikesafe_python.Discharge.get_spikesafe_channel_discharge_time(compliance_voltage)
-        spikesafe_python.Threading.wait(wait_time)
+    spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(
+        spikesafe_socket=tcp_socket, 
+        spikesafe_info=spikesafe_info,
+        compliance_voltage=compliance_voltage,
+        channel_number=1)
 
     # disconnect from SpikeSafe    
     tcp_socket.close_socket()      

application_specific_examples/making_tj_measurements/TjMeasurement.py

@@ -132,11 +132,11 @@ def calculate_Vf0(start_point: int, end_point: int, digitizer_data_list: list[sp
     tcp_socket.send_scpi_command('OUTP1 0')
 
     # wait until the channel is fully discharged
-    if spikesafe_info.supports_discharge_query:
-        spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(tcp_socket, channel_number=1)
-    else:
-        wait_time = spikesafe_python.Discharge.get_spikesafe_channel_discharge_time(compliance_voltage)
-        spikesafe_python.Threading.wait(wait_time)
+    spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(
+        spikesafe_socket=tcp_socket, 
+        spikesafe_info=spikesafe_info,
+        compliance_voltage=compliance_voltage,
+        channel_number=1)
 
     log_and_print_to_console('\nK-factor values obtained. Stopped bias current output. Configuring to perform Electrical Test Method measurement.')
 
@@ -190,11 +190,11 @@ def calculate_Vf0(start_point: int, end_point: int, digitizer_data_list: list[sp
     tcp_socket.send_scpi_command('OUTP1 0')
 
     # wait until the channel is fully discharged
-    if spikesafe_info.supports_discharge_query:
-        spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(tcp_socket, channel_number=1)
-    else:
-        wait_time = spikesafe_python.Discharge.get_spikesafe_channel_discharge_time(compliance_voltage)
-        spikesafe_python.Threading.wait(wait_time)
+    spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(
+        spikesafe_socket=tcp_socket, 
+        spikesafe_info=spikesafe_info,
+        compliance_voltage=compliance_voltage,
+        channel_number=1)
 
     # prepare digitizer voltage data to plot
     samples = []

application_specific_examples/making_transient_dual_interface_measurement/digitizer_log_sampling_demo.py

@@ -154,11 +154,11 @@ def receive_user_input_and_log() -> str:
     tcp_socket.send_scpi_command('OUTP1 0')
 
     # wait until the channel is fully discharged
-    if spikesafe_info.supports_discharge_query:
-        spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(tcp_socket, channel_number=1)
-    else:
-        wait_time = spikesafe_python.Discharge.get_spikesafe_channel_discharge_time(compliance_voltage)
-        spikesafe_python.Threading.wait(wait_time)
+    spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(
+        spikesafe_socket=tcp_socket, 
+        spikesafe_info=spikesafe_info,
+        compliance_voltage=compliance_voltage,
+        channel_number=1)
 
     # disconnect from SpikeSafe    
     tcp_socket.close_socket()      

application_specific_examples/measuring_hardware_based_dc_staircase_iv_sweep/MeasuringDcStaircaseIVSweep.py

@@ -0,0 +1,55 @@
+# Examples for Measuring Hardware Based DC Staircase Voltages Using the SpikeSafe PSMU Digitizer in Staircase Sweep Mode
+
+## Purpose
+Measuring DC staircase voltages is essential in comparing the actual versus expected I/V results of a DUT. This example demonstrates how to use a SpikeSafe PSMU to provide a DUT DC current in a staircase pattern and take both a voltage and current measurement at each step. This is an addition to [Measure Staircase Sweep Voltage](../../making_integrated_voltage_measurements/measure_staircase_sweep_voltage/) when presented with any of the following cases:
+1. Hardware triggering is available on external device
+1. Trigger timing is greater than or equal to 1ms
+1. Current readings are needed
+
+The SpikeSafe PSMU's integrated Digitizer is used to make high precision voltage measurements and the Keithley 7510 DMM is used to make current measurements while outputting a DC current steps to the DUT. The Digitizer and DMM are taking triggered readings using a hardware trigger initiated by a SCPI command. In this case a 3.5A, 25V LED is used as the DUT.
+
+## Overview 
+Operates SpikeSafe as both DC current source and a high precision voltage measurement device. A DC output is demonstrated in [Run Staircase Sweep](../../run_spikesafe_operating_modes/run_staircase_sweep/). While current is outputted, voltage measurements are being taken across the flattest portion of each current pulse. After all measurements are taken and read, the results are plotted in an I-V graph.
+
+Note the use of the New Data query while the SpikeSafe is operating. While the Digitizer is still acquiring voltage data, it can be unobtrusively queried to determine if the buffer is full yet. This information can be used to determine whether the user would ideally want to fetch data, as the data fetch will only return fresh data if the specified measurements have occurred. In this case, the New Data query will return `TRUE` once the Digitizer has taken measurements equal to its Trigger Count.
+
+### Key Settings
+
+### SpikeSafe Current Output Settings
+- **Pulse Mode**: Staircase Sweep
+- **Start Current**: 20mA
+- **Stop Current**: 200mA
+- **Step Count**: 10
+- **On Time**: 2ms
+- **Compliance Voltage**: 20V
+
+### Digitizer Voltage Measurement Settings
+- **Voltage Range**: 10V
+- **Aperture**: 500us
+- **Trigger Delay**: 1000us
+- **Trigger Source**: Hardware
+- **Trigger Count**: 10
+- **Reading Count**: 1 (per trigger)
+
+### DMM Current Measurement Settings
+- **Current Range**: 1A
+- **Aperture**: 500us
+- **Trigger Delay**: 1000us
+- **Trigger Source**: Hardware
+- **Trigger Count**: 10
+- **Reading Count**: 1 (per trigger)
+
+## Expected Results
+When running a DC staircase using this sequence, one can expect to see the following output.
+
+**I/V Graph**
+
+Once all 10 steps are measured, a graph will appear like below:
+
+![](staircase_sweep_liv.png)
+
+**DC Staircase Current Output**
+
+This image was acquired by measuring output current using a TCPA300 Current Probe into a MDO3024 Mixed Domain Oscilloscope
+
+![](dc_staircase_output.png)

application_specific_examples/measuring_hardware_based_dc_staircase_iv_sweep/README.md

@@ -118,6 +118,9 @@
         # send Set Current command for next step
         tcp_socket.send_scpi_command(cmdStr)
         currentIncrementFloat = step_size_A
+        
+        # A small delay of at least 5ms between setting the current and triggering the software trigger for the digitizer to properly measure the voltage at each step. The optimal delay time may vary based on the characteristics of the load being driven and should be determined experimentally
+        spikesafe_python.Threading.wait(0.005)
 
 
     # check for all events
@@ -134,11 +137,11 @@
     tcp_socket.send_scpi_command('OUTP1 0')
 
     # wait until the channel is fully discharged
-    if spikesafe_info.supports_discharge_query:
-        spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(tcp_socket, channel_number=1)
-    else:
-        wait_time = spikesafe_python.Discharge.get_spikesafe_channel_discharge_time(compliance_voltage)
-        spikesafe_python.Threading.wait(wait_time)
+    spikesafe_python.Discharge.wait_for_spikesafe_channel_discharge(
+        spikesafe_socket=tcp_socket, 
+        spikesafe_info=spikesafe_info,
+        compliance_voltage=compliance_voltage,
+        channel_number=1)
 
     # disconnect from PSMU    
     tcp_socket.close_socket()      

application_specific_examples/measuring_hardware_based_dc_staircase_iv_sweep/dc_staircase_output.png

@@ -1,9 +1,9 @@
-# Examples for Measuring DC Staircase Voltages Using the SpikeSafe PSMU Digitizer in DC Dynamic Mode
+# Examples for Measuring Software Based DC Staircase Voltages Using the SpikeSafe PSMU Digitizer in DC Dynamic Mode
 
 ## Purpose
-Measuring DC staircase voltages is essential in comparing the actual versus expected I/V results of a DUT. This example demonstrates how to use a SpikeSafe PSMU to provide a DUT DC current in a staircase pattern and take a voltage measurement at each step. This is an alternative to [Measure Pulsed Sweep Voltage](../../making_integrated_voltage_measurements/measure_pulsed_sweep_voltage) when presented with any of the following cases:
+Measuring DC staircase voltages is essential in comparing the actual versus expected I/V results of a DUT. This example demonstrates how to use a SpikeSafe PSMU to provide a DUT DC current in a staircase pattern and take a voltage measurement at each step. This is an alternative to [Measure Staircase Sweep Voltage](../../making_integrated_voltage_measurements/measure_staircase_sweep_voltage/) when presented with any of the following cases:
 1. No hardware triggering is available on external device
-1. Trigger timing is greater than 5ms
+1. Trigger timing is greater than or equal to 5ms
 
 The SpikeSafe PSMU's integrated Digitizer is used to make high precision voltage measurements while outputting a DC current steps to the DUT. The Digitizer is taking triggered readings using a software trigger initiated by a SCPI command. In this case a 1 ohm resistor is used as the DUT.