Actions

An action is a specific task, operation, or set of activities that will be performed when the event (or group of events) has been accomplished. The actions box contains all the created actions.

The user can also rename the action with the name of their choice.

../../../_images/actions.png

Actions menu

When creating a new action it is possible to choose from one of the previously created on the system or to create a new one.

../../../_images/new_action.png

New action

  • To add an action already created, select the desired event and click Accept.

  • By default, when a new action is created, it is assigned with the consecutive ID.

    However, if the user wants to create a new action with a specific ID, the New action ID option can be “unlocked” by holding down lock until the process is fully completed (during the unlocking process this icon lock_progress is “painted”).

    Once unlocked (when it appears as lock_open), the user can assign the desired ID to the new action.

    Finally, click Create and the new action will be added.

../../../_images/new_automation_4.png

Automations menu - New action ID

Caution

When the user enters an ID that is already assigned to an action, the following confirmation message will appear:

../../../_images/new_automation_confirmation_message_action.png

Automations menu - New action confirmation message

Then, if the user presses ‘OK’, the existing action will be removed and a new action with the entered ID will be added.

The different types of actions that can be created are presented below.

Atmosphere calibration

This action allows the atmosphere calibration in the same way as shown in the Operational panel of Veronte Ops (for more information about atmosphere calibration, see Veronte Ops manual).

../../../_images/actions_atmosphere_calibration.png

Atmosphere calibration action

The following options can be configured:

  • Altitude: Actual MSL altitude. The user must choose between entering this value manually or selecting a system variable.

  • User current pressure: By enabling it, the static pressure will be read from the static pressure sensor during the specified time (Time to acquire mean).

  • Static pressure: If the above option is not enabled, the actual static pressure should be specified manually.

  • Temperature (OAT): Outside air temperature.

Change active sensor

This option allows changing the current selected and default sensors used as IMU (accelerometer and gyroscope) and dynamic pressure.

../../../_images/actions_change_sensor.png

Change active sensor action

  • Sensor type: Select the type of sensor to be changed with this action: accelerometer, gyroscope or dynamic pressure.

  • Def. Sensor: A default sensor must be chosen. If all selected sensors fail, the measurement value will be that of the default sensor.

  • add : By clicking here, users can add the selected sensors of their choice.

    ../../../_images/actions_change_sensor_select.png

    Change active sensor action - Select sensor

Note

The behavior of the default and selected sensors is the same as described in the Sensors section of this manual.

Command block

This action allows the user to configure a gimbal or to trim a radio controller.

Note

This action is disabled by default when Autopilot 1x is started. To activate it, the user have to create a gimbal block or an arctrim block (see more information about it in the Block Programs section of this manual).

../../../_images/actions_command_block_default.png

Command block action

Gimbal

When this action is triggered, the gimbal control is enabled. There are several control modes that are explained below.

../../../_images/actions_command_block_gimbal.png

Command block action - Gimbal

  • Commandable Id: Id of the commandable Gimbal block (users can look up this Id in the block to be commanded, in the Gimbal - Devices blocks of the Block Programs menu).

  • NED: Control using NED axis, defining the initial position through azimuth and elevation.

  • Vector: This control uses aircraft body axis. The initial position is defined through roll and tilt.

  • Vector NED: In this case the axis should have been defined in Arcade Axis of the Control menu.

  • Location: The gimbal will point towards the projection on the ground at the specified point.

  • Command mode: Gimbal control is done externally, e.g. via VCP commands.

ArcTrim

This action trims the radio controller, i.e sets as zero the current sticks positions.

../../../_images/actions_command_block_arctrim.png

Command block action - ArcTrim

  • Commandable Id: Id of the commandable ArcTrim block (users can look up this Id in the block to be commanded, in Arc Trim - Servos blocks of the Block Programs menu).

  • Update the arcade trim values: If this option si enabled, the stick is trimmed but not saved in the configuration. This means that if Autopilot 1x is restarted the trimming is lost.

  • Save the arcade trim values calculated: Trim values are stored for future flights.

Custom CAN TX

When this action is triggered, a previously configured CAN message is sent through the CAN bus. The message has to be configured in CAN Custom messages panel of the Input/Output menu.

Warning

As this automation is used to send a single message on demand, in its configuration in Custom Messages, the user has to set its period to -1. This way, this message will only be sent when this action is triggered.

../../../_images/actions_custom_can.png

Custom CAN TX action

The two parameters to configure in this action are:

  • Producer: The user has to specify where the custom message is located: CAN custom message 0, 1 or 2.

  • Custom Message: The number of the custom messages that will be sent.

Custom Serial TX

When this action is triggered, a previously configured serial message is sent through the serial port (RS232 or RS485). The message has to be configured in Serial custom messages panel of the Input/Output menu.

Warning

As this automation is used to send a single message on demand, in its configuration in Custom Messages, the user has to set its period to -1. This way, this message will only be sent when this action is triggered.

../../../_images/actions_custom_serial.png

Custom Serial TX action

The two parameters to configure in this action are

  • Producer: The user has to specify where the custom message is located: RS custom message 0, 1 or 2.

  • Custom Message: The number of the custom messages that will be sent.

DEM calibration

This option allows the calibration of the digital elevation model by setting the actual AGL value in the same way as shown in the Operational panel of Veronte Ops (for more information about DEM calibration click Veronte Ops manual).

../../../_images/actions_dem_calibration.png

DEM calibration action

Enable/Disable Wind Estimation

This action allows the user to enable or disable the wind estimation.

../../../_images/actions_wind_estimation.png

Enable/Disable Wind Estimation action

The following parameters can be configured:

  • Enable Wind Estimation: Enabled/Disabled.

  • Init: By enabling it, an initial wind vector can be set to a faster convergence of the estimation.

    • North, East, Down: Inital wind vector.

FTS-Activation

This action activate the flight termination system (FTS) bit.

../../../_images/actions_fts_activation.png

FTS-Activation action

In an Autopilot 4x, when two or more autopilots activate their FTS the arbiter can activate a safe system such as a parachute.

Feature

When this action is triggered, a position is stored in the desired variable. This position can be absolute or relative (in the figure below the current position of the aircraft would be saved):

../../../_images/actions_feature.png

Feature action

The following options should be configured:

  • Value: Specified the position to be stored, this position can be absolute or relative.

    • Absolute: The coordinates can be set in UTM, MGRS, Decimal Degrees or Degress º ” ‘. They are indicated through the latitude, longitude and altitude (being possible to define this last one with respect to the ellipsoid, WGS84, to the sea level, MSL or to the ground, AGL).

    • Relative: In this case, the position of the point is relative to another point. That point could be any platform fitted with an Autopilot 1x.

  • Save value in: The position has to be saved in an ‘Inflight Reference Point’.

  • Type: There are 2 types of features:

    • Fixed: Once the point has been generated it remains fixed.

    • No change: If the point has been created relative, it remains relative all the time.

      Note

      This option only appears when the position has been previously defined as Relative.

This action is very useful for storing the take-off point for later landing at the same place.

Format SD

Warning

This action will have irreversible effects on your Autopilot 1x. Formatting the SD card will delete important and mandatory files for the correct functioning of Autopilot 1x.

In order to recover a formatted, please contact the support team (create a ticket in the customer’s Joint Collaboration Framework; for more information, see Tickets section of the JCF manual).

This action will format the SD card, deleting the configuration and flight logs from it.

../../../_images/actions_format_sd.png

Format SD action

Go to

This action is used to make the aircraft go to a patch created by the user with the mission toolbar of Veronte Ops. For more information about the mission toolbar, take a look at the Veronte Ops manual.

../../../_images/actions_go_to.png

Go to action

In this action two parameters can be configured:

  • Select Point: To select point (patch), first define it in the Operation elements panel of the UI menu.

  • Icon and color: It is possible to change the appearance of the point, selecting an icon from the icon list and a color, so the user can identify easily the point linked to that automation.

Once the action is triggered, the vehicle will go to that patch. If the patch is on a route, the vehicle will follow the selected patch and then it will continue the route going to its adjacent.

Mode

The flight mode is changed to the one specified in this option.

../../../_images/actions_mode.png

Mode action

These modes have been created previously. See Modes - Control section, for more information about creating modes.

Obstacle avoidance

This action enables avoidance of any obstacle previously created in Veronte Ops (for more information, see Veronte Ops manual).

../../../_images/actions_obstacle_avoidance.png

Obstacle avoidance action

2 types of obstacles can be enabled:

  • Designated on map: By activating this option Veronte Autopilot 1x attempts to avoid all obstacles on the map which may include prisms, cylinders, etc., as well as aircraft received by ADS-B.

  • Detection sensor: Obstacles previously defined in Veronte Ops.

Output

This action is used to set an output value in a GPIO pin. The output pin must have been configured as a GPIO output (visit GPIO - Connections section of this manual).

../../../_images/actions_output.png

Output action

The user can select, in the drop-down menu, between a GPIO output or a virtual output. The virtual option works like a normal GPIO output, but physically this output is not in the autopilot. It is used, for example, with a CEX.

There are four possible output signals:

  • Off: Provides continuous 0V output.

  • On: Provides continuous 3.3V output.

  • Pulse: Provides 3.3V for the specified time and after that 0V.

  • Pulse off: Provides 0V for the specified time and after that 3.3V.

Periodical

This action is used to set a timer during a flight operation.

../../../_images/actions_periodical.png

Periodical action

The following parameters are configured:

  • Timer: This parameter is an identifier for the timer, so it can be used in an event for another automation.

  • Run: Sets the timer status:

    • Run: The timer will start.

    • Stop: The timer will be stopped. Another automation should be created to run it again.

  • Reset: When this action is active, the timer is reset to zero before starting to measure.

    • Stop + Reset: The timer will be stopped and set back to zero.

  • Type: These available options have been previously explained in Automations.

  • Mode: The difference between fixed delay and fixed period has been previously explained in Automations.

For a better understanding of this action, a set of examples are detailed below with possible combinations of the different options.

  • Run + Distance/Time + Continuous: When the action is triggered, the timer will be started and will measure distance/time from that instant until the moment when the autopilot is turned off (or until another automation acts on the same timer).

  • Run + Distance/Time + Fixed Delay/Period: Once the action has been triggered, the timer will start to measure a distance/time. Each time the value indicated in Period is reached, the event linked to this timer (in another automation) will be triggered.

    For example, if the user wants to take a photo each 25 meters, in a first automation, the timer should have Distance in the Type option and 25 meters in Period, then in the second automation, an event of type Timer is created (and linked with the timer before created), so each time the timer reaches 25 meters the event will be triggered and the action will be carried out.

  • Distance + Vector: The distance is measured in the direction indicated by the vector.

Phase

The flight phase is changed to the one selected in this action.

../../../_images/actions_phase.png

Phase action

These phases have been created previously. See Phases - Control section, for more information about creating phases.

Ports

This action allows the user to switch between 4 pre-set configurations defined in the Ports panel of the Communications menu.

../../../_images/actions_ports.png

Ports action

Run block program

When this action is triggered, the block program specified in the “Execute” label is executed.

../../../_images/actions_run_block_program.png

Run block program action

This action can run those programs that have the lightning icon in grey color as those programs with the lightning icon in black color run continously. For more information about programs, see section Block Programs.

../../../_images/grey_program.png

Grey lightning icon

Safety Bits

This action selects a predefined safety bits list.

../../../_images/actions_safety_bits.png

Safety Bits action

This list must be previously configured. For more information about this, see Safety bits - Safety section of this manual.

Select Arcade axis

The axes system of the aircraft is changed to one that has been previously created in the Arcade Axis panel of the Control menu.

../../../_images/actions_select_arcade_axis.png

Select Arcade axis action

Stick priority

The user can switch between the two priority tables of the Stick block (for more information about the stick block, see Block Programs section of this manual). By default priority table 0 is selected when Autopilot 1x starts.

../../../_images/actions_stick_priority.png

Stick priority action

Terrain obstacle

This action is used to cause the aircraft to climb when it is reaching the ground (normally an altitude of zero metres), acting in the same way as an obstacle, with a vertical repulsion.

Caution

  • This only prevents “vertical” collisions.

  • This option cannot be activated all the time because it will not allow the aircraft to land.

../../../_images/actions_terrain_obstacle.png

Terrain obstacle action

  • Enable/Disable: When this option is enabled, the ground + an offset (Distance) is considered an obstacle, in the same way as those that can be defined from Veronte Ops. For more information on obstacles, please refer to the Set Obstacle (Sphere item) - Mission section of the Veronte Ops user manual.

  • Distance: Establishes the distance between the ground and the edge of the imaginary obstacle. The repulsion generated will be inversely proportional to the distance of the uav to this edge, being maximum when the uav is directly over the edge.

Important

The distance at which the repulsion starts will be inversely proportional to the acceleration set in the “Obstacles/Geofencing” configuration tab of the Envelope block.

Track

This action is used to configure a hover/loiter route (depending if it is a multicopter or an airplane) for the platform. Besides, there exists an option to follow a moving object.

There are 3 different options for the Track action, selecting Disabled no action will have effect on the guidance. The others are explained below.

Position

The aircraft will loiter/hover in a selected point.

../../../_images/actions_track_position.png

Track action - Position

The following options are available:

  • Location:

    • Selecting Current will make the platform to hover over the position that the vehicle has when this action is triggered, or loiter around that point in a circular route.

    • The box Longitude, Latitude allows the user to select the point where the hover/loiter will be performed.

  • Loiter: It is also possible to select the direction of the loiter (Auto, Clockwise and Anticlockwise).

  • When Hover is selected the option Direct can be enabled.

    • If direct is enabled, the autopilot will calculate the control actions to reach the desired point based on the position error with that point.

    • If direct is disabled, the autopilot will trace a path to the desired point and calculate the necessary control actions for this ‘new route’.

  • Distance:

    • Distance + Loiter: In this case, distance indicate the radius of the loiter circular route.

    • Distance + Hover: This option allows the user to define an acceptance radius around the position of the hover center. If the UAV position is inside this circle, then Autopilot 1x considers it is hovering correctly and will keep the position. If the center of the hover changes its position and the UAV position is out of the hovering area, 1x will fly to the hovering center, and once it is inside the circle, the hover will start.

Follow Leader

The platform will follow a moving object.

../../../_images/actions_track_leader.png

Track action - Follow Leader

In this action the following parameters can be configured:

  • Leader: Here is selected the object to follow, e.g. Moving Object.

  • Distance to leader: Distance to leader over trajectory.

  • Distance between points: Leader route is generated by points separated by the distance specified here.

  • Offset: User can establish offset parameters related to trajectory in Body or NED coordinates.

Note

To configure correctly this automation, the user has to follow the next steps:

  • Configure Telemetry in Air and Ground units.

  • Configure the automation as desired.

User Log

An entry, previously configured in the User Log panel of the Telemetry menu, is added to the on-board log.

../../../_images/actions_user_log.png

User Log action

Variable

This action allows the user to select variables or enter values and store them in user variables.

../../../_images/actions_variable.png

Variable action

Yaw

When this action is triggered, the current yaw will be set to the one configured here.

../../../_images/actions_yaw.png

Yaw action

This action is useful when flying without a magnetometer, as the user can establish the current yaw value when it is known.