HomeGuides
Log In
Guides

Vehicle profiles

In the Main menu section Profiles are listed all the base and custom vehicle profiles of UgCS.
In the left column is a list of all vehicle profiles and the button to 'Create new' profile from scratch. On the right, all vehicle profile block cards are listed.

Vehicle profiles parameters

ParameterDescriptionMandatory
Main section Yes
Vehicle profile nameUser-defined vehicle profile nameYes
TypeVehicle type (helicopter, multicopter, fixed-wing)Yes
PlatformChoose a vehicle platform from the available variablesYes
PayloadsEdit available payloads for the vehicle profileYes
Battery section
Charged battery voltageBattery fully charged at voltage, V, shown as 100%. The voltage value shown in white color if between this voltage and normal voltage.Yes
Normal battery voltageNormal battery voltage V. Voltage value shown in white if at or above this voltage, shown in yellow if below this voltage.Yes
Low battery voltageLow, but sufficient voltage, V. Voltage value shown in yellow if at this voltage or between low and normal voltage. The voltage value shown in red if below this voltage.Yes
Discharged battery voltageBattery zero level, V, is shown as 0%. Shown in red.Yes
Normal battery power level*, %Normal battery level, percentage. Value in percent is shown in yellow if below this value.No
Low battery power level**, %Low battery level, percentage. Value in percent is shown red if below this value.No
Battery weightBattery weight, kgYes
GPS section
Normal number of GPS satellitesThe normal number of satellites provides a good level of accuracy. Shown in white color if at or above this level. The number of satellites shown in yellow color if below this level and between normal and low levels.Yes
Low number of GPS satellitesThe low number of GPS satellites while still being enough to launch the vehicle. The number of satellites shown in yellow color if at this level or between this and the normal level. The number of satellites shown in red color if below this level.Yes
Telemetry section
Normal telemetry levelNormal telemetry level. The telemetry level value is shown in white color if at or above this level. The telemetry level value is shown in yellow color if below this level and between normal and low levels.Yes
Low telemetry levelLow telemetry level. Telemetry level value is shown in yellow color if at this level or between this and normal level. Telemetry level value is shown in red color if below this level.Yes
Routing section
Max. waypointsMaximum supported WPs by the flight controllerYes
Waypoint acceptance radius3D distance of the vehicle from the approach waypoint is sufficient to consider the point as reached. Please refer to autopilot documentation to check the applicability of this parameter.Yes
Max altitude AMSLMaximum allowed altitude AMSL, mYes
Max altitude AGLMaximum allowed altitude AGL, mYes
Maximum Rangefinder distance, mThe maximum altitude, the rangefinder can be used from. See the rangefinder’s manual to set this parameter correctly.Yes
Fence radiusRadio link range radius, mYes
Maximum travel timeMaximum flight time in secondsYes
Safe height over terrainMinimal allowed distance to terrain for the vehicle, m. Small vehicles can fly very close to terrain but larger ones should fly higherYes
Safe distance to obstacleMinimal allowed distance to obstacles for the vehicle, mYes
Max. climb rateMaximum climb speed of copters for take-off waypoints, m/sYes
Max. descent rateMaximum descent rate of copters for landing waypoints, m/sYes
Max. horizontal speedMaximum horizontal speed, m/sYes
Default climb rateDefault climb speed of copters for take-off waypoints, m/sYes
Default descent rateDefault descent rate of copters for landing waypoints, m/sYes
Default horizontal speedDefault horizontal speed relative to the ground, m/s
Used as default speed for route segments and for Click & Go mode.
Yes
Initial speedDefault speed from the home point to the route's first point, the continuing point of the route (also if checked "Take-off to route's first waypoint", m/s
By default - 5m/s
Yes
Corner radiusControls the curvature of the path in case the route contains Adaptive Bank Turn waypoints. By default - 20mYes
Fixed-wing section***
Glide slope, %Default glide slope, %
Applicable for the planes
Yes
Airspeed during landing approachAirspeed for fixed-wing aircraft when approaching landingNo
Landing ground speed, m/sPlane ground speed in the last flight segment to the landing point, m/s
Applicable for planes and not used for multirotor
Yes
Landing flare altitudeAltitude in meters at which Landing Flare will be engaged, this parameter is secondary to the landing flare time parameterNo
Landing flare timeTime in which fixed-wing aircraft should reach the ground during landing when landing flare will be engaged, motors stopped, and heading lockedNo
Minimum landing pitchMinimum pitch in ° during final landing stage (after flare), the algorithm will control pitch above this value to achieve proper sink rateNo
Controller sink rate to pitch gain during flareSink rate gain for pitch demand during final landing stage, m/°No
Weighting applied to speed control during landingA value closer to 2 will result in the plane ignoring height error during landing (will keep the nose up), and a value closer to 0 results in the plane ignoring speed error (use with caution, could result in plane stall)No
Maximum pitch in auto flightControls maximum pitch in ° during the automatic mode, Rage: 0 to 45°, if set to zero, Maximum pitch parameters will be usedNo
Maximum pitchThe maximum commanded pitch-up angle, Range: 0 to 90°No
Minimum throttleMinimum throttle setting in % which Autopilot will apply. For the final landing stage, this is ignoredNo
Landing sink rate (final stage)The sink rate in meters/second for the final landing stage. Range: 0.0 to 2.0No
Enable rangefinder for landingEnables the use of a rangefinder for automatic landing. The rangefinder will be used both on the landing approach and for the final flareNo
Minimum rangefinder distanceThe minimum distance in centimeters that the rangefinder can reliably readNo
Basic section****
Height****Vehicle height, mYes
Width****Vehicle width, mYes
Length****Vehicle length, mYes
Wind resistance****Maximum allowed wind speed, m/sYes
Dry take-off weight****Dry take-off weight, kgYes
Maximum take-off weight****Maximum allowed weight, kgYes

*Percentage displayed if supported by the vehicle. If the vehicle does not report the remaining charge as a percentage, the UgCS calculates the percentage based on the voltage values from the vehicle profile.

**Percentage displayed if supported by the vehicle. If the vehicle does not report the remaining charge as a percentage, the UgCS calculates the percentage based on the voltage values from the vehicle profile.

***Display section depends on the type of vehicle.

****Currently ignored and reserved for future versions.

Adding a New Vehicle Profile

Add a new vehicle profile by creating a new card and filling in the parameters.

Editing a Vehicle Profile

Edit a vehicle profile by clicking on the profile card and pressing the “Edit” button. There are a variety of different (3D) avatars for vehicles. Vehicle profile parameters can be edited here as well.

Note: Profile changing leads to a route convert procedure that can cause errors in some cases. If this occurs, a message as a notification will be displayed to choose to accept or cancel the changes.

Copying a Vehicle Profile

Copy an existing vehicle profile by selecting the profile and clicking on the 'Copy' button. It will create a duplicate of the selected profile with a '- Copy' suffix. Works the same as 'Edit' (see above), except it will save a new copy upon confirmation.

Deleting a Vehicle Profile

To remove the vehicle profile, select the profile and click 'Remove'.
Basic profiles can not be deleted. Basic profiles - are system profiles embedded into software installation.