Component: Joystick (Sparkfun Quiic) 2D (Analog Input): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix TSL
Version	10.0
Category	Analog Input

Joystick (Sparkfun Quiic) 2D component

An XY sprung joystick with click switch allowing for easy user input control. Connected using I2C bus.

Version information

Library Version, Component Version, Date, Author, Info
10, 10.0, 04-12-24, MW,Icon edited so compatible with dark theme

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

ChangeI2CAddress

	ChangeI2CAddress
Allows the I2C Device address to be changed which in turn allows more then one RFID reader to sit on the same physical I2C bus. Returns 1 if succesful.
- BYTE	NewAddress
Range: 8 to 119 or 0x08 - 0x77
- BOOL	Return

CheckButton

	CheckButton
Checks to see if the button has been pressed since the last read of CheckButton or ReadButton.
- BOOL	Return

Initialise

	Initialise
Initialises the I2C bus ready for communications with the module.
- VOID	Return

ReadAxis

	ReadAxis
Reads a single axis of the joystick and returns as a signed integer value.
- BYTE	Axis
Range 0-1 Where 0=X, 1=Y
- BOOL	Type
0 = Signed (-512 to 511), 1 = Unsigned (0 to 1023)
- INT	Return

ReadButton

	ReadButton
Checks to see if the button is currently pressed
- BOOL	Return

SimMoveThumbStick

	SimMoveThumbStick

- FLOAT	X

- FLOAT	Y

- HANDLE	Component

- VOID	Return

Property reference

	Properties
	Return To Center
Decides if the joystick automatically returns to the center position when released. Yes: The joystick will return to the center when released. No: The joystick will remain in the current position when released.
	Limits
	X Min

	X Max

	Device Address

	Theme
	Box Colour

	Shaft Colour

	Knob Colour

	Style

	Style
Outline line style
	Connections
	Channel
Channel selection
	Baud Select
Baud rate option selector
	SDA
Pin used for SDA (data signal)
	SDA Remap Pin

	SCL
Pin used for SCL (clock signal)
	SCL Remap Pin

	Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.
	Simulation
	Simulate Comms

	Scope Traces
Selects if the component pin connections are automatically generated on the data recorder window or not. Yes: Automatically add the component pins to a group on the data recorder which will reflect the sim data during simultion. No: Do not show the pin signals on the data recorder window.
	Console Data
Selects if the console data is automatically generated or not
	API
Specifies the API component on the panel to interact with to provide comms simulation.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_Sparkfun_Quiic_Joystick_2dgi.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_Sparkfun_Quiic_Joystick_2dgi.fcfx

@@ Line 67: / Line 67: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ChangeI2CAddress'''
+| width="90%" class="mtx-class-macrohead" | '''ChangeI2CAddress'''
 |-
 | colspan="2" | Allows the I2C Device address to be changed which in turn allows more then one RFID reader to sit on the same physical I2C bus. Returns 1 if succesful.&nbsp;
@@ Line 86: / Line 86: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CheckButton'''
+| width="90%" class="mtx-class-macrohead" | '''CheckButton'''
 |-
 | colspan="2" | Checks to see if the button has been pressed since the last read of CheckButton or ReadButton.&nbsp;
@@ Line 100: / Line 100: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+| width="90%" class="mtx-class-macrohead" | '''Initialise'''
 |-
 | colspan="2" | Initialises the I2C bus ready for communications with the module.&nbsp;
@@ Line 114: / Line 114: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadAxis'''
+| width="90%" class="mtx-class-macrohead" | '''ReadAxis'''
 |-
 | colspan="2" | Reads a single axis of the joystick and returns as a signed integer value.&nbsp;
@@ Line 138: / Line 138: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ReadButton'''
+| width="90%" class="mtx-class-macrohead" | '''ReadButton'''
 |-
 | colspan="2" | Checks to see if the button is currently pressed&nbsp;
@@ Line 152: / Line 152: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SimMoveThumbStick'''
+| width="90%" class="mtx-class-macrohead" | '''SimMoveThumbStick'''
 |-
 | colspan="2" | &nbsp;
@@ Line 181: / Line 181: @@
 {| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
@@ Line 190: / Line 190: @@
 | colspan="2" | Decides if the joystick automatically returns to the center position when released. Yes: The joystick will return to the center when released. No: The joystick will remain in the current position when released.&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Limits
+| width="90%" class="mtx-class-propfolder" | Limits
 |-
 |-
@@ Line 209: / Line 209: @@
 | colspan="2" | &nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Theme
+| width="90%" class="mtx-class-propfolder" | Theme
 |-
 |-
@@ Line 238: / Line 238: @@
 | colspan="2" | Outline line style&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Connections
+| width="90%" class="mtx-class-propfolder" | Connections
 |-
 |-
@@ Line 277: / Line 277: @@
 | colspan="2" | On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not  a 10ms delay between an I2C stop event and the next I2C start event.  Most modern microcontrollers will not have a problem so this property can be disabled to speed up the  I2C communications. &nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation
+| width="90%" class="mtx-class-propfolder" | Simulation
 |-
 |-

SteveT (talk | contribs)