Skip to content

Releases: OpenROV/openrov-software

30.1.0 DEV #169 (HD Camera Image)

19 Mar 22:29
79043d9
Compare
Choose a tag to compare
Pre-release

This image is specifically for running the HD camera on the OpenROV v2.6, v2.7, v2.8

30.0.3 ROV FLASH IMAGE

19 Mar 22:26
79043d9
Compare
Choose a tag to compare

Latest stable release for OpenROV Kit v2.6, v2.7, v2.8

30.0.3 release of the OpenROV FLASH image.
Must be burned on a SD card and is used to
FLASH the onboard memory on the ROV

Instructions to flash the image to your BeagleBone Black

2.5.1 final release

30 Dec 19:50
Compare
Choose a tag to compare

This is the cockpit code that went in to the 2.5.1 release. Refer to the 2.5.1 image notes to download.
http://community.openrov.com/profiles/blogs/new-rov-cockpit-software-released

Release 2.5.1 (RC5) -- obsolete

17 Oct 21:53
Compare
Choose a tag to compare

Release 2.5.1 (RC5)

https://github.com/OpenROV/openrov-proxy/tree/v2.5.1-rc1
https://github.com/OpenROV/openrov-software-arduino/tree/87f49553bdedd95a06c3d8cc8826ee7dc864fa11
https://github.com/OpenROV/openrov-dashboard/tree/v2.5.1-rc1

This release includes:

  • the re-organized repository structure and supporting layout in the image.
  • Debian O/S on the ROV with 3.15 linux kernel including DMA access to the USB bus
  • scripts to automatically upload firmware to afro ESCs
  • dashboard now supports push button updates
  • community plugin manager
  • IMU code now matches recommended mounting position
  • ROV now has indirect internet access via the browser if available
  • lots of new led light pattern indications: ROV ready, ROV lost contact with surface, BeagleBone running
  • pop-up on screen menu for additional options while piloting
  • lots of code cleanup and refactoring

Errants Notes:

  • This version DOES NOT work with cape based ROVs at the moment. Cape based ROVs must wait for 2.5.2 for updates.
  • The community plugin may require the ROV to have direct internet access to successfully install a plugin

---Here's how you can apply this image to your OpenROV v2.5:---

---------Applying the image to your micro SD card-----------------
Step 1: Download the zipped file, attached below - OpenROV-2.5.1-95.img.7z
Step 2: (For windows) Download SDFormatter and Win32DiskImager to your computer
Step 3: Format a microSD card using SDFormatter. "Quick Format" will work fine
Step 4: Unzip the file you've downloaded (OpenROV-2.5.1-95.img.7z)
Step 5: Run Win32DiskImager and select the image file (ending in *.img) you just unzipped. Make sure that the drive you select under "Device" is the SD card you've inserted.
Step 6: Write the image file to your formatted SD card by pressing the "Write" button in Win32DiskImager. This process will take around 5 or 10 minuets.
Step 7: Once the image has been successfully applied to the microSD card, eject the card and put in in your BeagleBone.

---------Applying the image to the flash memory on Beagle Bone Black -----------------
Step 1: Download the zipped file, attached below - OpenROV-flash-2.5.1-36.img.7z
Step 2: (For windows) Download SDFormatter and Win32DiskImager to your computer
Step 3: Format a microSD card using SDFormatter. "Quick Format" will work fine
Step 4: Unzip the file you've downloaded (OpenROV-flash-2.5.1-36.img.7z)
Step 5: Run Win32DiskImager and select the image file (ending in *.img) you just unzipped. Make sure that the drive you select under "Device" is the SD card you've inserted.
Step 6: Write the image file to your formatted SD card by pressing the "Write" button in Win32DiskImager. This process will take around 5 or 10 minuets.
Step 7: Once the image has been successfully applied to the microSD card, eject the card and put in in your BeagleBone.
Step 8: Boot the beaglebone, it will take about 14 minutes to complete. When all of the 4 blue LEDs on the beaglebone are solidly on, that indicates the process is complete.
Step 9: Power off the beaglebone, remove the SD card, power back on and enjoy.

----------------------------Connecting to the ROV--------------------------
Step 8: Turn your ROV on and allow about 60 seconds for it to boot.
Step 9: Make sure your computer's LAN port is set to a static IP address that looks like "192.168.254.x" where "x" is any value less then 254 and not 1
Step 10: Plug your ROV into your computer, open Google Chrome, and go to the following address: 192.168.254.1:8080
Step 11: OpenROV Cockpit should come up after several seconds (it may take a moment for the video to appear). Because the Controller Board has not yet been programmed you will not be able to control the lights or motors, and you won't see any valid telemetry.

------------------------Programming the OpenROV Controller Board---------------
Step 12: In Cockpit, press the "Settings" button in the upper right-hand side of the screen, and press "Upload firmware from SD card to Arduino"
Step 13: A window called "Upload Arduino Firmware" will pop up. Press the blue "Apply New Firmware" button in the lower right side of the window. This will upload the Arduino Code necessary for the Controller board to work.
Step 14: Once the Arduino Firmware has been uploaded (the window will stay open, but the green progress bar will have made it all the way to the right) you can close the window.

Step 15: Restart the ROV
Step 16: Once the ROV has restarted, verify that you can read telemetry data, control the lights, and control the thrusters. You may need to program and calibrate the thrusters before they respond properly to commands.
Step 17: Let us know how it works out!

Release Candidate 2

07 Oct 19:33
Compare
Choose a tag to compare
Release Candidate 2 Pre-release
Pre-release

Release 2.5.1 (RC2)

https://github.com/OpenROV/openrov-proxy/tree/v2.5.1-rc1
https://github.com/OpenROV/openrov-software-arduino/tree/87f49553bdedd95a06c3d8cc8826ee7dc864fa11
https://github.com/OpenROV/openrov-dashboard/tree/v2.5.1-rc1

This release includes the re-organized repository structure and supporting layout in the image.

Errants Notes:

This version DOES NOT work with cape based ROVs at the moment. Cape based ROVs must wait for 2.5.2 for updates.

The flash image is missing some disk protection. It may require multiple start attempts to get it to run.

Key changes since last DevImage:

  1. Cockpit community plugin downloader
  2. Dashboard software Update Feature
  3. Lots of stability fixes
  4. Moved to Debian for embedded O/S
  5. Moved to 3.15 version of the linux Kernel to enable USB DMA

---Here's how you can apply this image to your OpenROV v2.5:---

---------Applying the image to your micro SD card-----------------
Step 1: Download the zipped file, attached below - OpenROV-2.5.1-83.img.7z
Step 2: (For windows) Download SDFormatter and Win32DiskImager to your computer
Step 3: Format a microSD card using SDFormatter. "Quick Format" will work fine
Step 4: Unzip the file you've downloaded (OpenROV-2.5.1-83.img.7z)
Step 5: Run Win32DiskImager and select the image file (ending in *.img) you just unzipped. Make sure that the drive you select under "Device" is the SD card you've inserted.
Step 6: Write the image file to your formatted SD card by pressing the "Write" button in Win32DiskImager. This process will take around 5 or 10 minuets.
Step 7: Once the image has been successfully applied to the microSD card, eject the card and put in in your BeagleBone.

---------Applying the image to the flash memory on Beagle Bone Black -----------------
Step 1: Download the zipped file, attached below - OpenROV-flash-2.5.1-31.img.7z
Step 2: (For windows) Download SDFormatter and Win32DiskImager to your computer
Step 3: Format a microSD card using SDFormatter. "Quick Format" will work fine
Step 4: Unzip the file you've downloaded (OpenROV-flash-2.5.1-31.img.7z)
Step 5: Run Win32DiskImager and select the image file (ending in *.img) you just unzipped. Make sure that the drive you select under "Device" is the SD card you've inserted.
Step 6: Write the image file to your formatted SD card by pressing the "Write" button in Win32DiskImager. This process will take around 5 or 10 minuets.
Step 7: Once the image has been successfully applied to the microSD card, eject the card and put in in your BeagleBone.
Step 8: Boot the beaglebone, it will take about 14 minutes to complete. When all of the 4 blue LEDs on the beaglebone are solidly on, that indicates the process is complete.
Step 9: Power off the beaglebone, remove the SD card, power back on and enjoy.

----------------------------Connecting to the ROV--------------------------
Step 8: Turn your ROV on and allow about 60 seconds for it to boot.
Step 9: Make sure your computer's LAN port is set to a static IP address that looks like "192.168.254.x" where "x" is any value less then 254 and not 1
Step 10: Plug your ROV into your computer, open Google Chrome, and go to the following address: 192.168.254.1:8080
Step 11: OpenROV Cockpit should come up after several seconds (it may take a moment for the video to appear). Because the Controller Board has not yet been programmed you will not be able to control the lights or motors, and you won't see any valid telemetry.

------------------------Programming the OpenROV Controller Board---------------
Step 12: In Cockpit, press the "Settings" button in the upper right-hand side of the screen, and press "Upload firmware from SD card to Arduino"
Step 13: A window called "Upload Arduino Firmware" will pop up. Press the blue "Apply New Firmware" button in the lower right side of the window. This will upload the Arduino Code necessary for the Controller board to work.
Step 14: Once the Arduino Firmware has been uploaded (the window will stay open, but the green progress bar will have made it all the way to the right) you can close the window.

Step 15: Restart the ROV
Step 16: Once the ROV has restarted, verify that you can read telemetry data, control the lights, and control the thrusters. You may need to program and calibrate the thrusters before they respond properly to commands.
Step 17: Let us know how it works out!

V2.5 Release

25 Jun 01:26
Compare
Choose a tag to compare

_POSSIBLE ISSUE_

Detailed Change List can be found here: df6b09b...v2.5.0

This has been tested on both cape and controller board based ROVs.

There is a new file that must be updated to match your configuration called AConfig.h. Edit it before applying the new firmware.
The current release requires you to do a reboot after it finishes expanding the partition during the first boot with a new image on the SD care before you can apply the arduino firmware to the controllerboard based ROV.

_Known errants:_*

  • The cockpit takes twice as long to load right after a fresh boot. Be patient.
  • The very first time the ROV boots, it takes longer as it expands to take up all free space on the SD/emmc. This takes about 1 minute after which the LEDs should all go high so that you know to reboot the ROV. If you proceed without rebooting, flashing the arduino code may fail.
  • When using Cloud9, if you get a SessionID not found error, refresh the screen until it loads with no errors. Otherwise you won't be able to save your changes.
  • On the diagnostics panel, the motors are in the wrong order so pay attention when calibrating. They should go down the page Port-Vertical-Starboard but the don't. Also the dead-zon setting is no longer visible.

_Note to Cape ROV Owners_
If you want to use the updated software you must update the ACONFIG.h per the instructions below as the defaults create an image that is too big to load on to the ATMEGA 328p. As a side note, the size of the firmware for the MPU9150 IMU is a bit too large in its current state for the 32K of space available on the 328p. If your hell bent on running the IMU on the cape, you will need to spend some time reducing the size of the library.

_Note to original ROV Kickstarter Kit and 2.4 owners_
Delta V 15 propIf you have the older E-flite Delta V15 props (they are all the same vs. the counter rotating props added in later kits), you may want to adjust the motor proportional settings in the arduino code. They come preset for the more recent ROVs where the thrust in the reverse direction was much less than the forward direction. As a result, by default, the signal to the motors when in reverse is double that in the forward direction. If you want to have the same proportional control you had in a prior release, you have to change this line to all 1s: https://github.com/OpenROV/openrov-software/blob/v2.5.0/arduino/OpenROV/Motors.cpp#L61-L62

_Changes from RC3_

  • Fixed issue where motors would stop in extreme verse on power level 5.
  • Lowered the size of the internal command buffer to make it friendly for the 328p
  • Fixed an issue with the automatic board detection

_Change from RC2_

  • Fix to match Chrome's gamepad API breaking change

_Change list:_

  • A new default dashboard allowing starting the Cloud9 IDE, File Sharing, and the Cockpit has been added on port 80 of the ROV
  • Support for the MS5803 depth sensor added
  • Support for the MPU9150 IMU sensor added
  • Data logger plugin added
  • Major refactor of logic to plugin architecture
  • Major performance improvements in the browser and video
  • Beta touchscreen controls added for touch enabled devices
  • System now automatically expands the image to take over all free space on the SD card on initial boot
  • Latency measurement controls added
  • Heads up display can now be toggled off
  • Changed the UI to add more space for telemetry
  • Beta tank control mode added
  • Added saltwater/freshwater toggle
  • Changed cockpit to a darker theme that works better at night
  • Added beta depth and heading hold
  • Added beta fly-by-wire
  • Lots of fixes to the compass in cockpit. Note: Currently orientation to magnetic north has been disabled.
  • Lots of fixes to the things that are interrupting camera video
  • Made default motor response more aggressive
  • Fixed onboard temperature reporting on the controllerboard
  • Added support for the OpenROV Controllerboard 2.x class of boards
  • Sensor board support in the Arduino code
  • Logging of telemetry data to persistent storage on the browser
  • Ability to download telemetry in json
  • HUD depth and thrust indicators
  • Laser keyboard toggle
  • Depth Zeroing button
  • Light on/off toggle key

---Here's how you can apply this image to your OpenROV v2.5:---

---------Applying the image to your micro SD card-----------------
Step 1: Download the zipped file, attached here
Step 2: (For windows) Download SDFormatter and Win32DiskImager to your computer
Step 3: Format a microSD card using SDFormatter. "Quick Format" will work fine
Step 4: Unzip the file you've downloaded (OpenROV-2.5_01.img.7z)
Step 5: Run Win32DiskImager and select the image file (ending in *.img) you just unzipped. Make sure that the drive you select under "Device" is the SD card you've inserted.
Step 6: Write the image file to your formatted SD card by pressing the "Write" button in Win32DiskImager. This process will take around 5 or 10 minuets.
Step 7: Once the image has been successfully applied to the microSD card, eject the card and put in in your BeagleBone.

----------------------------Connecting to the ROV--------------------------
Step 8: Turn your ROV on and allow about 60 seconds for it to boot.
Step 9: Make sure your computer's LAN port is set to a static IP address that looks like "192.168.254.x" where "x" is any value less then 254 and not 1
Step 10: Plug your ROV into your computer, open Google Chrome, and go to the following address: 192.168.254.1:8080
Step 11: OpenROV Cockpit should come up after several seconds (it may take a moment for the video to appear). Because the Controller Board has not yet been programmed you will not be able to control the lights or motors, and you won't see any valid telemetry.

------------------------Programming the OpenROV Controller Board---------------
Step 12: In Cockpit, press the "Settings" button in the upper right-hand side of the screen, and press "Upload firmware from SD card to Arduino"
Step 13: A window called "Upload Arduino Firmware" will pop up. Press the blue "Apply New Firmware" button in the lower right side of the window. This will upload the Arduino Code necessary for the Controller board to work.
Step 14: Once the Arduino Firmware has been uploaded (the window will stay open, but the green progress bar will have made it all the way to the right) you can close the window.
Step 15: Restart the ROV
Step 16: Once the ROV has restarted, verify that you can read telemetry data, control the lights, and control the thrusters. You may need to program and calibrate the thrusters before they respond properly to commands.
Step 17: Let us know how it works out!

_Dashboard_

Dashboard: Browse to http://192.168.254.1/ to access the Dashboard (see below for features)
Cloud9 and Samba (network share) don't start automatically anymore to conserve resources, they can be started via the __Dashboard __

_eMMC flashing_

Version of the image that copies itself onto the onboard eMMC in the BB Black (see instructions below). Download the image for flashing to emmc ('OpenROV-flash-2.5-7.img.7z, unpack it and apply it to an SD card.
Boot the BBB from the SD card
After about 20 minutes all 4 user LEDs should light up. This means that the image now is applied to the eMMC
Remove the SD card and reboot the system

There are 2 img files:

  • OpenROV-2.5-29.img.7z: Burn to a SD card and runs from the SD card
  • OpenROV-flash-2.5-29.img.7z: Burn to a SD card and use to flash the onboard emmc with the new code

Stable Release for the cape based OpenROVs

21 Nov 06:55
Compare
Choose a tag to compare

Key Features

  • Firmware uploads are working reliably on serial.
  • Arduino code has a modular system for simpler refactoring and improvements
  • On screen view of all telemetry data
  • Tons of small fixes since the original code that shipped with the 2.3/2.4 kits

This code will not work with 2.5 controller boards.