ARI Safety 7700 series HypotMAX series IVI Driver Getting Started User Guide

September 3, 2024
ARI Safety

7700 series HypotMAX series IVI Driver Getting Started

“`html

Product Information

Specifications:

  • Product Name: HypotMAX series (7700 series)
  • Manufacturer: IKONIX Group
  • IVI Driver Version: 1.1
  • Supported Programming Languages: C#, C++, Python, LabVIEW
  • Operating System Compatibility: Windows

Product Usage Instructions

IVI Driver Setup

Follow these steps to set up the IVI Driver:

  1. Download the IVI Driver from the manufacturer’s website.

  2. Run the self-extracting setup file to start the installation
    wizard.

  3. Check if IVI Shared Components are installed; if not, download
    and install them from the IVI Foundation Website.

  4. Complete the installation wizard.

  5. Optionally install the source code of the IVI Driver if
    needed.

  6. The IVI driver will be installed under the path of IVI
    FoundationIVI. The necessary files and help documents will be
    located in specific folders.

Getting Started with C

To begin using the IVI Driver with C#, follow these steps:

  1. Ensure you have the required software and hardware listed under
    “Requirements” below.

  2. Import the driver into your C# project.

  3. Develop a program to control the device step-by-step.

Requirements:

  • HypotMAX IVI Driver

  • IVI Shared Components: Download
    Link

  • VISA (Virtual Instrument Software Architecture) driver:

    Download Link

  • Microsoft Visual Studio or other compatible IDEs

  • HypotMAX series safety tester (e.g., 7705, 7710, 7715, or

FAQs

Q: Where can I find more information about IVI drivers?

A: For more information about IVI drivers,
please refer to the website of IVI Foundation.

Q: How can I contact support for further assistance?

A: You can contact support by calling toll-free
at 1-800-858-8378 (US/Canada) or by visiting the manufacturer’s
website at www.arisafety.com.

“`

Document Version 1.1
IVI Driver Getting Started Guide
For HypotMAX series(7700 series),
Overview
This application note will describe the installing instructions and several programming examples for IVI Instrument Driver of HypotMAX series. To understand more about the IVI drivers, please refer to the website of IVI Foundation. For more detail of the HypotMAX IVI driver, please check the help document, HypotMAX.chm, located at the path of IVI FoundationIVIDriversHypotMAX.
1. IVI Driver Setup
Instructions on downloading and Installing IVI Instrument Drivers from website. Download and install Shared Components from IVI Foundation Website.
2. Getting Started with C#
A tutorial using IVI driver establishes communication with the instrument by C# programming.
3. Getting Started with C++
A tutorial using IVI driver establishes communication with the instrument by C++ programming.
4. Getting Started with Python
A tutorial using IVI driver establishes communication with the instrument by Python programming.
5. Getting Started with LabVIEW
A tutorial using IVI driver establishes communication with the instrument by LabVIEW programming.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

1. IVI Driver Setup
After downloading the IVI Driver, run the self-extracting setup file and you will see the installation wizard to start setup. Please follow the below instruction to complete the installation.
The setup will detect if IVI Shared Components are installed. If prompted with the following screen, click on Download, The IVI Foundation Website will be opened.
Please download the latest IVI Shared Components either 32-bit or 64-bit version. After downloading, install the shared components and continue the installation.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

After the IVI Shared Components are installed, please follow the steps to complete installation.
There are options for installing the source code of the IVI Driver, if it is necessary.
The IVI driver would be installed under the path of “IVI FoundationIVI”. For the files with “*.dll” extension name would be located in the “Bin” folder. And the necessary help documents will be in the folder of “..DriversHypotMAX”.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

2. Getting Started with C#
Introduction
This chapter describes the procedures of using the IVI-COM driver of IKONIX Group by C# programming language. In this exercise, the programmer could import the driver and complete a short program controlling the device step-by step.
The C# could use IVI-C driver, either. However, we suggest that an IVI-COM interop would be easier for you to develop the program.
Requirements
HypotMAX IVI Driver IVI Shared Components, https://www.ivifoundation.org/shared_components/Default.aspx VISA (Virtual Instrument Software Architecture) driver,
https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html Microsoft Visual Studio or other IDEs An HypotMAX series safety tester, including 7705, 7710, 7715 or 7720
Download the Drivers
Please go to the website of the Associated Research to download the latest version of IVI drivers or contact the vendors. Follow the steps and instructions in Chapter 1 to complete the installation.
References
On the website of IVI Foundation, there are documentations you might be interested while implementing controlling the devices. You could find the resources of developing with an IVI driver, https://www.ivifoundation.org/resources/default.aspx. The IVI Shared Components could be download from https://www.ivifoundation.org/shared_components/Default.aspx. There are several documents on the website for understanding the IVI.
In the installed directory, there are several documents for your reference understanding the HypotMAX IVI Driver. A help file, HypotMAX.chm, would be located at the path of IVI FoundationIVIDriversHypotMAX. In this help file, you could find all of the provided functions and their hierarchy.
There are four types of sample code for your reference which are located at the path of IVI FoundationIVIDriversHypotMAXExamples, including C#, C++, Python and LabVIEW as well.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

Development
1 Create a C# project 1.1 Open Visual Studio IDE and create a new C# console project.
2 Import Libraries 2.1 Right-click on the reference and select Add Reference in the solution explorer 2.2 Click on the Browse button and go to the path of “IVI FoundationIVIBinPrimary Interop Assemblies” and choose AssociatedResearch.HypotMAX.Interop.dll and Ivi.Driver.Interop.dll.
2.3 Declare to use the name spaces for the interop assemblies that are specified to reference in the previous section.
using AssociatedResearch.HypotMAX.Interop;
3 Start programming 3.1 Create an object of the driver and use the initialize method to build up the connection.
//Initialize // var driver = new HypotMAX(); string resourceName = “ASRL3::INSTR”; string optionString = “DriverSetup=BaudRate=9600”; driver.Initialize(resourceName, true, false, optionString);
For more detail for the parameters of the Initialize() method, please refer to the help document, HypotMAX.chm, which is located at “IVI FoundationIVIDriversHypotMAX”. The first parameter ResourceName is a string type and indicates the interfaces type and address of the connection. The resource name,”ASRL3::INSTR”, represents a serial port with address 3. For example, a GPIB connection could be “GPIB0::8::INSTR”. For TCP/IP connection, it will be in the format of “TCPIP0::192.168.0.1::10001::SOCKET”. The 10001 is the TCP/IP connection port of HypotMAX.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

If you use serial port to connect to device, please follow the above example, “DriverSetup=BaudRate=9600”, to setup the baud rate. There are other parameters for the option of the Initialize() method, please refer to the HypotMAX.chm for more details.

3.2 Create file and setup test

//Taking 7715 as an example which only support AC Withstand test type. //Edit Memory#1 // driver.Parameters.LoadMemory(1);

driver.Parameters.Voltage = 1.5; driver.Parameters.HighLimit = 5; driver.Parameters.LowLimit = 0; driver.Parameters.RampUpTime = 0.3; driver.Parameters.DwellUnit = HypotMAXTimeUnitEnum.HypotMAXTimeUnitSecond; driver.Parameters.DwellTime = 1; driver.Parameters.RampDownTime = 1; driver.Parameters.Frequency = HypotMAXFrequencyEnum.HypotMAXFrequency60Hz; configuration only for ACW (7705,7715) driver.Parameters.ArcDetectEnable = true; driver.Parameters.ArcSense = 5; driver.Parameters.Connect = true;

//This

//Edit Memory#2 // driver.Parameters.LoadMemory(2);

driver.Parameters.Voltage = 1.2; driver.Parameters.HighLimit = 5; driver.Parameters.LowLimit = 0.0; driver.Parameters.RampUpTime = 1; driver.Parameters.DwellUnit = HypotMAXTimeUnitEnum.HypotMAXTimeUnitSecond; driver.Parameters.DwellTime = 3; driver.Parameters.RampDownTime = 0.5; driver.Parameters.Frequency = HypotMAXFrequencyEnum.HypotMAXFrequency50Hz; configuration only for ACW (7705,7715) driver.Parameters.ArcDetectEnable = true; driver.Parameters.ArcSense = 9; driver.Parameters.Connect = false;

//This

For the HypotMAX, all of the test parameters are within a “memory”. There are fixed 50 memories available and a configuration named “Connect” to determine whether to go to next memory or end the test. In the above example, the “connect” configuration is enabled in memory #1 ,so the HypotMAX will continue to the memory #2.
Please be noted that the “Frequency” parameter is for AC Withstand which was provided by 7705 and 7715. Instead, there are “Ramp-HI” and “ChargeLo” available in DC Withstand test of 7710 and 7720.

3.3 Load file and start a test
//Output // driver.Parameters.LoadMemory(1); driver.Execution.Execute();

28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

Before running output, you have to select the starting memory to be load by using Parameters.LoadMemory(). And then invoke Execution.Execute() method to start a test.
3.4 Measure during test
bool lastOpcStatus = false; while (true) {
Console.WriteLine(driver.Execution.ReadTestDisplayRaw()); driver.System.WriteString(“*OPC?n”); string opcStatus = driver.System.ReadString(); if (opcStatus.Contains(“1”) && lastOpcStatus)
break; lastOpcStatus = opcStatus.Contains(“1”); Thread.Sleep(100); }
This while loop would run with the condition of state is testing. Using the methods of Execution.ReadTestDisplayRaw() could let you read the immediate readings.
3.5 Close the session
driver.Execution.Abort(); driver.Close(); Console.WriteLine(“Done – Press Enter to Exit”); Console.ReadLine();
Close() would close the I/O session to the instrument.
4 Completed example The completed sample code could be found at the path of “IVI FoundationIVIDriversHypotMAXExamples”.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

3. Getting Started with C++
Introduction
This chapter describes the procedures of using the IVI-COM driver of IKONIX Group by C++ programming language. In this exercise, the programmer could import the driver and complete a short program controlling the device step-by step.
Requirements
HypotMAX IVI Driver IVI Shared Components, https://www.ivifoundation.org/shared_components/Default.aspx VISA (Virtual Instrument Software Architecture) driver,
https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html Microsoft Visual Studio or other IDEs An HypotMAX series safety tester, including 7705, 7710, 7715 or 7720
Download the Drivers
Please go to the website of the Associated Research to download the latest version of IVI drivers or contact the vendors. Follow the steps and instructions in Chapter 1 to complete the installation.
References
On the website of IVI Foundation, there are documentations you might be interested while implementing controlling the devices. You could find the resources of developing with an IVI driver, https://www.ivifoundation.org/resources/default.aspx. The IVI Shared Components could be download from https://www.ivifoundation.org/shared_components/Default.aspx. There are several documents on the website for understanding the IVI.
In the installed directory, there are several documents for your reference understanding the HypotMAX IVI Driver. A help file, HypotMAX.chm, would be located at the path of IVI FoundationIVIDriversHypotMAX. In this help file, you could find all of the provided functions and their hierarchy.
There are three types of sample code for your reference which are located at the path of IVI FoundationIVIDriversHypotMAXExamples, including C#, C++ and Python as well.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

Development
1 Create a C++ project 1.1 Open Visual Studio or any other IDEs and create a new C++ console project.
2 Include Directories 2.1 Right-click on the project and select properties. 2.2 Expand the Configuration Properties and select VC++ Directories on the left menu. 2.3 Click on the drop-down column of the Include Directories and select <Edit..> to open the edit window.
2.4 Select the New Line button to add an include directories. There will be two necessary paths need to be added. IVI FoundationIVIBin $(VXIPNPPATH)VisaCom
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

2.5 Click OK to complete including the directories. 2.6 Use the #import operator to import the necessary DLLs

include “stdafx.h” #include #include #import

no_namespace #import no_namespace #import no_namespace 3 Start programming 3.1 Create an instance of the driver by pointer and use the initialize method to build up the connection. HRESULT hr = ::CoInitialize(NULL); IHypotMAXPtr driver(__uuidof(HypotMAX)); driver->Initialize(“ASRL3::INSTR”, true, false, “DriverSetup=BaudRate=9600”); For more detail for the parameters of the Initialize() method, please refer to the help document, HypotMAX.chm located at “IVI FoundationIVIDriversHypotMAX”. The first parameter ResourceName is a string type and indicates the interfaces type and address of the connection. The resource name,”ASRL3::INSTR”, represents a serial port with address 3. For example, a GPIB connection could be “GPIB0::8::INSTR”. For TCP/IP connection, it will be in the format of “TCPIP0::192.168.0.1::10001::SOCKET”. The 10001 is the TCP/IP connection port of HypotMAX. The second argument should be set with false value for not identifying the model names. If you use serial port to connect to device, please follow the above example, “DriverSetup=BaudRate=9600”, to setup the baud rate. There are other parameters for the option of the Initialize() method, please refer to the HypotMAX.chm for more detail.

3.2 Create file and setup test

//Taking 7715 as an example which only support AC Withstand test type. //Edit Memory#1 // driver->Parameters->LoadMemory(1);

driver->Parameters->Voltage = 1.5; driver->Parameters->HighLimit = 5; driver->Parameters->LowLimit = 0; driver->Parameters->RampUpTime = 0.3; driver->Parameters->DwellUnit = HypotMAXTimeUnitEnum::HypotMAXTimeUnitSecond; driver->Parameters->DwellTime = 1; driver->Parameters->RampDownTime = 1; driver->Parameters->Frequency = HypotMAXFrequencyEnum::HypotMAXFrequency60Hz; configuration only for ACW (7705,7715) driver->Parameters->ArcDetectEnable = true; driver->Parameters->ArcSense = 5; driver->Parameters->Connect = true;

//This

//Edit Memory#2 // driver->Parameters->LoadMemory(2);

28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

driver->Parameters->Voltage = 1.2; driver->Parameters->HighLimit = 5; driver->Parameters->LowLimit = 0.0; driver->Parameters->RampUpTime = 1; driver->Parameters->DwellUnit = HypotMAXTimeUnitEnum::HypotMAXTimeUnitSecond; driver->Parameters->DwellTime = 3; driver->Parameters->RampDownTime = 0.5; driver->Parameters->Frequency = HypotMAXFrequencyEnum::HypotMAXFrequency50Hz; configuration only for ACW (7705,7715) driver->Parameters->ArcDetectEnable = true; driver->Parameters->ArcSense = 9; driver->Parameters->Connect = false;

//This

For the HypotMAX, all of the test parameters are within a “memory”. There are fixed 50 memories available and a configuration named “Connect” to determine whether to go to next memory or end the test. In the above example, the “connect” configuration is enabled in memory #1 ,so the HypotMAX will continue to the memory #2.
Please be noted that the “Frequency” parameter is for AC Withstand which was provided by 7705 and 7715. Instead, there are “Ramp-HI” and “ChargeLo” available in DC Withstand test of 7710 and 7720.

3.3 Load file and start a test
//Output driver->Parameters->LoadMemory(1); driver->Execution->Execute();
Before running output, you have to select a memory to be load by using driver->Parameters>LoadMemory(1). And then invoke driver->Execution->Execute() method to start a test.

3.4 Measure during test
bool lastOpcStatus = false; while (true) {
std::cout << driver->Execution->ReadTestDisplayRaw() << std::endl; driver->System->WriteString(“*OPC?n”); std::string opcStatus = driver->System->ReadString(); if (opcStatus.find(“1”) != std::string::npos && lastOpcStatus)
break; lastOpcStatus = opcStatus.find(“1”) != std::string::npos; Sleep(100); }
This while loop would run with the condition of state is testing. Using the methods of
Execution->ReadTestDisplayRaw() could let you read the immediate readings.

28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

3.5 Close the session
driver->Execution->Abort(); driver->Close(); std::cout << “Done – Press Enter to Exit” << std::endl; std::cin.get();
Close() would close the I/O session to the instrument. 4 Completed example
The completed sample code could be found at the path of “IVI FoundationIVIDriversHypotMAXExamples”.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

4. Getting Started with Python
Introduction
This chapter describes the procedures of using the IVI-COM driver of IKONIX Group by Python programming language. In this exercise, the programmer could import the driver and complete a short program controlling the device step-by step.
Requirements
HypotMAX IVI Driver IVI Shared Components, https://www.ivifoundation.org/shared_components/Default.aspx VISA (Virtual Instrument Software Architecture) driver,
https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html Python IDE Cometypes Library ( pip install comtypes) An HypotMAX series safety tester, including 7705, 7710, 7715 or 7720
Download the Drivers
Please go to the website of the Associated Research to download the latest version of IVI drivers or contact the vendors. Follow the steps and instructions in Chapter 1 to complete the installation.
References
On the website of IVI Foundation, there are documentations you might be interested in while implementing controlling the devices. You could find the resources of developing with an IVI driver, https://www.ivifoundation.org/resources/default.aspx. The IVI Shared Components could be download from https://www.ivifoundation.org/shared_components/Default.aspx. There are several documents on the website for understanding the IVI.
In the installed directory, there are several documents for your reference understanding the HypotMAX IVI Driver. A help file, HypotMAX.chm, would be located at the path of IVI FoundationIVIDriversHypotMAX. In this help file, you could find all of the provided functions and their hierarchy.
There are three types of sample code for your reference which are located at the path of IVI FoundationIVIDriversHypotMAXExamples, including C#, C++ and Python as well.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

Development
1 Install the Comtypes library pip install comtypes
In order to call an external com DLL in Python, you will need comtypes library installed.
2 Create a Python file 2.1 Open any IDE of Python and create a new Python file.
3 Import Libraries 3.1 Import the cometypes library and HypotMAX_64.dll
import time import comtypes import comtypes.client as cc # Import the IVI-COM DLL cc.GetModule(‘HypotMAX_64.dll’) from comtypes.gen import HypotMAXLib
4 Start programming 4.1 Create an object of the driver and use the initialize method to build up the connection.
driver = cc.CreateObject(‘HypotMAX.HypotMAX’, interface=HypotMAXLib.IHypotMAX)

Initialize Driver and make connection driver.Initialize(‘ASRL3::INSTR’,

True, False, ‘DriverSetup=BaudRate=9600’)
For more detail for the parameters of the Initialize() method, please refer to the help document, HypotMAX.chm located at “IVI FoundationIVIDriversHypotMAX”. The first parameter ResourceName is a string type and indicates the interfaces type and address of the connection. The resource name,”ASRL3::INSTR”, represents a serial port with address 3. For example, a GPIB connection could be “GPIB0::8::INSTR”. For TCP/IP connection, it will be in the format of “TCPIP0::192.168.0.1::10001::SOCKET”. The 10001 is the TCP/IP connection port of HypotMAX. If you use serial port to connect to device, please follow the above example, “DriverSetup=BaudRate=9600”, to setup the baud rate. There are other parameters for the option of the Initialize() method, please refer to the HypotMAX.chm for more detail. For example, “QueryInstrStatus=true” makes the session automatically query the error status for each command was sent.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

4.2 Create file and setup test

Taking 7715 as an example which only support AC Withstand test type. #Edit

Memory#1 # driver.Parameters.LoadMemory(1);

Edit parameters of Memory#1 # driver.Parameters.Voltage = 1.5;

driver.Parameters.HighLimit = 5; driver.Parameters.LowLimit = 0; driver.Parameters.RampUpTime = 0.3; driver.Parameters.DwellUnit = HypotMAXLib.HypotMAXTimeUnitSecond; driver.Parameters.DwellTime = 1; driver.Parameters.RampDownTime = 1; driver.Parameters.Frequency = HypotMAXLib.HypotMAXFrequency60Hz; #This configuration only for ACW (7705,7715) driver.Parameters.ArcDetectEnable = True; driver.Parameters.ArcSense = 5; driver.Parameters.Connect = True;

Edit Memory#2 # driver.Parameters.LoadMemory(2);

Edit parameters of Memory#2 # driver.Parameters.Voltage = 1.2;

driver.Parameters.HighLimit = 5; driver.Parameters.LowLimit = 0.0; driver.Parameters.RampUpTime = 1; driver.Parameters.DwellUnit = HypotMAXLib.HypotMAXTimeUnitSecond; driver.Parameters.DwellTime = 3; driver.Parameters.RampDownTime = 0.5; driver.Parameters.Frequency = HypotMAXLib.HypotMAXFrequency50Hz; #This configuration only for ACW (7705,7715) driver.Parameters.ArcDetectEnable = True; driver.Parameters.ArcSense = 9; driver.Parameters.Connect = False;
For the HypotMAX, all of the test parameters are within a “memory”. There are fixed 50 memories available and a configuration named “Connect” to determine whether to go to next memory or end the test. In the above example, the “connect” configuration is enabled in memory #1, so the HypotMAX will continue to the memory #2. Please be noted that the “Frequency” parameter is for AC Withstand which was provided by 7705 and 7715. Instead, there are “Ramp-HI” and “ChargeLo” available in DC Withstand test of 7710 and 7720.
4.3 Load file and start a test

Start test driver.Parameters.LoadMemory(1) driver.Execution.Execute()

Before running output, you have to select a file to load using driver.Parameters.LoadMemory(1). And then invoke driver.Execution.Execute() method to start a test.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

4.4 Measure during test

Measure lastOpcStatus = False while(True):

print(driver.Execution.ReadTestDisplayRaw()) driver.System.WriteString(“*OPC?n”) opcStatus = driver.System.ReadString() if (‘1’ in opcStatus and lastOpcStatus):
break lastOpcStatus = ‘1’ in opcStatus time.sleep(0.1)
This while loop would run with the condition of state is testing. Using the methods of Execution.ReadTestDisplayRaw() could let you read the immediate readings. 4.5 Close the session

Reset test and close connection driver.Execution.Abort() driver.Close()

print(“Done”)
Close() would close the I/O session to the instrument. 5 Completed example
The completed sample code could be find at the path of “IVI FoundationIVIDriversHypotMAXExamples”.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

5. Getting Started with LabVIEW
Introduction
This chapter describes the procedures of using the IVI-COM driver of IKONIX Group by LabVIEW programming language. In this exercise, the programmer could learn how to import the driver and complete a short program controlling the device step-by step.
Even though the programmers could control the device by IVI Driver. For the LabVIEW programmer, we suggest that using LabVIEW plug & play driver would be easier for your programming and debugging. The LabVIEW drivers from IKONIX Group are all made up with commands directly, so you could clearly check how the commands were sent to instruments.
Requirements
HypotMAX IVI Driver IVI Shared Components, https://www.ivifoundation.org/shared_components/Default.aspx VISA (Virtual Instrument Software Architecture) driver,
https://www.ni.com/en/support/downloads/drivers/download.ni-visa.html National Instruments LabVIEW (This example was written in LabVIEW 2014) An HypotMAX series safety tester, including 7705, 7710, 7715 or 7720
Download the Drivers
Please go to the website of the Associated Research to download the latest version of IVI drivers or contact the vendors. Follow the steps and instructions in Chapter 1 to complete the installation.
References
On the website of IVI Foundation, there are documentations you might be interested while implementing controlling the devices. You could find the resources of developing with an IVI driver, https://www.ivifoundation.org/resources/default.aspx. The IVI Shared Components could be download from https://www.ivifoundation.org/shared_components/Default.aspx. There are several documents on the website for understanding the IVI.
In the installed directory, there are several documents for your reference understanding the HypotMAX IVI Driver. A help file, HypotMAX.chm, would be located at the path of IVI FoundationIVIDriversHypotMAX. In this help file, you could find all of the provided functions and their hierarchy.
There are three types of sample code for your reference which are located at the path of IVI FoundationIVIDriversHypotMAXExamples, including C#, C++ and Python as well.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

1 Open a new vi. 2 Import the DLL component.

Development

Open the Function Palette by right-clicking on the block diagram. Then select Connectivity -> ActiveX. Select or drop the Automation Open function on the block diagram. 3 Right-clicking on the Automation Open and select Select ActiveX Class -> Browse will open a window for choosing the DLL. 4 Select the Browse button and select the file HypotMAX_64.dll located at <Program Files>IVI FoundationIVIBin. The IVI HypotMAX Type Library would be added into the Type Libraries drop down menu. 5 Select IHypotMAX and then click OK to complete creating an object of HypotMAX driver instance.
The Labview will automatically generate an Automation refnum of HypotMAXLib.IHypotMAX control and connect to the Automation Open function.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

6 Create an Invoke Node function and connect the reference to the output of Automation Refnum and then click on the Method and select Initialize to initialize the connection with device.
For more detail for the parameters of the Initialize method, please refer to the help document, HypotMAX.chm located at “IVI FoundationIVIDriversHypotMAX”. The first parameter ResourceName is a string type and indicates the interfaces type and address of the connection. The resource name, “ASRL3::INSTR”, represents a serial port with address 3. For example, a GPIB connection could be “GPIB0::8::INSTR”. For TCP/IP connection, it will be in the format of “TCPIP0::192.168.0.1::10001::SOCKET”. The 10001 is the TCP/IP connection port of HypotMAX. If you use serial port to connect to device, please follow the above example, “DriverSetup=BaudRate=9600”, to setup the baud rate. There are other parameters for the option of the Initialize() method, please refer to the HypotMAX.chm for more detail.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

6.1 Create file and setup test
Use the Property Node to get reference of the sub-system of IHypotMAX class. For example, Parameters is one of the sub-class of IHypotMAX, and then we could use the LoadMemory method under Parameters to switch the memories in the device. For HypotMAX, there are constant 50 memories inside the device. Before set up the configurations, please be noted that you have to switch to the corresponding memory. There is a configuration, Connect, to determine whether to link to next memory. Taking a 5-steps test as an example, the Connect of the first step to forth step need to be set with True and the fifth memory needs to be set with False.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

6.2 Start a test and measure
Before running output, you have to select a memory to load. And then invoke Execute method to start a test under Execution class. The Execution class is one property of the IHypotMAX class. This for loop would run with polling the state and meters. Using the methods of ReadTestDispalyRaw could let you read the immediate readings. ReadTestDispalyRaw is one method of IHypotMAX.Execution. There is another commands querying states of the device, polling “*OPC?” could get the running status. Please be noted that the status between step and step might be OFF for a shot moment. To avoid reading wrong status, we use shift register comparing the status.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

6.3 Close the session
Close method in IHypotMAX class would close the I/O session to the instrument. Also, all of the references should be closed using the Close Reference function. 7 Completed example
The completed example with the state machine design pattern for your reference which are located at the path of IVI FoundationIVIDriversHypotMAXExamples, including C#, C++ and Python as well. However, we suggest that using LabVIEW plug & play driver would be easier for LabVIEW developers. If you need a LabVIEW driver, please download it from the website of Associated Research or contact the vendor.
28105 N. Keith Drive Lake Forest, IL 60045 USA Toll Free: 1-800-858-8378 US/Canada Phone: 1-847-367-4077 | Fax: 1-847-367-4080 | www.arisafety.com

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals