README.md

Open Solo Releases For Users

NEW: ARDUCOPTER 3.7-DEV TESTING

Click here for release notes and instructions as of January 28, 2019 for beta testing ArduCopter 3.7-dev on the Solo. You must already be on Open Solo to do this. This is a major beta testing project.

INFORMATION CURRENT FOR STABLE RELEASE OPEN SOLO v3.0.0 ON JANUARY 1, 2018

The team working on safe, reliable releases of Open Solo publishes them here. You can read all the details in the release notes, and link directly to installation instructions. These are the "official" instructions. These instructions supersede any other older instructions, videos, and wikis that came before Open Solo.

Release notes and instructions

• Release notes for each version:

  • Current stable release: v3.0.0
  • All releases including old betas

• For stock solos and previously installed and working green cubes, go straight to the Open Solo installation procedures:

  • Install using the Solex app on Android
  • Install using SidePilot app on iOS
  • Install using SSH/SFTP on widows or mac
  • Install / recovery with SD card images

• For a brand new Green Cube installation please follow these updated instructions!

  • New green cube installation procedure

Support, Social Media, and other useful links

• Solo Beta Test group on Facebook (primary Open Solo and Green Cube support group!!)
• Solo Mod Club group on Facebook
• Solex Users group on Facebook
• Solex App official website. This app is truely the future of Solo's user interface!
• SidePilot Community on Facebook
• Jester's Drones for the Green Cube and other cool gear
• ProfiCNC for the Green Cube and other cool gear
• ArduPilot homepage
• ArduCopter Full Parameter List details all 700 something parameters in ArduCopter.
• ArduCopter introduction: Learn what you're getting yourself into :)
• Mission Planner ground station app for Windows
• Filezilla for moving files to/from the companion computer
• WinSCP for moving files to/from the companion computer

Tech and Contributors

If you're the geeky type that wants to read all the commits to see what has been changed in Open Solo, they can all be found in the Open Solo github repositories.

• The Build System compiles all the code from all the repositories into functioning binaries to be loaded onto the Solo and Controller. This was a HUGE lift to make work outside of 3DR's environment. David Buzz (@davidbuzz) was the brains behind the move of everything from 3DR, setup of new repos and servers, build system engineering, and a new AWS based auto-build system. The AWS system can compile from scratch in 1hr, whereas a home PC takes up to 5hrs.

  • Meta-3DR is all the Yocto bitbake recipes.
  • Solo-Builder is the virtual machine and scripts to carry out the build.

• The Flight Code has numerous components that got fixes and new features. Matt Lawrence (@Pedals2Paddles) worked most of these changes. Other contributors to the code were Tim (@FLYBYME), Morten Enholm (@Spawn32), and Hugh Eaves (@hugheaves),

  • Sololink is mostly behind the scenes stuff related to booting, networking connections, firmware loading, etc. This compiles into a version for both the Copter and Controller's IMX companion computers.
  • Shotmanager is all the smart shots, button and control handling, camera stuff, and most other user facing operational stuff. This compiles primarily into the Copter's IMX companion computer.
  • Artoo is the controller's STM32 firmware for the screen, buttons, and sticks.
  • Mavlink-Solo is a rather old fork of Mavlink. The flight modes were brought up to current enumerations.
  • Sololink-python is some misc helper python files.
  • ArduPilot-solo is 3DR's fork of ArduCopter used on the stock Solo pixhawk 2.0 cube.

For Developers

FOR DEVELOPERS!! Not for general users that just want to put Open Solo releases on their solo!!!

Building Open Solo (everything)

If you want to build Open Solo, take a look at solo-builder here. It contains everything you need to build OpenSolo from scratch and update your artoo/solo. If you want to make customisations or build something specific take a look below.

Note: solo-builder is producing corrupt artoo stm32 binaries for some users. See the artoo docs if your artoo becomes "bricked" or doesn't turn on. (this is normally easily recoverable)

Artoo (the controller)

How to build the stm32 firmware

How to flash the stm32 firmware

How to unbrick artoo

How to customise start/shutdown image

How to customise strings/text (coming soon!)

Solo

Nothing yet :(

How to get involved

This documentation is pretty empty right now. If you know how Solo or Artoo works (or don't know!) and want to get involved pull requests are welcome on this documentation and all of the sub projects. (artoo, solo-builder etc) Most of the developers are hanging out on gitter and Facebook.

Special Mentions!

All of this would not be possible without 3DR. They very generously open sourced most of their internal code and build tools to make this possible. You can see the official 3DR release statement here and the ardupilot team's statement here.

Special thanks to Buzz and Peter for making this happen, and everyone else who has contributed to make solo even better.