> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Functional testing on mobile

> Check FTT pass rates, open failed runs, and start device tests from the KODE OS mobile app.

The **Functional Testing Tool (FTT)** runs automated checks on building equipment for commissioning and ongoing validation. On mobile, the `FTT` app shows pass rates, failed sequences, and building scores from [Functional Testing Tool](/products/ftt/overview) on the web.

Use mobile FTT to review results in the field. Project setup, workflow authoring, and deployment stay on the web ([FTT deployment](/products/ftt/deployment)).

## Common field tasks

| Task                                     | Where to start                                                       |
| ---------------------------------------- | -------------------------------------------------------------------- |
| Check overall pass rate for the building | [FTT home](#ftt-home) KPI tiles                                      |
| Open a failed or completed run           | `View All` → `History`                                               |
| Review a scheduled project               | `View All` → `Projects`                                              |
| Start a test on one unit                 | Device `More` menu → `FTT Reports` → `Start New Test` (when enabled) |

## FTT home

<span id="ftt-home" />

Open `FTT` from the building app launcher (or from the portfolio sheet when published).

<div className="flex justify-center w-full my-4">
  <Frame caption="Summary KPI tiles">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-ftt-kpi-summary.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=e6ea88d4d306e09d240083588dfee253" alt="FTT dashboard with average score, tested devices, and executed tests KPIs" width="400" height="867" data-path="images/mobile-app/kode-os-mobile-ftt-kpi-summary.png" />
  </Frame>
</div>

| KPI                           | Meaning                                   |
| ----------------------------- | ----------------------------------------- |
| `Average Score`               | Aggregate pass rate                       |
| `Tested Devices`              | Devices included in recent runs           |
| `Devices with Failures`       | Devices that still have failing sequences |
| `Executed Tests`              | Total test executions in range            |
| `Successfully Executed Tests` | Pass share                                |
| `Average Test Duration`       | Mean runtime per sequence                 |

Select `View All` for the full test list. Use the `filter` icon to change buildings or date scope.

Scroll the home screen for sequence, trend, and breakdown charts.

<AccordionGroup>
  <Accordion title="Chart reference on FTT home">
    | Chart                     | Shows                                                                |
    | ------------------------- | -------------------------------------------------------------------- |
    | `Sequence Success Scores` | Pass versus fail counts per sequence step                            |
    | `Buildings Score`         | Comparative bar chart across sites in portfolio context              |
    | `Workflows`               | Per-workflow archived, failed, and completed counts with score trend |
    | `Device Types`            | Share of tested devices by equipment type                            |
    | `Average Score by Area`   | Score breakdown by floor or area                                     |
    | `Status`                  | Overall completion gauge                                             |
    | `Score Trend`             | Performance over time                                                |
    | `Test Times`              | When tests run by day of week and hour                               |
  </Accordion>
</AccordionGroup>

## History and projects

Tap `View All` at the top of the home screen to open test history and projects.

<Tabs>
  <Tab title="History">
    The `History` tab lists completed runs with workflow name, score badge, timestamp, and device link. Tap a row to open that test.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Completed test runs">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-ftt-history.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=828b10ed20118f2fffaf92d1aea16e4c" alt="FTT History tab listing V2 VAV Damper Operation tests with score badges and device links" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-ftt-history.png" />
      </Frame>
    </div>

    <Tabs>
      <Tab title="Details">
        The `Details` tab shows building, device, workflow, score, timing, and status.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-ftt-test-details.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=5c2232b159474991976355bfe29434df" alt="FTT test Details tab with building, device, workflow, 100 percent score, and Completed status" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-ftt-test-details.png" />
          </Frame>
        </div>

        Scroll for `Score Results` (pass rate over time) and `Sequences Results` (passed versus failed counts by run date).
      </Tab>

      <Tab title="Test">
        The `Test` tab shows the step-by-step run timeline. Each step lists timestamps, sequence descriptions, sensor readings, and pass or fail outcomes. The run ends with `Finished` and the final score.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto" caption="Finished score">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-ftt-test-timeline-finished.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=7e912e84333bdd39657e67af3849a987" alt="Test tab timeline showing Open Damper sequence and Finished score of 100 percent" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-ftt-test-timeline-finished.png" />
          </Frame>
        </div>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Projects">
    Review scheduled and executed [FTT projects](/products/ftt/projects). Each card shows the project name, workflow, device count, status (`Scheduled` or `Executed`), recurrence (`Recurring` or `Once`), and run time.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Scheduled and executed runs">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-ftt-projects.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=39c687ff6fe3a6c7e66fea2b90e5d6db" alt="FTT Projects tab listing VAV Damper Operation, Cooling test, and Test Training with status and recurrence badges" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-ftt-projects.png" />
      </Frame>
    </div>

    Tap a row to open the project.

    | Tab       | Shows                                                                                                      |
    | --------- | ---------------------------------------------------------------------------------------------------------- |
    | `Details` | Workflow, device count, completion percentage, schedule dates, status, recurrence, description, and reason |
    | `Tasks`   | Execution groups with status, run times, device count, and completion percentage                           |
    | `Devices` | Progress by area and status, then individual device rows                                                   |
  </Tab>
</Tabs>

## Start a test from a device

<span id="ftt-reports-from-a-device" />

When your site enables mobile test runs, you can start a test from equipment.

<Steps>
  <Step title="Open FTT Reports">
    From a [device](/products/mobile-app/building/devices#device-menu), open the `More` menu and choose `FTT Reports`.
  </Step>

  <Step title="Review past runs">
    Each card shows the workflow name, device, area, reason, status badge, duration, and timestamp. Tap a report to open the run timeline and final score.
  </Step>

  <Step title="Start New Test">
    Tap `Start New Test`. Choose a `Workflow` and `Reason`, add an optional `Workflow Description`, then tap `Continue`.
  </Step>
</Steps>

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Test history with Start New Test">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-device-ftt-reports.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=d05e827dbb94341e6dfbe5efd16c26ee" alt="FTT Reports list with Failed and Archived test cards and Start New Test button" width="472" height="1024" data-path="images/mobile-app/kode-os-mobile-device-ftt-reports.png" />
  </Frame>
</div>

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Workflow and reason selected">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-device-ftt-run-new-test-form.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=d7159813715e5bd8f71ef57f9e7dcf54" alt="Run New Test form with workflow, reason, and description filled and Continue enabled" width="472" height="1024" data-path="images/mobile-app/kode-os-mobile-device-ftt-run-new-test-form.png" />
  </Frame>
</div>

<Info>
  If `Start New Test` is missing, your site is monitoring-only on mobile. Use web FTT to run or schedule tests. When no tests exist yet, the list can be empty while `Start New Test` still appears.
</Info>

For building-wide KPIs, use the [FTT home](#ftt-home) screen from the app launcher.

## Next steps

<CardGroup cols={2}>
  <Card title="Devices on mobile" icon="hard-drive" href="/products/mobile-app/building/devices" arrow={true}>
    Open equipment, trends, and device actions.
  </Card>

  <Card title="Events on mobile" icon="bell" href="/products/mobile-app/events/work-with-events" arrow={true}>
    Filter, acknowledge, and investigate events.
  </Card>

  <Card title="FTT on web" icon="flask-conical" href="/products/ftt/overview" arrow={true}>
    Author workflows and deploy projects.
  </Card>
</CardGroup>