MAVLink Deserializer

The uint8 byte stream that contains serialized MAVLink packets. The byte stream is usually received over a communication channel such as UDP, TCP, or Serial. At each sample time, the communication channel receives data and returns a byte stream that contains one or more MAVLink packets. The byte stream can also return a MAVLink packet partially in over multiple sample times. This input port accepts variable-length signals.

Data Types: uint8

Optional input port to include the length of valid MAVLink data. To enable this port, select the Input data stream length is available parameter. Use this option when you know the exact length of the valid MAVLink data in the data stream.

This option is useful when you have a communication channel receive peripheral that outputs partially received data that contains trailing zeros. Such peripherals also output the length of the actual number of valid data bytes received. You can connect the length output of the peripheral directly with the Length input port of MAVLink Deserializer block, so that trailing zeros in the input byte stream do not affect the decoding logic.

Data Types: uint16

New MAVLink message indicator returned as a logical. A value of 1 indicates that a new message is available since the last sample was received by the block. This output can be used to trigger subsystems to process new messages received from the MAVLink Deserializer block.

Data Types: Boolean

MAVLink packet, returned as a nonvirtual bus. The type of Payload in the MAVLink packet is a Simulink bus corresponding to the MAVLink message specified in the MAVLink message type parameter. The block outputs blank messages until it receives a message on the message name that you specify. The Msg port outputs this new message. If a new message is not available, it outputs the last received MAVLink message. If a message has not been received since the start of the simulation, Msg port outputs a blank MAVLink message.

Data Types: bus

Source for specifying the MAVLink message definition XML name, specified as one of the following:

MAVLink message definition file (.xml) to parse for MAVLink messages, specified as a string.

If the MAVLink dialect source parameter is set to Select from standard MAVLink dialects, you need to select a message definition among the available message definition names from the dropdown list.

If the parameter MAVLink dialect source parameter is set to Specify your own, you need to specify the message definition file (.xml) that is on the current MATLAB path, or you can provide the full path of the XML file.

MAVLink protocol version that the block uses to serialize and deserialize the MAVLink messages.

MAVLink message, specified as a string. Click Select to select from a full list of available MAVLink messages. The list varies based on the values that you selected for MAVLink dialect and MAVLink version parameters.

Data Types: string

When you select this option, the MAVLink Deserializer block provides an additional input port called Length. This input port can be used to pass the actual length of MAVLink data (if known) in the input byte stream. The input byte stream is cropped for this length.

This option is useful when you have a communication channel receive peripheral that outputs partially received data that contains trailing zeros. Such peripherals also output length of the actual number of valid data bytes received. You can connect the length output of the peripheral directly to the Length input port of MAVLink Deserializer block so that trailing zeros in the input byte stream do not affect the decoding logic.

Select this option to filter the received MAVLink messages for the System ID value mentioned in the System ID parameter. This option helps you to filter the received messages by both System ID and Component ID.

Specify the System ID value to use while filtering the decoded MAVLink messages. The block outputs the received MAVLink messages whose System ID matches the specified value and whose Message ID matches the MAVLink message (selected in the MAVLink Message type parameter).

Dependencies

To enable this parameter, select Filter Output MAVLink messages by System ID.

Select this option to filter the received MAVLink messages for the both the System ID and the Component ID mentioned in the System ID and Component ID parameters, respectively.

Dependencies

This parameter appears only if you select the Filter output MAVLink messages by System ID parameter.

Specify the Component ID value to use while filtering the decoded MAVLink messages. The block outputs those received MAVLink messages whose System ID and Component ID values match the specified values in the System ID and Component ID parameters, respectively, and whose Message ID matches the MAVLink message (selected in the MAVLink Message type parameter).

Dependencies

To enable this parameter, select Filter Output MAVLink messages by Component ID.

Select this option to output messages using the first-in-first-out pattern. If you do not select this option, the MAVLink Deserializer block outputs the latest received MAVLink message for the selected MAVLink message type (and with matching System ID and Component ID if those parameters are selected) at each simulation step. If more than one message matches the given parameters that are received in a simulation step, the latest message is passed as output, and the rest are discarded. You can reverse this behavior by selecting this option.

When you select this parameter, the behavior of the MAVLink Deserializer block at each simulation step is:

Selecting the Queue MAVLink messages in output parameter makes the Number of messages to be queued parameter visible. You can fix the size of the queue by setting the value of this parameter.

Specify the size of the queue to be used to store the received MAVLink messages matching the desired parameters.

Dependencies

To enable this parameter, select Queue MAVLink messages in output.