Lesson 3.1: Using Strings to Match Hardware Names Exactly

---

Technical Context

The Control Hub utilizes a registry to link Java objects to physical I/O ports. Using String variables to store configuration names prevents "Device Not Found" errors caused by typos or case-sensitivity mismatches during the hardwareMap.get() call.

---

Why Strings Matter for Hardware Names

In Java, a String is an object used to hold a sequence of characters. While primitive types like int or double start with lowercase letters, String is capitalized because it is a class within the Java library. When you initialize hardware, the SDK requires a string parameter that must match the name defined in the robot's configuration file exactly. Storing these names in variables at the top of your class ensures that if a hardware port name changes, you only need to update it in one location rather than searching through hundreds of lines of code.

---

Annotated Code

package org.firstinspires.ftc.teamcode;

import com.qualcomm.robotcore.eventloop.opmode.OpMode;
import com.qualcomm.robotcore.eventloop.opmode.TeleOp;
import com.qualcomm.robotcore.hardware.DcMotor;

@TeleOp(name="String_Mapping")
public class StringMapping extends OpMode {

    // Declaring a String variable to hold the hardware configuration name
    // By convention, hardware names are often stored as String literals
    String motorName = "drive_motor";
    DcMotor frontMotor;

    @Override
    public void init() {
        // Passing the String variable into the hardwareMap.get method
        frontMotor = hardwareMap.get(DcMotor.class, motorName);
        telemetry.addData("Status", "Mapped: " + motorName);
    }

    @Override
    public void loop() {}
}

---

Fill-in-the-Blank Practice

1. A group of characters used to store text, such as a hardware name, is known as a/an __________.
2. Because it is defined as a class rather than a primitive, the name of this datatype must begin with a/an __________ letter.
3. Java is __________, meaning the String "Motor" is considered a different value than "motor".

Show answers

1. String
2. uppercase (capital) letter: by Java convention all class names use PascalCase
3. case-sensitive

---

Simulator Challenge

Robot Scenario: Your team has named a Servo "claw_servo" in the configuration app. Create a String variable to store this name and use it to map the hardware.

1.Complete the codeWork in fullscreen when you need more room for the editor and visualizer.

2.Run the lifecyclePress Init, then Start. Use the available gamepad or scene controls.

3.Debug the behaviorCheck telemetry, motion, requirements, and hints before opening the answer.

Telemark Unit 3 Simulator

Tracks `String`, `double`, `boolean`, and `int` variables as you edit.

Supports telemetry, `gamepad1`, simple `if` blocks, and basic `setPower()` math.

Does not simulate full hardware behavior or complex Java control flow.

Show answer

String configName = "claw_servo";

@Override
public void init() {
    claw = hardwareMap.get(Servo.class, configName);
    telemetry.addData("Status", "Claw Map Successful");
}

Ready to move on?

Sign in with Google to save your progress with Telemark, or continue without saving.

Stuck on this lesson?

Ask about anything on this page. It can see which lesson you have open and which part you are reading.