Configuring a Project

To use the toolsuite, we first need to configure the settings for your specific mechanism.

Configure Project Parameters

In order to run on your robot, the tool must know some parameters about how your robot is set up.

First, you need to use the Analysis Type field to select the appropriate project config. General Mechanism is for non-drivetrain mechanisms (e.g. Simple Motor, Arm, Elevator), Drivetrain is for Drivetrain mechanisms, and Romi is for the Romi robots. This allows you to fill out the parameters specific to the type of system you are using.

Selecting the appropriate analysis type.

The rest of the Generator widget is focused on the proper settings based off of the analysis type:

Motor Controller Selection

The Motor / Motor Controller Selection allows you to add ports for each motor controller that will be used. The + and - buttons let you add and remove ports respectively.

Note

If you are plugging in your encoders into motor controllers make sure that the motor controller type and port(s) are the first ones you specify.

Motor selection section.

Each motor port contains the following parts:

  • Motor Port is where you add the port number for a specific controller

  • Inverted should be checked if the motorcontroller should be inverted

  • Motor Controller is the type of motor controller that will be used.

Encoder Selection

The Encoder Selection allows you to configure the encoders that will be used. The types of encoder you can use will vary with the first motor controller type specified (see note above).

Encoder selection section.

Encoder Types

  • General Types (consistent across all motor controller selections): roboRIO corresponds to any encoders that are plugged into the roboRIO, CANCoder corresponds to the CTRE CANCoder.

  • TalonSRX: Built-in corresponds to any quadrature encoder plugged into the encoder port, Tachometer corresponds to the CTRE Tachometer plugged into the encoder port.

  • TalonFX: Built-in corresponds to the integrated encoder on the TalonFX motor.

  • Spark MAX: Encoder Port refers to an encoder plugged into the encoder port, Data Port refers to an encoder plugged into the data port.

  • Venom: Built-in refers to an encoder plugged into the Venom’s encoder port.

Encoder Settings

Here are the following settings that can be configured (although the settings that are visible will vary by the previously selected encoder type):

  • Ports (either A and B or CANCoder Port

  • Encoder Inverted should be checked if a positive motor power doesn’t correspond to a positive increase in encoder values

  • Samples Per Average is how many samples will be averaged per velocity measurement. A value greater than one can help reduce encoder noise and 5-10 is recommended for encoders with high CPR. Only mess with this setting if a previous run of SysId resulted in extremely noisy data.

  • Reduce Encoding should be checked if using high resolution encoders (e.g. CTRE Mag Encoders or REV Through Bore Encoder) that are plugged into the roboRIO. This uses the Encoder class 1x decoding to reduce velocity noise. If this is checked, you will have to update your team’s robot code to also use 1x decoding on the encoders.

  • Time Measurement Window is the period of time in milliseconds that the velocity measurement will be taken across. This setting can reduce measurement lag at the cost of possibly introducing more noise. Only modify this if data lag is impeding accurate control and data collection.

Encoder Parameters

Counts Per Revolution is the encoder counts per revolution for your encoder which is generally specified on a datasheet. Common values include:

  • CTRE Magnetic Encoder: 4096

  • Falcon 500 Integrated: 2048

  • REV Throughbore: 8192

  • NEO (and NEO 550) Integrated Encoders (REV already handles this value): 1

Gearing is the gearing between the encoder and output shaft. For example, an magnetic encoder on a kit chassis would have a gearing of one as it is on a 1:1 ratio with the output shaft. However, if is was an integrated encoder in a motor that was in the gearbox, the gearing would be 10.71 (per Andymark) since there is now gearing between the encoder and the output shaft.

Encoder parameters section.

Gyro Parameters (Drivetrain Only)

Gyro lets you select the type of supported gyro. Gyro Parameter lets you configure additional settings needed to configure the previously specified gyro.

Gyro configuration section.

Loading and Saving Configurations

Once your robot configuration is set, you may save it to a location/name of your choice with the Save button:

Saving the configuration file

Accordingly, you can also load an existing config file with the Load Config button:

Loading a saved configuration file

Deploying Project

Once your project has been configured, it’s time to deploy the robot project to run the identification routine.

Deploying the config file

Team/IP is where you set your team number or IP. You can then deploy the code with the Deploy label.