Troubleshooting Common FTC Programming Issues

Introduction

Even experienced programmers run into common issues when working with FTC robots. This lesson will help you quickly identify and fix the most frequent problems in OnBot Java.

Hardware Mapping Errors

One of the most common issues is a mismatch between your hardware configuration and your code. If you misspell a device name or forget to add a device in the configuration, your code will throw an error. Always double-check that your hardwareMap.get() calls match the names in your configuration.

Example: Hardware Mapping Error

leftMotor = hardwareMap.get(DcMotor.class, "LEFT_DRIVE");

OpMode Lifecycle Mistakes

Understanding when your code runs is crucial. Initialization code should go before waitForStart(), and your main loop should be inside while (opModeIsActive()). Placing code in the wrong place can cause unexpected behavior.

Correct OpMode Structure

@TeleOp
public class LifecycleExample extends LinearOpMode {
    private DcMotor leftMotor;
    @Override
    public void runOpMode() {
        leftMotor = hardwareMap.get(DcMotor.class, "left_drive");
        waitForStart();
        while (opModeIsActive()) {
            leftMotor.setPower(0.5);
        }
    }
}

Sensor and Motor Initialization Problems

If you try to use a sensor or motor before it's initialized, you'll get errors or unexpected results. Always initialize all hardware before waitForStart().

Initialization Example

// Correct
leftMotor = hardwareMap.get(DcMotor.class, "left_drive");
// Incorrect (will cause errors)
leftMotor.setPower(1.0); // leftMotor not initialized yet

Quick Troubleshooting Checklist

Check that all device names in your code match your configuration.
Initialize all hardware before waitForStart().
Put your main robot logic inside while (opModeIsActive()).
Use telemetry to display variable values and program state.
Read error messages carefully and look up unfamiliar terms.

Practice: Find and Fix Common Issues

Below is an OpMode with multiple errors. Your task is to identify all the problems and fix them. Here are the devices configured in your robot:

Identify all errors in the provided OpMode code.
Explain what each error is and why it occurs.
Provide a corrected version of the OpMode.

// Configured Devices:
// - left_drive (DcMotor)
// - right_drive (DcMotor)
// - claw_servo (Servo)
// - color_sensor (ColorSensor)
// - distance_sensor (DistanceSensor)

// Find all the errors in this OpMode:
@TeleOp
public class BuggyOpMode extends LinearOpMode {
    private DcMotor leftMotor, rightMotor;
    private Servo clawServo;
    private ColorSensor colorSensor;
    private DistanceSensor distanceSensor;
    
    @Override
    public void runOpMode() {
        // Initialize hardware
        leftMotor = hardwareMap.get(DcMotor.class, "LEFT_DRIVE");
        rightMotor = hardwareMap.get(DcMotor.class, "right_drive");
        clawServo = hardwareMap.get(Servo.class, "claw_servo");
        colorSensor = hardwareMap.get(ColorSensor.class, "color_sensor");
        distanceSensor = hardwareMap.get(DistanceSensor.class, "distance_sensor");
        
        // Set motor power before initialization
        leftMotor.setPower(0.5);
        
        telemetry.addData("Status", "Initialized");
        telemetry.update();
        
        waitForStart();
        
        // Main loop
        while (opModeIsActive()) {
            // Drive logic
            double leftPower = -gamepad1.left_stick_y;
            double rightPower = -gamepad1.right_stick_y;
            leftMotor.setPower(leftPower);
            rightMotor.setPower(rightPower);
            
            // Claw control
            if (gamepad1.a) {
                clawServo.setPosition(1.0);
            } else if (gamepad1.b) {
                clawServo.setPosition(0.0);
            }
            
            // Sensor reading
            if (colorSensor.red() > 100) {
                telemetry.addData("Color Detected", "Red");
            }
            
            if (distanceSensor.getDistance(DistanceUnit.CM) < 10) {
                telemetry.addData("Distance", "Object close");
            }
            
            telemetry.addData("Left Power", leftPower);
            telemetry.addData("Right Power", rightPower);
            telemetry.addData("Claw Position", clawServo.getPosition());
            telemetry.update();
        }
        
        // Code after the loop (will never execute)
        leftMotor.setPower(0);
        rightMotor.setPower(0);
    }
}