Wellcome to ARS548 SDK

Table of Contents

• Introduction
  • Usage
  • Receiving Raw Radar Data
    • Raw Radar Data Callback
  • Receiving Parsed Target Data from SDK

Introduction

ARS548 SDK includes everything you need in order to develop software applications interacting with Continental ARS 548 RDI. The SDK contains full documentation and three kind of sample programs, written in C, C++.

Attention

We believe that the information contained herein was accurate in all respects at the time of printing. ADAS Engineering cannot, however, assume any responsibility for errors or omissions in this text. Also note that the information in this document is subject to change without notice and should not be construed as a commitment by ADAS Engineering.

Usage

The typical usage flow of SDK functions is as follows:

• Initialization
  • Call Ars548_Init to initialize the SDK.

• Register callback functions

  When radar data packets are received, SDK will notify user via callback functions. There are two kinds of callbacks available:

  • Call Ars548_SetRadarMessageCallback to set a callback to get raw radar message data.
  • Call Ars548_SetTargetListCallback to set a callback to get parsed radar target info data from SDK.
• Start receiving
  • Call Ars548_StartReceive to start the receive thread.
• Use data
  • In the callback set by Ars548_SetRadarMessageCallback, use the raw radar message data based on the message type ID.
  • In the callback set by Ars548_SetTargetListCallback, use the parsed target info data from SDK.
• Modify radar configuration
  • Configure sensor configuration of the radar via Ars548_SetSensorConfig.
  • Configure filter configuration of the radar via Ars548_SetFilterConfig.
• Deinitialization
  • Call Ars548_StopReceive to stop receiving data.
  • Call Ars548_UnInit to deinitialize SDK.

---

Receiving Raw Radar Data

The messages sent by the ARS548 radar are:

Message ID	Message Structure	Description
MSG_ID_DETECTION_LIST	Ars548DetectionList	List of radar detections
MSG_ID_OBJECT_LIST	Ars548ObjectList	List of radar identified objects
MSG_ID_SENSOR_STATUS	Ars548SensorStatus	Radar sensor status data
MSG_ID_FILTER_STATUS	Ars548FilterStatus	Radar filter status data

See the documentation of each message body or the radar technical documentation for more details.

Raw Radar Data Callback

When a radar data packet is received, SDK passes the message body to the callback function registered by the user.

Example callback function code:

void CALLBACK OnRadarMessage(int nMsgId, const Ars548Msg *pMsg) 
{
    std::cout << "OnRadarMessage() - nMsgId = " << nMsgId << std::endl;
 
    // Currently radar sends the following 4 message types
    Ars548DetectionList *pDetectionList = NULL;
    Ars548ObjectList *pObjectList = NULL;
    Ars548SensorStatus *pSensorStatus = NULL;
    Ars548FilterStatus *pFilterStatus = NULL;
 
    // Based on nMsgId, cast the pMsg pointer to the right type and access the message body.
    switch (nMsgId)
    {
        case MSG_ID_DETECTION_LIST:
            pDetectionList = (Ars548DetectionList *)pMsg;
            // ... related handling code
            break;
 
        case MSG_ID_OBJECT_LIST:
            pObjectList = (Ars548ObjectList *)pMsg;
            // ... related handling code
            break;
 
        case MSG_ID_SENSOR_STATUS:
            pSensorStatus = (Ars548SensorStatus *)pMsg;
            // ... related handling code
            break;
 
        case MSG_ID_FILTER_STATUS:
            pFilterStatus = (Ars548FilterStatus *)pMsg;
            // ... related handling code
            break;
 
        default:
            break;
    }
}

---

Receiving Parsed Target Data from SDK

The TargetList data provided by the SDK is parsed from Ars548DetectionList and Ars548ObjectList, and contains information like target horizontal/vertical distance and speed relative to the radar, for easier further processing by users.

Example callback function code:

void CALLBACK OnTargetListCallback(const TargetList *pTargetList)
{
    // Determine if Detections or Objects based on TargetType
    if (pTargetList->TargetType == TARGET_TYPE_DETECTION)
    {
        std::cout << "Ars548Dll::OnTargetListCallback() - Num Of Detections: " << pTargetList->NumOfTargets << std::endl;
    }
    else    // TARGET_TYPE_OBJECT
    {
        std::cout << "Ars548Dll::OnTargetListCallback() - Num Of Objects: " << pTargetList->NumOfTargets << std::endl;
    }
}