ryze

Connection to Ryze drone

Since R2020a

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

Description

This object represents a connection from MATLAB^® to the Ryze drone. To interact with the Ryze drone, use this object with the functions listed in the Object Functions.

Creation

Syntax

droneObj = ryze()

droneObj = ryze(droneName)

droneObj = ryze(droneID)

droneObj = ryze(droneIP)

Description

droneObj = ryze() connects to the first available Ryze drone over the wireless network.

droneObj = ryze(droneName) connects to the Ryze drone with the specified name over the wireless network.

droneObj = ryze(droneID) connects to a Ryze drone with a specific ID over the wireless network.

droneObj = ryze(droneIP) connects to a Ryze drone with a specific IP address.

Input Arguments

droneName — Name of the Ryze drone

"Tello" | "TelloEDU"

Name of the Ryze drone.

droneID — Unique ID of the Ryze drone

string

ID of the Ryze drone.

droneIP — The IP address of the Ryze drone

string

IP address of the Ryze drone.

Properties

Name — Name of drone

string

This property is read-only.

Name of the connected Ryze drone, returned as a string.

Example: "Tello"

Data Types: string

ID — Unique ID of drone

string scalar

This property is read-only.

The ID of the specific Ryze drone returned as a string scalar.

Example: "TELLO-D2B07B"

Data Types: string

IPAddress — IP address of Ryze Tello drone

string scalar

IP address of the Ryze Tello drone returned as a string scalar.

Example: r = ryze('192.168.10.15') creates a connection to an Ryze Tello drone that uses the IP address 192.168.10.15.

Data Types: string

State — Piloting state of drone

"Landed" | "Hovering" | "Flying"

This property is read-only.

The piloting state of the Ryze drone, returned as a string. The value of State does not change if the drone crash lands or force lands due to low battery.

Example: "Landed"

Data Types: string

BatteryLevel — Current battery level of drone

non negative integer

This property is read-only.

Current battery level of the drone, returned as a percentage.

Example: 50%

Data Types: double

StationMode — Station mode connection status

true or 1 | false or 0

This property is read-only.

Drone's station mode status, returned as numeric or logical 1 (true) or 0 (false).

Data Types: logical

AvailableCameras — Available cameras of drone

"FPV" | []

This property is read-only.

Available cameras of drone, returned as an array of strings. If the drone is in station mode, an empty array is returned.

Example: ["FPV"]

Data Types: string

Object Functions

The object functions are used to interact with your Ryze drone

abort	End flight of Ryze drone
flip	Flip Ryze drone in specified direction
land	Land Ryze drone
move	Move Ryze drone in all three axes
moveback	Move Ryze drone backwards
movedown	Move Ryze drone down
moveforward	Move Ryze drone forward
moveleft	Move Ryze drone left
moveright	Move Ryze drone right
moveup	Move Ryze drone upwards
readHeight	Read current height of Ryze drone relative to the takeoff surface
readOrientation	Read current orientation of Ryze drone in terms of Euler angles
readSpeed	Read current speed of Ryze drone
takeoff	Initiate Ryze drone takeoff
turn	Turn Ryze drone by a specified angle

Examples

Connect to Drone

Connect to a Ryze drone.

droneObj = ryze()

droneObj = 

  ryze with properties:

                   Name: "TelloEDU"
                     ID: "TELLO-D3EB8E"
              IPAddress: "192.168.10.1"
                  State: "landed"
           BatteryLevel: 95 %
            StationMode: 0
       AvailableCameras: ["FPV"] 

Connect to Specific Drone

Connect to a Ryze Tello drone.

droneObj = ryze("Tello")

droneObj = 
          ryze with properties:

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

Connect to Drone with Specific ID

Connect to a specific Ryze Tello drone with the ID.

droneObj = ryze("TELLO-D2B07B")

droneObj = 
          ryze with properties:

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

Connect to Drone with IP address

Connect to a specific Ryze Tello drone using its IPAddress.

droneObj = ryze("192.168.10.1")

droneObj = 

  ryze with properties:

                   Name: "TelloEDU"
                     ID: "TELLO-D3EB8E"
              IPAddress: "192.168.10.1"
                  State: "landed"
           BatteryLevel: 95 %
            StationMode: 0
       AvailableCameras: ["FPV"] 

You can also connect to a drone that is in station mode using its IP address. Identify the drone using the ryzelist function.

list = ryzelist

list =

  3×3 table

          ID            IPAddress       BatteryLevel
    ______________    ______________    ____________

    "TELLO-D2B07B"    "192.168.10.1"       92    
    "TELLO-D3EB8E"    "192.168.18.2"       94    
    "TELLO-D45AD2"    "192.168.18.9"       87    

Now connect to the third drone in the above table.

ryzeObj = ryze("192.168.18.9")

ryzeObj = 

  ryze with properties:

                   Name: "TelloEDU"
                     ID: "TELLO-D45AD2"
              IPAddress: "192.168.18.9"
                  State: "landed"
           BatteryLevel: 100 %
            StationMode: 1
       AvailableCameras: []

Drones set to station mode cannot access the drone camera. The AvailableCameras parameter is returned as empty.

Version History

Introduced in R2020a