moveback
Add-On Required: This feature requires the MATLAB Support Package for Ryze Tello Drones add-on.
Syntax
Description
moveback(
moves the Ryze drone backwards by the specified options.droneObj
,Name,Value
)
moveback(
moves the Ryze drone backwards for the specified time and specified additional
options.droneObj
,duration
,Name,Value
)
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
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)