1128 User Guide: Difference between revisions

From Phidgets Support
No edit summary
Line 1: Line 1:
[[Category:UserGuide]]
[[Category:UserGuide]]
{{UserguideTOC|1128.jpg|1128}}
==Getting Started==


===Checking the Contents===
===Required Hardware===
{{UGbox|
 
'''You should have received:'''
* A 1128 Sonar Sensor
* A sonar sensor
* An InterfaceKit or Hub to read the sensor
* A sensor cable
* A sensor cable
|
'''In order to test your new Phidget you will also need:'''
* A PhidgetInterfaceKit 8/8/8 or a PhidgetTextLCD
* A USB cable
* A USB cable
* A soldering iron and solder
* A computer
* A piece of wire (optional)
||}}


===Soldering the Sensor Cable===
===Connecting the Pieces===
{{UGbox|
[[Image:1128_Functional.jpeg|300px|right|link=]]
Solder one end of the sensor cable to the Sonar Sensor. The black wire is soldered to GND, the red wire to +5 and the white wire to AN. Optionally a fourth wire can be soldered to RX in order to turn the sensor on and off from your computer.
Solder one end of the sensor cable to the Sonar Sensor. The black wire is soldered to GND, the red wire to +5 and the white wire to AN. Optionally a fourth wire can be soldered to RX in order to turn the sensor on and off from your computer.
|
[[File:1128_0_Wiring.jpg|400px|link=]]||
}}
===Connecting the Pieces===
{{UGbox|
#Connect the Sonar Sensor to the Analog Input 7 on the PhidgetInterfaceKit 8/8/8 using the sensor cable.
#If you are using the 4th wire connect it to a digital output port.
#Connect the PhidgetInterfaceKit to your PC using the USB cable.
|
[[File:1128_0_Connecting_The_Hardware.jpg|400px|link=]]
||}}
===Testing Using Windows 2000 / XP / Vista / 7===
{{UGwin}}
===Running Phidgets Sample Program===
{{UGwin2|'''InterfaceKit-full'''}}
{{UGbox|
Double Click on the [[File:Ph.jpg|link=]] icon to activate the Phidget Control Panel and make sure that the '''Phidget InterfaceKit 8/8/8''' is properly attached  to your PC. 
|[[File:1018_2_Control_Panel_Screen.jpg|400px|link=]]
||}}
{{UGbox6|'''If you are using a 3-wire connection'''
1. Double Click on '''Phidget InterfaceKit 8/8/8''' in the Phidget Control Panel to bring up InterfaceKit-full and check that the box labelled Attached contains the word True.
2. Make sure that the Ratiometric box is Ticked.
3. Move the Sonar Sensor around and point at different objects. The distance is given in the Analog In box.
4. You can adjust the input sensitivity by moving the slider pointer.
5. Click on the Sensors button to bring up the Advanced Sensor Form.
|
[[File:1128 0 InterfaceKit Screen 3Wire.jpg|400px|link=]]
|
'''If you are using a 4-wire connection'''
#Double Click on '''Phidget InterfaceKit 8/8/8''' in the Phidget Control Panel to bring up InterfaceKit-full and check that the box labelled Attached contains the word True.
#Make sure that the Ratiometric box is Ticked.
#Activate the Sonar Sensor, by clicking in the Digital Out box. A tick mark will appear and the Sonar Sensor is on. To turn the sensor off, click on the Digital box again. The tick mark disappears and the sensor is off. The bottom row shows the status of the request, while the top row displays the status of the digital output as reported by the 1128.
#Move the Sonar Sensor around and point at different objects. The distance is given in the Analog In box.
#You can adjust the input sensitivity by moving the slider pointer.
#Click on the Sensors button to bring up the Advanced Sensor Form.
|
[[File:1128 0 InterfaceKit Screen 4Wire.jpg|link=|400px]]
|
#In the Sensor 7 box, select the 1116 - Sonar Sensor from the drop down menu.
#The distance of the object from the sensor is shown here.
#Formula used to convert the analog input SensorValue into distance.
|
[[File:1128 0 Advanced Sensor Form Screen.jpg|link=|400px]]
}}
===Testing Using Mac OS X===
{{UGmac| | }}
===Using Linux===


{{UGlinux}}
# Connect the sonar sensor to the InterfaceKit or Hub with the sensor cable.
# If you're using the fourth wire, connect it to a digital output port on the InterfaceKit or Hub.
# Connect the InterfaceKit or Hub to your computer with the USB cable.


===Using Windows Mobile / CE 5.0 / CE 6.0===
<br clear="all">
==Testing Using Windows==


{{UGce}}
{{UgSensor}}


==Technical Details==
==Technical Details==
Line 104: Line 41:
{{UGasens}}
{{UGasens}}


==API==
{{UGnext|}}
{{SensorAPI}}


==Product History==
==Product History==
{{UGhist}}
{{UGhist}}
{{UGrow|February 2008 |N/A |N/A |Product Release }}
{{UGrow|February 2008 |N/A |N/A |Product Release }}

Revision as of 18:07, 30 August 2016


Required Hardware

  • A 1128 Sonar Sensor
  • An InterfaceKit or Hub to read the sensor
  • A sensor cable
  • A USB cable
  • A computer

Connecting the Pieces

Solder one end of the sensor cable to the Sonar Sensor. The black wire is soldered to GND, the red wire to +5 and the white wire to AN. Optionally a fourth wire can be soldered to RX in order to turn the sensor on and off from your computer.

  1. Connect the sonar sensor to the InterfaceKit or Hub with the sensor cable.
  2. If you're using the fourth wire, connect it to a digital output port on the InterfaceKit or Hub.
  3. Connect the InterfaceKit or Hub to your computer with the USB cable.


Testing Using Windows

Phidget Control Panel

In order to demonstrate the functionality of the 1018, the Phidget Control Panel running on a Windows machine will be used.


The Phidget Control Panel is available for use on both macOS and Windows machines.

Windows

To open the Phidget Control Panel on Windows, find the Ph.jpg icon in the taskbar. If it is not there, open up the start menu and search for Phidget Control Panel

Windows PhidgetTaskbar.PNG

macOS

To open the Phidget Control Panel on macOS, open Finder and navigate to the Phidget Control Panel in the Applications list. Double click on the Ph.jpg icon to bring up the Phidget Control Panel.


For more information, take a look at the getting started guide for your operating system:


Linux users can follow the getting started with Linux guide and continue reading here for more information about the 1018.

First Look

After plugging the 1018 into your computer and opening the Phidget Control Panel, you will see something like this:

1018 Panel.jpg


The Phidget Control Panel will list all connected Phidgets and associated objects, as well as the following information:

  • Serial number: allows you to differentiate between similar Phidgets.
  • Channel: allows you to differentiate between similar objects on a Phidget.
  • Version number: corresponds to the firmware version your Phidget is running. If your Phidget is listed in red, your firmware is out of date. Update the firmware by double-clicking the entry.


The Phidget Control Panel can also be used to test your device. Double-clicking on an object will open an example.

Voltage Input

Double-click on a Voltage Input object in order to run the example: [[Image:{{{1}}}_VoltageInputSensor_Example.jpg|center|link=]]


General information about the selected object will be displayed at the top of the window. You can also experiment with the following functionality:

  • Modify the change trigger and/or data interval value by dragging the sliders. For more information on these settings, see the data interval/change trigger page.
  • If you have an analog sensor connected that you bought from us, you can select it from the Sensor Type drop-down menu. The example will then convert the voltage into a more meaningful value based on your sensor, with units included, and display it beside the Sensor Value label. Converting voltage to a Sensor Value is not specific to this example, it is handled by the Phidget libraries, with functions you have access to when you begin developing!


For more information about Voltage Inputs, check out the Voltage Input Primer.

Testing Using Mac OS X

  1. Go to the Quick Downloads section on the Mac OS X page.
  2. Download and run the Phidget OS X Installer
  3. Click on System Preferences >> Phidgets (under Other) to activate the Preference Pane
  4. Make sure your device is properly attached
  5. Double click on your device's objects in the listing to open them. The Preference Pane and examples will function very similarly to the ones described above in the Windows section.

Testing Using Linux

For a general step-by-step guide on getting Phidgets running on Linux, see the Linux page.

Using a Remote OS

We recommend testing your Phidget on a desktop OS before moving on to remote OS. Once you've tested your Phidget, you can go to the PhidgetSBC, or iOS pages to learn how to proceed.

Technical Details

The Sonar Sensor is manufactured by Maxbotix.com. We have added a sensor cable and instructions on soldering the cable to the sensor. The Sonar Sensor is Ratiometric. Make sure that the ratiometric property is set to TRUE when programming the sensor. Each time after the LV-MaxSonar®-EZ1™ is powered up, it will calibrate during its first read cycle. The sensor uses this stored information to range a close object. It is important that objects not be close to the sensor during this calibration cycle. The best sensitivity is obtained when it is clear for fourteen inches, but good results are common when clear for at least seven inches. If an object is too close during the calibration cycle, the sensor may then ignore objects at that distance. The LV-MaxSonar®-EZ1™ does not use the calibration data to temperature compensate for range, but instead to compensate for the sensor ringdown pattern. If the temperature, humidity, or applied voltage changes during operation, the sensor may require recalibration to reacquire the ringdown pattern. Unless recalibrated, if the temperature increases, the sensor is more likely to have false close readings. If the temperature decreases, the sensor is more likely to have reduced upclose sensitivity. To recalibrate the LV-MaxSonar®-EZ1™, cycle power. For more complete specifications on the MaxSonar-EZ1, please visit www.maxbotix.com

Interference

Since the beam width is fairly large and sound tends to reflect more than light, sonar sensors will interfere with one another if more than one is active in a sensor array. To avoid interference we recommend that you poll each sensor individually and only activate the specific sensor you are polling. That way you can activate one sensor, read the distance, and then deactivate it before moving to the next sensor. This will give you clean results. Perhaps the easiest way to achieve this is to take the power line from the sensor and connect it to a digital output of your InterfaceKit instead of the normal analog input power pin. This will allow you to toggle the power to the device and turn it on or off at will.

Formulas

The formula to translate SensorValue to Distance is:



Template:UGotherint

Phidget Cable

Analoginput.jpg

The Phidget Cable is a 3-pin, 0.100 inch pitch locking connector. Pictured here is a plug with the connections labelled. The connectors are commonly available - refer to the Analog Input Primer for manufacturer part numbers.

What to do Next

  • Programming Languages - Find your preferred programming language here and learn how to write your own code with Phidgets!
  • Phidget Programming Basics - Once you have set up Phidgets to work with your programming environment, we recommend you read our page on to learn the fundamentals of programming with Phidgets.


Product History

Template:UGhist Template:UGrow