allwpilib icon indicating copy to clipboard operation
allwpilib copied to clipboard

Consider adding RomiGyro class to Romi templates

Open agasser opened this issue 3 years ago • 8 comments

The RomiReference example project includes a RomiGyro class that implements gyro support for the Romi. This class knows internals about the way the Romi communicates with the simulator to provide gyro data that a user could no know.

Since this class and the knowledge it has is not documented anywhere in the WPILib documentation, this class should be included in the "Romi - Timed Robot" and "Romi - Command Robot" templates.

An alternative approach would be to add this class to WPILib or to a Romi vendor library. Another alternative approach would be to include the knowledge this class requires in the WPILib documentation so a user could recreate the class from scratch.

agasser avatar Dec 20 '21 22:12 agasser

It's included in a Romi vendordep, here's the JSON: https://github.com/wpilibsuite/romi-vendordep/blob/main/RomiVendordep.json

Starlight220 avatar Dec 20 '21 23:12 Starlight220

Is this documented? I would be willing to add it to the Romi Getting Started documentation section, but I want to be sure I'm adding accurate information. This is related to https://github.com/wpilibsuite/frc-docs/issues/1567

agasser avatar Dec 20 '21 23:12 agasser

Given that these are included in a vendordep, the example should be updated to reference the vendordep instead of having the RomiGyro implementation in the project. Additionally, the templates should be updated to include the vendordep. If this sounds OK, I would be willing to send a PR.

agasser avatar Dec 20 '21 23:12 agasser

The current templates (both here and in the VS Code extension don't contain any vendordeps (including the command-based ones). The Romi vendordep is developed in a separate repository, so I'm not sure that it's trivial to pull it in and use it in the examples (maybe the Romi examples should move to the Romi repository because of this?). I recommend waiting for someone on the maintainer team to respond.

Starlight220 avatar Dec 21 '21 06:12 Starlight220

It's included in a Romi vendordep, here's the JSON: https://github.com/wpilibsuite/romi-vendordep/blob/main/RomiVendordep.json

Using that JSON as an online vendor library does not work, the artifacts are not published to Maven.

agasser avatar Dec 21 '21 16:12 agasser

Ah, the artifacts are not published to release maven, just development. Thats something that needs to be fixed.

ThadHouse avatar Dec 21 '21 16:12 ThadHouse

Was this fixed?

Starlight220 avatar Sep 20 '22 16:09 Starlight220

The Romi vendordep publishing was fixed. The vendordep was documented in frc-docs. https://github.com/wpilibsuite/frc-docs/pull/1621 But the main issue has not been done. It requires changes in both allwpilib to the Romi examples to use the vendordep (https://github.com/wpilibsuite/allwpilib/pull/3870) It also requires changes in the VSCode extension (https://github.com/wpilibsuite/vscode-wpilib/issues/528 and https://github.com/wpilibsuite/vscode-wpilib/issues/508)

sciencewhiz avatar Sep 21 '22 02:09 sciencewhiz