Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Drivers Hub to Driver Station page #391

Merged
merged 16 commits into from
Oct 16, 2023
Merged
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
343031a
updated drivers station page
Eeshwar-Krishnan Sep 12, 2023
082fe60
spelling errors
Eeshwar-Krishnan Sep 12, 2023
dc28292
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
0fb4fdb
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
b11a0d6
Update driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
b27d982
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
df61f65
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
ad0e2b3
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 12, 2023
eb050be
fix random file changed
Eeshwar-Krishnan Oct 12, 2023
e4cef48
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
15d397b
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
957474e
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
ce73b52
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
65dc057
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
93c5ce9
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
af53d51
Update source/docs/power-and-electronics/driver-station-guide.rst
Eeshwar-Krishnan Oct 15, 2023
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 43 additions & 4 deletions source/docs/power-and-electronics/driver-station-guide.rst
Original file line number Diff line number Diff line change
@@ -1,13 +1,52 @@
Driver Station Guide
====================

From many years of collective experience, the writers have accumulated some general recommendations and best practices for driver stations to reduce the risk of disconnects.
The Driver Station (DS) is the way drivers interact with the robot. Through it, you configure settings, configure hardware, start and stop OpModes, use gamepads, and receive telemetry data from the robot. There are two main different choices for a Driver Station: the REV Robotics Driver Hub and an Android phone.

- A 5GHz phone is preferred over the standard 2.4GHz phone to reduce ping issues. Have you ever noticed that your team's robot seems to lag at competitions only?
REV Driver Hub
--------------

Most teams run on 2.4GHz, which means that the 2.4GHz channels will be more crowded on competition day. This can lead to noticeably higher ping/lag which adversely affects driver and robot performance.
The REV Robotics Driver Hub is effectively an Android phone with built in USB ports. It is purpose built for FTC, and has several advantages over traditional Android phones.

- USB and :term:`OTG <Micro USB On The Go (OTG) Cable>` connections can be a possible source of disconnects during a match. This is generally caused by poor quality connectors or adapters between the driver station and the gamepad controller. **It generally is worth it to purchase higher quality connectors as opposed to the cheapest options.**
Advantages
^^^^^^^^^^

- Full sized USB ports do not require flimsy On The Go (micro-USB connector to USB-A port) cables
- Charges from USB-C including fast charging Power Delivery modes
- Larger screen than many Android phones
- Case is more robust then a standard Android phone

Disadvantages
^^^^^^^^^^^^^

- Price: A Driver Hub costs $250.00, whereas legal Android phones can be purchased secondhand for less
- Power Issues: Teams have reported random losses of power coming from an improperly sized battery.
- Battery Issues: Teams have reported high battery drain in sleep mode, leading to hubs dying faster then expected
- Wifi Issues: The wifi driver will occasionally crash when the device goes to sleep, requiring a device restart

.. important::
If you purchase a Driver Hub and experience issues, refer to the `REV Driver Hub troubleshooting page <https://docs.revrobotics.com/duo-control/troubleshooting-the-control-system/driver-hub-troubleshooting>`_. The unexpected power off fix may be done preemptively to prevent a shutdown during a match.

Android Phones
--------------

As of 2023-2024, Android phones are still legal for competition use.

Advantages
^^^^^^^^^^

- Android phones can be very cheap when purchased secondhand
- Android phones generally are reliable out of the box

Disadvantages
^^^^^^^^^^^^^

- The lack of a full size USB A port means that flimsy On The Go cables must be used
- The phones themselves should be protected with a case to prevent damage

A 5 GHz phone is preferred over the standard 2.4 GHz phone to reduce ping issues. Have you ever noticed that your team's robot seems to lag at competitions only? This is because most school WiFi bands run on 2.4 GHz, which means that 2.4 GHz channels will be more crowded on competition day. This can lead to noticeably higher ping/lag which adversely affects driver and robot performance.

USB and :term:`OTG <Micro USB On The Go (OTG) Cable>` connections can be a possible source of disconnects during a match. This is generally caused by poor quality cables/adapters between the driver station and the gamepads. **It generally is worth it to purchase higher quality cables and adapters as opposed to the cheapest options.**

`Recommended USB to OTG Cable <https://www.amazon.com/gp/product/B00YOX4JU6?pf_rd_r=PY8B4WPEQRQ80XYJCMSH&pf_rd_p=edaba0ee-c2fe-4124-9f5d-b31d6b1bfbee/>`_

Expand Down
Loading