| .. | ||
| AP_State.cpp | ||
| APM_Config_mavlink_hil.h | ||
| APM_Config.h | ||
| ArduSub.cpp | ||
| arming_checks.cpp | ||
| Attitude.cpp | ||
| baro_ground_effect.cpp | ||
| capabilities.cpp | ||
| commands_logic.cpp | ||
| commands.cpp | ||
| compassmot.cpp | ||
| compat.cpp | ||
| config.h | ||
| control_acro.cpp | ||
| control_althold.cpp | ||
| control_auto.cpp | ||
| control_autotune.cpp | ||
| control_brake.cpp | ||
| control_circle.cpp | ||
| control_drift.cpp | ||
| control_flip.cpp | ||
| control_guided.cpp | ||
| control_land.cpp | ||
| control_loiter.cpp | ||
| control_poshold.cpp | ||
| control_rtl.cpp | ||
| control_sport.cpp | ||
| control_stabilize.cpp | ||
| crash_check.cpp | ||
| defines.h | ||
| ekf_check.cpp | ||
| esc_calibration.cpp | ||
| events.cpp | ||
| failsafe.cpp | ||
| fence.cpp | ||
| flight_mode.cpp | ||
| GCS_Mavlink.cpp | ||
| inertia.cpp | ||
| land_detector.cpp | ||
| landing_gear.cpp | ||
| leds.cpp | ||
| Log.cpp | ||
| make.inc | ||
| Makefile | ||
| Makefile.waf | ||
| motor_test.cpp | ||
| motors.cpp | ||
| navigation.cpp | ||
| Parameters.cpp | ||
| Parameters.h | ||
| Parameters.pde | ||
| perf_info.cpp | ||
| position_vector.cpp | ||
| precision_landing.cpp | ||
| radio.cpp | ||
| README.md | ||
| readme.txt | ||
| ReleaseNotes.txt | ||
| sensors.cpp | ||
| setup.cpp | ||
| Sub.cpp | ||
| Sub.h | ||
| surface_bottom_detector.cpp | ||
| switches.cpp | ||
| system.cpp | ||
| takeoff.cpp | ||
| test.cpp | ||
| tuning.cpp | ||
| UserCode.cpp | ||
| UserVariables.h | ||
| wscript | ||
ArduSub 
An ArduPilot-based project for remotely operated underwater vehicles.
Intro
The ArduSub project is a subsea vehicle control system designed primarily for ROVs and AUVs. It is based on the ArduCopter vehicle-type of the ArduPilot project.
The majority of code changes required for the ArduSub are held in the /ArduSub/ directory of this repository. Changes have also been made to a number of libraries:
- AP_Baro: Added support for MS58XX pressure sensors for water depth measurement
- AP_Motors: Added AP_Motors6DOF, AP_MotorsBlueROV6DOF, AP_MotorsVectoredROV classes
- AP_RCMapper: Added "forward" and "strafe" input axes
Setup
Hardware
The ArduSub project currently supports the following hardware:
- 3DR PixHawk Autopilot
- Any reversible ESCs with PWM control and 1500 centerpoint (Blue Robotics Basic ESC and BlueESC)
Since this is based on the ArduPilot project and includes the ArduPilot Hardware Abstration Layer (HAL), it should also be able to run on a number of other autopilots including the following:
- PixHawk variants (PXRacer, PX4V4)
- Navio+, Navio2 from Emlid
- Erle Brain 2 and PXFmini from Erle Robotics
- BBBmini
The following autopilots are not supported:
- APM 1 through APM 2.6+
Topside Control Software
The ArduSub project currently only supports topside control through QGroundControl using compatible joysticks and gamepad controllers. Please be sure to use the most recent daily build for bug fixes and improvements.
ROV Frame
The ArduSub project currently supports two frame types:
- 6-DOF Thruster Configuration (for the BlueRobotics BlueROV)
- Vectored Thruster Configuration with side-by-side vertical thrusters
The code must be compiled for the correct frame type using the commands below.
Compilation and Flashing
Please refer to the ArduPilot documentation for basic instructions on building the code.
To compile the ArduSub branch, first cd ArduSub to enter the directory and then use one of the following commands.
| Command | Function |
|---|---|
make px4-v2-bluerov |
Compile for BlueROV thruster configuration |
make px4-v2-vectored |
Compile for vectored thruster configuration |
Add -upload to the end of the make target to upload. For example:
make px4-v2-vectored-upload
Initial Setup
- Compile and upload firmware to the autopilot
- Open QGroundControl
- Calibrate gamepad with throttle and yaw on right stick, pitch and roll on left stick.
- Set to "full down is zero throttle"
- Calibrate radio using the joystick with the same inputs.
- Change parameters:
- DISARM_DELAY to 0
- ARMING_CHECK to Disabled
- BRD_SAFETYENABLE to Disabled
- AHRS_ORIENTATION to Roll90 (or applicable orientation)
- ATC_ACCEL_Y_MAX to Disabled
- EK_ALT_NOISE to 0.1
- RATE_YAW_FILT_HZ to 30
- PILOT_VELZ_MAX to 50 cm/s
- PILOT_ACCEL_Z to 50 cm/s/s
- POS_Z_P to 8.0 (above limit)
- GND_PRIMARY to 2ndBaro
- Setup Power Tab
- Analog Voltage and Current
- 10000 mAh
- Power Sensor: Other
- Current pin: Pixhawk
- Voltage pin: Pixhawk
- Voltage multiplier: 9.174
- Amps per volt: 14.70
- Flight Modes
- Set all to stabilize
- Set Flight Mode 6 to altHold (Learning mode)
- Set Up Camera Tilt (if desired)
- Use camera tab to connect RC8 to Output Channel 7
- Connect camera tilt servo or gimbal to Ch. 7
- Set up Lights
- Use camera tab to connect RC9 to Output Channel 8
- Set range to 1100-1900
- Connect lights PWM signal to Ch. 8
Operation
The gamepad controls the ROV during operation. It has been tested with the Microsoft XBox controller and the Logitech F310. The following joysticks and buttons are used:
- Left Stick: Forward and strafe input
- Right Stick: Throttle and yaw input
- Start Button: Arm vehicle
- Back Button: Disarm vehicle
- Y Button: Switch to althold (learning) mode
- B Button: Switch to stabilize (manual) mode
- Right Bumper: Increase light brightness
- Left Bumper: Decrease light brightness
- Buttonpad Up/Down Arrows: Tilt camera (if applicable and set up in QGC)
- Buttonpad Left/Right Arrows: Increase/decrease roll trim (if IMU is not completely level)
- Left Joystick Click: Reset camera tilt angle
Modes
In Stabilize (manual) mode, the ROV will attempt to remain level and will be easily controllable. Constant attention is needed to maintain depth.
In Althold (learning) mode, the ROV will stabilize and also hold its depth. Throttle input will cause the vehicle to ascend or descend and releasing the throttle will cause it to hold its current depth.
How To Get Involved
The ArduSub project is open source and we encourage participation and code contributions: guidelines for contributors to the ardupilot codebase.
Desired Enhancements and Bugs can be posted to the issues list.