OmniPreSense OPS243-A User manual

UM-003-A OPS243-A User Manual 1 OmniPreSense Corporation

UM-003 OPS243-A User Manual

OmniPreSense OPS243-A short range radar sensor has an easy to use API to control the output of the

sensor. Simple commands can be used to configure the operation and output information provided by

the sensor. Default settings are noted below. Upon powering on the module, the default settings are

used.

Installation Instructions

The OPS243-A provides a complete radar module on a single board. The coverage area or field of view

(FOV) for the OPS243-A is 20in the azimuth (horizontal) and 24elevation (vertical). Install the OPS243-

A facing the direction of the FOV to be covered. The antenna gain for the radar sensor is 11dBi.

Figure 1. OPS243-A Beamwidth

The OPS243-A can generally can be placed behind most any material (plastic, glass, wood, etc.) depending

on thickness. Typical applications will use plastics such as ABS or PVC at 3 or 6mm thickness. Some

materials will block the signal and the OPS243-A should not be placed behind these. Examples of these

are metal, concrete or brick.

UM-003-A OPS243-A User Manual 2 OmniPreSense Corporation

Radar Sensor Types

OmniPreSense provides two different types of sensors, Doppler radar sensor reporting motion and speed

and FMCW radar sensors reporting range. The feature differences for these sensors is shown in Table 1.

The following API commands pertain to both types of sensors except for special cases. In these cases, this

document will call out the special command for either a Doppler (-A), FMCW (-B), or both Doppler and

FMCW (-C) radar.

Table 1. Radar Sensor Feature Matrix

Sensor

Type

Motion

Speed

Direction

Signal

Magnitude

Range

FCC/IC

Modular

Approval

Detection

Range

(RCS = 10)

OPS243-A

Doppler

●

75-100m

OPS243-C

Doppler

& FMCW

●

(pending)

50-60m

Terminal Control

A simple Command Terminal can be used to control the module operation with the API commands.

Examples of simple but very useful Command Terminals are Tera Term and PuTTY.Both are free, open

source terminal tools for the PC/Mac which can easily connect to a serial port and accept data over USB

from the OmniPreSense module.

To begin using the OmniPreSense sensor, first download Tera Term or PuTTY onto your PC/Mac. With the

OmniPreSense sensor plugged into the USB port of your PC/Mac, start Tera Term or PuTTY. A

configuration window such as Figure 2 or Figure 3 will appear. Tera Term can detect the active COM port

(greyed out to right of Serial button if TCP/IP is selected). Select the Serial button and press OK.For

PuTTY, you’ll need to know which COM port is used, set its value, select the Serial button, and Open.

Figure 2. Tera Term Startup Menu

UM-003-A OPS243-A User Manual 3 OmniPreSense Corporation

Figure 3. PuTTY Startup Menu

Once connected, the data reported by the sensor will start streaming to the terminal when an object

either in motion appears (-A, -C Doppler radar sensors) or there are objects in the sensors field of view (-

B, -C FMCW radar) to report the range to. The default settings are shown in Table 2. If there is no object

moving in front of the sensor or it’s not pointing at any object, no data is reported or streamed to the

terminal. A simple wave of the hand will show data like that shown in Figure 4. Any of the API commands

can now be executed to change the output data or query the configuration.

Figure 4. Streaming Data with Tera Term

UM-003-A OPS243-A User Manual 4 OmniPreSense Corporation

Figure 5. Streaming Data with PuTTY

UM-003-A OPS243-A User Manual 5 OmniPreSense Corporation

Default Settings

The default settings of the module are set to provide solid performance over a wide range of applications.

Upon power-up the default settings are used, and operation begins. Future updates will allow the module

to retain the settings of the module from the last operation. The default settings are listed in Table 2.

Table 2. Default Settings

API Command

Doppler (-A)

Default Value

FMCW (-B)

Default Value

Output Units

UM/uM

m/s

Data Precision

Sampling Rate

10,000

N/A

Sampling Buffer Size

1024

N/A

Simple Motion Interrupt

Off

Reported Speed Filter

R>n, R<n

Off

N/A

Reported Direction Filter

Off

N/A

Reported Range Filter

r>n, r<n

N/A

Off

Magnitude Filter

M>n, M<n (Doppler) or

m>n, m<n (FMCW)

>10

>100

JSON Output

Off

LED Control

Magnitude Report

Off

Number Reports

Raw Data Output

Off

Post FFT Data Output

Off

Speed or Range Report

OS/OD

Time Report

Off

Output Units

N/A

Sensor Power Mode

Active

Power Level

Speed Operating Range (-A Doppler only)

The maximum speed reported is determined by the Sampling Frequency. For slow moving objects, a

sample rate of 5,000 (SV command) is perfectly fine. The default setting of 10,000 (SX command) provides

a detectable speed of up to 31.1 m/s (69.5 mph) while 20,000 (S2 command) provides up to 62.2 m/s

(139.1 mph). The resolution of the reported speed increases as the sample frequency goes down. The

range of values is summarized in Table 3.

UM-003-A OPS243-A User Manual 6 OmniPreSense Corporation

Table 3. Maximum Operating Speeds

Sample

Frequency

API

Command

Maximum

Speed (m/s)

Maximum

Speed (mph)

Resolution*

(m/s)

Resolution*

(mph)

1,000

3.1

7.0

0.006

0.014

5,000

15.5

34.8

0.030

0.068

10,000

31.1

69.5

0.061

0.136

20,000

62.2

139.1

0.121

0.272

50,000

155.4

347.7

0.304

0.679

100,000

310.8

695.4

0.608

1.358

* 1024 buffer size, 512 buffer size accuracy will be twice these values, 256 four times

UM-003-A OPS243-A User Manual 7 OmniPreSense Corporation

API Commands

The following are the API commands supported by the OPS243. These commands can be sent by typing

into the command terminal to change settings on the sensor or control its operation. The commands

provided include simple queries to fetch information about the sensor and its settings or write commands

which control or change the operation of the sensor.

Module Information –returns information about the module and its setting.

Command

Name

R/W

Value

Module Information

Read

{"Product":"OPS243"}

{"Version":"1.0.0"}

{"SamplingRate":10000, "resolution":0.0607}

{“SampleSize”:1024}

{"Clock":"54"}

{"Q2COUNT":"1149 (~22980 counts/sec)

@t=37"}

{"PowerMode":"Continuous"}

{"Squelch":"100"}

{“RequiredMinSpeed”:”0.000”}

Reset Reason

Read

Provides the reason why sensor reset.

{ "ResetReason": "Status from bitmask",

"Power On" : true, "Supply Watchdog" : true,

"Power Validation" : true }

Module Part Number –returns model number of sensor.

Command

Name

R/W

Value

Module Part Number

Read

{"Product":"OPS243 Doppler"}

Firmware Version/Board ID –returns current firmware version of the module. Firmware version

consists of a major revision, minor revision, and patch revision in the form of xx.yy.zz.

Command

Name

R/W

Value

Firmware Version Number

Read

{"Version":"1.3.1"}

Firmware Build Number

Read

{"Build":"20181005_1335"}

Unique Board ID

Read

{"UID":"b2000040b7a12400d5188041"}

UM-003-A OPS243-A User Manual 8 OmniPreSense Corporation

Speed Output Units (-A, -C Doppler only) –read or set the units for the velocity output. Units

supported include m/s (default), cm/s, ft/s, km/hr, and miles per hour.

Command

Name

R/W

Value

Current Velocity Units

Read

{"Units":"m-per-sec"}

Centimeters per second

Write

{"Units":"cm-per-sec"}

Feet per second

Write

{"Units":"ft-per-sec"}

Kilometers per hour

Write

{"Units":"km-per-hr"}

Meters per second

Write

{"Units":"m-per-sec"}

Miles per hour

Write

{"Units":"mph"} Calculations are based on the

international mile (1,609.344 m per mile).

Range Output Units (-B, -C FMCW only) –read or set the units for the range output. Units supported

include meter (default), centimeter, feet, inch, and yards.

Command

Name

R/W

Value

Current Range Units

Read

{"Units":"Value", "RangeUnit":"m"}

{"Resolutions":"Value",

"RangeResolution_m":0.0777}

Meters

Write

{"Units":"Value", "RangeUnit":"m"}

{"Resolutions":"Value",

"RangeResolution_m":0.0777}

Centimeters

Write

{"Units":"Value", "RangeUnit":"cm"}

{"Resolutions":"Value",

"RangeResolution_cm":7.7710}

Feet

Write

{"Units":"Value", "RangeUnit":"ft"}

{"Resolutions":"Value",

"RangeResolution_ft":0.2550}

Inch

Write

{"Units":"Value", "RangeUnit":"in"}

{"Resolutions":"Value",

"RangeResolution_in":3.0594}

Yards

Write

{"Units":"Value", "RangeUnit":"yd"}

{"Resolutions":"Value",

"RangeResolution_yd":0.0850}

Data Precision –set the number of digits for the data reported.

Command

Name

R/W

Value

Decimal Places

Write

Set n to the number of decimal places to be

reported. For example, setting to F2 will

report 2 decimal places (ex. 10.35). F0 will

provide the integer value only. Valid values of

n are 0-5.

Decimal Place Setting

Read

Query the number of decimal places set.

UM-003-A OPS243-A User Manual 9 OmniPreSense Corporation

Sampling Rate/Buffer Size (-A, -C Doppler only) –set these values to control the sample rate of the

module. This setting influences the output data and the rate at which the data is reported. The buffer

size influences the report rate and resolution. A buffer size of 512 will have a report rate between 5-30Hz.

The resolution becomes worse by a factor of two with a 512-buffer size versus 1024 (Figure 6) and worse

again at 256 buffer size.

Command

Name

R/W

Notes

1K samples/second

Write

5K samples/second

Write

SX or S1

10K samples/second

Write

20K samples/second

Write

50K samples/second

Write

100K samples/second

Write

1024 buffer size

Write

1024 samples are collected before processing

512 buffer size

Write

512 samples are collected before processing

256 buffer size

Write

256 samples are collected before processing

Figure 6. Doppler (-A) Buffer Size versus Resolution

-0.10

0.10

0.30

0.50

0.70

0.90

1.10

1.30

1.50

1.70

1.90

2.10

2.30

2.50

1,000 10,000 100,000

Resolution (m/s)

Sampling Rate

256 Buffer

512 Buffer

1024 Buffer

UM-003-A OPS243-A User Manual 10 OmniPreSense Corporation

Reported Speed/Range/Direction Filter –use these settings to set the range of data to report. Settings

are available for either a minimum or maximum value below or above which data will not be reported.

Commands are available to set speed, range, and direction of speed filters. These filters can be used to

help set sensitivity levels of detection. This command requires a return () after the number. Direction

filter allows reporting only a single direction or both.

Command

Name

R/W

Notes

R>n

Reported Minimum Speed

Filter

Write

n is any number upon which no detected

speeds below that number will be reported.

R>0 resets to no limit. Doppler (-A, -C) radar

only.

R<n

Reported Maximum Speed

Filter

Write

n is any number upon which no detected

speeds above that number will be reported.

R<0 resets to no limit. Doppler (-A, -C) radar

only.

r>n

Reported Range Filter

Write

n is any number upon which no detected

range below that number will be reported.

r>0 resets to no limit. FMCW (-B, -C) radar

only.

r<n

Reported Range Filter

Write

n is any number upon which no detected

range above that number will be reported.

r<0 resets to no limit. FMCW (-B, -C) radar

only.

Report Current Speed Filter

Read

Reports current settings of the speed filter

Report Current Range Filter

Read

Reports current settings of the range filter

R+

Inbound Only Direction

Write

Only reports inbound direction

R-

Outbound Only Direction

Write

Only reports outbound direction

Clear Direction Control

Write

Reports both directions

Frequency Control (-A, -C Doppler only) –use this setting to set the desired transmit frequency. Set nto

a positive or negative number to set the frequency. T=0 is the default setting targeting 24.125GHz. Each

increment steps approximately 18MHz. The programming steps are limited to 24.0 through 24.25GHz for

the OPS243. The limits on nare -2 (~24.0GHz) to 2 (~24.25GHz) for the OPS243 which has some guard

banding to ensure it stays within the 24.0-24.25GHz ISM band. Depending on the spread between the

current frequency and the newly set frequency, there may be a long settling time on the order of 5-10

seconds or longer based on the size of the jump in values. Writing ?F will provide the current transmitter

output frequency.

Command

Name

R/W

Value

T=n

Frequency Setting

Write

T=0 is the default setting for 24.125GHz.

Frequency Output

Read

?F returns the output frequency of the

transmitter in GHz.

Other OmniPreSense Radar manuals

OmniPreSense

OmniPreSense OPS242 User manual

Popular Radar manuals by other brands

SAW D2L

SAW D2L Valentine One Gen2 owner's manual

Raymarine

Raymarine Raytheon R20X instruction manual

Simrad

Simrad CA34 manual

Endress+Hauser

Endress+Hauser Micropilot FMR67B Brief operating instructions

Endress+Hauser

Endress+Hauser Levelflex M FMP45 operating instructions

ECHOMAX

ECHOMAX Active-X-Band manual

AGD

AGD 340 product manual

Kustom Signals

Kustom Signals Eagle 3 user manual

SYMEO

SYMEO STU product manual

Axis

Axis D2110-VE installation guide

MALA

MALA MIRA operating manual

Emerson

Emerson ROSEMOUNT 5300 Reference manual

Rosemount

Rosemount 5300 Series Reference manual

Endress+Hauser

Endress+Hauser Levelflex FMP56 Brief operating instructions

TERMA

TERMA SCANTER 5102 Technical maintenance manual

GSSI

GSSI UtilityScan quick start guide

Acconeer

Acconeer A111 datasheet

Crosley

Crosley CR37 instruction manual