Differences

This shows you the differences between two versions of the page.

--- en:python-ivi:readme [2012/12/16 22:22]
alex [Included drivers]
+++ en:python-ivi:readme [2013/06/23 08:43]
alex [Included drivers]
@@ Line 1: / Line 1: @@
 ====== Python IVI Readme ======
+===== Introduction =====
 Python IVI is a Python-based interpretation of the Interchangeable Virtual Instrument standard from the [[http://www.ivifoundation.org/|IVI foundation]].
@@ Line 5: / Line 7: @@
 ===== Included drivers =====
-  * DC Power Supplies (dcpwr)
+  * Oscilloscopes (scope)
-    * Tektronix PS2520G/PS2521G
+    * Agilent InfiniiVision 7000A/B series
-    * Agilent E3600A series
+    * Agilent Infiniium 90000A/90000X series
   * Function Generators (fgen)
     * Tektronix AWG2000 series
+  * DC Power Supplies (dcpwr)
+    * Agilent E3600A series
+    * Agilent 603xA series
+    * Tektronix PS2520G/PS2521G
   * RF Power Meters (pwrmeter):
     * Agilent 436A
   * RF Signal Generators (rfsiggen)
     * Agilent 8642 A/B
-  * Oscilloscopes (scope)
-    * Agilent InfiniiVision 7000A series
 ===== Instrument communication =====
-Python IVI can use Python VXI11, pySerial and linux-gpib to connect to instruments. The implementation of the initialize method takes a VISA resource string and attempts to connect to an instrument. If the resource string starts with TCPIP, then Python IVI will attempt to use Python VXI11. If it starts with GPIB, it will attempt to use linux-gpib's python interface. If it starts with ASRL, it attemps to use pySerial. Integration with PyVISA is planned, but not currently supported.
+Python IVI can use Python VXI-11, Python USBTMC, pySerial and linux-gpib to connect to instruments.  The implementation of the initialize method takes a VISA resource string and attempts to connect to an instrument.  If the resource string starts with TCPIP, then Python IVI will attempt to use Python VXI-11.  If it starts with USB, it attempts to use Python USBTMC.  If it starts with GPIB, it will attempt to use linux-gpib's python interface.  If it starts with ASRL, it attemps to use pySerial.  Integration with PyVISA is planned, but not currently supported.
 ===== A note on standards compliance =====
@@ Line 26: / Line 30: @@
 The Python IVI library is a Pythonized version of the .NET and COM IVI API specifications, with the CamelCase for everything but the class names replaced with lowercase_with_underscores.  The library most closely follows the .NET standard, with the calls that would require the .NET helper classes follwing the corresponding COM specifications.  There are some major deviations from the specification in order to be consistent with the spirit of the other IVI specifications.  The fgen class is the most obvious example of this, using properties instead of the getters and setters as required by the IVI specification.
+===== Installation =====
+Extract and run
+<code>
+# python setup.py install
+</code>
 ===== Usage example =====
-This sample Python code will use Python IVI connect to an Agilent MSO7104A over LXI (VXI11), configure the timebase, trigger, and channel 1, capture a waveform, and read it out of the instrument.
+This sample Python code will use Python IVI connect to an Agilent MSO7104A over LXI (VXI-11), configure the timebase, trigger, and channel 1, capture a waveform, and read it out of the instrument.
 <code python>
@@ Line 36: / Line 49: @@
 # connect to MSO7104A via LXI
 mso = ivi.agilent.agilentMSO7104A("TCPIP0::192.168.1.104::INSTR")
+# connect to MSO7104A via USBTMC
+#mso = ivi.agilent.agilentMSO7104A("USB0::2391::5973::MY********::INSTR")
 # configure timebase
 mso.acquisition.time_per_record = 1e-3
@@ Line 53: / Line 68: @@
 # read out channel 1 waveform data
 waveform = mso.channels[0].measurement.fetch_waveform()
+# measure peak-to-peak voltage
+vpp = mso.channels[0].measurement.fetch_waveform_measurement("voltage_peak_to_peak")
+# measure phase
+phase = mso.channels['channel1'].measurement.fetch_waveform_measurement("phase", "channel2")
 </code>
@@ Line 91: / Line 110: @@
 import ivi
 # connect to E3649A via GPIB
-#awg = ivi.agilent.agilentE3649A("GPIB0::5::INSTR")
+#psu = ivi.agilent.agilentE3649A("GPIB0::5::INSTR")
 # connect to E3649A via E2050A GPIB to VXI11 bridge
 psu = ivi.agilent.agilentE3649A("TCPIP0::192.168.1.105::gpib,5::INSTR")
@@ Line 97: / Line 116: @@
 #psu = ivi.agilent.agilentE3649A("ASRL::/dev/ttyUSB0,9600::INSTR")
 # configure output
+psu.outputs[0].configure_range('voltage', 12)
 psu.outputs[0].voltage_level = 12.0
 psu.outputs[0].current_limit = 1.0