Locus User Documentation

1. Introduction

Welcome to the LOCUS Application Guide

Using TEKTELIC’s IoT devices, LOCUS tracks assets with BLE beacons for indoor spaces and GPS/WiFi for outdoor areas. It works with all LoRaWAN Gateways and Network Servers, so the user is covered no matter your setup. User creates Sites (your main locations), Buildings, and Floor Plans, then adds Devices and Assets to a Home Site. Assets can move between Sites, and you’ll see them all on a global Outdoor Map. Set up Geofences and Alarm Rules to get notified when Asset enters or leaves specific zone.

2. Acronyms and Glossary

Altitude - Height of an asset relative to sea level, measured in meters.
Asset - An item or object user want`s to track, such as equipment or inventory. In LOCUS, assets are linked to devices to monitor their location.
Asset ID - A unique identifier is automatically generated by the system for each asset.
Asset Status - The current condition of an asset in LOCUS, shown as Online (actively tracked with updates), Offline (no current data from the device), or Not Active (not linked to a device). This reflects whether the asset’s position is being monitored.
Asset Type - A category user creates in LOCUS to label your assets. It can be anything you need to track, like a van, cart, or a person, helping you organize and identify assets easily.
Battery Level - The most recent battery level of a device or beacon (%).
Beacon - Device from TEKTELIC or a third-party provider that uses BLE (Bluetooth Low Energy) to send signals. Beacons help devices locate assets indoors by acting as reference points for tracking.
Beacon ID - Unique identifier automatically generated by the system for each beacon.
BLE (Bluetooth Low Energy) - Wireless technology used by beacons for short-range communication.
Beacon model - The specific type or version of a beacon used in LOCUS. For Tektelic beacons, the model is automatically pulled from the database. For third-party beacons, the user needs to contact a Support Engineer to create and enter the model.
Building - A structure within a Site for indoor tracking. Contains floor plans. Linked to a Site.
Device - A TEKTELIC IoT tracker that collects location data (via GPS, BLE, or WiFi). Devices must be assigned to an asset to display its position.
Device model - Specific hardware model name of a tracking device (e.g., PELICAN).
Event - Notification triggered by predefined conditions (e.g., low battery).
Event ID - Unique identifier automatically generated by the system for each event.
Event Rules - Custom conditions user sets in LOCUS to trigger alerts about your assets. Examples include when an asset enters or exits a geofence or when a device’s battery runs low.
Device EUI – 64-bit globally-unique Extended Unique Identifier (EUI-64) is assigned by the manufacturer, or the owner of the end device.
Floor Plan - Internal layout map of a building, used for indoor tracking.
Home Site - Logical or primary location assigned to an asset/device by the user.
Geofence: A virtual boundary user creates in LOCUS to monitor assets indoors or outdoors. The user can set it up around a specific area (like a room or a site) and link it to event rules to trigger events, such as when an asset enters or exits the zone.
Indoor Map – In LOCUS, this refers to a layout of a specific level within a building (e.g., an office floor or warehouse section). User will use indoor maps to place devices and beacons for precise indoor tracking.
Latitude – A geographic coordinate that shows an asset’s north-south position on Earth. In LOCUS, it’s used with GPS data from Tektelic devices to track assets outdoors.
LoRa - Long-range wireless communication technology used by tracking devices
Longitude – A geographic coordinate that shows an asset’s east-west position on Earth. Paired with longtitude in LOCUS, it pinpoints outdoor asset locations using GPS.
MAC Address - 12-character unique network identifier for beacon devices.
Outdoor Map – Global map showing the planet, focused on a specific Site. Tracks devices moving between Sites using GPS or WiFi.
PSR (Packet Success Rate) - Percentage of successfully received data packets from a device within one hour.
RSSI (Received Signal Strength Indicator): Signal strength received from devices or beacons, measured in dBm.
SNR (Signal-to-Noise Ratio) - Measurement of signal quality compared to background noise, expressed in decibels (dB).
Site – Top-level location for managing tracking. Contains buildings or outdoor areas. Devices are assigned here.
Tag – Custom labels used to categorize and organize assets.
Tenant – Organization or workspace within the LOCUS application.

3. Key Features

LOCUS empowers user to track assets indoors and outdoors with precision and ease. Here are its standout features to streamline your asset management:

Real-Time Tracking: Monitor asset locations instantly using TEKTELIC devices with GPS (outdoors), BLE (indoors), or WiFi, so you always know where everything is.
Customizable Entities: Create and manage sites, buildings, floor plans, devices, beacons, and assets yourself, tailoring the app to your exact needs.
Geofence Monitoring: Set virtual boundaries (indoor or outdoor) and get alerts when assets enter or exit them, keeping you in control.
Event Rules: Define custom alerts for key events, like an asset moving in or out of a geofence or a device’s battery running low, with options for email, SMS, or app notifications.
Indoor Mapping: Use floor plans to place devices and beacons, ensuring precise tracking inside buildings like warehouses or offices.
Asset Management: Assign devices to assets and categorize them with custom asset types (e.g., van, cart, or person) for easy organization.
Seamless Integration: Works with any LoRaWAN Network servers.

REST API for integration with 3rd party systems
Device Insights: Track device status (Online, Offline, Not Active)
Location Precision: Pinpoint assets with latitude and longitude outdoors, or BLE reference points indoors, all updated live.