Skip to content

Blecon Documentation

Proximity association

Proximity association

Proximity association monitors when two device types come near each other or move apart, and can automatically create or remove asset associations based on physical proximity.

How it works

You define a parent device type and a child device type along with a proximity radius. When a child device enters the radius of a parent device, the system can trigger an association — for example, linking a sensor tag on a pallet to the truck it's loaded onto.

Trigger modes

Dwell

The association triggers when the two devices are within the radius for a specified duration. This avoids false positives from devices briefly passing each other.

Set trigger to "dwell".
Set dwell_seconds to the required time in proximity.

Co-movement

The association triggers when the two devices move together over a specified distance. This confirms they're physically travelling as one unit rather than just happening to be nearby.

Set trigger to "co_movement".
Set co_movement_meters to the distance they must travel together.

Parameters

Parameter	Description
`child_device_type`	Device type of the child asset
`parent_device_type`	Device type of the parent asset (must differ from child)
`radius_meters`	Proximity radius (0–10,000 m)
`trigger`	`"dwell"` or `"co_movement"`
`dwell_seconds`	Time in proximity before triggering (when using dwell)
`co_movement_meters`	Distance threshold for co-movement detection

See the alert rule types reference for the full parameter specification.