pacmod_game_control repository

Repository Summary

Checkout URI https://github.com/astuff/pacmod_game_control.git
VCS Type git
VCS Version master
Last Updated 2021-08-05
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
pacmod_game_control 3.0.1

README

PACMod Game Controller

CircleCI

An interface node to allow control of the PACMod system with a game controller that is represented in ROS by a Joy node.

For more information, see the ROS Wiki.

For access to the DBC file which defines the CAN interface for the PACMod, see the pacmod_dbc repo.

Controls

Supported Controllers

The currently supported controllers are:

NOTE: The Logitech F310 controller has a switch on the back of the controller for switching between "X" and "D". Ensure the switch is always set to "X". In addition, the Logitech F310 also has a MODE button that toggles a green light, ensure the green light is always off.

In the event that you want to add support for a new controller: Simply add the new controller type to the GamepadType enum in include/globals.h and create new button mappings in src/startup_checks.cpp.

Logitech F310 Control Scheme

Below is the control scheme for the Logitech F310, the control scheme is similar for other controllers.

Left: Front Layout of logitech Controller; Right: Side-button layout of logitech controller

Button Action Notes
Directional Pad (left-hand side) Headlights and Turn Signals
Up Headlights Some vehicles only
Left Left turn signal
Right Right turn signal
Down Hazards Some vehicles only
Button Pad (right-hand side) Gear Selection
A Drive
B Reverse
X Neutral
Y Park
Center region
Back Enable/Disable 'Back' and 'Start' buttons must be pressed simultaneously to enable by-wire mode. 'Back' button must be pressed to disable by-wire mode.
Start Enable 'Back' and 'Start' buttons must be pressed simultaneously to enable by-wire mode.
Mode Not supported Do not use. Mode light should be OFF at all times. Pressing mode button will change button mapping.
Joystick Steering Joystick click buttons unused
Left joystick Steering Steering defaults to left joystick, but can be set to right joystick by operator.
Right joystick Steering Only if set by operator; steering defaults to left joystick
Left bumper Wipers Some vehicles only
Left trigger Brake
Right bumper Horn Some vehicles only
Right trigger Throttle

Supported Vehicles

Please see PACMod3 readme and astuff_sensor_msgs readme to use correct version of driver for a vehicle. For vehicles using drivers with message migration, astuff_sensor_msgs repo is not required.

Supported Vehicles ROS Version Available PACMod Version ROS Driver Branch
Polaris GEM Series (e2/e4/e6) MY 2016+ ROS PACMod2 PGC Driver
Polaris eLXD MY 2016+ ROS PACMod2 PGC Driver
International Prostar+ 122 ROS PACMod2 PGC Driver
Lexus RX-450h MY 2016+ ROS PACMod3 PGC Driver
Lexus RX-450h MY 2016+ V3 ROS PACMod3 PGC Driver with message migration
Kenworth T680 Semi 2017+ ROS PACMod3 PGC Driver
Freightliner Cascadia DD13 DayCab/Sleeper/Extended-Sleeper ROS PACMod3 PGC Driver
Tractor 2017+ ROS PACMod3 PGC Driver (Hexagon Tractor)
Ford Ranger 2019+ ROS PACMod3 PGC Driver with message migration
Polaris Ranger X900 ROS PACMod3 PGC Driver with message migration
Toyota Minivan 2019+ ROS PACMod3 PGC Driver with message migration
VEHICLE_HCV ROS PACMod3 PGC Driver with message migration
VEHICLE_FTT ROS PACMod3 PGC Driver with message migration

More coming soon...

CONTRIBUTING

No CONTRIBUTING.md found.

Repository Summary

Checkout URI https://github.com/astuff/pacmod_game_control.git
VCS Type git
VCS Version master
Last Updated 2021-08-05
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
pacmod_game_control 3.0.1

README

PACMod Game Controller

CircleCI

An interface node to allow control of the PACMod system with a game controller that is represented in ROS by a Joy node.

For more information, see the ROS Wiki.

For access to the DBC file which defines the CAN interface for the PACMod, see the pacmod_dbc repo.

Controls

Supported Controllers

The currently supported controllers are:

NOTE: The Logitech F310 controller has a switch on the back of the controller for switching between "X" and "D". Ensure the switch is always set to "X". In addition, the Logitech F310 also has a MODE button that toggles a green light, ensure the green light is always off.

In the event that you want to add support for a new controller: Simply add the new controller type to the GamepadType enum in include/globals.h and create new button mappings in src/startup_checks.cpp.

Logitech F310 Control Scheme

Below is the control scheme for the Logitech F310, the control scheme is similar for other controllers.

Left: Front Layout of logitech Controller; Right: Side-button layout of logitech controller

Button Action Notes
Directional Pad (left-hand side) Headlights and Turn Signals
Up Headlights Some vehicles only
Left Left turn signal
Right Right turn signal
Down Hazards Some vehicles only
Button Pad (right-hand side) Gear Selection
A Drive
B Reverse
X Neutral
Y Park
Center region
Back Enable/Disable 'Back' and 'Start' buttons must be pressed simultaneously to enable by-wire mode. 'Back' button must be pressed to disable by-wire mode.
Start Enable 'Back' and 'Start' buttons must be pressed simultaneously to enable by-wire mode.
Mode Not supported Do not use. Mode light should be OFF at all times. Pressing mode button will change button mapping.
Joystick Steering Joystick click buttons unused
Left joystick Steering Steering defaults to left joystick, but can be set to right joystick by operator.
Right joystick Steering Only if set by operator; steering defaults to left joystick
Left bumper Wipers Some vehicles only
Left trigger Brake
Right bumper Horn Some vehicles only
Right trigger Throttle

Supported Vehicles

Please see PACMod3 readme and astuff_sensor_msgs readme to use correct version of driver for a vehicle. For vehicles using drivers with message migration, astuff_sensor_msgs repo is not required.

Supported Vehicles ROS Version Available PACMod Version ROS Driver Branch
Polaris GEM Series (e2/e4/e6) MY 2016+ ROS PACMod2 PGC Driver
Polaris eLXD MY 2016+ ROS PACMod2 PGC Driver
International Prostar+ 122 ROS PACMod2 PGC Driver
Lexus RX-450h MY 2016+ ROS PACMod3 PGC Driver
Lexus RX-450h MY 2016+ V3 ROS PACMod3 PGC Driver with message migration
Kenworth T680 Semi 2017+ ROS PACMod3 PGC Driver
Freightliner Cascadia DD13 DayCab/Sleeper/Extended-Sleeper ROS PACMod3 PGC Driver
Tractor 2017+ ROS PACMod3 PGC Driver (Hexagon Tractor)
Ford Ranger 2019+ ROS PACMod3 PGC Driver with message migration
Polaris Ranger X900 ROS PACMod3 PGC Driver with message migration
Toyota Minivan 2019+ ROS PACMod3 PGC Driver with message migration
VEHICLE_HCV ROS PACMod3 PGC Driver with message migration
VEHICLE_FTT ROS PACMod3 PGC Driver with message migration

More coming soon...

CONTRIBUTING

No CONTRIBUTING.md found.