Team 2853 presents...their Book of Electrical (updated for the roboRIO!)

[MHSrobotics2853]

Hi everyone! Some of your might remember our post from last year (http://www.chiefdelphi.com/forums/showthread.php?p=1365230#post1365230). Since the cRIO was replaced with the roboRIO, we've been busy documenting all the new shiny features.

Link: https://docs.google.com/document/d/1MxxcVN0LOX8bVq6RX9leczkSZ2z8tWAnklBboo1HZk0/edit?usp=sharing
(To save as a PDF, go to File > Download As > PDF. However, this will remove the Table of Contents hyperlinks)

Major Changes

Documented all new components of 2015 control system
Rewrote sample code (C++) to reflect changes (i.e. parts are now indexed at 0)
Added more sensors
Added mecanum drive
Added new wiring diagrams in the Appendix
Added new Driver Station
Fixed broken links

There are still a few sections that need to be written (more sensors, USB camera, eclipse IDE, SmartDashboard) & porting it to our website since a 160 page Google doc is quite laggy. Here's a sample page (http://mililanirobotics.org/documentation/electrical/bible/TheroboRIO.html).

View our changelog (http://www.mililanirobotics.org/documentation/electrical/bible/changelog.html) for up-to-date information.

We would definitely appreciate comments and feedback, especially if some information is not completely true/erroneous. We hope teams will find this helpful!

[Al Skierkiewicz]

Very nice and very comprehensive.

[JohnFogarty]

Wow....that is exceptional...

[AndrewGRowles]

I am really impressed. You should really move this guide to a GitHub repo. That way other teams can contribute by forking and making pull requests. This guide is so comprehensive that is would be a shame for it not to be open to collaboration from the community. Also see: gitbook.com (https://www.gitbook.com/)

[MHSrobotics2853]

I am really impressed. You should really move this guide to a GitHub repo. That way other teams can contribute by forking and making pull requests. This guide is so comprehensive that is would be a shame for it not to be open to collaboration from the community. Also see: gitbook.com (https://www.gitbook.com/)

That's a great idea. We'll look into using that. Thanks! :D

Edit: After looking into it, there are a two problems I have:

It will take a while to format everything in markdown.
Images don't mesh nicely, see here. (http://mililanirobotics.gitbooks.io/frc-electrical-bible/content/connecting_to_the_roborio_wirelessly.html) I can't move the image down to the next line because it will reset my numbering to 1. It's a small formatting issue, but it greatly bothers me :P


Would it be more convenient to implement a form for suggested changes?

[AndrewGRowles]

That's a great idea. We'll look into using that. Thanks! :D

Edit: After looking into it, there are a two problems I have:

It will take a while to format everything in markdown.
Images don't mesh nicely, see here. (http://mililanirobotics.gitbooks.io/frc-electrical-bible/content/connecting_to_the_roborio_wirelessly.html) I can't move the image down to the next line because it will reset my numbering to 1. It's a small formatting issue, but it greatly bothers me :P


Would it be more convenient to implement a form for suggested changes?

Have you linked the book to a GitHub repo? If so, I can take a look at it and try to fix the markdown.

You can link it to a GitHub repo by going to the your book dashboard in GitBooks and choosing the GitHub option and then just set the repo.

For an example GitBook with a GitHub repo see: https://github.com/SamyPesse/How-to-Make-a-Computer-Operating-System

[MHSrobotics2853]

Have you linked the book to a GitHub repo? If so, I can take a look at it and try to fix the markdown.

You can link it to a GitHub repo by going to the your book dashboard in GitBooks and choosing the GitHub option and then just set the repo.

For an example GitBook with a GitHub repo see: https://github.com/SamyPesse/How-to-Make-a-Computer-Operating-System

We tried to link our current book to the repository here (https://github.com/mililanirobotics/ElectricalBible) (by clicking on the "Github Integration" tab in GitBook). But nothing has been pushed. Sorry for the difficulty...we're not too familiar with this.

EDIT
We found out how to port it to GitHub and format it to our heart's content. Working on a GitBook version now.

[MHSrobotics2853]

We figured out how to use GitBook & Markdown and are now in the process of porting it over.

http://mililanirobotics.gitbooks.io/frc-electrical-bible/content/index.html

Repository here (https://github.com/mililanirobotics/ElectricalBible)

[MHSrobotics2853]

Import into Gitbook is about halfway done.

The changelog can now be found here (http://mililanirobotics.gitbooks.io/frc-electrical-bible/content/CHANGELOG.html).

[juchong]

Import into Gitbook is about halfway done.

The changelog can now be found here (http://mililanirobotics.gitbooks.io/frc-electrical-bible/content/CHANGELOG.html).

Exceptional work, everyone! Thanks for all your effort! :cool:

[dominik.daners]

You sir (team) are a god (gods).
Especially loving the detail and coverage of absolutely everything
Thx!!!

[MHSrobotics2853]

Glad you guys are finding it useful! :)

Sorry for the delayed import into Gitbooks, the end of build season is coming close, and we're currently overwhelmed with work (as many teams are as well!)

We promise to update sections towards the end of this week!