7 min

Why Edge-Based Action Matters in Fuel Security
When a fuel security event occurs, detection is only the first step. A fast and reliable response is equally important, especially when a vehicle is outside cellular coverage.
In a conventional telematics workflow, a fuel cap event travels from the cap to the GPS tracker, through the mobile network to a server, and into a fleet management platform. The platform then processes the event and sends an output command back to the vehicle.
Each stage introduces potential delays and depends on network availability.
Teltonika Custom Scenarios offers a different approach. Once a compatible Teltonika tracker receives Bluetooth status data from Trak Smart Fuel Cap, it can evaluate predefined conditions locally and activate a digital output without waiting for a server response.
The result is local action with cloud visibility. The tracker handles immediate security responses, while the fleet platform continues receiving data for notifications, reporting, and investigation.
Four Operational Advantages
Continued protection without mobile data
Local rules operate independently of cellular coverage and server availability. As long as the tracker is powered, receives the required Bluetooth data, and has access to the configured input/output sources, security actions can continue even when the vehicle is offline.
Faster and more predictable response
Eliminating the network and server round trip reduces unnecessary delays. Sirens, warning lights, and compatible camera inputs can respond as soon as the tracker evaluates the fuel cap status.
Reduced server-side processing
Immediate security decisions are handled by the tracker. This allows the fleet management platform to focus on event storage, notifications, reporting, and analytics rather than processing every local output command.
Advanced security scenarios with external devices
Teltonika digital outputs can control compatible peripherals, including sirens, warning lights, relays, and camera trigger inputs.
Additional conditions, such as driver authorization, smart tag presence, or ignition status, can also be incorporated where supported by the tracker and firmware.
How Trak Smart Fuel Cap and Custom Scenarios Work Together
Trak Smart Fuel Cap communicates its status over Bluetooth Low Energy (BLE), indicating whether the cap is open, closed, or has detected tampering.
A compatible Teltonika tracker receives this information and makes it available through a custom input/output (I/O) parameter.
For Custom Scenarios, the cap status must be mapped to the Custom 2 field of the corresponding BLE sensor slot.
Custom 1: Displays the status in hexadecimal format.
Custom 2: Provides the integer value required for scenario-based threshold conditions.
The cap can be assigned to BLE 1, BLE 2, or another available sensor slot. The scenario must reference the matching Custom 2 source.

Teltonika Custom Scenarios supports up to three independent scenarios, each with up to three triggers. Depending on the hardware and firmware, users can configure threshold conditions, AND/OR logic, activation delays, event priority, and digital output control.
For the standard Trak/Teltonika byte order, the two cap-open values are:
29557: Cap open, no tamper detected.
29301: Cap open, tamper detected.
Both conditions should be included to ensure the local response is activated whether the cap is opened normally or a tamper condition is also present.

A third scenario can be configured to detect tampering while the cap remains closed:
29292: Cap closed, tamper detected.
Important: When tampering is detected, Trak Smart Fuel Cap repeatedly broadcasts the tamper status for 15 seconds to improve detection reliability.
How long this status remains visible to the Teltonika tracker depends on the device, Bluetooth scanning configuration, and data-clear settings.
For tamper-triggered outputs, we recommend disabling Permanent Output Control and defining a finite DOUT ON Duration.
To generate a single output pulse, set DOUT OFF Duration to zero. Non-zero ON and OFF durations may produce a repeating pattern until the scenario becomes inactive.
Trak Smart Fuel Cap Status Values
The following values apply to the standard byte order described in the Trak Teltonika pairing guide.

The displayed integer may differ if another byte order or endianness is selected. Always verify the live values on the target tracker before configuring scenario thresholds.
Configuring Digital Output Behavior
Custom Scenarios can activate an available digital output and generate an event record for the fleet management platform.
Two output modes are available:
Permanent Output Control enabled: The output remains active while the scenario condition is true.
Permanent Output Control disabled: Configurable ON and OFF durations allow pulse-based or repeating output behavior.

This flexibility allows the output to match the connected equipment. A siren may require continuous activation, while a camera or external controller may need only a short trigger pulse.
Before installation, verify the tracker's output type, current capacity, peripheral voltage, and grounding requirements. Use a suitable relay or electrical interface where necessary, and ensure that vehicle wiring is completed by qualified personnel.
Practical Fuel Security Scenarios
Local Siren or Warning Light
When either cap-open status is detected, the tracker activates a connected siren or warning light.
Because the response is processed locally, the alarm can operate without a cellular data connection or server command.
Camera Recording Trigger
A compatible camera or digital video recorder (DVR) can receive a trigger when the fuel cap is opened or tampering is detected.
The tracker can also transmit an event record, allowing fleet operators to correlate video footage with vehicle location and event time.
Authorized Refueling
Additional inputs, such as a push button, smart tag, or ignition condition, can be incorporated into the security logic.
This enables integrators to design workflows that distinguish authorized refueling from potentially unauthorized fuel access, provided the tracker supports the required conditions.
Multi-Stage Security Response
Custom Scenarios can also support staged responses using multiple conditions and activation delays.
For example, an initial event may activate a warning light, while a persistent or higher-priority condition triggers a siren.
The available configuration depends on the tracker model, supported I/O sources, and the required operating logic.
Teltonika Tracker Compatibility
Teltonika provides Custom Scenarios through a feature-preview or evaluation firmware branch.
At the time this article was prepared, the official compatibility list for firmware 04.00.00.Rev.121 included the following models:

Firmware availability and supported models may change. Always consult Teltonika's official documentation to confirm current compatibility, firmware requirements, and configurator versions before deployment.
Configuration Overview
The following steps outline the integration process:
Pair the devices. Connect Trak Smart Fuel Cap to a compatible Bluetooth-enabled Teltonika tracker using the dedicated Trak pairing guide.
Check firmware compatibility. Verify that the tracker supports Custom Scenarios and install the appropriate firmware and configurator package.
Map the status data. Assign the fuel cap status to the correct BLE sensor slot using Custom 2.
Configure the scenarios. Define conditions for both cap-open values, set the required thresholds, and assign a digital output.
Set output behavior. Choose permanent or duration-based activation, configure any additional conditions, and validate the complete installation on the vehicle.
Combining Local Security with Fleet Intelligence
Custom Scenarios complements rather than replaces fleet management platforms.
The responsibilities are straightforward:
The tracker evaluates conditions and activates immediate vehicle-side responses.
The fleet platform manages remote notifications, event history, vehicle location, reporting, and analytics.
This approach combines faster local security actions with centralized operational visibility.
Fleet managers can continue monitoring fuel cap events and investigating suspicious activity, even though immediate vehicle-side responses no longer depend on server communication.
Bringing Faster Fuel Security to Connected Fleets
Combining Trak Smart Fuel Cap with Teltonika Custom Scenarios enables a flexible, device-level approach to fuel security.
By processing events locally, compatible trackers can activate connected security devices, maintain protection during cellular outages, and support more advanced authorization and alarm workflows.
For setup instructions, refer to the Trak Smart Fuel Cap - Teltonika configuration guide and Teltonika's official Custom Scenarios documentation.
To discuss a siren, camera, or multi-input security application, contact our technical team with your Teltonika tracker model, peripheral specifications, and preferred operating logic.
Join the newsletter
Be the first to read our articles.




