Package: acconeer-exptool
Acconeer Exploration ToolExplore the Next Sensewith Acconeer Exploration Tool! Use one of ourevaluation kitstogether with our Python examples and start exploring the world of Acconeer's radar sensor technology. The Python scripts and the Application in this repository will help you to easily stream the radar sensor's data to your local machine to start radar sensor evaluation and/or algorithm development for your application.To run the Python exploration scripts, you will need anevaluation kitrunning the included Exploration or Module server, both of which are supplied with theAcconeer SDK and Module SWimage.This release is developed forAcconeer SDK and Module SWA111-v2.15.2andA121-v1.5.0.
Running this version is strongly recommended, as we continuously fix bugs and add features.Quickstart for WindowsThere is a portable version of the Acconeer Exploration Tool for Windows:Downloadthe zip file and extractDouble click theupdate.batfile and wait for the installation to finish, which might take a couple of minutesDouble click therun_app.batFor an in-depth evaluation, we recommend a full installation as described below.DocumentationDocumentation is available atdocs.acconeer.com,
where you can also find theFAQ.Newsv7.4.0 released. See theChangelog.Setting up your evaluation kitXM126XM125XC120 + XE121 (A121)Raspberry Pi (A121 on XE121)Raspberry Pi (A111 on XC111+XR111 or XC112+XR112)XM112XM122XM132For additional resources, head over to theAcconeer developer page. There you will find both a getting started guide and a video showing you how to set up your evaluation kit. There you will also find the SDK download.Setting up your local machineRequirementsPython 3.8 or newer. Older versions have limited or no support.Tested on:Python 3 (developed and tested on 3.8, 3.9, 3.10, 3.11 and 3.12)Windows 10Ubuntu 20.04SetupInstalling theacconeer-exptoolpackageInstall from PyPI:python -m pip install --upgrade acconeer-exptool[app]Depending on your environment, you might have to replacepythonwithpython3orpy.For other options, have a look atdocs.acconeer.com.Windows COM port driversIf no COM port is recognized when plugging in a module, you might need to install a driver.
See information about your specific module atdocs.acconeer.comLinux setupAfter installing theacconeer-exptoolpackage, you can runpython -m acconeer.exptool.setupDepending on your environment, you might have to replacepythonwithpython3orpy.which interactively configures your machine and downloads needed dependencies.
This is done in order for your machine to work at its best with Exploration tool.acconeer.exptool.setupperforms the steps described in theLinux setup section on docs.acconeer.com.ApplicationUsing the application is the easiest way to start exploring Acconeer's radar sensor and our application examples:python -m acconeer.exptool.appDepending on your environment, you might have to replacepythonwithpython3orpy.In the top right box of the application, namedConnection, select the interface you wish to useSPI: auto-detects an XM112 connected to USB2 (USB1 is also needed for power)Socket: specify the IP address of your Raspberry Pi running the streaming serverSerial: specify the serial port that is assigned to the sensorConnections viaSerialhave the option of choosing aProtocol. The choices areModuleandExploration, where the protocol should match the server installed
on the module (Module serverorExploration server, respectively). Choosing the wrong
protocol will show an error.After pressingConnect, a connection should be established.
In the box below labelledScan controls, select the service or processing example you want to test.
Now you may tune the sensor and processing settings to your specific setup.
Once you pressStart measurement, the application will start fetching data from the sensor and plotting the results.
After pressingStop, you can save (and later load data) or just replay the data stored in the buffer.The ML interface(no longer supported)Support for the Machine Learning interface in Exploration Tool has been dropped.If you still need to use it, it is possible to use an old version of Exploration Tool.From theacconeer-python-explorationdirectory:git checkout v3And follow the instructions in an old version of this document (README.md).Note that this version of Exploration Tool will not be actively supported. Compatibility with new
RSS versionsis not guaranteed.Running an example script on your local machineIf you prefer using the command line for testing and evaluation of our examples you can use the following instructions.XC111+XR111 or XC112+XR112 (mounted on a Raspberry Pi):python examples/a111/basic.py -s <your Raspberry Pi IP address>XM112+XB112 via SPI over USB:python examples/a111/basic.py -spiAny module via UART over USB, attempting to auto-detect the serial port:python examples/a111/basic.py -uAny module via UART over USB, using a specific serial port:python examples/a111/basic.py -u <the serial port, for example COM3>Depending on your environment, you might have to replacepythonwithpython3orpy.Choosing which sensor(s) to be used can be done by adding the argument--sensor <id 1> [id 2] .... The default is the sensor on port 1. This is not applicable for the modules.Scripts can be terminated by pressing Ctrl-C in the terminal.DisclaimerHere you find thedisclaimer.FAQ and common issuesSee theFAQon the Acconeer documentation pages.