Table of Contents
Advertisement
24 GHz radar tools and development environment
XENSIV™ 24 GHz radar demo boards
4 Extracting radar raw data
4
Extracting radar raw data
The 24 GHz radar demo boards can use different interfaces, enabling the user to fetch raw data from the radar
board as follows:
MATLAB radar system interface
•
C radar system interface
•
UART radar system library interface
•
Supported radar communication libraries define a set of APIs to guarantee the data transfer through the host
communication protocol.
4.1
Radar host communication protocol
The communication protocol is a generic protocol to exchange messages with microcontroller-based devices
over a generic byte-stream connection (typically a virtual serial port via USB). The communication is always
initiated by the host, while the connected microcontroller device responds to messages received from the host.
The protocol defines two types of messages:
Payload messages – contain a block of data with arbitrary size and meaning
•
Status messages – contain a 16-bit status code
•
Messages from the host to the device are always payload messages. Whenever the device receives a payload
message from the host, it responds with one (and only one) status message. The device may also send an
arbitrary number of additional payload messages proceeding that status message. Once the device has sent
the status message, it will not send any more messages until it receives a new message from the host.
Each message from the host to the device is addressed to a certain logical endpoint, and each message from
the device to the host is sent from a logical endpoint. The number of logical endpoints is defined by the device.
Endpoints are used to define functional groups in the device and are continuously enumerated starting with 1.
At least one logical endpoint is always present. Each logical endpoint is of a defined type, which defines the
meaning of the message payload exchanged with that endpoint.
Additionally, each endpoint has a version number that allows it to distinguish between slight modifications of
the endpoints' set of known messages. The host can query the type and version of the endpoints present in the
device.
All data received from the connected device is returned through callbacks. For each message type that can be
received from the device, a separate callback function type is defined.
Within the 24 GHz radar firmware project, the host communication library contains the USB interface on host
communication protocol drivers.
4.2
MATLAB radar system interface
The MATLAB application interface defines a set of APIs and functions that help the user access a serial
communication port and communicate with the radar-defined endpoints, enabling the user to extract the raw
IF data from the radar module via the USB interface to the PC/laptop for further signal processing.
Please refer to /Firmware_Software/Communication
Library/ComLib_Matlab_Interface/RadarSystemDocumentation for more details about the interface's set of
classes and functions that can be used to control the 24 GHz radar board via MATLAB.
User manual
23
Revision 1.40
2023-02-14
Advertisement
Table of Contents
