The Motion and Presence Detection OOB demo shows some of the capabilities of the xWRL6432 SOC using the drivers in the MMWAVE-L-SDK (Software Development Kit). It allows user to specify the chirping profile and displays the detected objects and other information in real-time. The demo comes with two default configurations (PresenceDetect.cfg and MotionDetect.cfg). The configuration in PresenceDetect.cfg leverages the Minor Motion mode of the Signal processing chain to demonstrate the sensors ability to detect presence through fine motion. The MotionDetect.cfg configures the device to detect moving objects. It outputs a point cloud that can be fed to a tracker.

The following documents provide more information on the OOB demo.
[1] describes system execution flow, memory usage, task organization, memory and benchmark results of Motion and Presence detection OOB demo.
[2] contains a high level description of the Signal Processing chain and has useful information on tuning the demo performance for different usecases.

Refer ${SDK_INSTALL_PATH}/docs/MotionPresenceDetectionDemo_documentation.pdf document for implementation details of Demo application.

Supported Combinations

Parameter	Value
CPU + OS	m4fss0-0 freertos
Toolchain	ti-arm-clang
Board	xWRL6432-evm
Example folder	examples/mmw_demo/motion_detection

Steps to Run the Example

When using CCS projects to build, import the CCS project for the required combination and build it using the CCS project menu (see Using SDK with CCS Projects).
When using makefiles to build, note the required combination and build using make command (see Using SDK with Makefiles)
Launch a CCS debug session and run the executable, see CCS Launch, Load and Run

Configuration (.cfg) File Format (CLI INTERFACE)

Attention: Converting configuration from older SDK release to current SDK release:
As new versions of SDK releases are available, there are usually changes to the configuration commands that are supported in the new release. Now, users may have some hand crafted config file which worked perfectly well on older SDK release version but will not work as is with the new SDK release. Check users guide for details.

Note: Example configuration files are available at '${SDK_INSTALL_PATH}/examples/mmw_demo/motion_detection/profiles/xwrL64xx-evm'. All the CLI commands should be between 'sensorStop' and 'sensorStart'

Each line in the .cfg file describes a command with parameters. The various commands and their arguments are described in the table below (arguments are in sequence)

Commands	Parameters	Notes
sensorStop	`FrameStopMode`	Indicates the frame stop mode. This command stops the sensor from transmitting further frames. Important Note: This command is not supported when lowPowerCfg is 1
channelCfg	`RxChCtrlBitMask`	RX antennas 1 and 2, mask = 0x011b = 3 RX antennas 1 and 3, mask = 0x101b = 5 RX antennas 2 and 3, mask = 0x110b = 6 RX antennas 1, 2 & 3, mask = 0x111b = 7
	`TxChCtrlBitMask`	TX antennas 1 and 2, mask = 0x011b = 3 TX antenna 1, mask = 0x001b = 1 TX antenna 2, mask = 0x010b = 2
	`MiscCtrl`	Not supported on the current version of the SDK.
chirpComnCfg	`DigOutputSampRate`	Digital output Sampling rate for chirp ADC samples. Digital sampling rate is given by 100MHz/ DigOutputSampRate. The valid sampling rate can be configured as per below. 8 - 12.5 MHz 9 - 11.11 MHz 10 - 10 MHz 12 - 8.333 MHz 16 - 6.25 MHz 20 - 5 MHz 25 - 4 MHz 32 - 3.125 MHz 40 - 2.5 MHz 50 - 2 MHz 64 - 1.5625 MHz 80 - 1.25 MHz 100 - 1 MHz
	`DigOutputBitsSel`	Digital output sample bits select, this field governs which bits of the FECSS DFE's internal 16 bit signed data path are sent as output. 0 - Digital sample output is 12 MSB bits of DFE after rounding 4 LSBs 1 - Digital sample output is 12 bits after rounding 3 LSBs & clipping 1 MSB 2 - Digital sample output is 12 bits after rounding 2 LSBs & clipping 2 MSB 3 - Digital sample output is 12 bits after rounding 1 LSBs & clipping 3 MSB 4 - Digital sample output is 12 LSB bits after clipping 4 MSB 5 - Digital sample output is 16 bits
	`DfeFirSel`	The final stage FIR filter's characteristics can be selected as below. 0 - Long Filter (90% visibility): This provides visibility to a larger range of IF frequencies: 0 to 0.45 x Sampling Rate. Beyond that, the filter response starts drooping & enters filter transition band. 1 - Short Filter (80% visibility): This provides faster settled outputs but the IF frequency range visible is 0 to 0.40 x Sampling Rate. Beyond that, the filter response starts drooping & enters filter transition band.
	`NumOfAdcSamples`	No. of ADC samples. Current SDK work for values with powers of 2 Valid Range: 2 to 2048
	`ChirpTxMimoPatSel`	Only BPM is supported in current OOB Demo. 0 - TX BPM MIMO pattern disabled 1 - TDMA_2TX pattern 4 - BPM_2TX pattern
	`ChirpRampEndTime`	Chirp Profile Ramp end Time. This is a common ramp end time value for all chirps in a frame.
	`ChirpRxHpfSel`	Chirp Profile HPF corner frequency. This is a common HPF corner frequency value for all chirps in a frame. 0 - 175kHz HPF corner frequency 1 - 350kHz HPF corner frequency 2 - 700kHz HPF corner frequency 3 - 1400kHz HPF corner frequency
chirpTimingCfg	`ChirpIdleTime`	Chirp Profile Idle Time. This is a common idle time value for all chirps in a frame. Unit: 1us.
	`ChirpAdcSkipSamples`	Chirp Profile ADC start skip samples. This is a common adc start time value for all chirps in a frame Valid range: 0 to 63
	`ChirpTxStartTime`	Chirp Profile TX start Time. This is a common TX start time value for all chirps in a frame.This field indicates the TX start time in the chirp cycle with respect to the knee of the ramp. Unit: In usec
	`ChirpRfFreqSlope`	Chirp Profile RF Frequency Slope. This is a common RF frequency slope value for all chirps in a frame.This field indicates the required FMCW slope of the chirp. Unit: MHz/us Valid range:- 399MHz/us to +399MHz/us.
	`ChirpRfFreqStart`	Chirp Profile RF start Frequency. This is a common RF start frequency value for all chirps in a frame. This field indicates the required start frequency of the chirp. Unit: GHz Valid range:58GHz to 62.5GHz for ES1.0 devices
frameCfg	`NumOfChirpsInBurst`	Number of Chirps in a Burst. This field indicates the number of chirps to be generated per burst. Valid range: 1 to 65535 chirps . (Limited support in current OOB)
	`NumOfChirpsAccum`	Number of accumulation per chirp. This field indicates the Number of chirps to be accumulated before sending the ADC data out in DFE, this can be used to increase the SNR without increasing the number of chirps to process in the DSP/HW accelerator. Valid range: : 0 to 64 chirps. (Limited support in current OOB)
	`BurstPeriodicity`	Burst Periodicity. This field indicates the period of the burst. (Limited support in current OOB)
	`NumOfBurstsInFrame`	Burst Periodicity. This field indicates the period of the burst. Valid range:1 to 4096 (Limited support in current OOB)
	`FramePeriodicity`	Frame Periodicity. This field indicates the period of the frame, 32bit counter.This field indicates the frame periodicity, the time gap between successive frame starts. Unit: ms Valid range:100 to 4294967295 (Limited support in current OOB)
lowPowerCfg	`Enable/Diable`	Configuration to enable/disable the power management framework. 0 - Disabled 1 - Enabled
factoryCalibcfg	`Save enable`	When this option is enabled application will boot-up normally and configure the FECSS to perform all applicable factory calibrations during FECSS initialization. Once the calibrations are performed, application will retrieve the calibration data from FECSS and save it to FLASH. User need to specify valid <flash offset> value. <restore enable> option should be set to 0. Note The factory calibration should be done at room temp (25 °C +/- 15 °C) 0 - Save Disabled 1 - Save Enabled
	`restore enable`	When Restore enabled option is set, application will check the FLASH for a valid calibration data section. If present, it will restore the data from FLASH and provide it to FECSS while configuring it to skip any real-time factory calibrations and use provided calibration data. User need to specify valid <flash offset> value which was used during saving of calibration data. <save enable> option should be set to 0. <rxGain> and <backoff0> arguments will be ignored when restore option is enabled. 0 - Restored Disabled 1 - Restore Enabled
	`rxGain`	Recommended value is 30db to 40db. Units: db.
	`backoff0`	TX channel power calibration. Valid Range: 0db to 26db. Units: db.
	`flash offset`	Address offset in the flash to be used while saving or restoring calibration data. Make sure the address doesn't overlap the location in FLASH where application images are stored and has enough space for saving factory Calibration data. This field is don't care if both save and restore are disabled.Flash address range is 0x0 to 0x1FFFFF (16Mb) Actual Factory calibration data is of size 128 bytes. It is recommended to use last sector of flash memory starting with address 0x1FF000
sigProcChainCfg	`azimuthFftSize`	Azimuth FFT size. Suggested to set as power of 2
	`elevationFftSize`	Elevation FFT size. Suggested to set as power of 2
	`motDetMode`	Major / Minor / AUTO mode selection 1 - Major motion detection only (Supported in SDK) 2 - Minor motion detection only(Supported in SDK) 3 - Auto detection mode.(Not Supported in SDK)
	`coherentDoppler`	Coherent/Non-coherent Doppler selection 0 - Non-coherent integration along Doppler dimension. 1 - Select maximum (coherent) peak in Doppler dimension. 2 - Non-coherent integration along Doppler used to create detection matrix, and find maximum position to add to detected point.
	`numFrmPerMinorMotProc`	Number of frames included for minor motion detection.
	`numMinorMotionChirpsPerFrame`	Number of chirps (bursts) per frame used for minor motion detection.
cfarCfg	`averageMode`	CFAR Averaging mode selection Recommened to set 2 0 - CFAR-CA 1 - CFAR-CAGO 2 - CFAR-CASO
	`winLen`	One-sided noise averaging window length (in samples) of range-CFAR Recommened to set as power of 2
	`guardLen`	One-sided guard length (in samples) of range-CFAR.
	`noiseDiv`	Cumulative noise sum divisor expressed as a shift. Sum of noise samples is divided by 2^noiseDiv. Suggested to set as log2(winLen).
	`cyclicMode`	Cyclic mode or wrapped around mode. 0 - Disabled 1 - Enabled
	`thresholdScale`	Threshold factor of range-CFAR in dB scale (20log10).
	`peakGroupingEn`	Enable or disable Peakgrouping 0 - Disabled 1 - Enabled
	`sideLobeThreshold`	Sidelobe threshold (in linear scale) in azimuth domain to declare a local peak as a valid detection.
	`localMaxRangeDomain`	Enable/disable selection of the local maximum in the range domain 0 - Disabled 1 - Enabled
	`localMaxAzimuthDomain`	Enable/disable selection of the local maximum in the Angle domain 0 - Disabled 1 - Enabled
	`interpolateRange`	Enable /disable the interpolation of the range 0 - Disabled 1 - Enabled
	`localMaxAzimuthDomain`	Enable /disable the interpolation of the Azimuth 0 - Disabled 1 - Enabled
aoaFovCfg	`minAzimuthDeg`	Minimum azimuth angle (in degrees) that specifies the start of field of view
	`maxAzimuthDeg`	Maximum azimuth angle (in degrees) that specifies the end of field of view
	`minElevationDeg`	Minimum elevation angle (in degrees) that specifies the start of field of view
	`maxElevationDeg`	Maximum elevation angle (in degrees) that specifies the end of field of view
rangeSelCfg	`minMeters`	Minimum range of exported detected points
rangeSelCfg	`maxMeters`	Maximum range of exported detected points
clutterRemoval	`enabled`	Configure the static clutter removal 0 - Disabled 1 - Enabled
compRangeBiasAndRxChanPhase	`rangeBias`	Value of the Range Bias
	`virtAntIdx 1`	Phase compensation factor (real, imaginary) of virtual antenna 1.
	`virtAntIdx 2`	Phase compensation factor (real, imaginary) of virtual antenna 2.
	`virtAntIdx 3`	Phase compensation factor (real, imaginary) of virtual antenna 3.
	`virtAntIdx 4`	Phase compensation factor (real, imaginary) of virtual antenna 4.
	`virtAntIdx 5`	Phase compensation factor (real, imaginary) of virtual antenna 5.
	`virtAntIdx 6`	Phase compensation factor (real, imaginary) of virtual antenna 6.
guiMonitor	`pointCloud`	Enable/Diable the transmission of the point cloud data 0 - Disable 1 - Enable, point cloud in floating point format, plus side information, 2 - Enable, point cloud in compressed format (fixed point)
	`rangeProfile`	Enable/Diable the transmission of the Range Profile data 0 - Disable 1 - Enable, range profile from Major mode detection 2 - Enable, range profile from Minor mode detection 3 - Enable, both range profiles(Not Supported in the SDK)
	`NoiseProfile`	Not used in the current SDK
	`rangeAzimuthHeatMap`	Enable/Diable transmission of the Range Azimuth heatmap 0 - Disable 1 - Enable, heatmap from Major mode detection 2 - Enable, heatmap from Minor mode detection 3 - Enable, both heatmaps(Not supported in the current SDK)
	`rangeDopplerHeatMap`	Not used in the current SDK
	`statsInfo`	Enable /disable the transmission of the Statistics info that include processing time, temperature, power. (Partially supported in the current SDK) 0 - Disabled 1 - Enabled
mpdBoundaryBox	`Zone`	Zone: This command is used to describe the boundary of each zone. (Only four zones are permitted in current SDK)
	`x-min`	x-min
	`x-max`	x-max
	`y-min`	y-min
	`y-max`	y-max
sensorStart	'FrameTrigMode'	Frame Trigger Mode. 0 - Frame SW immediate trigger Mode (SW_TRIG). 1 - Frame SW timer based trigger Mode (SW_TIMER_TRIG). 2 - Frame HW trigger low power Mode (HW_LOW_PWR_TRIG). 3 - Frame HW trigger low jitter Mode (HW_LOW_JIT_TRIG). 4 - CW CZ Trigger Mode (CW_CZ_TRIG). 5 - Chirp Timer Override Trigger Mode (CT_OVRD_TRIG). (Currently SDK supports only SW_TRIG mode(0))
	'ChirpStartSigLbE'	Chirp Timer (CT) start signal loopback enable control. 0 - CHIRP_START_SIGNAL to DIG_SYNC_OUT Loopback Disable 1 - CHIRP_START_SIGNAL to DIG_SYNC_OUT Loopback Enable. (Currently SDK supports only Loopback Disable mode(0))
	'FrameLivMonEn'	Frame Live monitors enable control. 0 - Live monitor Disabled 1 - Live monitor Enabled (Currently SDK supports only Live monitor Disabled(0))
	'FrameTrigTimerVal'	Frame Trigger Timer Value. 32bit counter value. (Currently SDK demo is tested only with value 0)

Parameter Tuning Guide

Refer below document to tune the performance of signal processing chain in Motion and Presence detection OOB demo for different use cases and environments.

${SDK_INSTALL_PATH}/docs/MotionPresenceDetectionDemo_TuningGuide.pdf

Flow Diagram in Low Power Configuration (lowPowerCfg = 1)

Below is the high level flow diagram of Motion and Presence detection OOB demo in Low Power Mode:

Flow in Low Power Mode