Notice: This page contains information for the legacy Phidget21 Library. Phidget21 does not support VINT Phidgets, and will not support any new Phidgets. Phidget21 will be maintained until 2020. We recommend that new projects be developed against the Phidget22 Library.
1055 User Guide
|Go to this device's product page|
Checking the Contents
You should have received:
In order to test your new Phidget you will also need:
Connecting the Pieces
Connect the PhidgetIR to your computer using the Mini-USB cable.
Testing Using Windows 2000 / XP / Vista / 7
Make sure you have the current version of the Phidget library installed on your PC. If you don't, follow these steps:
- Go to the Quick Downloads section on the Windows page
- Download and run the Phidget21 Installer (32-bit, or 64-bit, depending on your system)
- You should see the icon on the right hand corner of the Task Bar.
Running Phidgets Sample Program
Double clicking on the icon loads the Phidget Control Panel; we will use this program to ensure that your new Phidget works properly.
Updating Device Firmware
If an entry in this list is red, it means the firmware for that device is out of date. Double click on the entry to be given the option of updating the firmware. If you choose not to update the firmware, you can still run the example for that device after refusing.
Double Click on the icon to activate the Phidget Control Panel and make sure that the Phidget IR Receiver Transmitter is properly attached to your PC.
Testing Using Mac OS X
- Go to the Quick Downloads section on the Mac OS X page
- Download and run the Phidget OS X Installer
- Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
- Make sure that the Phidget IR Receiver Transmitter is properly attached.
- Double Click on Phidget IR Receiver Transmitter in the Phidget Preference Pane to bring up the IR-full Sample program. This program will function in a similar way as the Windows version.
For a step-by-step guide on getting Phidgets running on Linux, check the Linux page.
Using Windows Mobile / CE 5.0 / CE 6.0
For a step-by-step guide on getting Phidgets running on Windows CE, check the Windows CE page.
The PhidgetIR can send and receive data encoded in various fashions as pulses of infrared light. The various encoding that the PhidgetIR supports are grouped under the general term ‘Consumer IR’ or CIR. CIR is generally used to control consumer products such as TVs, DVD players, etc. with a wireless remote control, but in general can be used for any application that needs to transmit low speed data wirelessly.
CIR is a low speed protocol - commands generally contain no more then 32-bits of data with a bit rate of at the most 4000 bits/second, but usually much less. There is no concession for anti-collision, so only one code can be transmitting at any time. Transmission distance depends on the power of the transmitter, but needs to be line of sight - though generally this can include bouncing off walls/ceilings, etc.
CIR data is transmitted using a modulated bit stream. Data is encoded in the length of the pulses / spaces between pulses, of IR light. The pulses of IR light are themselves modulated at a much higher frequency (usually ~38kHz) in order for the receiver to distinguish CIR data from ambient room light.
You can read more about IR remote controls in our IR Remote Control Primer.
We document API Calls specific to this product in this section. Functions common to all Phidgets and functions not applicable to this device are not covered here. This section is deliberately generic. For calling conventions under a specific language, refer to the associated API manual in the Quick Downloads section for that language. For exact values, refer to the device specifications.
- int dataLength;
- IR_Encoding encoding;
- IR_Length length;
- int gap;
- int trail;
- int header;
- int one;
- int zero;
- int repeat[MAX_REPEAT_LENGTH];
- int min_repeat;
- byte toggle_mask[MAX_DATA_LENGTH];
- int carrierFrequency;
- int dutyCycle;
The CodeInfo Structure/Class represents all aspects of a code except for the data. This is used when learning and when transmitting codes.
- dataLength: The length of the code data in bits
- encoding: The encoding used for the data. Possible values are: Space, Pulse, Bi-Phase, RC5 and RC6
- length: Whether the code length (including gap) is constant or variable.
- gap: The gap time. For constant length codes this is the entire code time including the data and the gap, for variable length codes, this is the gap time only.
- trail: Trailing bit time.
- header: Header pulse and space. Specify 0 for no header.
- zero: The pulse and space used to identify a ‘0’ in the bit stream.
- one: The pulse and space used to identify a ‘1’ in the bit stream.
- repeat: The repeat code. This must start and end with a pulse and be terminated with a 0 (null).
- min_repeat: Minimum number of times to repeat the code.
- toggle_mask: The toggle mask. These bits are toggled when transmitting.
- carrierFrequency: The carrier frequency in Hz. Default is 38000. Range is 10kHz - 1MHz
- dutyCycle: The period of the carrier frequency. Default is 50. Range is 10-50.
Depending on the encoding used, most of these can be set to 0/null to select default values.
Transmit(Byte data, IR_CodeInfo codeInfo)
- Transmits a code.
- Transmits a repeat for the last transmitted code. Note that this function must be called before the gap time has elapsed since the original code transmission, or the repeat code will be transmitted too late.
TransmitRaw(int data, int offset, int count, int carrier, in dutyCycle, int gap)
- Transmits a raw data stream of length count starting at offset, at a specific carrier frequency and duty cycle, with a microsecond gap after the data is sent. Carrier, duty cycle, gap, count, and offset can be set to 0 to specify default values. The data array must start and end with a pulse (have an uneven number of values).
int ReadRaw(int data, int length)
- Reads up to a specified amount of raw data in the data buffer. If no data is available, returns 0, else returns number of ints read. Read data always starts with a space and ends with a pulse.
Byte LastCode() [get]
- Gets the last code received. If there is no last code, this will throw the EPHIDGET_UNKOWNVAL exception.
(Byte, IR_CodeInfo) LastLearnedCode() [get]
- Gets the last learned code. Returns both the code and a CodeInfo structure/object. If there is no last code, throws the EPHIDGET_UNKNOWNVAL exception.
Code(Byte data, int bitLength, Bool repeat)
- The code event is fired every time a code is received and correctly decoded. The data array has a length 1/8 of bitLength with the MSB being in position 0. MSB is considered to be the first bit received. Repeat will be true if a repeat is detected - either timing wise or via a repeat code. False repeats can happen if two separate button presses happen close together.
Learn(Byte data IR_CodeInfo codeInfo)
- The Learn event fires when a button has been held down long enough for PhidgetIR to have learned the CodeInfo values - usually about 1 seconds, or after 4 repeats.
- The Raw Data event will fire every time the PhidgetIR gets more data - at most once every 8ms.
|Date||Board Revision||Device Version||Comment|
|May 2010||0||100||Product Release|
|May 2011||0||101||getLabelString fixed for labels longer than 7 characters|