moveback

Move Ryze drone backwards

Since R2020a

Add-On Required: This feature requires the MATLAB Support Package for Ryze Tello Drones add-on.

Syntax

moveback(droneObj)

moveback(droneObj,Name,Value)

moveback(droneObj,duration)

moveback(droneObj,duration,Name,Value)

Description

moveback(droneObj) moves the Ryze drone backwards.

moveback(droneObj,Name,Value) moves the Ryze drone backwards by the specified options.

moveback(droneObj,duration) moves the Ryze drone backwards for the specified time.

moveback(droneObj,duration,Name,Value) moves the Ryze drone backwards for the specified time and specified additional options.

Examples

Move Ryze Drone Backwards

Connect to a Ryze drone.

droneObj = drone("Tello")

droneObj = 
          ryze with properties:

                    Name: "Tello"
                      ID: "TELLO-D2B07B"
               IPAddress: "192.168.10.1"
                   State: "landed"
            BatteryLevel: 50%
             StationMode: 0
        AvailableCameras: ["FPV"]

Use takeoff to initiate takeoff of the drone.

takeoff(droneObj)

While the Ryze Tello drone is hovering, move the drone backwards for the default duration of 0.5 seconds.

moveback(droneObj)

Move Ryze Drone Backwards by a Specified Distance

Connect to a Ryze drone.

droneObj = drone("Tello")

droneObj = 
          ryze with properties:

                    Name: "Tello"
                      ID: "TELLO-D2B07B"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]
 

Use takeoff to initiate takeoff of the drone.

takeoff(droneObj)

While the Ryze Tello drone is hovering, move the drone back by 2m while unblocking MATLAB^® Command Line.

moveback(droneObj,'Distance',2','WaitUntilDone',false)

Move Ryze Drone Backwards for Specified Duration

Connect to a Ryze drone.

droneObj = drone("Tello")

droneObj = 
          ryze with properties:

                    Name: "Tello"
                      ID: "TELLO-D2B07B"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]
 

Use takeoff to initiate takeoff of the drone.

takeoff(droneObj)

While the Ryze Tello drone is hovering, move the drone backwards for 5 seconds.

moveback(droneObj,5)

Move Ryze Drone Backwards for Specified Duration and Speed

Connect to a Ryze drone.

droneObj = drone("Tello")

droneObj = 
          ryze with properties:

                    Name: "Tello"
                      ID: "TELLO-D2B07B"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]
 

Use the droneObj to initiate takeoff of the Ryze drone.

takeoff(droneObj)

While the Ryze Tello drone is hovering, move the drone backwards for 5 seconds and at a speed of 1 m/s.

moveback(droneObj,5,'Speed',1)

Input Arguments

droneObj — Ryze drone connection

drone object

Ryze drone connection object, specified as a droneObj.

duration — Duration in seconds

0.5 (default) | positive real scalar

The time for which the Ryze drone moves back, specified in seconds.

Data Types: double

Name-Value Arguments

Example: moveback(obj,‘Distance’,0.5,‘Speed’,0.4,‘WaitUntilDone’,true);

Specify optional comma-separated pair of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Note

Specify either duration or Distance to control the drone.

Distance — Relative distance in meters

0.2 (default) | scalar in the range [0.2,5]

The relative distance (in meters) at which drone must move, specified as a double.

Data Types: double

Speed — Speed of drone in m/s

0.4 (default) | scalar in the range [0.1,1]

The speed which the drone must move, specified as a double.

Data Types: double

WaitUntilDone — Mode of operation

true (default) | false

Mode of operation for the moveback command, specified as logical value of true or false.

WaitUntilDone is true by default and blocks MATLAB command line execution until the current move command runs to completion. If WaitUntilDone is set to false, the MATLAB command line is unblocked, while the previous move command is still in progress.

Note

The Ryze drone ignores any subsequent move commands that is executed before completion of the previous move command.

Data Types: logical

Version History

Introduced in R2020a