bluerobotics / bluerobotics.github.io

Blue Robotics product documentation site.

Blue Robotics Documentation Website

This repository is the home to Blue Robotics' product documentation, including product manuals, tutorials, and guides. This information is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. We welcome and encourage contributions from others as well as reports of issues or errors.

For more information please visit the actual documentation site.

##How the Website Works

The documentation website uses the Github Pages feature to host the website directly from this repository. The documentation is written in Markdown and uses Jekyll to generate the website.

If you want to play around with it and make modifications, just create a fork of the repository.

When you've got the files on your computer, you can host the site locally by typing:

jekyll serve

Then visit the site at http://localhost:4000/.

For more information on how to install Jekyll on your computer, visit the Jekyll website.

bluerobotics.github.io's Issues

Link to hex for flashing Basic ESC is not working

At http://docs.bluerobotics.com/besc/#advanced link for Basic ESC Firmware (BESC30-R1) (http://docs.bluerobotics.com/besc/firmware/afro_nfet_besc30_r1.hex) returns 404 error.

BESC30-R1 CAD File Missing

Hi, I wanted to download the CAD file for the Basic ESC, but all the links are broken.

Suggestion- Vacuum test

The vacuum test for the telemetry can should be done between the two o-rings, not the entire can. When testing the whole can you need a huge leakage to be able to read the leakage on the gauge. A small leakage like a hair or some rag on the o-rings will not bee seen unless the test last for very extended periods.
Measuring between the o-rings test both o-rings. Today's test only require one o-ring to be OK in order to pass the test.
It is not a question IF but WHEN you forget to put back the vacuum test cap. If the vacuum test vent goes between the O-rings, the area between the two o-rings will be flooded but not the telemetry can, unless the inner o-ring fails. In that case the technician should have experienced that the vacuum test failed prior to put the vehicle in water.

Add note to make sure joystick is 'Enabled'

BROV2: Add note about configuring low voltage failsafe to software setup

Blue Robotics Battery Calculator

I am trying to use the battery calculator on the Blue Robotics website and it is not working. I have tried using 2 different computers and it is not working on either. I used this tool about 2 months ago and it was working but now I cannot get it to work.

Thank you

Font size too small

Hi, I realized that I was reading the documentation using browser's zoom at 140% and I thought that maybe you would like to get this kind of feedback.

There are several guidelines (like this, this and this) that suggests that the ideal size for the content text is around 16px and now it seems to be 10px.

Thank you

Add note not to touch face of bar100

It is pretty easily deformed, the metal face is very thin.

Motors won't spin

Hello,
I purchased 6 of your new model of ESCs and have them connected to a pixhawk with ardusub firmware 3.5.2 stable version git revision 07f2d5ac, which is connected over usb to an nvidia jetson tx2 which is running mavproxy to connect over ethernet to a laptop running qground control, which has a logitech f310 controller plugged in. I am able to arm and disarm the controller with the start and select buttons but when I move the joysticks the motors do not spin. Do the ESCs need calibrated? I have tested them with a servo tester and they all work fine and spin the motors, but they don't work when connected to pixhawk. Any help would be great, thanks!

Update battery selection for BROV2

http://docs.bluerobotics.com/battery/

Update battery pictures to R2

Water tight enclosure

Hi, It would be really helpful for marine robotics researchers if you could widen your catalogue of water tight enclosures with increased OD. I require an enclosure with OD of 10" and depth rating of 100m for one of my underwater robots. Thanks.

Broken Link

The following link isn't working:

Detailed Lithium-ion Storage Information

From the following page:
http://docs.bluerobotics.com/batteries/

Fix CI

*ahem*

Make sure we don't have any links to QGC website/download page

Clarify motor direction setup

Many miss this or mess it up.

Update BROV2 Camera in Assembly Doc

Update BOM to reflect that the Low-Light HD USB Camera is now standard instead of the RPI Cam 2.

Add missing cad models

Fathom ROV Tether connection to Fathom-X Tether Interface Board

Hey Good Evening,

We are in college. Doing a ROV project. So we ended up buying most of the electronic components individually. And now we are having trouble wiring the whole system.

The obstacle we are facing currently is, understanding tether's end wires. What are their applications? More specifically, how would I connect the tether to the fathom-X board?

We also tried researching more about schematic diagram of the the whole blueROV2. We couldn't pinpoint a single reliable source so far. from 2018 we found a discussion with the same problem. But the solution page/website no longer exists.

Any help is greatly appreciated.
Thank you.

something about how to use VS2012 to run the ROV2’s control program

Dear designer:
Firstly,i want know where i can get the ROV2's control program.
Secondly,i want know how to use VS2012 to run it.
that's all.
thank you.

brov2: add windows game center doc for center joystick button

Resolve this type of thing: https://discuss.bluerobotics.com/t/joystick-function/2702

Remove references to Standard BlueROV2

BROV2 kit assembly page difficult to view

The text on the page bounces around for a couple of minutes as all of the many images load.

We should compress/resize the images so they load faster, or have the image containers initialize to the correct height before the image is loaded.

Pressure/Depth calculator doesn't work

http://docs.bluerobotics.com/calc/pressure-depth/?waterType=fresh#learn-more

Does not show output

Doc: add hardware minimum requirements for QGC

ROV

Hi,

You have mentioned that the ROV has 200 thrusters. But in the image it shows T100 propellers. so actually what are the thrusters you used for the blue ROV.

New I2C adress after update

default I2C address for the blueESC is 0x29

after update the firmware with the "blueesc_id1.hex" file, it would be intuitive that the new I2C address should be 0x01... but in reality it is : 0x29 + 1 = 0x2A !

You may add this unwritten rule to the documentation page to avoid some pain (and panic) to the futur users :)

To find the address of an unknown BlueESC we have made the following code that we are happy to share with the community

I2CSeekAddress.zip

Thank you for your beautiful motors :)

No 'TX mode' selection available in QGroundControl

In the 'Joystick/Gamepad Calibration' Step of the manual, step 2 states:

Ensure the ‘TX Mode’ selection is set to 3

In QGroundControl v3.1.3 there is no TX Mode selection GUI element.

Doc hasn't a detailed description of LED indicator light behavior?

No Links to Fathom Slim Docs From Main Page

There are no links to the Fathom Slim documentation on the docs.bluerobotics.com page nor in the nav bar.

BlueROV2 CAD files missing

The links to the CAD files here (http://docs.bluerobotics.com/brov2/) don't actually point to any CAD files.

BlueESC

The manual doesn't explain what the red and blue LED's indicate on the integrated BlueESC. Also what does it mean when it beeps every few seconds?

I am able to read I2C data from the BlueESC but am unable to get prop spinning when writing I2C. Do you have any debug suggestions? Do you have to use PWM stop signal to activate motor, prior to being able to use I2C? I assume not? Do you have some I2C Python SBUS examples you could post to make sure I'm using your desired conventions? Thanks
[email protected]

Inconsistent documentation for thruster config

Inconsistent documentation for thruster config.

In the build instructions for the Bluerov, the thruster order is not the same as the thruster numbering on the ArduSub documentation site. Thrusters 1,2 and 3,4 are mismatched. This is in regards to the standard bluerov configuration.

Stickers should have cheap shipping

I wouldn't mind sporting a snazzy Blue Robotics sticker, but the shipping price is $8. You should consider charging a dollar or so and drop it in a first class envelope.

Git merge mess on Basic ESC R3 docs page

Messed up merge commit.

T200 Advance ratio

Hi friends:

I'm into a design that will use your T200 thruster. Albeit you've provided a lot of information, I'd like to know a few details about the testing conditions related to the published curves.

May I know which "free flow speed" was used for the Thrust curves plotting ? Or are those curves obtained in static conditions ?

I need that data in order to achieve some hidrodynamic goals.

Thanks in advance and ... kind regards

Pixhawk channel 7 already used

When assembling my ROV2 the instructions say to install the lumen control wire to channel 7 of the pixhawk. This channel is already used by what appears to be the camera servo. Can the lumen go into a aux port?

Link to Solidworks files not working

http://docs.bluerobotics.com/tutorials/cable-penetrator/

The .zip folder download links (all three) are not functioning.

Software setup - dependencies on Ubuntu 18.04

Software setup instructions, or else the QGroundControl appimage, should be updated for Ubuntu 18.04.

Attempted to run QGroundControl AppImage with a fresh install of Ubuntu 18.04 LTS. I found it was necessary to install two dependencies:

sudo apt-get install espeak (to get it to run at all)
sudo apt-get install gstreamer1.0-plugins-bad (for video to work)

OS was Ubuntu 18.04
QGroundControl version 3.2.4-BlueRobotics-Rev5