Documentation

Managing Sensors

Sensors collect additional data from your vehicles beyond basic GPS tracking. NexaBus supports fuel level monitors and eco-score sensors that measure driving behavior.

Viewing Sensors

The Sensors table displays the following columns:

• ID: Unique identifier (hidden by default)
• Name: Your name for the sensor
• Device: Which GPS device(s) the sensor is connected to, or "All Devices"
• Attribute: What the sensor measures (Fuel or Eco Score)
• Parameter: The specific data field from the device
• Value: Current real-time reading from the sensor
• Sync Status: Connection status with the tracking server
• Actions: Edit and Delete options

On mobile devices, columns like ID, Name, Attribute, Parameter, and Sync Status are automatically hidden.

Sensor Grouping

When a device has multiple sensors, they are automatically grouped together in the table:

• Click the expand button to see all sensors for that device
• Group headers show the sensor count
• Configure aggregation settings for grouped sensors

Understanding Sensor Values

Different sensor types display values differently:

• Fuel sensors: Show current fuel level in liters (e.g., "45.50 L") after applying calibration
• Eco score sensors: Show a score from 0-10 with a rating badge:
  • 8.00-10: Excellent (green)
  • 6.00-7.99: Good (neutral)
  • 4.00-5.99: Not Good (yellow)
  • 2.00-3.99: Bad (orange)
  • 0-1.99: Very Bad (red)

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

Searching for Sensors

Use the search field to find sensors. The search works across sensor name, attribute, parameter, and device name. Results update as you type.

Adding a Sensor

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

General Tab

• Name (Required): A descriptive name for the sensor (e.g., "Main Fuel Tank")
• Attribute (Required): What the sensor measures:
  • Fuel: Fuel level monitoring
  • Eco Score: Driver behavior/eco score
• Device Selection:
  • Check All Devices to apply this sensor to all your devices
  • Or select specific devices from the dropdown
• Parameter (Required): Select which data field from the device this sensor reads. Available parameters are loaded from your devices.

Calculations Tab

This tab appears only for Fuel and Eco Score sensors:

For Fuel Sensors:

Configure calibration data to convert raw sensor readings into accurate fuel volume:

1. Calibration Points View:
   • Enter pairs of sensor level (X) and fuel in liters (Y)
   • Add multiple points for accurate calibration
   • Import from CSV using the import button
2. Coefficients View:
   • Shows calculated slope (a) and intercept (b) for each segment
   • Formula: Y = aX + b
   • Click Generate to calculate coefficients from calibration points
3. Chart View:
   • Visual representation of calibration curve
   • Shows min/max values and data points

For Eco Score Sensors:

View how eco scores are calculated:

• Formula: ECO Score = 10 / (Events / (Distance x (Allowed Events / 100)))
• Monitored Events:
  • Harsh acceleration
  • Harsh braking
  • Harsh cornering
  • Over-speeding
  • Excessive idling
  • High RPM (requires OBD device)

3. Click Create Sensor.

Sensor Grouping and Aggregation

When multiple sensors measure the same attribute on a device, you can configure how their values are combined:

1. Click the group configuration button on a grouped row.
2. Create calculation groups and assign sensors.
3. Choose an aggregation method for each group:
   • Sum: Add all values together
   • Average: Calculate the mean value
   • Min: Use the lowest value
   • Max: Use the highest value
4. Choose a final aggregation method to combine groups.
5. Preview shows the calculated result.

This is useful for vehicles with multiple fuel tanks or sensors.

Comparing Device Parameters

When creating an "All Devices" sensor, click View Missing Parameters to see:

• Which devices are missing the required parameter
• Which devices have no data yet
• This helps identify devices that need configuration

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:

• Syncing: Spinning icon indicates sync in progress (yellow)
• Synced: Check icon confirms successful connection (green)
• Outdated: Alert icon indicates data may be stale - click to refresh (yellow)
• Failed: Error icon indicates sync failed - click to retry (red)
• N/A: Dash indicates no devices assigned

Sync status updates automatically in real-time.

Real-Time Value Updates

Sensor values update automatically via WebSocket connection:

• No page refresh needed
• Values update as devices report new data
• Fuel values apply calibration formulas automatically
• Eco scores normalize to 0-10 scale

Pagination

The table displays 10 sensors per page. Use the pagination controls at the bottom to navigate:

• First and Last page buttons
• Previous and Next page buttons
• Current page indicator showing "Showing X to Y of Z"

Permissions

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