SDK Contents

Directory structure

Ars548_SDK
   ├─Doc
   │  ├─html
   │  └─Ars548SDK.chm
   └─Demos
       ├─sdk
       ├─ars548_demo
       ├─ars548_qt_demo
       ├─ars548_qt_demo_filter_config
       ├─ars548_qt_demo_sensor_config
       └─ars548_qt_demo_simulation

Doc

html

This directory contains HTML-format documentation for the SDK, please locate "index.html" and open it in your browser for reading.

Ars548SDK.chm

This is the help file format under Windows. It is a self-contained file that packages all the content of HTML documents together, and you can search the documentation contents through indexes.

Demos

This directory contains some example programs and tutorials.

‍NOTE: The programs in this directory are meant for demonstration purposes only. This means that they are built to be readable rather than reliable or functional.

These demos are written in C++, and users can compile them on the Linux platform with x86 architecture using CMake and GCC build tools.

How to build

Install the compiler

On my Ubuntu 18.04, I installed the C++ compiler through the following command:

sudo apt install build-essential

And then you should install CMake:

sudo apt install cmake

Some of the code demos use Qt5, so in order to run those examples, your needs to have the relevant Qt5 development libraries and components installed.

sudo apt install qt5-default

System component version

The versions of the system components that the code passed testing with are as follows:

Component	Version
CMake	3.10.2
GCC	7.5.0
Qt	5.9.5

Build and Run

The building methods for all of these demos are the same. Using ars548_demo as an example.

Enter the directory of the demo:

cd ars548_demo

Create a build directory and navigate into it:

mkdir build
cd build

Build:

cmake ..
make

Finally, try to use the newly built Tutorial with these commands:

sudo ./ars548_demo

‍NOTE: Since the SDK needs to create raw sockets, it requires root privileges. Append 'sudo' before the command line when running any demo programs.

ars548_demo

This is a console program that demonstrates the basic usage of the SDK, including initialization, data reception, data display, and sending sensor configurations and filter settings.

This program requires two command line arguments to run, which are the IP address of the local NIC (Network Interface Card) and the IP address of the radar. After the program starts running, it will start receiving and outputting the target information sent by the radar to the screen.

The user can send a few key presses to make the program perform other operations:

1. Press "s" and enter, the program will send a sensor configuration command to the radar. Please note that the code here is for demonstration purposes only, so the calling parameters are hardcoded. The user should write their own code for sensor configuration according to the SDK documentation to ensure the expected effect after understanding how to use the SDK.
2. Press "f" and enter, the program will send a filter configuration command to the radar. Similarly, the calling parameters in the code are hardcoded, which will set a filter on the radar to only send target data within the range of 0-10m.
3. Press "r" and enter, the program will send a reset filter command to the radar, so that the filter set earlier can be cleared.
4. Press "q" and enter, to quit the program.

ars548_qt_demo

This is a graphical interface example program based on Qt5, demonstrating the basic usage of the SDK: receiving radar target data and displaying it in a table. Users can sort columns of interest, indicating that you can obtain the data you need through the SDK and then further process and manipulate it to meet your specific business requirements.

ars548_qt_demo_filter_config

This is a graphical interface example program based on Qt5, demonstrating how to receive and display radar sensor configuration information and allowing modifications to a portion of the sensor data.

When modifying the radar sensor settings, note the several flags in the Ars548SensorConfiguration structure - NewSensorMounting, NewVehicleParameters, NewRadarParameters and NewNetworkConfiguration. When modifying the corresponding settings, the respective flag fields need to be set to 1.

ars548_qt_demo_sensor_config

This is a graphical interface example program based on Qt5, demonstrating how to receive and display radar filter configuration information and allowing modifications to a portion of the filter data.

ars548_qt_demo_simulation

This is a graphical interface example program based on Qt5, demonstrating how to send vehicle dynamics parameters (or vehicle state simulation information) to the radar, including velocity, driving direction, yaw rate, lateral or longitudinal acceleration, etc.

Relase Notes

2024-03-22 v1.2.0

New recording functions.

2024-02-28 v1.1.0

New ars548_qt_demo_simulation.

2023-09-18 v1.0.0

Initial release.