Work in progress. This library and its docs are new and still changing, and some parts are not yet tested on a real robot. Something wrong or unclear?Tell us with a short GitHub form.

SIM-01: Drive a kit bot in the simulator

high prioritySimulator only (no robot needed)about 30 minSimulator

Your robot needs: any robot.
Starter bots that fit: goBILDA starter bot, REV DUO starter bot, AndyMark Robits starter bot, Studica starter bot.
Library version: v0.16.0 or newer.
The docs it tests: The simulator: a pretend Control Hub and Driver Hub, The four BIOBUZZ starter bots as test robots.

Why

The simulator is how most teams will try the library first. It must start on Windows, Mac, Linux and Chromebooks, with the laptop setup as written. This is the best first test for any team.

Setup

A laptop with Android Studio (it brings Java). The library folder (in your robot project, or cloned on its own).
The laptop setup done once.

Steps

In a terminal in the ftc-helper-lib folder, run ./gradlew :sim:run -Probot=sim/robots/starter-bot-gobilda.properties (or the REV, AndyMark or Studica file). Windows: gradlew.bat.
Open http://localhost:8780.
Choose the kit bot's TeleOp (for example "goBILDA Bot TeleOp"), INIT, START.
Set gamepad 1 to "Keyboard". Drive with W A S D and the arrows for a minute.
Try a real controller if you have one (choose it in the list, press a button once).
Run the intake and (goBILDA) spin up with LB and fire with RB.

Pass rule

The page opens within 5 minutes of the first command (after the first download), the robot drives with the keyboard, and nothing shows an error in red.

Record

Write these down while you test. The report form has them as a list to fill in.

computer and operating system, browser
which kit bot
how long the first ./gradlew took (minutes)
any step in the laptop setup that did not work as written, and what fixed it
controller tried (and whether it worked)

If your robot is different

This test uses a kit bot file, so your robot does not matter. If you build one of the kit bots, say whether the simulator's robot behaves like yours (speed, size, which button does what).

Report your result

Pass, fail, or could not run: every result helps. The form opens on GitHub with this test filled in (a free GitHub account is needed). No student names, please.

Report result

No reports for this test yet: yours would be the first. Every test's reports.

All tests · Next: SOM-01 Shooting on the move - standing still nothing changes

Something wrong on this page? Tell us with a short GitHub form.