Skip to content

Comments

De-emphasizing phones#294

Merged
texasdiaz merged 48 commits intoFIRST-Tech-Challenge:mainfrom
miriamsr:android
Feb 3, 2025
Merged

De-emphasizing phones#294
texasdiaz merged 48 commits intoFIRST-Tech-Challenge:mainfrom
miriamsr:android

Conversation

@miriamsr
Copy link
Member

@miriamsr miriamsr commented Aug 2, 2024

Resolves FIRST-Tech-Challenge/ftcdocs-private#106

@emcclurg
Copy link
Contributor

emcclurg commented Aug 2, 2024

This looks good to me. T

@uvidyadharan uvidyadharan marked this pull request as draft August 2, 2024 17:26
@emcclurg emcclurg marked this pull request as ready for review August 16, 2024 14:20
@emcclurg
Copy link
Contributor

@miriamsr will you be able to finish this by next week?

@miriamsr
Copy link
Member Author

@emcclurg Yes, I will get back to work on this, end of next week should be doable.

robot. It does all of the thinking for the robot and tells the robot what
to do. It consists of an Android device running a Robot Controller app. Many
Teams will also connect a REV Robotics Expansion Hub for additional ports to
connect motors, servos, and sensors to the ROBOT.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think generally ftc-docs does not use the Oxford comma.


A second Android device sits with the team drivers and has one or two
gamepads connected. This second device is known as the DRIVER STATION.
The DRIVER STATION is sort of like a remote control that you might use
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest omitting "sort of", for more consistent language/tone of ftc-docs.

The REV Robotics Control Hub is an integrated version of the Robot Controller.
It combines an Android device built into the same case as a REV Robotics
Expansion Hub.
While not reccomended, teams may opt to use an Android smartphone as either their
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"recommended" is misspelled, but anyway I suggest omitting that opening phrase. The actual status of smartphones is that they are optional, covered by "Teams may opt to...". Some teams have a legitimate need or preference for smartphones.

It combines an Android device built into the same case as a REV Robotics
Expansion Hub.
While not reccomended, teams may opt to use an Android smartphone as either their
DRIVER STATION or ROBOT CONTROLLER. DRIVER STATION phones should have the FTC Driver
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest changing "either...or" to just "or". As an alternate, add ", or both" after ROBOT CONTROLLER.

@@ -109,14 +107,14 @@ floor and then score a game element (such as a ball) into a goal
autonomously during a match. Teams write “op modes” (which stand for
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"OpModes"

*Op modes* are computer programs that are used to customize the behavior
*OpModes* are computer programs that are used to customize the behavior
of a competition robot. The Robot Controller can *execute* a selected op
mode to perform certain tasks during a match.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpMode

of programming tools that they can use to create their own op modes.
of programming tools that they can use to create their own OpModes.
Teams can use a visual (“drag and drop”) programming tool called the
*Blocks Programming Tool* to create their op modes. Teams can also
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OpModes

Controller via the OTG adapter and USB cable. The Robot Controller will
automatically label this device as an Expansion Hub “Portal”. The Robot
Controller will talk through this portal to the individual Expansion
Controller will controller through this portal to the individual Expansion
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

change "controller" to "communicate"

Let's modify your op mode to control the DC motor that you connected and
configured for your REV Expansion Hub. Modify the code for the program
Let's modify your OpMode to control the DC motor that you connected and
configured for your REV Control Hub or REV Expansion Hub. Modify the code for the program
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add Robotics?

|

Congratulations! You ran your first java op mode!
Congratulations! You ran your first java OpMode!
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Java?

Your op mode takes input from a gamepad and uses this input to control a
DC motor. To run your op mode, you will need to connect a Logitech F310
Your OpMode takes input from a gamepad and uses this input to control a
DC motor. To run your OpMode, you will need to connect a Logitech F310
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

F310 or other approved gamepad

Your example op mode is looking for input from the gamepad designated as
Your example OpMode is looking for input from the gamepad designated as
the user or driver #1. Press the Start button and the A button
simultaneously on the Logictech F310 controller to designate your
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Logitech is misspelled. Also, could consider mentioning the alternate button names on PS2-style gamepads.


If your op mode requires input from a gamepad, then you will need to
If your OpMode requires input from a gamepad, then you will need to
connect a Logitech F310 gamepad to the DRIVER STATION. Note that you can
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

...or other approved...

2. For the examples in this wiki, the op modes are looking for input
2. For the examples in this wiki, the OpModes are looking for input
from the gamepad designated as the user or driver #1. Press the Start
button and the A button simultaneously on the Logitech F310
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

consider mentioning PS2-style button names?

|

Note that the word "TeleOp" is short for "Tele-Operated" and it implies a driver controlled op mode (i.e., an op mode that gets input from a human driver).
Note that the word "TeleOp" is short for "Tele-Operated" and it implies a driver controlled OpMode (i.e., an OpMode that gets input from a human driver).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can omit the comma after i.e.

@texasdiaz texasdiaz merged commit 7ffe7a4 into FIRST-Tech-Challenge:main Feb 3, 2025
6 of 7 checks passed
@miriamsr miriamsr deleted the android branch October 23, 2025 18:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants