WestlakeLEARN
FTC / Java

First Tech Challenge

FTC / Java

01 · Java for FTC
  • OpMode Anatomy and Hello Robot
  • Variables, Math, and Decisions
  • Methods, Classes, and Robot Helpers
02 · FTC Hardware Essentials
  • Hardware Map and RobotHardware
  • Motors, Servos, and Sensors
  • IMU, Encoders, and Bulk Caching
03 · TeleOp and Mecanum
  • Robot-Centric Mecanum Drive
  • Field-Centric Driving
  • Driver Ergonomics and Safe TeleOp
04 · Subsystems and Commands
  • Subsystem Lifecycle
  • Enums and Finite State Machines
  • Command-Based OpModes
05 · From Timed Steps to Actions
  • Timed and Encoder Autonomous
  • Autonomous State Machines
  • Actions and Sequencing
06 · PID and Feedforward
  • PID Basics
  • Feedforward and PIDF
  • Dashboard Tuning Workflow
07 · Motion Profiling
  • Motion Profile Concepts
  • Implementing a Profiled Mechanism
  • Testing Profiles and Failure Modes
08 · OpenCV and AprilTags
  • VisionPortal Camera Setup
  • OpenCV Color and Region Processors
  • AprilTags and Field Pose
09 · Setup and Tuning
  • Road Runner 1.0 Install and Drive Class
  • Feedforward Tuning
  • Localization and Validation
10 · Trajectories, Actions, and MeepMeep
  • Action Builder and Trajectories
  • MeepMeep Preview
  • Full Road Runner Autonomous
11 · Git, Debugging, and Competition Readiness
  • Git Workflow for FTC Teams
  • Telemetry-First Debugging
  • Competition Readiness Checklist
12 · Driver Control
  • Driver Control
13 · Autonomous Build
  • Simple Autonomous
14 · Debugging1/1
  • Debugging with Telemetry

14 / Debugging

Debugging with Telemetry

Use telemetry to find what the robot thinks is true.

35 minWalkthroughDebugging

You will

  1. 01Print sensor and state values clearly.
  2. 02Separate driver mistakes from code mistakes.
  3. 03Make a short pre-match debug checklist.

Why Debugging with Telemetry matters

This lesson is part of the team workflow layer, where code quality becomes a competition habit. The point is to make programming choices visible, reviewable, and recoverable when students are tired or under event pressure.

Starting point

Telemetry is the robot talking back

Good telemetry turns mystery behavior into visible data. Show joystick input, current state, motor power, and any sensor value that affects decisions.

Debug the smallest claim first

Before rewriting logic, check whether the robot sees the same input you think it sees. Most fixes start with one boring value on screen.

Build path

Practice the workflow in small loops: make a change, describe it, test it, record the result, and decide whether it is safe to keep. The lesson should produce a team artifact such as a checklist, branch, commit, tuning note, or debug log.

For this specific lesson, students should first restate the goal in robot terms, then identify the value or behavior they expect to observe, then run the smallest test that proves the idea. The lesson should feel like a guided lab: predict, run, observe, explain, and only then extend.

TelemetryDebug.java · Java

telemetry.addData("Drive", drive);
telemetry.addData("Strafe", strafe);
telemetry.addData("Turn", turn);
telemetry.addData("Lift target", liftTargetTicks);
telemetry.addData("Lift position", liftMotor.getCurrentPosition());
telemetry.update();

Debugging and failure modes

Workflow breaks when knowledge lives only in one student's head. If nobody knows what changed, what was tested, or what code is deployed, the robot becomes fragile. The lesson should make the next action obvious to another teammate.

Practice

Add telemetry for drivetrain inputs and one mechanism state, then test it with the robot disabled and enabled.

Checks

  • Telemetry labels are readable in a hurry.
  • The value changes when the input changes.
  • The driver can explain what the value means.

Check your understanding

Module check

What should you check first when robot code does not behave as expected?

0 of 1 answered

References

FIRST FTC DocsOfficial FTC SDK and robot programming documentation.Learn Road RunnerFTC autonomous and trajectory reference.

Finished reading?

Mark this lesson complete.

Simple Autonomous