# XPlaneConnect Toolbox-readDATA

<-- Back

# readDATA

Reads UDP Socket and interprets data

## Inputs

- location: Either an opened UDP Socket or integer port number

## Outputs

If data is X-Plane data format:

- data: Matlab X-Plane DATA Structure
  - .h: Header array containing header numbers corresponding to values in the X-Plane UDP Data screen.
  - .d: 2-D Data array. Each row contains eight values corresponding to the header value (.h(1) corresponds to .d(1,:))
  - .raw: raw UDP data array received by readUDP

If data is matlab structure:

- data: Matlab Structure. Raw udp data saved to data.raw

If data is any other format:

- data: Matlab Structure containing one field
  - .raw & .d: raw UDP data array received by readUDP

## Use

1. import XPlaneConnect.*;
2. socket = openUDP(49005);
3. data = readDATA(socket);
4. status = closeUDP(socket);
or
1. import XPlaneConnect.*;
2. data = readDATA(49005);

## Note

NOTE: sending in a port number instead of an opened socket clears the UDP buffer. This only works if the data is being sent at a fast rate. Sending in a UDP Socket reads the first packet in the buffer.

## Change Log

10/02/14: [CT] V0.9: Updated to work with updated xpcPlugin
09/10/13: [CT] Updated to receive UDP socket or port number
06/10/13: [CT] Code created
<-- Back