Interface with the Logitech G27 shifter. More...

#include <SimRacing.h>

Inheritance diagram for SimRacing::LogitechShifterG27:

Public Types
enum	Button : uint8_t { BUTTON_UNUSED1 = 15 , BUTTON_REVERSE = 14 , BUTTON_UNUSED2 = 13 , BUTTON_SEQUENTIAL = 12 , BUTTON_3 = 11 , BUTTON_2 = 10 , BUTTON_4 = 9 , BUTTON_1 = 8 , BUTTON_NORTH = 7 , BUTTON_EAST = 6 , BUTTON_WEST = 5 , BUTTON_SOUTH = 4 , DPAD_RIGHT = 3 , DPAD_LEFT = 2 , DPAD_DOWN = 1 , DPAD_UP = 0 }
	Enumeration of button values. More...

using	Gear = int8_t
	Type alias for gear numbers.

Public Member Functions
	LogitechShifterG27 (PinNum pinX, PinNum pinY, PinNum pinLatch, PinNum pinClock, PinNum pinData, PinNum pinLed=UnusedPin, PinNum pinDetect=UnusedPin)
	Class constructor.

virtual void	begin ()
	Initializes the hardware pins for reading the gear states and the buttons.

bool	getButton (Button button) const
	Retrieve the state of a single button.

bool	getButtonChanged (Button button) const
	Checks whether a button has changed between updates.

int	getDpadAngle () const
	Get the directional pad angle in degrees.

bool	buttonsChanged () const
	Checks if any of the buttons have changed since the last update.

void	setPowerLED (bool state)
	Sets the state of the shifter's power LED.

bool	getPowerLED () const
	Gets the commanded state of the shifter's power LED.

long	getPosition (Axis ax, long rMin=AnalogInput::Min, long rMax=AnalogInput::Max) const
	Retrieves the buffered position for the analog axis, rescaled to a nominal range using the calibration values.

int	getPositionRaw (Axis ax) const
	Retrieves the buffered position for the analog axis.

bool	getReverseButton () const
	Checks the current state of the "reverse" button at the bottom of the shift column.

void	setCalibration (GearPosition neutral, GearPosition g1, GearPosition g2, GearPosition g3, GearPosition g4, GearPosition g5, GearPosition g6, float engagePoint=CalEngagementPoint, float releasePoint=CalReleasePoint, float edgeOffset=CalEdgeOffset)
	Calibrate the gear shifter for more accurate shifting.

void	serialCalibration (Stream &iface=Serial)
	Runs an interactive calibration tool using the serial interface.

Gear	getGear () const
	Returns the currently selected gear.

char	getGearChar () const
	Returns a character that represents the current gear.

String	getGearString () const
	Returns a String that represents the current gear.

bool	gearChanged () const
	Checks whether the current gear has changed since the last update.

Gear	getGearMin ()
	Retrieves the minimum possible gear index.

Gear	getGearMax ()
	Retrieves the maximum possible gear index.

bool	update ()
	Perform a poll of the hardware to refresh the class state.

bool	isConnected () const
	Check if the device is physically connected to the board.

void	setStablePeriod (unsigned long t)
	Set how long the detection pin must be stable for before the device is considered to be 'connected'.

Static Public Member Functions
static char	getGearChar (int gear)
	Returns a character that represents the given gear.

static String	getGearString (int gear)
	Returns a String that represents the given gear.

Protected Member Functions
virtual bool	updateState (bool connected)
	Perform an internal poll of the hardware to refresh the class state.

void	setGear (Gear gear)
	Changes the currently set gear, internally.

void	setDetectPtr (DeviceConnection *d)
	Sets the pointer to the detector object.

Detailed Description

Interface with the Logitech G27 shifter.

The G27 shifter includes the same analog shifter as the Logitech Driving Force shifter (implemented in the LogitechShifter class), as well as a directional pad and eight buttons.

See also: https://en.wikipedia.org/wiki/Logitech_G27

Examples: LogitechShifterG27_Joystick.ino, and LogitechShifterG27_Print.ino.

Definition at line 937 of file SimRacing.h.

Member Typedef Documentation

◆ Gear

using SimRacing::Shifter::Gear = int8_t

inherited

Type alias for gear numbers.

Definition at line 510 of file SimRacing.h.

Member Enumeration Documentation

◆ Button

enum SimRacing::LogitechShifterG27::Button : uint8_t

Enumeration of button values.

Buttons 1-4 are the red buttons, from left to right. The directional pad is read as four separate buttons. The black buttons use cardinal directions.

These values represent the bit offset from LSB. Data is read in MSB first.

Enumerator
BUTTON_UNUSED1	Unused shift register pin.
BUTTON_REVERSE	Reverse button (press down on the shifter)
BUTTON_UNUSED2	Unused shift register pin.
BUTTON_SEQUENTIAL	Sequential mode button (turn the dial counter-clockwise)
BUTTON_3	3rd red button (mid right)
BUTTON_2	2nd red button (mid left)
BUTTON_4	4th red button (far right)
BUTTON_1	1st red button (far left)
BUTTON_NORTH	The top black button.
BUTTON_EAST	The right black button.
BUTTON_WEST	The left black button.
BUTTON_SOUTH	The bottom black button.
DPAD_RIGHT	Right button of the directional pad.
DPAD_LEFT	Left button of the directional pad.
DPAD_DOWN	Down button of the directional pad.
DPAD_UP	Top button of the directional pad.

Examples: LogitechShifterG25_Joystick.ino, LogitechShifterG25_Print.ino, LogitechShifterG27_Joystick.ino, and LogitechShifterG27_Print.ino.

Definition at line 949 of file SimRacing.h.

Constructor & Destructor Documentation

◆ LogitechShifterG27()

SimRacing::LogitechShifterG27::LogitechShifterG27	(	PinNum	pinX,
		PinNum	pinY,
		PinNum	pinLatch,
		PinNum	pinClock,
		PinNum	pinData,
		PinNum	pinLed = UnusedPin,
		PinNum	pinDetect = UnusedPin )

Class constructor.

Parameters

pinX	analog input pin for the X axis, DE-9 pin 4
pinY	analog input pin for the Y axis, DE-9 pin 8
pinLatch	digital output pin to pulse to latch data, DE-9 pin 3
pinClock	digital output pin to pulse as a clock, DE-9 pin 1
pinData	digital input pin to use for reading data, DE-9 pin 2
pinLed	digital output pin to light the power LED on connection, DE-9 pin 5
pinDetect	digital input pin for device detection, DE-9 pin 7. Requires a pull-down resistor.

Definition at line 1148 of file SimRacing.cpp.

Member Function Documentation

◆ begin()

void SimRacing::LogitechShifterG27::begin ( )

virtual

Initializes the hardware pins for reading the gear states and the buttons.

Reimplemented from SimRacing::AnalogShifter.

Reimplemented in SimRacing::LogitechShifterG25.

Definition at line 1280 of file SimRacing.cpp.

◆ buttonsChanged()

bool SimRacing::LogitechShifterG27::buttonsChanged ( ) const

Checks if any of the buttons have changed since the last update.

Returns: 'true' if any buttons have changed state, 'false' otherwise

Definition at line 1327 of file SimRacing.cpp.

◆ gearChanged()

bool SimRacing::Shifter::gearChanged ( ) const

inlineinherited

Checks whether the current gear has changed since the last update.

Returns: 'true' if gear has changed, 'false' otherwise

Examples: LogitechShifter_Joystick.ino, and LogitechShifter_Print.ino.

Definition at line 572 of file SimRacing.h.

◆ getButton()

bool SimRacing::LogitechShifterG27::getButton ( Button button ) const

Retrieve the state of a single button.

Parameters

button The button to retrieve

Returns: The state of the button

Definition at line 1331 of file SimRacing.cpp.

◆ getButtonChanged()

bool SimRacing::LogitechShifterG27::getButtonChanged ( Button button ) const

Checks whether a button has changed between updates.

Parameters

button The button to check

Returns: 'true' if the button's state has changed, 'false' otherwise

Definition at line 1335 of file SimRacing.cpp.

◆ getDpadAngle()

int SimRacing::LogitechShifterG27::getDpadAngle ( ) const

Get the directional pad angle in degrees.

This is useful for using the directional pad as a "hatswitch", in USB

Returns: the directional pad value in degrees (0-360), or '-1' if no directional pad buttons are pressed

Definition at line 1339 of file SimRacing.cpp.

◆ getGear()

Gear SimRacing::Shifter::getGear ( ) const

inlineinherited

Returns the currently selected gear.

Will either be reverse (-1), neutral (0), or the current gear indexed at 1 (1st gear is 1, 2nd gear is 2, etc.).

Returns: current gear index

Examples: LogitechShifterG25_Joystick.ino, LogitechShifterG27_Joystick.ino, LogitechShifter_Joystick.ino, and LogitechShifter_Print.ino.

Definition at line 528 of file SimRacing.h.

◆ getGearChar() [1/2]

char SimRacing::Shifter::getGearChar ( ) const

inherited

Returns a character that represents the current gear.

Returns: letter representing the current gear

See also: getGearChar(int)

Definition at line 763 of file SimRacing.cpp.

◆ getGearChar() [2/2]

char SimRacing::Shifter::getGearChar ( int gear )

staticinherited

Returns a character that represents the given gear.

'r' for reverse, 'n' for neutral, or the number of the current gear.

Parameters

gear	the gear index to get the representation for

Returns: letter representing the current gear

Examples: LogitechShifterG25_Print.ino, and LogitechShifterG27_Print.ino.

Definition at line 745 of file SimRacing.cpp.

◆ getGearMax()

Gear SimRacing::Shifter::getGearMax ( )

inlineinherited

Retrieves the maximum possible gear index.

Returns: the highest gear index

Definition at line 588 of file SimRacing.h.

◆ getGearMin()

Gear SimRacing::Shifter::getGearMin ( )

inlineinherited

Retrieves the minimum possible gear index.

Returns: the lowest gear index

Definition at line 581 of file SimRacing.h.

◆ getGearString() [1/2]

String SimRacing::Shifter::getGearString ( ) const

inherited

Returns a String that represents the current gear.

Returns: String representing the current gear

See also: getGearString(int)

Definition at line 804 of file SimRacing.cpp.

◆ getGearString() [2/2]

String SimRacing::Shifter::getGearString ( int gear )

staticinherited

Returns a String that represents the given gear.

"reverse" for reverse, "neutral" for neutral, and then "1st", "2nd", "3rd", and so on.

Parameters

gear	the gear index to get the representation for

Returns: String representing the current gear

Examples: LogitechShifter_Print.ino.

Definition at line 767 of file SimRacing.cpp.

◆ getPosition()

long SimRacing::AnalogShifter::getPosition	(	Axis	ax,
		long	rMin = AnalogInput::Min,
		long	rMax = AnalogInput::Max ) const

inherited

Retrieves the buffered position for the analog axis, rescaled to a nominal range using the calibration values.

By default this is rescaled to a 10-bit value, matching the range used by the AVR analog to digital converter (ADC).

Parameters

rMin	the minimum output value for the rescaling function
rMax	the maximum output value for the rescaling function

Returns: the axis position, buffered and rescaled

Parameters

ax	the axis to get the position of

Examples: LogitechShifterG25_Joystick.ino, LogitechShifterG27_Joystick.ino, and LogitechShifter_Joystick.ino.

Definition at line 915 of file SimRacing.cpp.

◆ getPositionRaw()

int SimRacing::AnalogShifter::getPositionRaw ( Axis ax ) const

inherited

Retrieves the buffered position for the analog axis.

Returns: the axis position, buffered

Parameters

ax	the axis to get the position of

Examples: LogitechShifterG25_Print.ino, LogitechShifterG27_Print.ino, and LogitechShifter_Print.ino.

Definition at line 920 of file SimRacing.cpp.

◆ getPowerLED()

bool SimRacing::LogitechShifterG27::getPowerLED ( ) const

inline

Gets the commanded state of the shifter's power LED.

Returns: 'true' if the power LED is commanded to be on, 'false' if it's commanded to be off.

Definition at line 1048 of file SimRacing.h.

◆ getReverseButton()

bool SimRacing::AnalogShifter::getReverseButton ( ) const

inherited

Checks the current state of the "reverse" button at the bottom of the shift column.

This button is pressed (HIGH) when the shifter is in reverse gear, LOW otherwise.

Returns: current state of the "reverse" button

Examples: LogitechShifter_Joystick.ino.

Definition at line 934 of file SimRacing.cpp.

◆ isConnected()

bool SimRacing::Peripheral::isConnected ( ) const

inherited

Check if the device is physically connected to the board.

That means it is both present and detected long enough to be considered 'stable'.

Returns: 'true' if the device is connected, 'false' otherwise

Definition at line 446 of file SimRacing.cpp.

◆ serialCalibration()

void SimRacing::AnalogShifter::serialCalibration ( Stream & iface = Serial )

inherited

Runs an interactive calibration tool using the serial interface.

Parameters

iface the serial interface to send and receive prompts. Defaults to Serial (CDC USB on most boards).

Examples: LogitechShifterG25_Print.ino, LogitechShifterG27_Print.ino, and LogitechShifter_Print.ino.

Definition at line 1021 of file SimRacing.cpp.

◆ setCalibration()

void SimRacing::AnalogShifter::setCalibration	(	GearPosition	neutral,
		GearPosition	g1,
		GearPosition	g2,
		GearPosition	g3,
		GearPosition	g4,
		GearPosition	g5,
		GearPosition	g6,
		float	engagePoint = CalEngagementPoint,
		float	releasePoint = CalReleasePoint,
		float	edgeOffset = CalEdgeOffset )

inherited

Calibrate the gear shifter for more accurate shifting.

Note that this uses a large number of GearPosition arguments rather than an array because it allows for the use of aggregate initialization.

This way users can copy a single line to set calibration, rather than declaring an array of GearPosition elements and then passing that by pointer to this function.

Parameters

neutral	the X/Y position of the shifter in neutral
g1	the X/Y position of the shifter in 1st gear
g2	the X/Y position of the shifter in 2nd gear
g3	the X/Y position of the shifter in 3rd gear
g4	the X/Y position of the shifter in 4th gear
g5	the X/Y position of the shifter in 5th gear
g6	the X/Y position of the shifter in 6th gear
engagePoint	distance from neutral on Y to register a gear as being engaged (as a percentage of distance from neutral to Y max, 0-1)
releasePoint	distance from neutral on Y to go back into neutral from an engaged gear (as a percentage of distance from neutral to Y max, 0-1)
edgeOffset	distance from neutral on X to select the side gears rather than the center gears (as a percentage of distance from neutral to X max, 0-1)

Definition at line 940 of file SimRacing.cpp.

◆ setDetectPtr()

void SimRacing::Peripheral::setDetectPtr ( DeviceConnection * d )

protectedinherited

Sets the pointer to the detector object.

The detector object is used to check if the peripheral is connected to the microcontroller. The object is polled on every update.

Although the detector instance is accessed via the Peripheral class, it is the responsibility of the dervied class to store the DeviceConnection object and manage its lifetime.

Parameters

d	pointer to the detector object

Definition at line 456 of file SimRacing.cpp.

◆ setGear()

void SimRacing::Shifter::setGear ( Gear gear )

protectedinherited

Changes the currently set gear, internally.

This function sanitizes the newly selected gear with MinGear / MaxGear, and handles caching the previous value for checking if the gear has changed.

Parameters

gear	the new gear value to set

Definition at line 735 of file SimRacing.cpp.

◆ setPowerLED()

void SimRacing::LogitechShifterG27::setPowerLED ( bool state )

Sets the state of the shifter's power LED.

If the shifter is currently connected, this function will turn the power LED on and off. If the shifter is not connected, this will buffer the commanded state and set the LED when the shifter is next connected.

Note: The update() function must be called in order to push the commanded state to the shifter.

Parameters

state the state to set: 1 = on, 0 = off

Definition at line 1233 of file SimRacing.cpp.

◆ setStablePeriod()

void SimRacing::Peripheral::setStablePeriod ( unsigned long t )

inherited

Set how long the detection pin must be stable for before the device is considered to be 'connected'.

Parameters

t	the amount of time, in ms, the input must be stable for (no changes) before it's interpreted as 'detected'

Definition at line 460 of file SimRacing.cpp.

◆ update()

bool SimRacing::Peripheral::update ( )

inherited

Perform a poll of the hardware to refresh the class state.

Returns: 'true' if device state changed, 'false' otherwise

Examples: HandbrakeJoystick.ino, HandbrakePrint.ino, LogitechShifterG25_Joystick.ino, LogitechShifterG25_Print.ino, LogitechShifterG27_Joystick.ino, LogitechShifterG27_Print.ino, LogitechShifter_Joystick.ino, LogitechShifter_Print.ino, PedalsJoystick.ino, and PedalsPrint.ino.

Definition at line 433 of file SimRacing.cpp.

◆ updateState()

bool SimRacing::LogitechShifterG27::updateState ( bool connected )

protectedvirtual

Perform an internal poll of the hardware to refresh the class state.

This function is called from within the public update() in order to refresh the cached state of the peripheral. It needs to be defined in every derived class. This function is the only place where the cached device state should be changed.

Parameters

connected the state of the device connection

Returns: 'true' if device state changed, 'false' otherwise

Reimplemented from SimRacing::AnalogShifter.

Reimplemented in SimRacing::LogitechShifterG25.

Definition at line 1291 of file SimRacing.cpp.

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Member Typedef Documentation

◆ Gear

Member Enumeration Documentation

◆ Button

Constructor & Destructor Documentation

◆ LogitechShifterG27()

Member Function Documentation

◆ begin()

◆ buttonsChanged()

◆ gearChanged()

◆ getButton()

◆ getButtonChanged()

◆ getDpadAngle()

◆ getGear()

◆ getGearChar() [1/2]

◆ getGearChar() [2/2]

◆ getGearMax()

◆ getGearMin()

◆ getGearString() [1/2]

◆ getGearString() [2/2]

◆ getPosition()

◆ getPositionRaw()

◆ getPowerLED()

◆ getReverseButton()

◆ isConnected()

◆ serialCalibration()

◆ setCalibration()

◆ setDetectPtr()

◆ setGear()

◆ setPowerLED()

◆ setStablePeriod()

◆ update()

◆ updateState()