Skip to content

Monterey is the computer GUI for rov-suite, an open source ROV control system.

Notifications You must be signed in to change notification settings

rovsuite/monterey

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Monterey Screenshot - Windows

Monterey

Monterey is the computer GUI for ROV-Suite, an open source ROV control system, written in Qt with SDL for joystick support. It works in conjunction with the bottom-side code, written for Arduino microprocessors and Raspberry Pis, to operate an ROV.

Features:

-Multithreaded: For faster performance

-Joystick support: Nearly ANY USB joystick can work with Monterey, and all buttons, hats and axes are mappable to whichever commands you want

-Customizable: Joystick settings, mapping settings, and sensor settings let you tweak Monterey to your liking without having to look at any source code

-Open design: A documented UDP-based communications protcol makes it easy to write your own bottom-, or top-, side software to replace any component of ROV-Suite, including Monterey

-Expandable: Monterey has been designed from the ground up to be easy to expand upon. Need more relays? Change a few lines of the source code and the number of required relays will be quickly and easily added

Requirements:

-An Arduino with ethernet capabilities and a Raspberry Pi (these can be replaced by anything you want if you want to write code to interface with Monterey over UDP)

-A USB joystick or gamepad

Dependencies required for development:

-Qt 5.1 (or greater)

-SDL version 1.2.15 (sudo apt-get install libsdl-dev)

Compiling Instructions:

All OSes: Install Qt version 5.1 (or greater).

Linux: Install SDL version 1.2.15 (sudo apt-get install libsdl-dev). Then open Monterey.pro in Qt Creator and select Desktop as your target. Then click run and it should run just fine.

OSX: First, download SDL's Runtime Library for Mac. Install the framework to /Library/Frameworks. Then, open Monterey.pro in Qt Creator, select Desktop as your target and click run. It should build without any problems.

Windows: Development work is done primarily with MSVC, so that is the recommended compiler although MinGW has been used as well. Open Monterey.pro in Qt Creator, select Desktop as your target and click run. It should build and run just fine!

Notes:

Monterey can compile on OSX, Windows and Linux just fine, but keep in mind that Monterey is being developed in a Windows environment (tested on MinGW 4.8 32bit).

How can I help make Monterey better?

There are many ways you can help (even if you can't write code), and all of them are greatly appreciated!

-Bug reports: These are incredibly useful and help make Monterey better for everyone. If bugs aren't reported to the developers, how can they fix them?

-Feature requests: Want a feature added? Simply ask for it! Go to the "Issues" page and create an issue tagged as "enhancement". It's that simple!

-Code contributions: If you've written some cool code or fixed some bugs, don't be afraid to ask for a pull request!

-Hardware: If you've made a cool ROV, write about it online and, if you want, share plans with people! Monterey is a cool application, but it doesn't do much without an ROV attached to the other end of it...

-Join the project! Anyone who wants to is allowed to join the ROV-Suite project.

-Provide feedback! Do you like something we did? Do you want to see a feature added? Did we mess something up? Let us know! You can email Chris Konstad at chriskon149 [at] gmail [dot] com with your feedback.

-Finally, spread the word!

License

Copyright (C) 2014 Chris Konstad (chriskon149@gmail.com)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

Monterey is the computer GUI for rov-suite, an open source ROV control system.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages