Update to using the VH-109 Radio #2885

jasondaming · 2024-12-28T05:01:11Z

source/docs/controls-overviews/control-system-hardware.rst

jasondaming · 2024-12-30T05:24:31Z

I still have a little more work to do on radio-programming but I think this is at least ready for everyone to look at things.

@kiet

Kevin-OConnor

Thanks Jason. I've included a handful of comments but this looks most of the way there to me.

source/docs/controls-overviews/control-system-hardware.rst

source/docs/zero-to-robot/step-3/radio-programming.rst

Kevin-OConnor

A few of the checks are still running but other than that LGTM. Thanks!!

sciencewhiz · 2024-12-30T19:15:10Z

source/docs/controls-overviews/control-system-hardware.rst


-.. image:: images/control-system-hardware/radio-power-module.png
-  :alt: REV Radio Power Module
+.. image:: images/control-system-hardware/radio.png


Need an image credit added at the end

sciencewhiz · 2024-12-30T19:22:53Z

source/docs/hardware/hardware-basics/status-lights-ref.rst

+|          +----------------+------------------------------+
+|          | Off            | Booting Up                   |
+----------+----------------+------------------------------+
+| 2.4G     | Blinking (20Hz)| Battery detected,            |


There should be solid rows for 2.4G and 6G

sciencewhiz · 2024-12-30T19:25:44Z

source/docs/software/driverstation/driver-station-log-viewer.rst

@@ -116,4 +116,4 @@ An issue with the ethernet cable on the robot is primarily indicated by the ping
 .. image:: images/driver-station-log-viewer/radioreboot.png
   :alt: The ping here shows the roboRIO and the radio as BAD.

-A reboot of the robot radio is typically characterized by a loss of connection to the radio for ~40-45 seconds. In this example, the radio briefly lost power at 3:22:44, causing it to start rebooting. The event at 3:22:45 indicates that the ping to the radio failed. At 3:23:11, the DS regains communication with the roboRIO and the roboRIO indicates it has been up for 1272.775 seconds, ruling out a roboRIO reboot. Note that the network switch on the radio comes back up very quickly so a momentary power loss may not result in a "radio lost"/"radio seen" event pair. A longer disturbance may result in radio events being logged by the DS. In that case, the distinguishing factor which points towards a radio reboot is the ping status of the radio from the DS. If the radio resets, the radio will be unreachable. If the issue is a cabling or connection issue on the robot, the radio ping should remain "GOOD".
+A reboot of the robot radio is typically characterized by a loss of connection to the radio for ~60 seconds. In this example, the radio briefly lost power at 3:22:44, causing it to start rebooting. The event at 3:22:45 indicates that the ping to the radio failed. At 3:23:11, the DS regains communication with the roboRIO and the roboRIO indicates it has been up for 1272.775 seconds, ruling out a roboRIO reboot. Note that the network switch on the radio comes back up very quickly so a momentary power loss may not result in a "radio lost"/"radio seen" event pair. A longer disturbance may result in radio events being logged by the DS. In that case, the distinguishing factor which points towards a radio reboot is the ping status of the radio from the DS. If the radio resets, the radio will be unreachable. If the issue is a cabling or connection issue on the robot, the radio ping should remain "GOOD".


I thought the radio was supposed to reboot faster then the old radio

sciencewhiz · 2024-12-30T19:26:21Z

source/docs/software/support/support-resources.rst

@@ -27,7 +27,7 @@ Support for Cross The Road Electronics components (Pneumatics Control Module, Po

 ## REV Robotics Support

-Support for REV Robotics components (SPARK MAX, Sensors, Pneumatic Hub, Power Distribution Hub, Radio Power Module) is provided via phone at [844-255-2267](tel:844-255-2267) or via the email address [[email protected]](mailto:[email protected]).
+Support for REV Robotics components (SPARK MAX, Sensors, Pneumatic Hub, Power Distribution Hub) is provided via phone at [844-255-2267](tel:844-255-2267) or via the email address [[email protected]](mailto:[email protected]).


I'm ok with keeping this reference to RPM

sciencewhiz · 2024-12-30T19:26:42Z

source/docs/software/frc-glossary.rst

@@ -236,7 +239,6 @@
      [REV Robotics](https://www.revrobotics.com/) - inspires innovation and creativity within the educational robotics community by offering comprehensive product lines, extensive educational resources, world-class customer service, and specialized sponsorship programs. With a global presence spanning over 190 countries, we empower the next generation of STEM professionals by providing cutting-edge solutions and essential tools for success. Founded in 2014 by robotics enthusiasts Greg Needel and David Yanoshak, REV Robotics is driven by the mission to inspire and support students as they explore the exciting world of robotics and unlock their full robotic design potential. A majority of our employees are FIRST Alumni who remain actively involved, serving as volunteers and mentors for the local FIRST Community. This deep engagement reflects our commitment to supporting and inspiring the next generation of STEM enthusiasts.

   RPM
-      Radio Power Module - is designed to keep one of the most critical system components, the OpenMesh OM5P-AC WiFi radio, powered in the toughest moments of the competition.


I'm ok with keeping this definition of the RPM

sciencewhiz · 2024-12-30T19:31:06Z

source/docs/zero-to-robot/step-1/intro-to-frc-robot-wiring.rst

@@ -338,49 +339,39 @@ After making the connection check to be sure that it is clean and secure:


 ## Radio Power
+[Vivid-Hosting Wiring Guide](https://frc-radio.vivid-hosting.net/getting-started/usage/wiring-your-radio)


There's a formatting issue. I think it needs a new line below

sciencewhiz · 2024-12-30T19:38:51Z

source/docs/zero-to-robot/step-3/radio-programming.rst


-.. warning:: It is not possible to modify the configuration manually.
+5. Enter the 2.4 GHz WPA/SAE key.  This is the password team members will type in when connecting to the 2.4 GHz network, if available.


What is this used for?

sciencewhiz · 2024-12-30T19:40:05Z

source/docs/zero-to-robot/step-3/radio-programming.rst


 ## Prerequisites

-The FRC Radio Configuration Utility requires administrator privileges to configure the network settings on your machine. The program should request the necessary privileges automatically (may require a password if run from a non-administrator account), but if you are having trouble, try running it from an administrator account.
+The recommended setup requires: 2 VH-109 radios, 1 VH-117 :term:`PoE` Wall Adapter, and 1 Radio Heatsink.  Available [here](https://wcproducts.com/products/frc-radio).


This feels like it could really use a picture to show how everything works together.

sciencewhiz · 2024-12-30T19:41:15Z

source/docs/zero-to-robot/step-3/radio-programming.rst


-## Allow the program to make changes, if prompted
+If your team still has an older radio from a previous season, it can serve as a temporary substitute for the VH-109 on your robot. In this case, you should:
+- Reserve a spot on your robot specifically for the VH-109 radio to ensure seamless integration during competition.


formatting issues with all the lists in this section. Think there needs to be some more newlines

sciencewhiz · 2024-12-30T19:45:29Z

source/docs/software/support/support-resources.rst

Should add WCP support here, now that they are a KOP vendor

sciencewhiz · 2024-12-30T19:46:14Z

source/docs/zero-to-robot/step-1/intro-to-frc-robot-wiring.rst

The video and some of the pictures still has the old radio. Should add some kind of call-out

first draft, need more work on radio programming

c202e95

sciencewhiz reviewed Dec 28, 2024

View reviewed changes

source/docs/controls-overviews/control-system-hardware.rst Outdated Show resolved Hide resolved

jasondaming added 4 commits December 28, 2024 08:11

fix image, redirects, lint

1e5fc7f

fix image, redirects, lint, remove RPM and Bridge references

9020f92

missed + in table

623321a

lots more info and cleanup on radio-programming

7b11c04

jasondaming marked this pull request as ready for review December 30, 2024 05:19

jasondaming requested review from sciencewhiz and Kevin-OConnor December 30, 2024 05:20

Kevin-OConnor requested changes Dec 30, 2024

View reviewed changes

feedback changes

215f360

jasondaming requested a review from Kevin-OConnor December 30, 2024 18:47

fix you->your and acess

9c1983f

Kevin-OConnor approved these changes Dec 30, 2024

View reviewed changes

sciencewhiz reviewed Dec 30, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update to using the VH-109 Radio #2885

Update to using the VH-109 Radio #2885

jasondaming commented Dec 28, 2024

jasondaming commented Dec 30, 2024

Kevin-OConnor left a comment

Kevin-OConnor left a comment

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

sciencewhiz Dec 30, 2024

		@@ -338,49 +339,39 @@ After making the connection check to be sure that it is clean and secure:


		## Radio Power
		[Vivid-Hosting Wiring Guide](https://frc-radio.vivid-hosting.net/getting-started/usage/wiring-your-radio)


		.. warning:: It is not possible to modify the configuration manually.
		5. Enter the 2.4 GHz WPA/SAE key. This is the password team members will type in when connecting to the 2.4 GHz network, if available.

Update to using the VH-109 Radio #2885

Are you sure you want to change the base?

Update to using the VH-109 Radio #2885

Conversation

jasondaming commented Dec 28, 2024

jasondaming commented Dec 30, 2024

Kevin-OConnor left a comment

Choose a reason for hiding this comment

Kevin-OConnor left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment