Alert.png

Notice: This page contains information for the legacy Phidget21 Library.

Phidget21 is out of support. Bugfixes may be considered on a case by case basis.

Phidget21 does not support VINT Phidgets, or new USB Phidgets released after 2020. We maintain a selection of legacy devices for sale that are supported in Phidget21.

We recommend that new projects be developed against the Phidget22 Library.


Click on the 2phidget22.jpg button in the menu bar to go to the Phidget22 version of this page.

Alert.png

Language - AutoIt: Difference between revisions

From Phidgets Legacy Support
Line 113: Line 113:
Some events such as Attach and Detach belong to the base Phidget object and thus are common to all types of Phidgets.  
Some events such as Attach and Detach belong to the base Phidget object and thus are common to all types of Phidgets.  
Please refer to the API manual for a full list of events and their usage.
Please refer to the API manual for a full list of events and their usage.
===Working directly with the Phidget===


Some values can be directly read and set on the Phidget, and inside polling loops used as an alternative to event driven programming.  
Some values can be directly read and set on the Phidget, and inside polling loops used as an alternative to event driven programming.  
Line 128: Line 126:
Alternatively, you can usually use the integer value 0 for false and 1 for true.  
Alternatively, you can usually use the integer value 0 for false and 1 for true.  


===Working with multiple Phidgets===
====Close and Delete====


Multiple Phidgets of the same type can easily be run inside the same program.  
Multiple Phidgets of the same type can easily be run inside the same program.  
Line 135: Line 133:
If the application needs to distinguish between the devices, open can be called with the serial number of a specific Phidget.
If the application needs to distinguish between the devices, open can be called with the serial number of a specific Phidget.


===Other Phidgets===
{{MoreHowTos}}
 
The design given in this document can also be followed for almost all Phidgets. For example, if you
were using a PhidgetRFID instead of an PhidgetInterfacekit, you would declare a PhidgetRFID object
instead of a PhidgetInterfaceKit. The methods and events available would change but they can be
accessed in a similar manner.


==Common Problems and Solutions/Workarounds==
==Common Problems and Solutions/Workarounds==


None at this time.
None at this time.

Revision as of 18:53, 14 May 2012

Icon-Autoit.png AutoIt is a general-purpose GUI scripting language for Windows.

Introduction

If this is your first time working with a Phidget, we suggest starting with the Getting Started page for your specific device. This can be found on your product page on our main website. That page will walk you through installing drivers and libraries for your operating system, and will then bring you back here to use AutoIt specifically.

AutoIt is capable of using the complete Phidget API, including events. However, AutoIt has no Phidget examples for devices at this time.

AutoIt can be developed with Windows 2000/XP/Vista/7.

You can compare AutoIt with our other supported languages.

Quick Downloads

Just need the AutoIt documentation, drivers, libraries, and examples? Here they are:

Documentation

Example Code

  • None Provided

Libraries and Drivers

Getting Started with AutoIt

Applications using Phidgets can be developed in AutoIt v3 through the COM API and this tutorial assumes its use.

The Windows installers above in the Quick Downloads section will install the Phidget framework and will register the necessary .dlls for you.

In lieu of example code, to begin in AutoIt you can create a new script file and open it with your preferred editor. Then, create a simple user interface to work with and then place an input control for the purpose of capturing some simple output:

  #include <GUIConstantsEx.au3>

  GUICreate("Phidget Test")
  $InputControl = GUICtrlCreateInput("", 20, 40, 160)
  GUISetState(@SW_SHOW)

  ;Phidget initialization code goes here

  Do
     $msg = GUIGetMsg()
  Until $msg = $GUI_EVENT_CLOSE

  ;Phidget Event Handlers go here

Coding For Your Phidget

There are additional references for writing AutoIt code:

  • COM API (This is the complete set of functions you have available for all Phidgets)
  • Device Specific APIs - The one for your Phidget can be found in its user guide.

To learn the details behind opening, configuring, using, and closing your Phidget, try the General Phidget Programming page. That page also describes using the Phidget in an event-driven manner and in a traditional manner, both of which are available in AutoIt.

Code Snippets

Specific calls in AutoIt will differ in syntax from those on the General Phidget Programming page, but the concepts stay the same.

It may help to have the General Phidget Programming page and this section open at the same time, because they parallel each other and you can refer to the AutoIt syntax. However, many additional concepts are covered on the General Phidget Programming page on a high level, such as using multiple Phidgets, handling errors, and different styles of programming.

Step One: Initialize and Open

To open the Phidget, you must create the object from the Phidget21COM library at initialization. This can be accomplished through a call to ObjCreate. Then, we try to open the Phidget. The open() call is simple most of the time, but it can also handle many different types of open (i.e. remote open using the Phidget WebService, opening multiple Phidgets, etc). For the details of open (and other functions on this page), refer to the Opening the Phidget section on the General Phidget Programming page.

For example, we can declare, create, and open a PhidgetInterfaceKit with:

  $oPhid1 = ObjCreate("Phidget21COM.PhidgetInterfacekit")
  $oPhid1.Open()

The object name for any type of Phidget is listed in the COM API manual, as well as the variety of open call available. Every type of Phidget also shares some functionality from the base Phidget class.

Step Two: Wait for Attachment (plugging in) of the Phidget

An attached Phidget is one that is attached in hardware - i.e. plugged it. We can account for this connection by waiting or by catching an AttachEvent. WaitForAttachment will block indefinitely until a connection is made to the Phidget, or an optional timeout is exceeded:

  $oPhid1.WaitForAttachment(3000)
  If NOT $oPhid1.IsAttached Then
     MsgBox(0, "Error", "Phidget Device not attached")
  Exit
  EndIf

One important thing to remember is that when working with Phidgets, a local connection will reserve the device until closed. This means only one program can access the Phidget locally. Many computers can access one Phidget over the Phidget WebService.

Step Three: Do Things with the Phidget

We recommend the use of event driven programming when working with Phidgets. This allows the program to execute other tasks until the Phidget generates a new event. In AutoIt, you enable event handlers for a Phidget at initialization with the following line:

  $oPhidEvents = ObjEvent($oPhid1, "phid1_")

AutoIt will use the phidl1_ prefix we declared when looking for the handler to execute. You can define the handler functions for events such as OnSensorChange or Attached elsewhere in your code:

 
  Func phid1_OnSensorChange($Index, $SensorValue)
     GUICtrlSetData($InputControl, $SensorValue)
  EndFunc

With this method, the code inside phid1_OnSensorChange will get executed every time the PhidgetInterfaceKit reports a change on one of its analog inputs. Some events such as Attach and Detach belong to the base Phidget object and thus are common to all types of Phidgets. Please refer to the API manual for a full list of events and their usage.

Some values can be directly read and set on the Phidget, and inside polling loops used as an alternative to event driven programming. Simply use the instance properties such as SensorValue(Index as Long) or OutputState(Index as Long) for PhidgetInterfaceKits.

  $oPhid1.OutputState(0) = "true"

Note that when setting booleans on the Phidget, it must be encapsulated in quotes. Alternatively, you can usually use the integer value 0 for false and 1 for true.

Close and Delete

Multiple Phidgets of the same type can easily be run inside the same program. In our case, it requires another PhidgetInterfaceKit object to be defined and initialized. The new object can then be set up, opened and used in the same process as the previous one. If the application needs to distinguish between the devices, open can be called with the serial number of a specific Phidget.

More How-To's

The General Phidget Programming page gives more information about:

Common Problems and Solutions/Workarounds

None at this time.