Documentation

Managing Sensors

Sensors collect additional data from your vehicles beyond basic GPS tracking. Common sensors include fuel level monitors, temperature sensors, and eco-score trackers that measure driving behavior.

Viewing Sensors

The Sensors table displays:

• ID: Unique identifier for the sensor
• Name: Your name for the sensor
• Device: Which GPS device the sensor is connected to
• Attribute: What the sensor measures (fuel, temperature, score)
• Parameter: The specific data field from the device
• Value: Current real-time reading from the sensor
• Sync Status: Connection status (Pending, Synced, Failed)

Understanding Sensor Values

Different sensor types display values differently:

• Fuel sensors: Show current fuel level in liters (after calibration)
• Temperature sensors: Show temperature in degrees
• Eco score sensors: Show a score with a rating (Excellent, Good, Not Good, Bad, Very Bad)

Values update in real-time as your devices report data.

Searching for Sensors

Use the search field to find sensors by name. Type your search term and press Enter.

Adding a Sensor

1. Click the Add Sensor button.
2. Complete the tabs:

General Tab

• Name (Required): A descriptive name for the sensor
• Device (Required): Select which GPS device this sensor is connected to
• Attribute: What the sensor measures:
  • fuel: Fuel level monitoring
  • score: Driver behavior/eco score
  • temperature: Temperature monitoring
• Parameter: Select which data field from the device this sensor reads

Calculations Tab

This tab appears for fuel and score sensors:

For fuel sensors:

• Enter calibration data to convert raw sensor readings into accurate fuel volume (liters)
• Calibration is necessary because sensor voltage doesn't directly correspond to fuel level

For eco score sensors:

• Configure how the driving score is calculated
• Set thresholds for different rating levels

3. Click Create Sensor.

Editing a Sensor

1. Find the sensor in the table.
2. Click the actions menu (three dots) in that row.
3. Select Edit.
4. Update the configuration as needed.
5. Click Update Sensor.

Deleting a Sensor

1. Find the sensor in the table.
2. Click the actions menu (three dots) in that row.
3. Select Delete.
4. Confirm the deletion.

Sync Status

Sensors sync with the NexaBus server to ensure accurate data:

• Pending: Currently syncing
• Synced: Successfully connected
• Failed: Connection failed - click to retry

If sync fails repeatedly, check that the associated device is online and properly configured.

Permissions

You need the appropriate permissions to add, edit, or delete sensors. If these options are not visible, contact your administrator to request access.