HIN1100 User Guide - Revision history

Mparadis at 21:15, 17 January 2022

2022-01-17T21:15:07Z

← Older revision		Revision as of 21:15, 17 January 2022
Line 42:		Line 42:
	{{UGC-Addressing}}		{{UGC-Addressing}}
	{{UGC-DataInterval}}		{{UGC-DataInterval}}
			{{UGC-Firmware}}
	{{UGC-Entry\|Converting to Polar Coordinates\|\|		{{UGC-Entry\|Converting to Polar Coordinates\|\|
	[[Image:HIN1100_Polar.jpg\|700px\|link=]]		[[Image:HIN1100_Polar.jpg\|700px\|link=]]

Mparadis at 20:11, 28 January 2021

2021-01-28T20:11:06Z

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

Mparadis at 21:04, 4 August 2020

2020-08-04T21:04:39Z

← Older revision		Revision as of 21:04, 4 August 2020
Line 1:		Line 1:
	__NOINDEX__		__NOINDEX__
			__NOTOC__
	<metadesc>The Thumbstick Phidget is perfect for making a custom controller for your project. Two-axis with a center pushbutton, it plugs into a VINT port.</metadesc>		<metadesc>The Thumbstick Phidget is perfect for making a custom controller for your project. Two-axis with a center pushbutton, it plugs into a VINT port.</metadesc>
	[[Category:UserGuide]]		[[Category:UserGuide]]
	==~~=Getting Started=~~==		==Part 1: Setup==

	* [{{SERVER}}/products.php?product_id=HIN1100 HIN1100 Thumbstick Phidget]		* [{{SERVER}}/products.php?product_id=HIN1100 HIN1100 Thumbstick Phidget]
Line 17:		Line 18:
	{{UGIntroDone\|HIN1100}}.		{{UGIntroDone\|HIN1100}}.

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

			== Part 2: Using Your Phidget ==

			===About===
			The 2-axis Thumbstick Phidget tracks the horizontal and vertical position of the stick between -1 and 1. The stick will snap back to the center when released. The thumbstick can also be clicked down to activate a push-button, similar to a video game controller.

	{{~~UGcontrolpanel\|HIN1100~~}}		[[Image:HIN1100-About.jpg\|link=]]

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

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

			'''1.''' Open your Control Panel, and you will find the following channels:

			[[Image:HIN1100_Panel.jpg\|link=\|center]]

			'''2.''' Double click on a channel to open an example program.
			{{UGC-Start}}

	{{~~ugDigitalInputButton~~\|~~HIN1100~~\|~~You can click down on~~ the ~~middle~~ of the ~~thumbstick to activate the digital input.}}~~		{{UGC-Entry\|Joystick Axis:\| Reports the tilt of the joystick (Channel 0 for up/down and channel 1 for left/right)\|
			In your Control Panel, double click on "Joystick Axis":

	~~{{ugVoltageRatioAxis~~\|~~HIN1100~~}}		[[Image:HIN1100-VoltageRatio.jpg\|center\|link=]]}}

	{{~~ugAddressingInformation}}~~		{{UGC-Entry\|Joystick Button:\| Reports the state of the pushbutton\|
			In your Control Panel, double click on "Joystick Button":

	~~{{ugUsingYourOwnProgram~~\|~~HIN1100~~}}		[[Image:HIN1100-DigitalInput.jpg\|center\|link=]]}}

	~~==Technical Details==~~		{{UGC-End}}

	~~=== Converting to Polar Coordinates ===~~		{{UG-Part3}}

			== Part 4: Advanced Topics and Troubleshooting ==
			{{UGC-Start}}
			{{UGC-Addressing}}
			{{UGC-DataInterval}}
			{{UGC-Entry\|Converting to Polar Coordinates\|\|
	[[Image:HIN1100_Polar.jpg\|700px\|link=]]		[[Image:HIN1100_Polar.jpg\|700px\|link=]]

Line 41:		Line 65:
	::<math>\phi = atan2(x, y) </math>		::<math>\phi = atan2(x, y) </math>

	Where ~~'''~~r~~'''~~ is the magnitude, ~~'''~~ϕ~~'''~~ is the angle, and ~~'''~~x~~'''~~ and ~~'''~~y~~'''~~ are the two axis values. Atan2 is the 2-argument arctangent function, which you can find in most math libraries. For example, in C# you could use ~~{{Code\|~~Math.Atan2(x,y)}}. Depending on your language, ~~'''~~ϕ~~'''~~ may be in radians or degrees.		Where r is the magnitude, ϕ is the angle, and x and y are the two axis values. Atan2 is the 2-argument arctangent function, which you can find in most math libraries. For example, in C# you could use Math.Atan2(x,y). Depending on your language, ϕ may be in radians or degrees.
			Since x and y range from -1.0 to 1.0, the resulting r will range from -√2 to √2, so you may also want to modify the first formula like so:
	Since ~~'''~~x~~'''~~ and ~~'''~~y~~'''~~ range from -1.0 to 1.0, the resulting ~~'''~~r~~'''~~ will range from ~~<math>~~-~~\sqrt{2}</math>~~ to ~~<math>\sqrt{2}</math>~~, so you may also want to modify the first formula like so:

	::<math>\text{r} = \frac{\sqrt{x^2 + y^2}}{\sqrt{2}} </math>		::<math>\text{r} = \frac{\sqrt{x^2 + y^2}}{\sqrt{2}} </math>

	This way, your ~~'''~~r~~'''~~ will range from ~~'''~~0~~'''~~ to ~~'''~~1~~'''~~, which is more intuitive than ~~<math>~~-~~\sqrt{2}</math>~~ to ~~<math>\sqrt{2}</math>~~.		This way, your r will range from 0 to 1, which is more intuitive than -√2 to √2.
			}}
	~~=== Current Consumption ===~~

	~~The current consumption of the HIN1100 depends on the data interval being used:~~

	~~[[Image:HIN1100-current.jpg\|link=]]~~

	{{~~UGnext\|~~}}		{{UGC-End}}

Jdecoux at 16:40, 17 October 2019

2019-10-17T16:40:27Z

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

	{{ugUsingYourOwnProgram\|~~This Phidget is compatible with the {{ExampleLink\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.~~}}		{{ugUsingYourOwnProgram\|HIN1100}}

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

Jdecoux: /* Using the HIN1100 */

2018-08-28T17:57:29Z

Using the HIN1100

← Older revision		Revision as of 17:57, 28 August 2018
Line 21:		Line 21:
	{{UGcontrolpanel\|HIN1100}}		{{UGcontrolpanel\|HIN1100}}

	{{~~ugDigitalInput~~\|HIN1100\|You can click down on the middle of the thumbstick to activate the digital input.}}		{{ugDigitalInputButton\|HIN1100\|You can click down on the middle of the thumbstick to activate the digital input.}}

	{{ugVoltageRatioAxis\|HIN1100}}		{{ugVoltageRatioAxis\|HIN1100}}

Jdecoux at 16:00, 28 August 2018

2018-08-28T16:00:57Z

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

	{{ugUsingYourOwnProgram\| the {{ExampleLink\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.}}		{{ugUsingYourOwnProgram\|This Phidget is compatible with the {{ExampleLink\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.}}

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

Jdecoux: /* Using Your Own Program */

2018-08-27T22:14:47Z

Using Your Own Program

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

	~~===Using Your Own Program===~~		{{ugUsingYourOwnProgram\| the {{ExampleLink\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.}}

	~~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\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.

	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:16, 27 August 2018

2018-08-27T18:16:40Z

← Older revision		Revision as of 18:16, 27 August 2018
Line 24:		Line 24:

	{{ugVoltageRatioAxis\|HIN1100}}		{{ugVoltageRatioAxis\|HIN1100}}

			{{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\|VoltageRatioInput}} and the {{ExampleLink\|DigitalInput}}.

			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: /* Converting to Polar Coordinates */

2018-06-26T18:59:36Z

Converting to Polar Coordinates

← Older revision		Revision as of 18:59, 26 June 2018
Line 43:		Line 43:
	::<math>\text{r} = \frac{\sqrt{x^2 + y^2}}{\sqrt{2}} </math>		::<math>\text{r} = \frac{\sqrt{x^2 + y^2}}{\sqrt{2}} </math>

	This way, your '''r''' will range from 0 to 1, which is ~~better when using the Thumbstick Phidget as a controller~~.		This way, your '''r''' will range from '''0''' to '''1''', which is more intuitive than <math>-\sqrt{2}</math> to <math>\sqrt{2}</math>.

	=== Current Consumption ===		=== Current Consumption ===

Mparadis: /* Converting to Polar Coordinates */

2018-06-26T18:58:36Z

Converting to Polar Coordinates

← Older revision		Revision as of 18:58, 26 June 2018
Line 37:		Line 37:
	::<math>\phi = atan2(x, y) </math>		::<math>\phi = atan2(x, y) </math>

	Where '''r''' is the magnitude, '''ϕ''' is the angle, and '''x''' and '''y''' are the two axis values. Atan2 is the 2-argument arctangent function, which you can find in most math libraries. For example, in C# you could use {{Code\|Math.Atan2(x,y)}}.		Where '''r''' is the magnitude, '''ϕ''' is the angle, and '''x''' and '''y''' are the two axis values. Atan2 is the 2-argument arctangent function, which you can find in most math libraries. For example, in C# you could use {{Code\|Math.Atan2(x,y)}}. Depending on your language, '''ϕ''' may be in radians or degrees.

	Since '''x''' and '''y''' range from -1.0 to 1.0, the resulting '''r''' will range from <math>-\sqrt{2}</math> to <math>\sqrt{2}</math>, so you may also want to modify the first formula like so:		Since '''x''' and '''y''' range from -1.0 to 1.0, the resulting '''r''' will range from <math>-\sqrt{2}</math> to <math>\sqrt{2}</math>, so you may also want to modify the first formula like so:

← Older revision		Revision as of 17:57, 28 August 2018
Line 21:		Line 21:
	{{UGcontrolpanel\|HIN1100}}		{{UGcontrolpanel\|HIN1100}}

	{{~~ugDigitalInput~~\|HIN1100\|You can click down on the middle of the thumbstick to activate the digital input.}}		{{ugDigitalInputButton\|HIN1100\|You can click down on the middle of the thumbstick to activate the digital input.}}

	{{ugVoltageRatioAxis\|HIN1100}}		{{ugVoltageRatioAxis\|HIN1100}}