Android App

Standalone Alternative

This app is an all-in-one alternative to the PC setup guide. If you use the Android app, you do not need to run terminal commands on a computer.

The open-source Axiom Android app packages the entire discovery, gRPC diagnostic communication, and ADB key pairing workflow into a single mobile application.

---

Manufacturing Mode

Use this if you know your scooter is already in manufacturing mode and want to use Direct IP Connection.

Finding Your Scooter’s IPv4 Address (Optional)

Connecting over IPv4 using your local Wi-Fi subnet is often the most convenient method. If you do not have access to your router’s administration page to find the DHCP client lease, you can view the assigned IPv4 address directly on the scooter’s touchscreen:

1. Open Wi-Fi Settings: On your scooter display, open the settings menu and navigate to Wi-Fi.

2. Select Connected Network: Tap directly on the Wi-Fi card you are currently connected to.

   Tap on the active Wi-Fi network card to open its connection details.

3. Locate IPv4 Address: The network details screen will display your scooter’s current network configuration:

   Your IPv4 address is shown on this screen.

---

Getting Started with the App

1. Download and Install the Application:

   Visit the official releases repository and download the latest version:

   • Download Link: Axiom Releases on Codeberg

   Download app-release.apk from the latest release, open the file on your Android device, and proceed with the installation. (If prompted, allow your browser or file manager permission to install unknown apps).

2. Launch the App:

   Open Axiom from your home screen or app drawer and tap Get Started to proceed to the connection setup.

3. Choose Your Connection Method:

   The app presents three connection methods based on your network environment:

   • Direct IP Connection: Use this if IPv4 access is already unblocked on your scooter (such as when manufacturing mode is already active). Simply input the scooter’s IPv4 or link-local address and tap connect.
   • Discover Neighbors: Best when both your phone and scooter are connected to a standard Wi-Fi network (such as a home router). Note that standard mobile hotspots typically fail here because Wi-Fi AP client isolation blocks devices from communicating directly with each other.
   • Shizuku Discovery: Recommended if you are connected via a mobile hotspot (or hosting the hotspot directly from your phone). By pairing with Shizuku, the app inspects kernel neighbor tables with elevated permissions to discover the scooter’s link-local IPv6 address. It then connects over IPv6, which succeeds in most hotspot environments because AP client isolation typically only blocks IPv4 traffic.

   Select the connection method that best matches your network setup.

4. Scan and Select Your Scooter:

   Once scanning begins, the app listens for the scooter’s diagnostic service on TCP port 50005. When your scooter appears in the list, tap on it to establish a connection.

   Tap on your discovered scooter to connect.

5. Access Basic Diagnostics:

   Once connected, the app opens an active gRPC session to your head unit. You can now access and view your scooter’s basic diagnostic readings, device status, and telemetry directly from your phone.

   View vehicle telemetry and diagnostic status directly in Axiom.

---

Using Features in the App

Once connected, navigate to the Control tab at the bottom of the screen to access advanced head unit controls, terminal access, application management, and vehicle operation modes.

Executing Root Shell Commands

You can execute shell commands directly on the scooter from the integrated terminal in the ADB card:

1. Choose an Execution Method:
   • gRPC (Recommended): Directly executes shell commands through the diagnostics service. It is significantly faster and does not require ADB daemon pairing.
   • ADB: Routes commands through a wireless ADB session.
2. Both methods can give you root access.
3. Tap Open Terminal to launch the interactive shell session.

Select an execution method and tap Open Terminal.

4. In the terminal window that opens, enter any commands you wish to execute. If you chose the ADB execution method, run the su command to elevate to root.

---

Launching Apps

You can launch any installed application directly on your scooter’s display:

1. Scroll down to the App Launcher card in the Control tab.
2. Search for the app you want to open.
3. Tap Launch. The application will open immediately on the scooter’s touchscreen.

Search for and launch installed applications on the scooter.

---

Installing APKs

You can sideload third-party Android applications directly onto your scooter:

ADB Connection Required

Sideloading applications requires an active ADB connection. Ensure your ADB pairing is active before installing APKs.

1. Scroll down to the App Installer card in the Control tab.
2. Tap to select the .apk file you want to install from your phone’s storage.
3. Tap Install to upload and install the package on your scooter.

Select an APK file to install onto the scooter’s head unit.

4. Once installation is complete, a prompt will appear asking if you want to launch the app. Tap Launch App to open it immediately on the scooter.

Tap Launch App to open the application directly after installation.

---

Accessing Diagnostic Mode from the HMI

Ola typically requires scanning a dynamic QR code / OTP to enter factory diagnostic mode from the scooter. You can bypass this requirement by changing your vehicle operation mode into Manufacturing mode directly within Axiom:

1. In the Control tab, scroll down to the Vehicle Operation Mode card.
2. Tap Manufacturing to switch the scooter out of Customer mode.

Switch the vehicle operation mode to Manufacturing.

Once the operation mode has been set to Manufacturing or Service mode, trigger the diagnostic screen directly from the dashboard:

1. Unlock the Scooter: Power on and unlock your scooter to reach the main MoveOS home screen.

2. Navigate to Ride Stats: Swipe left twice across the touchscreen to navigate to the Ride Stats screen.

   Navigate to the Ride Stats screen on the dashboard.

3. Tap Regen Stats 6 Times: Locate the Regen stats card on the display and tap it 6 times.

   Tap the Regen stat box 6 times to open the PIN entry dialog.

   A PIN keypad modal will open on the touchscreen.

4. Enter the Static PIN: Enter the passcode 560095.

   Because the scooter is operating in Manufacturing or Service mode instead of Customer mode, the HMI verifies this static factory PIN rather than demanding dynamic QR authentication.

5. Diagnostic Mode Opens: The factory diagnostic interface (com.ola.mfgapp) will launch immediately on the dashboard display, allowing you to test vehicle hardware.

   The onboard diagnostic mode interface.

Vehicle Identification Number (VIN) Notice

Although an option to modify your vehicle’s VIN is available within the diagnostic interface, altering or tampering with a vehicle’s VIN without proper legal authorization is strictly illegal in most jurisdictions. We do not support, encourage, or condone any unauthorized modification of vehicle identifiers.