PlayUAV OSD migration to dRonin firmware

Set up prerequisites

Download Required Programs

• Git 2.6.4 or later - The latest release should be fine.
• Python 2.7.x - Get the latest Python 2.7.x Anaconda distribution from https://www.continuum.io/downloads

Install Required Programs

1. Install git. Default options are okay. You will use this to clone the dRonin repository to your machine. It also provides a bash shell and other Unix-like tools.
2. Install Python 2.7.x Anaconda distribution. Default options are okay. Python is used at various stages in the build process for both GCS and firmware.
3. Install pyserial. Open a command prompt, and run "pip install pyserial".

Checkout the dRonin repository

1. Create a directory, on a place you like.
2. Open a command prompt in that directory, or cd to that directory.
3. Clone the dRonin repository. If you have your own fork, specify its URL on the git command line instead of the default URL. Command to use: "git clone git://github.com/d-ronin/dRonin.git".

Migration of the PlayUAV OSD to dRonin firmware

1. Either build dRonin or copy from an installed development dRonin. After building, the required file can be found at "build\bu_playuavosd\bu_playuavosd.px4". For copying the required file can be found at "dRonin\firmware\bu_playuavosd.px4". Copy the file to the "flight\targets\playuavosd" directory.
2. Open the Device Manager. Take a note of the serial port that appears and disappears when connecting and disconnecting the PlayUAV OSD.
3. Leave the PlayUAV OSD connected.
4. Open a command prompt in the "flight\targets\playuavosd" directory.
5. Execute the following command: "python px_uploader.py --port COM5 bu_playuavosd.px4". Make sure the "COM5" matches with the serial port noted in step 2.
6. The following output should be shown:

Loaded firmware for 5a,0, size: 151964 bytes, waiting for the bootloader...
If the board does not respond within 1-2 seconds, unplug and re-plug the USB connector.
attempting reboot on COM5...
if the board does not respond, unplug and re-plug the USB connector.
attempting reboot on COM5...
if the board does not respond, unplug and re-plug the USB connector.
attempting reboot on COM5...

6. Unplug and replug the PlayUAV OSD.
7. The following output should be shown:

Found board 5a,0 bootloader rev 4 on COM5
ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff ffffffff type: ÿÿÿÿ
idtype: =FF
vid: ffffffff
pid: ffffffff
coa: //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////8=

sn: 002e00323435511331383933

Erase : [====================] 100.0%
Program: [====================] 100.0%
Verify : [====================] 100.0%
Rebooting.

8. Wait a minute to be sure everything has finished, and avoid bricking the PlayUAV OSD.
9. Start dRonin GCS.
10. If it doesn't recognize the board, unplug and replug the PlayUAV OSD.
11. dRonin GCS will prompt that it has found a board without firmware.
12. Press the button the continue, dRonin GCS will start the autoupgrade process, which flashes the dRonin firmware into the PlayUAV OSD.
13. When it is ready, unplug and replug the PlayUAV OSD.
14. The PlayUAV OSD should blink just like your Flight Controller. One led solid, and the other at a fixed interval.
15. You are done migrating the PlayUAV OSD to dRonin firmware, and can now start configuring the OSD elements.