Skip to content

OvApp Overview

What is OvApp?

OvApp is a Bluetooth Low Energy (BLE) and location-enabled Android application used in the battery-swapping ecosystem.

It brings together different user types—Riders, Passive Customers, Agents, and Distributors—and gives each of them tools tailored to their role:

  • Riders can find swap stations on a map, perform battery swaps, and track their swap history.
  • Passive Customers can enter tokens/codes on a keypad to (re)activate devices.
  • Distributors can monitor devices in their area, manage tokens, and oversee swap inventory.
  • Agents can scan devices over BLE, read technical data, and perform diagnostics.

OvApp works both online and offline and acts as the main mobile entry point into the wider OVES ecosystem (ERM, PAYG, swap stations, and connected batteries).

Purpose

OvApp is designed to:

  • Simplify battery swaps for Riders using:
  • Map-based navigation to nearby swap stations.
  • Station cards showing available batteries.
  • Swap history and expenditure tracking.
  • Provide secure keypad access for Passive Customers using time-limited codes/tokens.
  • Enable Distributors to:
  • Monitor device inventory in swap stations and warehouses.
  • Generate tokens for Riders and Passive Customers.
  • View device data and swap-related metrics.
  • Equip Agents with:
  • BLE scanning and connection tools.
  • Route tracking.
  • Device data views (att/cmd/sts/dta/dia).
  • Diagnostics and troubleshooting capabilities.

Access Rules

OvApp enforces access rules based on role:

  • Agents & Distributors
  • Must log in with an account linked to the Enterprise Resource Manager (ERM).

  • Their access is governed by permissions configured in the backend.

  • Riders

  • Typically log in to associate swaps and payments with a Rider profile.

  • After login, they see Rider-specific menus (Keypad, Routes, Swap History).

  • Passive Customers

  • Do not need to log in.
  • They access a simplified experience focused on Keypad + BLE connection to their device.

⚠️ Exact login requirements can be adjusted per deployment. The behavior above reflects the current default configuration.

Role-Based Experience

Role Login Required Main Features
Riders ✅ Yes Keypad, Map with nearby swap stations, Swap history & expenditure tracking
Passive Customers ❌ No Keypad access only (enter codes/tokens to (re)activate devices)
Distributors ✅ Yes Inventory dashboards, Device list, Token generation, Device data views
Agents ✅ Yes BLE scanning, Route tracking, Keypad access, Device data & diagnostics

Core Feature Groups

OvApp exposes features grouped into a few core areas:

  • Keypad Function

    • Enter codes/tokens to unlock or reactivate devices.
    • Used by Riders, Passive Customers, Distributors, and Agents.

  • Map & Routing (Riders)

    • Show nearby swap stations.
    • Display how many batteries are available per station.
    • Offer route guidance/menu to reach a swap station along the Rider’s route.

  • Swap History (Riders)

    • List of past swaps.
    • Total expenditure on battery swaps over time.

  • Inventory & Token Management (Agents/Distributors)

    • Device lists for swap stations and warehouses.
    • Token generation tools for Riders and Passive Customers.

  • Device Data & Diagnostics (Agents/Distributors)

    • Structured data grouped in:
      • att – Attributes (IDs, SIM, firmware).
      • cmd – Commands/configuration.
      • sts – Status & PAYG state.
      • dta – Data (power, battery, GPS, cycles).
      • dia – Diagnostics (cell voltages, temperatures).

  • Offline Access

    • Riders & Passive Customers:
      • Can use Keypad and view last synced data offline.
      • Agents & Distributors:
      • Can use BLE to read devices offline.
      • Need internet to sync changes and upload readings.

Summary

OvApp is a multi-role mobile app that connects Riders, Customers, Agents, and Distributors into one smart ecosystem. It combines:

  • BLE device access
  • Token/keypad activation
  • Map-based swap station discovery
  • Inventory & diagnostics views

All with support for online + offline operation in the field.