Machine Companion App Manual
Page Contents
Introduction¶
The Machine Companion App operates as an extension of the machine, giving OEMs, dealers, and machine owners access to machine-related insights. The app is available on both Android and iOS.
The main target groups of the app are:
- Machine owners with a smaller number of machines compared to the OEM.
- Dealer or OEM organizations handling maintenance tasks.
App Variants¶
The app can be offered in two variants:
- Standard variant: set up with the standard Proemion signals for the machines accessible by the machine owner. The app is free to download and available on both Android and iOS, see Machine Companion App (Google Play) and Machine Companion App (App Store). No branding or customization applies to this variant.
- Customized (white-labeled) variant: a paid variant delivered through the OEM's own Google Play and App Store channels.
During the initial setup, Proemion collects the OEM's configuration details:
- Custom signals to highlight key metrics, see Signals List for how signals are selected and displayed.
- A custom theme and color scheme.
- SSO authentication, if required, see Login.
Warning
Customers who choose a white-labeled DataPortal URL must also upgrade to a white-labeled Machine Companion App, because access to the standard Proemion app is restricted in that case. Treat white-labeling the portal and the app as part of the same upgrade or purchase to keep access uninterrupted and the user experience consistent.
Login¶
Machine Companion App uses a single login flow for all users: tapping Login redirects to a Proemion web login page, where the user signs in with their account credentials or through the OEM's configured SSO, if set up during the initial setup.
Features
Overview¶
Machine Companion App organizes machine data and insights into a set of dedicated screens, accessible from the side panel menu:
- Machines: the inventory of available machines, in both list and map views.
- DTCs: active diagnostic trouble codes across all machines.
- Maintenance: machine-specific maintenance tasks and their status.
- Events: geofence entry and exit events.
- Settings: profile, signals, and other app settings.
Note
The Maintenance screen is enabled only if the OEM has opted for Maintenance.

Machines¶
The Machines screen shows the inventory of available machines, presented in both list and map views.
In both views, you can:
- Search machines.
- Sort by Machine, Model, Organization Name, or Service due dates.
- Filter by Machine Mode (Online, Offline, or Not applicable), Model, Organization, and Warnings (for Fuel and AdBlue).
Status Icons¶
Both the list and map views show warning icons at a glance, for example when fuel or AdBlue levels are low, or when a machine has active diagnostic trouble codes (DTCs). They also show icons for the color-coded status of maintenance tasks, such as overdue, upcoming, completed, or skipped. Select a machine from either view to see the detailed tabs behind each icon.
- Low Fuel Level:
Details appear in the Fuel Tab.- Yellow: the fuel level is available and is above 15 % and at or below 20 %.
- Red: the fuel level is below 15 %.
- Low AdBlue Level:
Details appear in the Fuel Tab as well.- Yellow: the AdBlue level is available and is above 15 % and at or below 20 %.
- Red: the AdBlue level is below 15 % (Android only).
- Active Diagnostic Trouble Codes (DTCs):
Details appear in the DTCs Tab.- Red: at least one DTC is active.
- Maintenance:
Details appear in the Maintenance Tab.
Maintenance tasks are color-coded:- Grey: skipped.
- Green: completed.
- Red: overdue.
- Yellow: upcoming, i.e. hours remaining until the next service.
Machines List¶
The list view shows each machine as a row with its status icons for quick scanning:

- Select a machine to open its Machine Details.
- Icons for maintenance tasks, fuel or AdBlue levels, and active DTCs appear as described under Status Icons.
Machines Map¶
The map view plots the same machines geographically and additionally offers:

- Machine clusters for better accessibility; zooming in reveals more detail, down to individual machines. For details on cluster behavior, see Map view in the DataPortal manual.
- Machines shown with their model asset icon and online/offline status (enable this via the Themes Behavior option).
- Zoom controls (Zoom In, Zoom Out, Reset) to adjust the map view and select a specific machine.
- Location data and navigation options, to open the machine details or start Google Navigation to the machine's location.
- The same icons for maintenance tasks, fuel or AdBlue levels, and active DTCs as in the list view.
- A warning when location data is outdated.
Selecting a machine from either view opens its Machine Details screen, where you can monitor the machine's metrics across several tabs.
Machine Details¶
Open Machine Details for any machine from either the list or map view in Machines, to view the machine's data across several tabs.
Note
Machine Companion App always displays machine data in the user's configured time zone, regardless of the machine's actual location. For further information, see Date & Time.
General Tab¶
The General tab shows the machine's status, work metrics, and geolocation:

- Location history plotting within preconfigured time ranges (requires the Location:History Permission Set).
- Geolocation details, including the option to share the location or navigate to the machine, see Share Live and Static Location.
- Maintenance status indicators show the color-coded status of each maintenance task, including upcoming, overdue, skipped, and completed tasks, based on either the Proemion maintenance feature or the "Hours to next service" metric. Select a task to view its details.
- Zoom controls (Zoom In, Zoom Out, Reset) to adjust the map view and select a specific machine.
Signals List¶
The Signals list in the General tab shows essential Proemion standard machine signals and, if defined, aliased signals instead of the standard ones. The list shows the most recent update time and value for each signal available to the user for the selected machine:

Adapt the Signals list
The list can be customized to display the required machine signals within the app, based on the OEM configuration:
- Signal names and units are localized based on the user's preferred language (English, German, or Italian) and unit system. The localization follows the device settings.
- Machine owners can prioritize the order of signals by dragging and dropping them according to their individual importance, see Reorder Signals. The set of signals used for your Machine Companion App is listed in the Global Signals menu.
Custom Signals
For white-labeled variants, the signal list additionally supports both standard and custom signals based on the OEM preferences, which can be configured during the initial setup.
Reorder Signals¶
Machine owners can reorder the list of signals by priority using drag-and-drop. Reordering the signals changes their position shown in the General Tab of each machine.
Change the order via the Global Signals menu or through the settings icon in the General tab.
Select and hold a signal, then move it to the desired position:

Share Live and Static Location¶
Use the following options within the General tab to share the machine's location:

See Copy & Share location in the DataPortal manual, since the sharing options work the same way in both products.
Operating Hours Tab¶
The Operating Hours tab features a daily operating hours graph that shows both operating and idle hours for the past 7 days. It also includes a heatmap showing the operating hours for the last 30 days in a calendar view, with each day color-coded by value:

Customization¶
OEMs can customize both the graph and the heatmap for white-labeled variants during the initial setup.
For the Operating Hours graph:
- Choose preferred standard or custom signals (up to 3 signals with the same measurement unit).
- Tailor by aggregator and time range.
- Select the color scheme.
- Choose between bar or line charts.
- Customize the bucket size.
- Set a fallback signal to use if the primary one is unavailable.
Note
The graph is normally based on a time period of 7 days and the heatmap on 30 days.
For the Operating Hours heatmap:
- Choose the operating hours signal the heatmap is based on, for example "engine hours total" or "machine hours total".
- Select the duration, e.g. 7 days or 30 days.
- Set a fallback signal to use if the primary one is unavailable.
Fuel Tab¶
The Fuel tab shows the current fuel level, efficiency, and consumption.
Note
The Fuel tab is enabled only if the machine has the corresponding signal configured.

The same threshold icons appear next to each machine in Machines List.
Customization¶
OEMs can customize both the list and graph visualization for white-labeled variants on the iOS platform during the initial setup.
- Choose preferred standard or custom signals (up to 3 signals with the same measurement unit).
- Tailor by aggregator and time range.
- Select the color scheme.
- Choose between bar or line charts for the graph.
- Customize the bucket size.
- Set a fallback signal to use if the primary one is unavailable.
DTCs Tab¶
The DTCs tab shows the active DTCs reported by the machine:

The DTC details show the following information:
- Source: the hardware on the machine containing the error, e.g. "Engine #1".
- Suspect Parameter Number (SPN): the description of the error, e.g. "oil level".
- Failure Mode Identifier (FMI): the kind of error, e.g. "exceeding or falling below value ranges", "short-circuits at the sensor", "incorrect update rate", or calibration errors.
The same DTC icons appear next to each machine in the Machines List.
Note that the DTCs screen shows the DTCs of all machines.
Electric Tab¶
The Electric tab shows the battery and energy consumption.
Note
The Electric tab is enabled only if the machine has the corresponding signal configured.

Customization¶
OEMs can customize both the list and graph visualization for white-labeled variants during the initial setup.
- Choose preferred standard or custom signals (up to 3 signals with the same measurement unit).
- Tailor by aggregator and time range.
- Select the color scheme.
- Choose between bar or line charts.
- Customize the bucket size.
- Set a fallback signal to use if the primary one is unavailable.
Maintenance Tab¶
The Maintenance tab shows all maintenance tasks of the selected machine:

Select a maintenance task to view its details.
The same maintenance icons appear next to each machine in the Machines List.
Note that the Maintenance screen shows the maintenance tasks of all machines.
DTCs¶
The DTCs screen shows all active DTCs across machines, sorted by machine name, together with each machine's model name and DTC count:

Search for a specific model or machine name to filter the list, or select the filter icon in the top-right corner to filter by:

- Organization
- Model
- Machine
DTC Details¶
Selecting a machine opens its DTC details, listing every DTC reported for that machine:

For a description of the fields shown for each DTC, see DTCs Tab.
At the top of the DTC details, a link opens the related Machine Details page.
Maintenance¶
The Proemion Maintenance feature lets you monitor machine-specific maintenance tasks for each of your machines, along with details of additional maintenance services performed.
Note
If the OEM relies on "Hours to next service" for maintenance, Machine Companion App displays only the maintenance status indicators on the machine details page.
Overview¶
The Maintenance screen lists all maintenance tasks across machines, with their different statuses:

- (1) Indicators: show both the progress status (planned, unplanned, completed, skipped) and the deadline status (yellow icon for upcoming, red icon for overdue) of a maintenance task. Skipped and completed tasks have no deadline.
- (2) Filters: select the filter icon in the top-right corner to open the Filters and narrow down the list of maintenance tasks.
- (3) Sort: sort tasks by Newest, Oldest, or Last Modified.
Filters¶
Select the desired filter checkboxes and select Apply:

Maintenance tasks can be filtered by status:
- Progress
- Unplanned
- Planned
- Skipped
- Completed
- Deadline
- Upcoming
- Overdue
Other filters:
- Organization
- Model
- Machine
- Acknowledgement
Maintenance Task Details¶
Select a maintenance task to use the following features:
- View checklists for the maintenance services performed on a machine. Checklists let service technicians document actions such as exchanging fuel filters or replenishing engine oil.
- Add an optional completion note to share additional information about the maintenance task, during or after the service appointment.
- Request a signature during or after the service appointment, see Acknowledge Maintenance Tasks.
Update a Maintenance Task¶
The Update task button at the bottom of the maintenance task details moves the task to Planned status, resets it to Unplanned, or completes it. You cannot update skipped maintenance tasks.

To update a maintenance task, proceed as follows:
- At the bottom of the maintenance task details, click Update task.
-
In the dialog that opens, update the task:

Figure 4: Update task dialog -
Select Mark as planned to move the task back to planned status.
-
Or select Mark all as completed to complete the task and its open activities, or Continue anyway to close the task without marking the pending activities as completed:

Figure 5: Complete task Completing the task changes its state indicator to Completed and iterates or resets the service cycle:

Figure 6: Completed task in overview
The Overview list reflects the updated labels as well.
Acknowledge Maintenance Tasks¶
The acknowledgment process lets a dealer organization's service technician request acknowledgment from the machine owner once the service is complete, by validating the owner's identity and collecting a signature.

The acknowledged task syncs to the DataPortal, where you can also view the acknowledgment details, see Acknowledge Maintenance Tasks in the DataPortal manual.
To add a signature after completing a task, open the Maintenance screen, select Acknowledge Completion, and provide the signature in the field:

Events¶
The Events tab provides visibility into geofence events, letting users track when machines enter or exit predefined geographic areas. This gives insight into location-based activity and supports decision-making based on machine movements.
Events Listing¶
The Events screen shows a list of all geofence events, including both entry and exit breaches. Each event entry shows:
- Event title (e.g. "Geofence Entering Breach" / "Geofence Leaving Breach").
- Timestamp of the breach.
- Machine name (selecting the machine name opens its Machine Details).

Filter the list by:
- Machine
- Organization
- Time
Sort events by:
- Newest
- Oldest
Time-based Filtering¶
The Events tab supports time-based filtering, letting users filter events by predefined or custom time periods.
Default Behavior¶
- The default time filter is Current Year (year-to-date).
- When opening the Events tab, the Time filter is preselected and visible in the filter screen.
- Edge case: on January 1, the filter remains set to Current Year, even if few or no events are available.
Accessing the Time Filter¶
The Time filter is available under Events.

Select Time to open the dedicated Time Filter screen:

Available Options¶
The following predefined time ranges are available:
- Today
- Yesterday
- Current Week
- Current Month
- Current Year (default)
- Custom
The selected option is highlighted, and the selection persists when navigating back to the screen.
Custom Time Range¶
Selecting Custom enables a date range selection on the same screen:
- Users can select a start date and an end date.
- Select Done to confirm the selection and return to the main filter screen.
- Previously selected dates remain visible when reopening the filter.
Returning to Filter Screen¶
After confirming the selection, the selected time filter appears in the Time field:
- Predefined values are shown as labels (e.g. Current Week).
- Custom ranges are shown as formatted dates (e.g. Nov 1 - Nov 10).
Clear All¶
Selecting Clear All resets the Time filter to Current Year, and the Time field reflects the default value again.
Apply Filter¶
Selecting Apply filters the Events list based on the selected time range and other active filters (e.g. Machine, Organization).
Events Details¶
Selecting an event opens a detailed view with the following information:
- Event title (e.g. "Geofence Entering Breach" / "Geofence Leaving Breach").
- Timestamp of the breach.
- Machine name.
- Geofence area name.
- Location and address.
- A map showing the geofence area, the machine's track for ±15 minutes around the event time and its direction, a breach marker (red for a leaving breach, green for an entering breach), zoom and reset controls, and a legend.
Location Sharing¶
Users can also share the location of a geofence event, either as an address or as coordinates, enabling easy communication of location information with relevant stakeholders. See also Share Live and Static Location to share a machine's current location the same way.
Settings¶
The Settings screen provides the following menus:

Two toggles sit above the menus: Enable features in beta and Enable push notifications.
Machine Companion App follows the phone's language setting throughout the app, including the privacy policy documents described under Privacy Policy. Supported languages are English (fallback), German, French, and Italian.
Profile¶
The Profile menu shows the following account information:

- App or company logo
- Full name of the user
- Organization of the user
- E-mail address of the user
- Time zone of the user
- Unit system of the user
Global Signals¶
The Global Signals menu lists all signals used across your machines, and lets you reorder them yourself:

Read how signals are used in Machine Companion App in Signals List, which explains how this list and its ordering affect the General tab.
Privacy Policy¶
Upon launching the app or logging in, users see a Legal documents popup if they have not yet accepted the latest version of either the Mobile Privacy Note or the Platform Privacy Policy:

To continue using the app, users must check both the privacy note/policy checkbox and the EULA checkbox, then select OK. Selecting Cancel logs them out. The Platform Privacy Policy and Mobile Privacy Note each remain accessible at any time as their own menu item in Settings.
The app shows the privacy policy documents in the phone's language and records the consent.
Other Settings¶
- Imprint: legal company information.
- About: version information.
- Restore Default Settings: resets all default settings.
- Delete Account.
FAQ¶
Does the List of Signals Only Display Standard Signals?¶
Machine Companion App always ensures that the required signals are highlighted. The standard app is configured for the standard signals listed below.
All white-labeled variants support both standard and custom signals, which can be configured during the initial app setup, see Signals List.
Standard Signals¶
The following signals are the Proemion standard signals that can be displayed in Machine Companion App:
| Signal Label | Customer Metric Key |
|---|---|
| Total Operating Hours | value.common.machine.hours.operation.total |
| Idle Operation Hours | value.common.machine.hours.idle.total |
| Time To Next Service | value.common.machine.service.hourstonextservice |
| Total Distance Traveled | value.common.machine.distance.total |
| Fuel Level | value.common.engine.fuel.level |
| AdBlue Level | value.common.engine.def.level |
| Fuel Efficiency | value.common.engine.fuel.efficiency.current |
| Total Fuel Consumption | value.common.engine.fuel.used.total |
| Idle Fuel Consumption | value.common.engine.fuel.idle.total |
| Energy Consumption | value.common.engine.energy.total |
| Remaining Battery Capacity | value.custom.machine.battery.stateofcharge |
| Remaining Battery Time To Empty | value.custom.machine.battery.timetoempty |
| Machine State | value.common.machine.state.numeric |
| StarterBatteryVoltage | value.common.machine.battery.voltage |
| TelematicsControlUnitBatteryVoltage | value.common.cu.battery.voltage |
Are Custom Metrics Supported for the Operating Hours, Fuel, and Electric Tabs on the Machine Details Page?¶
Yes, the data displayed in the Operating Hours Tab, Fuel Tab, and Electric Tab on the machine details page can support custom metrics in white-labeled variants.
Can the Graphs Be Customized in the White-Labeled Variant?¶
The Operating Hours graph supports customization for white-labeled variants. OEMs can tailor the visualization according to their preferred signal (up to 3), aggregator, time range, color scheme, visualization type (bar or line), and bucket size during the initial app setup. Proemion plans to extend this customization to other graphs.
Can I Request New Graphs?¶
Yes, custom visualizations can be requested to meet individual needs and provide a more personalized experience. Proemion reviews these requests and evaluates their feasibility.
Service and Support¶
The latest versions of the drivers, software, firmware, and documentation are available at Document Library.
Do you need help or want to report a bug?
Visit Proemion for more information, or raise a ticket via Support.
Firmware Updates and Support¶
To ensure the best performance and security of your devices, we strongly recommend always installing the latest firmware provided by Proemion.
Please note:
We do not provide technical support for issues caused by outdated firmware.
Errors resulting from outdated firmware are considered non-qualified errors and are not covered by warranty or support.
Regular firmware updates are essential to maintaining the functionality of your devices.
If you need assistance with the update process, please contact our Service and Support.
For more information on the Firmware Update, check the device manual of your device at the Document Library.




