mavlinkclient

MAVLink client information

Description

The mavlinkclient object stores MAVLink client information for connecting to UAVs (unmanned aerial vehicles) that utilize the MAVLink communication protocol. Connect with a MAVLink client using mavlinkio and use this object for saving the component and system information.

Creation

Syntax

client = mavlinkclient(mavlink,sysID,compID)

Description

client = mavlinkclient(mavlink,sysID,compID) creates a MAVLink client interface for a MAVLink component. Connect to a MAVLink client using mavlinkio and specify the object in mavlink. When a heartbeat is received by the client, the ComponentType and AutoPilotType properties are updated automatically. Specify the SystemID and ComponentID as integers.

Input Arguments

mavlink — mavlink client connection

mavlinkio object

mavlink client connection, specified as a mavlinkio object

sysID — MAVLink system ID

nonnegative integer between 0 and 255

MAVLink system ID, specified as a nonnegative integer between 0 and 255. MAVLink protocol only supports up to 255 systems. Usually, each UAV has its own system ID, but multiple UAVs could be considered one system.

Example: 1

Data Types: numeric

compID — MAVLink component ID

nonnegative integer between 0 and 255

MAVLink component ID, specified as a nonnegative integer between 0 and 255.

Example: 2

Data Types: numeric

Properties

SystemID — MAVLink system ID

positive integer between 1 and 255

MAVLink system ID, specified as a positive integer between 1 and 255. MAVLink protocol only supports up to 255 systems. Usually, each UAV has its own system ID, but multiple UAVs could be considered one system.

Example: 1

Data Types: uint8

ComponentID — MAVLink component ID

positive integer between 1 and 255

MAVLink component ID, specified as a positive integer between 1 and 255.

Example: 2

Data Types: uint8

ComponentType — MAVLink component type

"Unknown" (default) | string

MAVLink component type, specified as a string. This value is automatically updated to the correct type if a heartbeat message is received by the client with the matching system ID and component ID. You must be connected to a client using mavlinkio.

Example: "MAV_TYPE_GCS"

Data Types: string

AutoPilot — Autopilot type for UAV

"Unknown" (default) | string

Autopilot type for UAV, specified as a string. This value is automatically updated to the correct type if a heartbeat message is received by the client with the matching system ID and component ID. You must be connected to a client using mavlinkio.

Example: "MAV_AUTOPILOT_INVALID"

Data Types: string

Examples

Store MAVLink Client Information

Connect to a MAVLink client.

mavlink = mavlinkio("common.xml");
connect(mavlink,"UDP");

Create the object for storing the client information. Specify the system and component ID.

client = mavlinkclient(mavlink,1,1)

client = 
  mavlinkclient with properties:

         SystemID: 1
      ComponentID: 1
    ComponentType: "Unknown"
    AutopilotType: "Unknown"

Disconnect from client.

disconnect(mavlink)

Version History

Introduced in R2019a