2023-Robot

Robot code for 2023 FRC season

Key Features

LED Color Codes

Controller Vibration Feedback

FTP

• ftp://172.22.11.2 -USB only
• ftp://roborio-1756-frc.local -USB, Wifi, or Ethernet
• ftp://10.17.56.2 -Wifi or Ethernet

Commissioning A Robot

When commissioning a new robot, you should set the instance type to either "Competition" or "Practice" by creating a text file using FTP readable by lvuser on the RoboRIO at path /home/lvuser/robotInstance. The content of this file should be just the text Competition or Practice with no whitespace preceding. If no valid instance is found at runtime, competition instance will be used and an error will be generated.

Homing Swerve Drive

1. When homing swerve modules figure out what is the front of the robot. The intake is the front.
2. Rotate each swerve module to where each bevel gear is to the left side of the robot.
3. Use something flat that is the length of the robot and line the swerve wheels up.
4. Power on the robot and connect your computer. You will need one XBox controller. Make sure the controller says its controller 0(driver) in drivers station. Once connected, enable the robot and press your swerve homing buttons. We are using the buttons A, B, and X on the XBox controller. You have to hold the three buttons for 1.5 seconds.
5. Once the homes have been set the homes will be put in a document. You will be able to open up the document.
6. First open file explorer.
7. Once you are in click in the white box at the top where you can type.
8. Use one of the above FTP addresses.
9. Then double click on the home folder.
10. Then double click on the lvuser folder.
11. Then double click on the homes folder.
12. Then you can click on the swerveHomes file to see the homes of the swerve modules.

Wrist Homing

1. Set up your wrist how you would like it homed. We have it where it is horizontal and the wheels are towards the ground.
2. Power on the robot. Once it powered on connect the robot to your computer. You will need one XBox controller. Make sure the controller is controller 1(operator) in drivers station. Enable the robot and hold the buttons X and Y for 1.5 seconds. Once the homes have been set the homes will be put in a document. You will be able to open up the document.
3. First open file explorer.
4. Once you are in click in the white box at the top where you can type.
5. Use one of the above FTP addresses.
6. Then double click on the home folder.
7. Then double click on the lvuser folder.
8. Then double click on the homes folder.
9. Then you can click on the wristHomes file to see the home of the wrist.

Shoulder Homing

1. Set the arm to where it is perfectly horizontal over the front of the robot.
2. Power on the robot. Once it powered on connect the robot to your computer. You will need one XBox controller. Make sure the controller is controller 1(operator) in drivers station. Enable the robot and hold the buttons A and B for 1.5 seconds. Once the homes have been set the homes will be put in a document. You will be able to open up the document.
3. First open file explorer.
4. Once you are in click in the white box at the top where you can type.
5. Use one of the above FTP addresses.
6. Then double click on the home folder.
7. Then double click on the lvuser folder.
8. Then double click on the homes folder.
9. Then you can click on the shoulderHomes file to see the home of the shoulder.

Homing Extension

1. Set arm to be in back n-stop position. Make sure it's ALL the way back!
2. Power on robot. Connect the robot to your computer, no controller is needed for this homing.
3. Open File Explorer
4. Click in the white space in the bar at the top
5. Use one of the above FTP addresses
6. Double click on home folder
7. Double click on lvuser folder
8. Double click on homes folder
9. Delete the extension homes file & restart code WITHOUT moving the arm extension

Vision

See vision readme for information on which pipelines to use and which indices to install these pipelines on.

Playing With Fusion Addressing

Go to http://10.17.56.2:5812 while connected to the robot to update firmware or change addresses.

Project Setup

Pre-Commit

This project uses pre-commit to check code formatting before accepting commits.

First install the prerequisites:

• python3 (with pip) - instructions
  • Python 3.9.x from the Python website works well. Make sure to check the add to path option in the installer.

• pip packages:

  • You may need to add the pip install path to your shell's path if you're using Git Bash. In git bash:
    1. Open (or create) new file ~/.bashrc by running vim ~/.bashrc
    2. Add this to the end: PATH=$PATH:$LOCALAPPDATA/Programs/Python/Python39/Scripts/ (change Python39 to match your python version)
       • Note: The actual path you need to add ($LOCALAPPDATA/Programs/Python/Python39/Scripts/ in the above example) depends on your Python installation. If y ou do the pip install steps first, pip will print the path you need to add.
       • To type in Vim, type i and you should see INSERT at the bottom of the window to indicate you're editing in insert mode
    3. Exit by pressing Esc then type :wq and press Enter
    4. Run source ~/.bashrc to update your session
  • wpiformat - pip install wpiformat
  • clang-format - pip install clang-format
  • pre-commit - pip install pre-commit

  Make sure to run pip install <package> commands in an administrator terminal if installing in windows

Then initialize:

pre-commit install
pre-commit run

The first run may take a moment, but subsequent automatic runs are very fast.

You'll now have the linter run before each commit! For compatibility with Windows, we recommend the pip version of clang-format, but wpi-format will find any installed clang-format binary in the system path.

Robot Startup

To properly start up, the following mechanisms need to be started up in a state such that:

The Oui Oui Placer is pointing upwards towards the sky, against it's n-stop.

The Bash Guards are all the way back, inside the robot to their n-stops.

The Arm assembly needs to be reasonably close to the stow position (not up and out).

Arm Extension Warning: Because of the use of the function ExtensionFromRotation(), the extension has a condition where it can believe it "wraps" around. To home, the extension treats some absolute value as zero degrees [0-360), if the extension is physically held beyond this zero, the absolute encoder might read 359° rather than 0° (or any other value beyond the home) causing the extension to "wrap around" and initialize the motor with completely incorrect soft limits, and current position.

Ex: You home the arm at absolute encoder 5° (which may map to 0 in extension depending on gearing of encoder rotation to extension), the arm is homed at an absolute encoder value of 3° because it was mechanically held past 5° before start. The extension now believes it's at 357° (which may be an extension of 30 in). A huge error!

Controls

Software Checkout

:memo: Note: Wrist should start near 0° orientation (wheels up, bar down).

Pits

• Soft limit tests on extension, bash, shoulder
• Pick up & Place cone, go to High, Medium, Low
• Repeat with cube
• Bash guard deploys
• Field Centric Home
• Robot drives forward / left / back / right
• Robot turns as well

Pits - Extended

• Camera is sending data
• All fuses are in and secure
• No obvious errors in log or events list
• Check CAN devices should have: (23)

Software Versions

We're using the following dependencies:

• CTRE Phoenix 5.30.4
• Playing With Fusion 2023.01.17
• REVLib 2023.1.3
• WPILib 2023.4.2

Special Thanks

• Our sponsors for the 2022 season. Thank you for your continued support
  • Caterpillar
  • Gene Haas Foundation
  • Boeing
  • Limestone Community High School
  • J. H. Benedict Co
  • LCHS Booster Club
  • Playing With Fusion
  • Wadi Powder Coating
  • Caterpillar employees & The Caterpillar Foundation
• Doxygen Awesome - for making our documentation look great

License

This software is licensed under the BSD 3-clause license. If you would like to use this software under the terms of a different license agreement, please contact us.