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

Update control systems #409

Merged
merged 9 commits into from
Nov 2, 2023
Merged
43 changes: 24 additions & 19 deletions source/docs/power-and-electronics/control-system.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,47 +3,52 @@
Control Systems
===============

The FTC control system is based on using Android phones as a ":term:`Robot Controller`" and a ":term:`Driver Station`." The ":term:`Robot Controller`" phone is mounted on the robot and connected by a USB cable to a special "Hub", which in turn is connected to motors, servos, and sensors.
The FTC control system is based around a ":term:`Robot Controller`" and a ":term:`Driver Station`". The :term:`Robot Controller` is mounted on the robot and are connected to special "Hub(s)", which in turn connect to motors, servos, and sensors. The :term:`Robot Controller` is linked to the :term:`Driver Station` through WiFi Direct.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The FTC control system is based around a ":term:`Robot Controller`" and a ":term:`Driver Station`". The :term:`Robot Controller` is mounted on the robot and are connected to special "Hub(s)", which in turn connect to motors, servos, and sensors. The :term:`Robot Controller` is linked to the :term:`Driver Station` through WiFi Direct.
The FTC control system is based around a ":term:`Robot Controller`" and a ":term:`Driver Station`". The :term:`Robot Controller` is mounted on the robot and is connected to special "Hub(s)", which in turn connect to motors, servos, and sensors. The :term:`Robot Controller` is linked to the :term:`Driver Station` through WiFi Direct.

Copy link
Contributor

Choose a reason for hiding this comment

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

This paragraph doesn't really account for the fact that the Robot Controller can itself be a REV Hub. Additionally, the Control Hub does not use Wi-Fi Direct in any way. Instead, it broadcasts a standard Wi-Fi access point.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thoughts:
The FTC control system is based around a ":term:Robot Controller" and a ":term:Driver Station". The :term:Robot Controller is mounted on the robot and handles motors, servos, sensors, and input from the drivers' controllers. The :term:Driver Station remain with the drive team and connects to the :term:Robot Controller over WiFi.

Adds some ambiguity to the Robot Controller definition, just giving a very basic overview of its purpose. This leaves the second paragraph for actually describing the hubs. Also fixes up the WiFi Direct mistake.

abidingabi marked this conversation as resolved.
Show resolved Hide resolved

The two major manufacturers of control hubs for FTC are Modern Robotics and REV; however, nearly all teams are shifting over to REV because it is cheaper, simpler, and more reliable.
REV Robotics is the sole manufacturer of legal FTC control system components. The REV Expansion Hub connects to motors, servos, sensors, and a :term:`Robot Controller`. A REV Control Hub has the same functionality of an Expansion Hub but with a built-in :term:`Robot Controller`.

More information about the FTC Control system can be found below:
More information about the FTC Control System can be found below:

- `Official control system Wiki on GitHub <https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki>`_
- `Official Control System docs on FTC Docs <https://ftc-docs.firstinspires.org/en/latest/programming_resources/shared/control_system_intro/The-FTC-Control-System.html>`_
abidingabi marked this conversation as resolved.
Show resolved Hide resolved
- `REV Control System Documentation <https://docs.revrobotics.com/duo-control/>`_
- `Official troubleshooting guide <https://www.firstinspires.org/sites/default/files/uploads/resource_library/ftc/control-system-troubleshooting-guide.pdf>`_

There are two possible control systems that can be run on an FTC robot legally:

- REV Control Hub + REV Expansion Hub
- :term:`RC Phone <Robot Controller>` + REV Expansion Hub(s)
- REV Control Hub + REV Expansion Hub as it is less expensive and more reliable than the older Modern Robotics

RC Phone + REV Expansion Hub(s)
-------------------------------
.. important:: Beginning in the 2024-2025 season, an :term:`RC Phone <Robot Controller>` will no longer be legal to use as a Robot Controller. Teams will be required to use a REV Control Hub as their :term:`Robot Controller`.

REV Control Hub + REV Expansion Hub
-----------------------------------

.. warning:: It is of vital importance to update the firmware on REV Expansion hubs to at least version 1.8.2. It includes better protection against disconnects and improves program performance. See the `REV Expansion Hub firmware update docs`_.

This is the standard control system for teams starting out in FTC. The REV Expansion Hub is reliable, as long as proper strain relief and wiring is carried out. This includes the :term:`USB Retention Mount`, as well as 3D printing :term:`XT30` stress relief mounts.
This is the standard control system for teams starting out in FTC.

The Expansion Hub connects to the :term:`Robot Controller` phone through the mini USB port, and the :term:`RC <Robot Controller>` phone is linked to the DS (:term:`Driver Station`) phone through WiFi Direct. For more information on setting up the Expansion Hub and configuring the robot, head to `REV Robotics' Technical Resources Expansion Hub Guide <https://docs.revrobotics.com/duo-control/legacy/expansion-hub-gs>`_.
The Control Hub connects to the Expansion Hub through either a RS-485 port on both hubs or a USB-A port on the Control Hub to the mini USB port on the Expansion Hub. In either case, proper strain relief and cable management should be used.
abidingabi marked this conversation as resolved.
Show resolved Hide resolved

- `USB Retention Mount <https://www.revrobotics.com/rev-41-1214/>`_
- `XT30 Stress Relief <https://www.thingiverse.com/thing:2887045>`_
- `REV Robotics Technical Resources <https://www.revrobotics.com/resources/>`_
For more information on setting up the Control Hub and configuring the robot, head to `REV Robotics' Technical Resources Control Hub Guide <https://docs.revrobotics.com/duo-control/control-hub-gs>`_.

.. image:: images/control-system/exh-wiring-diagram.jpg
:alt: A diagram of the RC Phone + Expansion Hub(s) control system
.. image:: images/control-system/ch-wiring-diagram.png
:alt: A diagram of the Control Hub + Expansion Hub control system
:width: 100%

REV Control Hub + REV Expansion Hub
-----------------------------------
RC Phone + REV Expansion Hub(s)
-------------------------------

.. warning:: It is of vital importance to update the firmware on REV Expansion hubs to at least version 1.8.2. It includes better protection against disconnects and improves program performance. See the `REV Expansion Hub firmware update docs`_.

Note: The Control Hub will be legal for all teams from the 2020-2021 FTC season onwards. In 2019-2020, the Control Hub was not legal for all teams as it was undergoing a pilot program.
The Expansion Hub connects to the :term:`Robot Controller` phone through the mini USB port. The REV Expansion Hub is reliable, as long as proper strain relief and wiring is carried out. This includes the :term:`USB Retention Mount`, as well as 3D printing :term:`XT30` stress relief mounts.
abidingabi marked this conversation as resolved.
Show resolved Hide resolved

.. image:: images/control-system/ch-wiring-diagram.png
:alt: A diagram of the Control Hub + Expansion Hub control system
For more information on setting up the Expansion Hub and configuring the robot, head to `REV Robotics' Technical Resources Expansion Hub Guide <https://docs.revrobotics.com/duo-control/legacy/expansion-hub-gs>`_.

- `USB Retention Mount <https://www.revrobotics.com/rev-41-1214/>`_
- `XT30 Stress Relief <https://www.thingiverse.com/thing:2887045>`_

.. image:: images/control-system/exh-wiring-diagram.jpg
:alt: A diagram of the RC Phone + Expansion Hub(s) control system
:width: 100%

.. _REV Expansion Hub firmware update docs: https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware
Loading