younters / qdriverstation Goto Github PK

QDriverStation is an open-source, cross-platform alternative to the FRC Driver Station.

The application looks and behaves almost identically to the FRC Driver Station, we may release some tutorials in the future. If you are already familiar with the FRC Driver Station, we would welcome any contributions regarding the documentation and/or tutorials for new users.

Joystick input is achieved with SDL 2.0, which is a cross-platform library for C/C++.

The actual code that moves and manages a FRC robot is found in a separate repository, which you can use in your own Qt projects or change it to support older (and future) communication protocols.

We are also developing a mobile version of the QDriverStation. Check it here!

You can download the QDriverStation from GitHub or SourceForge. If you got the QDriverStation from another website, it was probably modified by another person and may contain adware or some nasty junk in it. Be advised that SourceForge is known for serving misleading advertisements.

We strongly recommend you to download the installers from GitHub and not from SourceForge.

Download Links:

• Download from GitHub
• Download from SourceForge

While for the moment we don't build Linux packages, there are some packages of the QDriverStation made available by some members of the FRC community:

• ArchLinux package by lopsided98
• QDriverStation 0.14 DEB package

For more information regarding Linux installers, check this issue.

Check this tutorial by Dakota Keeler to build and install the QDriverStation on your Linux box.

Once you finish installing the software, you can launch it and begin driving your robot. Just be sure to input your team number and to verify that the joysticks are working correctly.

Mac users will be prompted to download an additional driver for Xbox 360 controllers to work.

Due to a kernel bug, the QDriverStation may detect an external mouse as a joystick. For more information, check this issue.

The only requirement to compile the application is to have Qt installed in your system. The desktop application will compile with both Qt4 and Qt5.

• If you are using Linux, make sure that you have installed the following packages:
  • libsdl2-dev

The project already contains the compiled SDL libraries for Windows and Mac.

Once you have Qt installed, open QDriverStation.pro in Qt Creator and click the "Run" button.

Alternatively, you can also use the following commands:

• qmake
• make
• Optional: sudo make install

Before changing an existing translation, please do the following:

• Run the "lupdate" tool from terminal, this will "sync" the translations with the current code

If you want to create a new translation, please do the following:

• Open QDriverStation.pro with any text editor
• Go to the "Translations" section (at the bottom of the file)
• Add a new line with your language code:
  • For example, if you want to create a Russian translation, you would add this line:

  • TRANSLATIONS += $$PWD/translations/qds_ru.ts

• Update the "translations.qrc" file (under the resources section)
• Do your translations and run the "lrelease" tool
• Update the "Languages" class (src/Utilities/Languages.h)

Once you finish creating or improving a translation, please do the following:

• Run the "lrelease" tool from terminal
• Recompile the QDriverStation

This application was created by FRC team 3794 "WinT" from Metepec, Mexico. We sincerely hope that you enjoy our application and we would love some feedback from your team about it.