HIN1001 User Guide - Revision history

Mparadis at 21:14, 17 January 2022

2022-01-17T21:14:56Z

← Older revision		Revision as of 21:14, 17 January 2022
Line 36:		Line 36:
	{{UGC-Addressing}}		{{UGC-Addressing}}
	{{UGC-Graphing}}		{{UGC-Graphing}}
			{{UGC-Firmware}}
	{{UGC-Entry\|Interaction with Data Interval\|\|		{{UGC-Entry\|Interaction with Data Interval\|\|
	Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial		Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial

Mparadis at 20:36, 28 January 2021

2021-01-28T20:36:02Z

@@ Line 4: / Line 4: @@
 [[Category:UserGuide]]
 ==Part 1: Setup==
+{{PT1 Deck Sequence}}
 == Part 2: Using Your Phidget ==

Mparadis: /* Part 4: Advanced Topics and Troubleshooting */

2021-01-06T21:19:57Z

Part 4: Advanced Topics and Troubleshooting

← Older revision		Revision as of 21:19, 6 January 2021
Line 47:		Line 47:
	{{UGC-Start}}		{{UGC-Start}}
	{{UGC-Addressing}}		{{UGC-Addressing}}
			{{UGC-Graphing}}
	{{UGC-Entry\|Interaction with Data Interval\|\|		{{UGC-Entry\|Interaction with Data Interval\|\|
	Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial		Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial

Mparadis at 19:50, 4 August 2020

2020-08-04T19:50:44Z

← Older revision		Revision as of 19:50, 4 August 2020
Line 1:		Line 1:
	__NOINDEX__		__NOINDEX__
			__NOTOC__
	<metadesc>The Touch Wheel Phidget has a circular touch region and buttons that make for an intuitive user interface to your Phidgets system.</metadesc>		<metadesc>The Touch Wheel Phidget has a circular touch region and buttons that make for an intuitive user interface to your Phidgets system.</metadesc>
	[[Category:UserGuide]]		[[Category:UserGuide]]
	==~~Getting Started~~==		==Part 1: Setup==

	* [{{SERVER}}/products.php?product_id=HIN1001 HIN1001 Touch Wheel Phidget]		* [{{SERVER}}/products.php?product_id=HIN1001 HIN1001 Touch Wheel Phidget]
Line 15:		Line 16:
	<br clear="all">		<br clear="all">

	==Using ~~the HIN1001~~==		{{UGcontrolpanel\|HIN1001}}

			== Part 2: Using Your Phidget ==

			===About===
			The Touch Wheel Phidget provides one scroll wheel and seven capacitive touch regions with adjustable sensitivity.

			===Explore Your Phidget Channels Using The Control Panel===

			You can use your Control Panel to explore your Phidget's channels.

	~~{{UGcontrolpanel\|HIN1001}}~~		'''1.''' Open your Control Panel, and you will find the following channels:

	~~{{ugCapacitiveTouch~~\|~~HIN1001}}~~		[[Image:HIN1001_Panel.jpg\|link=\|center]]

	~~{{ugAddressingInformation}}~~		'''2.''' Double click on a channel to open an example program. Each channel belongs to the '''CapacitiveTouch''' channel class:

	{{~~ugUsingYourOwnProgram\|HIN1001~~}}		{{UGC-Start}}

	~~==Technical Details==~~		{{UGC-Entry\|Capacitive Scroll Sensor:\| Detects a touch or the close proximity of your hand or other conductive objects\|
			In your Control Panel, double click on "Capacitive Scroll Sensor":

	=~~==Interaction with Data Interval===~~		[[Image:HIN1001-CapacitiveTouch.jpg\|center\|link=]]}}

	Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial response time, rather than an overall data rate. After the first touch has been detected, the device will stream data as fast as possible (up to every 16ms, as data becomes available). This means that if setting a data interval of 250ms, the first touch may need to be held up to 250ms to wake the device, after which subsequent touches on all channels will be detected much faster, until no touch is detected for a few seconds. Once the device has been left alone for a few seconds, it will resume its low-~~power state and wait for the next touch.~~		{{UGC-End}}

	~~===Re~~-~~Calibration===~~		{{UG-Part3}}

	~~Since capacitive touch sensors rely on checking capacitance against a threshold to detect when they are touched~~, ~~they need to keep~~ a ~~good baseline of~~ the ~~capacitance of their environment. The~~ HIN1001 ~~will re-calibrate~~ its ~~baseline levels if it detects a constant touch for more than 50 seconds~~, ~~in order to prevent getting stuck in a touched state~~. ~~Similarly~~, it will ~~re-calibrate its baseline capacitance~~ to ~~adjust to falling capacitance (such~~ as ~~when it is moved away from a surface~~) ~~in order to prevent getting stuck in a not-touched state. The latter adjustment happens as soon as the baseline is detected to have fallen~~.		== Part 4: Advanced Topics and Troubleshooting ==
			{{UGC-Start}}
			{{UGC-Addressing}}
			{{UGC-Entry\|Interaction with Data Interval\|\|
			Unlike most other Phidgets, setting a data interval on the HIN1001 affects its initial
			“wake up” time, instead of the overall data rate. After the first touch has been detected, the device will stream data as fast as possible (up to every 16ms, as data becomes available).

	~~===Relative Change in Position===~~		This means that if setting a data interval of 250ms, the first touch may need to be held up to 250ms to wake the device, after which subsequent touches on all channels will be detected much faster, until no touch is detected for a few seconds. Once the device has been left alone for a few seconds, it will resume its low-power state and wait for the next touch.
	~~[[Image:CapacitiveTouch_CircularPositionChange.jpg\|250px\|right\|link=]]~~		}}

	~~Since the~~ touch ~~wheel is circular, calculating~~ the ~~change in position~~ of a ~~finger over the wheel can be~~ more ~~involved~~ than ~~simply subtracting one position from another. In cases where the value crosses the zero point~~, ~~a simple subtraction would indicate a large movement~~ in ~~the opposite direction. For example~~ a ~~movement from 0~~.9 to ~~0.1 would appear~~ as ~~a movement of -0.8,~~ when a ~~movement of +0.2 is much more likely. As such,~~ a ~~change is position should be calculated taking this into account~~. ~~Here~~ is ~~an example of how~~ to ~~do the calculation in C:~~		{{UGC-Entry\|Recalibration\|\|
			The capacitive touch sensors rely on checking capacitance against a threshold to detect when they are touched. As a result you need to keep a good baseline of the capacitance of the sensor's environment. The HIN1001 will recalibrate its baseline levels if it detects a constant touch for more than 50 seconds, in order to prevent getting stuck in a touched state. Similarly, it will recalibrate its baseline capacitance to adjust to falling capacitance (such as when it is moved away from a surface) in order to prevent getting stuck in a not-touched state. The latter adjustment happens as soon as the baseline is detected to have fallen.
			}}

	<div class="source">		{{UGC-Entry\|Relative Change in Position\|\|
	<syntaxhighlight lang=c>		[[Image:CapacitiveTouch_CircularPositionChange.jpg\|250px\|right\|link=]]
			Since the touch wheel is circular, calculating the change in position of a finger over the wheel can be more involved than simply subtracting one position from another. In cases where the value crosses the zero point, a simple subtraction would indicate a large movement in the opposite direction. For example a movement from 0.9 to 0.1 would appear as a movement of -0.8, when a movement of +0.2 is much more likely. As such, a change in position should be calculated taking this into account. Here is an example of how to do the calculation in C:
			<div class{{=}}"source">
			<syntaxhighlight lang{{=}}c>
	static void CCONV		static void CCONV
	onTouchHandler(PhidgetCapacitiveTouchHandle ch, void *ctx, double touchValue) {		onTouchHandler(PhidgetCapacitiveTouchHandle ch, void *ctx, double touchValue) {
Line 59:		Line 80:
	</syntaxhighlight>		</syntaxhighlight>
	</div>		</div>
	~~<!--~~		}}
	~~===Current Consumption===~~		{{UGC-End}}

	The current consumption of the HIN1001 varies depending on the data interval that you choose. When it is connected but not configured, it will draw a minimal current of around 20 µA. Once it has been configured, current consumption will increase as the interval between data events is shortened, as illustrated by this graph:

	~~[[Image:HIN1001-current.jpg\|link=\|885px]]~~
	~~-->~~
	{{~~UGnext\|~~}}

Jdecoux at 16:38, 17 October 2019

2019-10-17T16:38:07Z

← Older revision		Revision as of 16:38, 17 October 2019
Line 23:		Line 23:
	{{ugAddressingInformation}}		{{ugAddressingInformation}}

	{{ugUsingYourOwnProgram\|~~This Phidget is compatible with the {{ExampleLink\|CapacitiveTouch}}.~~}}		{{ugUsingYourOwnProgram\|HIN1001}}

	==Technical Details==		==Technical Details==

Jdecoux: /* Using the HIN1001 */

2018-08-28T16:13:30Z

Using the HIN1001

← Older revision		Revision as of 16:13, 28 August 2018
Line 23:		Line 23:
	{{ugAddressingInformation}}		{{ugAddressingInformation}}

	{{ugUsingYourOwnProgram\| {{ExampleLink\|CapacitiveTouch}}.}}		{{ugUsingYourOwnProgram\|This Phidget is compatible with the {{ExampleLink\|CapacitiveTouch}}.}}

	==Technical Details==		==Technical Details==

Jdecoux: /* Using Your Own Program */

2018-08-27T22:13:56Z

Using Your Own Program

← Older revision		Revision as of 22:13, 27 August 2018
Line 23:		Line 23:
	{{ugAddressingInformation}}		{{ugAddressingInformation}}

	~~===Using Your Own Program===~~		{{ugUsingYourOwnProgram\| {{ExampleLink\|CapacitiveTouch}}.}}

	~~You are now ready to start writing your own code for the device. The best way to do that is to start from our examples:~~

	~~This Phidget is compatible with the~~ {{ExampleLink\|CapacitiveTouch}}.

	Once you have your example, you will need to follow the instructions on the page for your programming language to get it running. To find these instructions, select your programming language from the [[Software_Overview#Language_Support\|Software Overview]] page.

	==Technical Details==		==Technical Details==

Jdecoux at 18:13, 27 August 2018

2018-08-27T18:13:48Z

← Older revision		Revision as of 18:13, 27 August 2018
Line 20:		Line 20:

	{{ugCapacitiveTouch\|HIN1001}}		{{ugCapacitiveTouch\|HIN1001}}

			{{ugAddressingInformation}}

			===Using Your Own Program===

			You are now ready to start writing your own code for the device. The best way to do that is to start from our examples:

			This Phidget is compatible with the {{ExampleLink\|CapacitiveTouch}}.

			Once you have your example, you will need to follow the instructions on the page for your programming language to get it running. To find these instructions, select your programming language from the [[Software_Overview#Language_Support\|Software Overview]] page.

	==Technical Details==		==Technical Details==

Mparadis at 15:59, 7 June 2018

2018-06-07T15:59:46Z

← Older revision		Revision as of 15:59, 7 June 2018
Line 7:		Line 7:
	* {{VINTHub}}		* {{VINTHub}}
	* USB cable and computer		* USB cable and computer
	* [{{~~SERVER~~}}~~/?view=comparetable&rel=Phidget%20Cables Phidget cable]~~		* {{CT\|PhidgetCable\|Phidget cable}}

	Next, you will need to connect the pieces:		Next, you will need to connect the pieces:

Mparadis at 20:26, 8 May 2018

2018-05-08T20:26:15Z

← Older revision		Revision as of 20:26, 8 May 2018
Line 1:		Line 1:
			__NOINDEX__
	<metadesc>The Touch Wheel Phidget has a circular touch region and buttons that make for an intuitive user interface to your Phidgets system.</metadesc>		<metadesc>The Touch Wheel Phidget has a circular touch region and buttons that make for an intuitive user interface to your Phidgets system.</metadesc>
	[[Category:UserGuide]]		[[Category:UserGuide]]