parrot

Connection to Parrot drone

Since R2019a

Description

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

Note

MATLAB Support Package for Parrot Drones supports only the Parrot shipped factory firmware. To restore the original firmware, see Restore Original Firmware.

Creation

Syntax

parrotObj = parrot

parrotObj = parrot(droneName)

parrotObj = parrot(droneID)

Description

parrotObj = parrot connects to the first available Parrot drone over the wireless network.

parrotObj = parrot(droneName) connects to the Parrot drone with the specified name over the wireless network.

parrotObj = parrot(droneID) connects to a Parrot drone with a specific ID over the wireless network.

Input Arguments

droneName — Name of the Parrot drone

string

Name of the Parrot drone.

Parrot Drones	String used to create the parrot object
Parrot Mambo FPV	'Mambo'
Parrot Bebop 2	'Bebop2'

droneID — Unique ID of the Parrot drone

string

ID of the Parrot drone.

Properties

Name — Name of drone

string

Name of the connected Parrot drone, specified as a string.

Example: "Mambo"

Data Types: string

ID — Unique ID of drone

string

The ID of the specific Parrot drone returned as a string.

Example: "Mambo_564853"

Data Types: string

State — Piloting state of drone

landed | landing | takingoff | hovering | emergency | flying | initializing

This property is read-only.

The piloting state of the Parrot drone, specified as a string.

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, specified as a percentage.

Example: 50%

Data Types: double

AvailableCameras — Available cameras of drone

"FPV"

Available cameras of drone, specified as a cell array

Example: ["FPV"]

Data Types: struct

Object Functions

The object functions are used to interact with your Parrot drone

abort	End flight of Parrot drone
flip	Flip Parrot drone in specified direction
land	Land Parrot drone
move	Move Parrot drone in all six directions
moveback	Move Parrot drone backwards
movedown	Move Parrot drone down
moveforward	Move Parrot drone forward
moveleft	Move Parrot drone left
moveright	Move Parrot drone right
moveup	Move Parrot drone upwards
readHeight	Read current height of Parrot drone
readOrientation	Read Euler angles of Parrot drone
readSpeed	Read speed of Parrot drone
takeoff	Initiate Parrot drone takeoff
turn	Turn Parrot drone at specified angle

Examples

Connect to Parrot Drone

Connect to a Parrot drone.

parrotObj = parrot()

parrotObj = 
          parrot with properties:

                    Name: "Mambo"
                      ID: "Mambo_564853"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]

Connect to Specific Parrot Drone

Connect to a Parrot Mambo FPV drone over a wireless network.

parrotObj = parrot('Mambo')

parrotObj = 
          parrot with properties:

                    Name: "Mambo"
                      ID: "Mambo_564853"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]

Connect to Parrot Drone with Specific ID

Connect to a specific Parrot Mambo FPV drone with the ID over a wireless network.

parrotObj = parrot('Mambo_564853')

parrotObj = 
          parrot with properties:

                    Name: "Mambo"
                      ID: "Mambo_564853"
                   State: "landed"
            BatteryLevel: 50%  
        AvailableCameras: ["FPV"]

Version History

Introduced in R2019a