Joystick: Joy messages

This guide will teach you how to configure Joy messages for joystick control.

Step 1: Navigate to device teleoperation settings

  1. In Formant, in the upper-left corner, open the menu and click Settings.
  2. Click Devices, and then click on the device you want to configure.
  3. Click on the Teleoperation tab to open the teleoperation configuration page.

Step 2: Add a Joy stream

  1. In the teleoperation configuration page, scroll down to Joystick and click the plus (+) icon.

ROS

Formant will send joystick coordinate data as a geometry_msgs/Twist stream.

  1. In the teleoperation configuration page, scroll down to Joy (not Joystick) and click the plus (+) icon.
  2. Click Add ROS Topic.
  3. Enter the ROS topic to which you want to post joystick coordinate data.
  4. Click Done.

API

You can also handle joystick input through the Agent SDK.

  1. In the teleoperation configuration page, scroll down to Joystick and click the plus (+) icon.
  2. Click Add from API.
  3. Enter the name of the function which handles joystick input.
  4. Click Done.

Step 3: Configure joystick settings

  1. Click the edit (pencil) icon to configure the settings for your Joy stream.

PropertyUsage
Disable button mapping?If OFF, gamepad buttons will map to buttons on the teleop interface. If ON, gamepad buttons are disabled.
Publish frequencyRate at which messages will be published. Number between 0 - 100 Hz. Default 5 Hz.
  1. Click Done to save your changes.

👋

If you notice an issue with this page or need help, please reach out to us! Use the 'Did this page help you?' buttons below, or get in contact with our Customer Success team via the Intercom messenger in the bottom-right corner of this page, or at [email protected].