Configuration

Tuning Webpage

YAGSL maintains a somewhat complete configuration tool to aid you in creating configuration files from scratch here.

https://broncbotz3481.github.io/YAGSL-Example/broncbotz3481.github.io

IF you are using an Absolute Encoder which is attached to your SparkMAX then the angle conversion factor is 360.

From this webpage you should be able to download all files and place them into your deploy directory to use for new SwerveParser(new File(Filesystem.getDeployDirectory(),"swerve").createSwerveDrive(Units.feetToMeters(4.5)); .

We also maintain a repository for known working configurations here!

GitHub - BroncBotz3481/YAGSL-Configs: Known working YAGSL Configs for COTS swerve modules.GitHub

Make sure you know what module is what!

If not your modules could end up like this!.

Modules flipped around, spinning CCW+

This happens when you input module locations incorrectly due to where the gyroscope is oriented on the robot or you have the wrong CANID's in the wrong relative location of the robot. If this happens to you, you HAVE misconfigured your modules.

Challenge

Here is a challenge for you, how can you solve this misconfiguration?

Solution

Steps:

1. Invert 4 and 2.

2. Swap 1 and 4.

This may help you in your endeavors!

42KB

SwerveDiagram.docx

Open

Orient your swerve modules correctly!

To correctly get the absoluteEncoderOffset your swerve modules must be facing this way while reading the values.

Configuration Directory

JSON Files

JSON stands for "JavaScript Object Notation" it is a popular format for configuration, and string data representation. Learn more here

What does the swerve directory need to look like?

The swerve directory for generating a swerve drive must look like this. Assuming you have defined your swerve modules as "modules": [ "frontleft.json", "frontright.json", "backleft.json", "backright.json"] in swervedrive.json.

└── swerve
    ├── controllerproperties.json
    ├── modules
    │   ├── backleft.json
    │   ├── backright.json
    │   ├── frontleft.json
    │   ├── frontright.json
    │   ├── physicalproperties.json
    │   └── pidfproperties.json
    └── swervedrive.json

The modules folder, controllerproperties.json, physicalproperties.json, pidfproperties.json, and swervedrive.json files are necessary to build the swerve drive. Each one has specific fields which correspond to an attribute of the swerve drive, some physical and some abstract.

Migrating Old Configuration Files

1. Delete wheelDiamter, gearRatio, encoderPulsePerRotation from physicalproperties.json

2. Add optimalVoltage to physicalproperties.json

3. Delete maxSpeed and optimalVoltage from swervedrive.json

4. IF a swerve module doesn't have the same drive motor or steering motor as the rest of the swerve drive you MUST specify a conversionFactor for BOTH the drive and steering motor in the modules configuration JSON file. IF one of the motors is the same as the rest of the swerve drive and you want to use that conversionFactor, set the conversionFactor in the module JSON configuration to 0.

5. You MUST specify the maximum speed when creating a SwerveDrive through new SwerveParser(directory).createSwerveDrive(maximumSpeed);

6. IF you do not want to set conversionFactor in swervedrive.json. You can pass it into the constructor as a parameter like this

double DriveConversionFactor = SwerveMath.calculateMetersPerRotation(Units.inchesToMeters(WHEEL_DIAMETER), GEAR_RATIO, ENCODER_RESOLUTION);
double SteeringConversionFactor = SwerveMath.calculateDegreesPerSteeringRotation(GEAR_RATIO, ENCODER_RESOLUTION);
new SwerveParser(directory).createSwerveDrive(maximumSpeed, SteeringConversionFactor, DriveConversionFactor);