Background
Phidget is a company that provides products for USB Sensing and Control. Phidget specialize in making affordable, easy to use sensors and controllers that require minimal electronics knowledge. Phidget covers vast range of sensors and motors.
Sensors
Motors
Phidget Protocol Handler Flow
TQLEngine provides phidget protocol handler, which is essentially a wrapper over the Phidget Driver that is provided by Phidget. Note that the developers are required to install the phidget driver for different platform (Linux, Windows, Mac) from the phidget website.
Phidget Protocol Handler Parameters
Phidget has a broad range of sensors and motors. The phidget protocol handler provides wrapper implementation for following Device Types. Adding support for additional device types will be provided on a need basis.
Phidget Input Parameter List
| Name | Description | How Used? |
|---|---|---|
DeviceType | Specify the type of device that requires interaction. Supported values are: PhidgetRFID, PhidgetTextLCD, PhidgetGPS, PhidgetInterfaceKit, PhidgetAdvancedServo | DeviceType is passed as a modifier to Invoke. <Invoke Method="Get" DeviceType="PhidgetInterfaceKit"/> |
| SerialNumber | This represents the interface port number to which the sensor or motor is connected. | SerialNumber is passed as a modifier to Invoke |
| ServoAngle | Angle to be applied to a Advanced Servo Motor. | ServoAngle is passed as a payload to Invoke wrapped within Message/Value container. <Invoke Method="Post" DeviceType="PhidgetTextLCD"> <Message><Value><ServoAngle>110.0</ServoAngle></Value></Message> </Invoke> |
| Simulated | Simulates Sensor Behavior by sending random integer values between 1 and 100 | |
| - | Some time if you need to pass a String value to the handler as input - usually in case of RFID Writer or LCD Text Display, you can pass it as part of <Message><Value>Hello</Value></Message> as payload to Invoke. | Payload of <Invoke>. <Invoke Method="Post" DeviceType="PhidgetTextLCD"> <Message><Value>Hello</Value></Message> </Invoke> |
Phidget Output Format
Output from the Phidget Handler is simply a text value.
Special formatted case for GPS Sensors - In case of GPS the output text is aggregated and presented in a single formatted text as below:
Lon:<value>;Lat:<value>;Alt:<Value>;Vel:<Value>;Head:<Value>;Status:<Value> Default Value for Lon, Lat, Alt, Vel, Head is: Unknown Default Value for Status is false
<USBCameraParameters>
<ImageFormat></ImageFormat>
<SaveToDisk></SaveToDisk>
<ImageName></ImageName>
<Size>
<Height></Height>
<Width></Width>
</Size>
<Configuration>
<Standard></Standard>
<Quality></Quality>
<Channel></Channel>
<Brightness></Brightness>
<Contrast></Contrast>
<Gamma></Gamma>
<Gain></Gain>
<Sharpness></Sharpness>
<Saturation></Saturation>
<Hue></Hue>
</Configuration>
</USBCameraParameters>
USB Camera Parameter Structure
Invoking UCAM Handler
<Action Name="USBCameraImageAction"> <Workflow Limit="1" Live="1" Timeout="-1"> <Task name="Main" while="true"> <Event name="Argument" as="ActionArgument"/> <Invoke name="GetImage" waitFor="ActionArgument" post="ucam://"> <Message> <Value> <USBCameraParameters> <ImageFormat>[%:Event.Argument.USBCameraParameters.ImageFormat.Value:%]</ImageFormat> <SaveToDisk>[%:Event.Argument.USBCameraParameters.SaveToDisk.Value:%]</SaveToDisk> <ImageName>[%:Event.Argument.USBCameraParameters.ImageName.Value:%]</ImageName> <Size> <Height>[%:Event.Argument.USBCameraParameters.Size.Height.Value:%]</Height> <Width>[%:Event.Argument.USBCameraParameters.Size.Width.Value:%]</Width> </Size> <Configuration> <Standard>[%:Event.Argument.USBCameraParameters.Configuration.Standard.Value:%]</Standard> <Quality>[%:Event.Argument.USBCameraParameters.Configuration.Quality.Value:%]</Quality> <Channel>[%:Event.Argument.USBCameraParameters.Configuration.Channel.Value:%]</Channel> <Brightness>[%:Event.Argument.USBCameraParameters.Configuration.Brightness.Value:%]</Brightness> <Contrast>[%:Event.Argument.USBCameraParameters.Configuration.Contrast.Value:%]</Contrast> <Gamma>[%:Event.Argument.USBCameraParameters.Configuration.Gamma.Value:%]</Gamma> <Gain>[%:Event.Argument.USBCameraParameters.Configuration.Gain.Value:%]</Gain> <Sharpness>[%:Event.Argument.USBCameraParameters.Configuration.Sharpness.Value:%]</Sharpness> <Saturation>[%:Event.Argument.USBCameraParameters.Configuration.Saturation.Value:%]</Saturation> <Hue>[%:Event.Argument.USBCameraParameters.Configuration.Hue.Value:%]</Hue> </Configuration> </USBCameraParameters> </Value> </Message> </Invoke> <Log Message="******Invoked USBCamera******"/> <Output name="Result" as="ActionResult"> <Value> <Image>[%:[%:@Output:%]Invoke.GetImage.Message.Value:%]</Image> </Value> </Output> </Task> </Workflow> </Action>
