What is a DigitalChannel? — Sharp AI

Skip to content

What is a DigitalChannel?

A DigitalChannel is an SDK class used to represent a binary, digital device, such as a touch sensor or limit switch, connected to a digital port on the robot. According to the Telemark Unit 7 Mastery Quiz, it must be looked up in the hardware map using DigitalChannel.class rather than an analog class. The Telemark Annotated Code demonstrates that programmers must configure the channel's mode to input using setMode(DigitalChannel.Mode.INPUT) during initialization.

This class reads the binary state of the connected sensor using the getState() method. As explained in the Telemark guide on keeping linear slides safe, some hardware like the REV Touch Sensor operates on active-low logic, meaning getState() returns false when pressed and true when released, which typically requires inverting the boolean value in software for natural readability.

In robot applications, a DigitalChannel is commonly used to build software limiters that protect mechanical components. The Telemark Overview notes that by checking the sensor's state, the robot's control loop can automatically block motor power in a specific direction when a physical limit is reached, preventing structural damage and high-current motor stalls.

Was this right?

Sources16

1

Overview

Telemark·Team owned

Lesson 8.5: Challenge: Build a Two-Way Linear Slide with Software Limits

---

Linear slides are prone to mechanical failure if driven past their physical limits, either bottoming out at the base or over-extending at the top. Using a DigitalChannel touch sensor as a software limiter prevents the motor from applying power in a direction that would cause hardware damage, protecting the motor from stall current and the mechanism from structural failure.

---

2

Simulator Challenge

Telemark·Team owned

Use the simulator below to practice protecting a lift with an active-low bottom limit switch and lesson-specific starter code.

3

Annotated Code

Telemark·Team owned

package org.firstinspires.ftc.teamcode;

@TeleOp(name="Safe_Slide_Demo")
public class SafeSlideDemo extends OpMode {

    private DcMotor liftMotor;
    private DigitalChannel limitSwitch;

    @Override
    public void init() {
        liftMotor   = hardwareMap.get(DcMotor.class, "lift_motor");
        limitSwitch = hardwareMap.get(DigitalChannel.class, "limit_bottom");

        limitSwitch.setMode(DigitalChannel.Mode.INPUT);
        liftMotor.setZeroPowerBehavior(DcMotor.ZeroPowerBehavior.BRAKE);
    }

    @Override
    public void loop() {
        double power = -gamepad1.left_stick_y;

        // Active-low: false = pressed, so invert for intuitive logic
        boolean isAtBottom = !limitSwitch.getState();

        // Block downward movement if the bottom limit is triggered
        if (isAtBottom && power < 0) {
            power = 0.0;
            telemetry.addData("Safety", "BOTTOM LIMIT REACHED");
        }

        liftMotor.setPower(power);
        telemetry.addData("Slide Power",   power);
        telemetry.addData("At Bottom",     isAtBottom);
        telemetry.update();
    }
}

---

4

How to Keep a Linear Slide Safe in Both Directions

Telemark·Team owned

This challenge requires combining concepts from Units 7 and 8. You must:

Map both a DcMotor and a DigitalChannel in init()
Read the touch sensor state each loop cycle
Apply conditional logic that overrides driver input when the sensor is triggered

A critical hardware nuance: the REV Touch Sensor uses active-low logic. getState() returns true when the sensor is not pressed and false when it is pressed. This means you must use the logical NOT operator (!) to invert the signal for intuitive use: boolean isPressed = !limitSwitch.getState().

The limiter logic then becomes: if the driver is commanding the slide downward (negative power) AND the bottom limit is pressed, override the power to 0.0. Movement upward is still permitted because the limiter only blocks the dangerous direction.

---

5

Fill-in-the-Blank Practice

Telemark·Team owned

A software limiter uses __________ operators and sensor data to prevent mechanical binding at the physical end of travel.
If a touch sensor returns false when physically pressed (active-low logic), you must use the __________ operator in Java to flip the signal for intuitive use.
Preventing a motor from stalling against a physical limit improves robot __________ by avoiding the sustained high-current draw that burns out motor windings.

Show answers

conditional (comparison / logical)
! (the logical NOT operator)
reliability (longevity / lifespan)

---

6

Simulator Challenge

Telemark·Team owned

Use the simulator below to complete the precise autonomous slider routine. Fill in the missing reset, target, run mode, power, busy-loop telemetry, and stop logic, then press START to move the game element.

7

Overview

Telemark·Team owned

Lesson 11.1: Reading Touch Sensor Binary States via DigitalChannel

---

A motor that does not know where it is will keep driving until something stops it physically. For a linear slide or a rotating arm, that physical stop is the robot's own frame, and the moment the mechanism hits it, the motor is stalling against a hard wall. Stall current is the highest current a motor can draw, and sustained stall causes heat buildup, gear damage, and can trip the protection circuitry on the Control Hub port. A touch sensor mounted at the mechanism's physical limit solves this problem before it becomes a hardware failure.

The principle is simple: the robot checks the sensor before applying power in a dangerous direction. If the sensor says the mechanism has reached its limit, the code blocks movement in that direction even if the driver is still holding the joystick.

---

8

Annotated Code

Telemark·Team owned

package org.firstinspires.ftc.teamcode;

@TeleOp(name="Touch_Sensor_Demo")
public class TouchSensorDemo extends LinearOpMode {

    @Override
    public void runOpMode() {
        DcMotor        liftMotor    = hardwareMap.get(DcMotor.class,     "lift_motor");
        DigitalChannel limitSwitch  = hardwareMap.get(DigitalChannel.class, "limit_bottom");

        // Required: configure the pin direction before the match starts
        limitSwitch.setMode(DigitalChannel.Mode.INPUT);
        liftMotor.setZeroPowerBehavior(DcMotor.ZeroPowerBehavior.BRAKE);

        waitForStart();

        while (opModeIsActive()) {
            double power = -gamepad1.left_stick_y;

            // Active-low: getState() is false when pressed, so ! gives us
            // a true "is pressed" boolean that reads naturally in code
            boolean isAtBottom = !limitSwitch.getState();

            // Block downward movement if the bottom limit has been reached
            if (isAtBottom && power < 0) {
                power = 0.0;
                telemetry.addData("Safety", "BOTTOM LIMIT REACHED");
            }

            liftMotor.setPower(power);
            telemetry.addData("At Bottom", isAtBottom);
            telemetry.addData("Power",     power);
            telemetry.update();
        }
    }
}

---

9

Simulator Challenge

Telemark·Team owned

Robot Scenario: Combine everything. Create an OpMode where the A button acts as a "Turbo Switch." If A is pressed, use the raw joystick values. If A is NOT pressed, use squared joystick values for precision.

Show answer

@Override
public void loop() {
    double rawY = -gamepad1.left_stick_y;
    double finalPower;

    if (gamepad1.a) {
        finalPower = rawY;
    } else {
        finalPower = rawY * rawY * Math.signum(rawY);
    }

    telemetry.addData("Drive Power", finalPower);
}

10

II. Debug the Code

Telemark·Team owned

The following code is attempting to map a drivetrain motor named "left_drive" and a touch sensor named "lift_limit". Identify and fix the 2 errors.

package org.firstinspires.ftc.teamcode;

@TeleOp(name="Mapping_Challenge")
public class MappingChallenge extends LinearOpMode {

    private DcMotor       drive;
    private DigitalChannel limit;

    @Override
    public void runOpMode() {
        drive = hardwareMap.get(DcMotor.class, "left_drive")
        limit = hardwareMap.get(AnalogInput.class, "lift_limit");
        limit.setMode(DigitalChannel.Mode.INPUT);

        waitForStart();

        while (opModeIsActive()) {
            drive.setPower(-gamepad1.left_stick_y);
            if (!limit.getState()) {
                drive.setPower(0);
            }
        }
    }
}

Show answers

Error 1: Syntax Error: The hardwareMap.get() call for drive on the first mapping line is missing a semicolon (;) at the end of the statement. Java requires every statement to be terminated with a semicolon.

drive = hardwareMap.get(DcMotor.class, "left_drive"); // ← semicolon added

Error 2: Logic Error: The limit variable is declared as a DigitalChannel, but it is being instantiated using AnalogInput.class in the get() call. A touch sensor is a binary (digital) device connected to a digital port: it must be looked up with DigitalChannel.class. Using AnalogInput.class would either crash at runtime or return an incompatible object, making limit.getState() inaccessible.

limit = hardwareMap.get(DigitalChannel.class, "lift_limit"); // ← correct class
limit.setMode(DigitalChannel.Mode.INPUT);

---

11

Overview

Telemark·Team owned

Lesson 8.2: Sizing Linear Slides, Spools, and Extension Speed

---

Linear slides give reach far beyond the robot's frame, which is why almost every high scoring FTC robot has them. They also stack tolerances, accumulate friction, and multiply forces in ways that catch teams out.

---

12

Simulator Challenge

Telemark·Team owned

Robot Scenario: Create a "Precision Mode." If the driver holds the left bumper, the motor power should be exactly half of the joystick input. Use variables for input, scaleFactor, and finalPower.

Show answer

@Override
public void loop() {
    double input = -gamepad1.left_stick_y;

    double finalPower;

    if (gamepad1.left_bumper) {
        finalPower = input * scaleFactor;
    } else {
        finalPower = input;
    }

    motor.setPower(finalPower);
}

13

Fill-in-the-Blank Practice

Telemark·Team owned

A cascading slide with three moving stages extends three times as fast and lifts __________ as hard as a continuous rigging with the same spool.
As string wraps onto a spool, the effective spool diameter __________, so the slide speeds up and weakens as it extends.
A slide should be extended by hand with the string disconnected to check for __________ across the full travel.

Show answers

one third
grows (increases)
bind (friction, stiffness)

---

14

Simulator Challenge

Telemark·Team owned

Use the simulator below to practice wiring a reusable mechanism class into a TeleOp and keeping the mapping logic in one place.

15

Simulator Challenge

Telemark·Team owned

Use the simulator below to practice mapping digital and analog sensors with the correct SDK classes and setup steps.

16

Try It

Telemark·Team owned

---

Slide friction is a function of build quality more than of design, and it is usually the difference between a slide that works and one that does not.

Sources:

Non-parallel rails. Rails that converge or diverge along their length bind at one end of travel.
Twist. Rails that are square at the base and rotated at the tip load the bearings sideways.
Overtightened rollers. Preload that removes all play also adds substantial drag.
String angle. String that pulls at an angle rather than straight along the travel puts a side load on every stage.
Debris. Field tile dust in the bearing track.

The diagnostic: extend the slide by hand with the string disconnected. It should move smoothly under light finger pressure across the full travel. Anywhere it gets stiff is a bind, and fixing it recovers motor output you would otherwise buy with a larger motor.

Testing an unloaded slide on a bench is not the same as testing it loaded and cantilevered, where the deflection is largest. Test at the extreme of travel with the real load on it.

---