Haltian Field on Haltian Developer Documentation

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Installation

Android

Haltian Field for Android is available on Google Play Store. Search for “Haltian Field” or ask your Haltian representative for a direct link.

Requirements: Android 15 (SDK 35) or later.

iOS

Haltian Field for iOS is available on the Apple App Store. Search for “Haltian Field” or ask your Haltian representative for a direct link.

Requirements: iOS 15 or later.

Logging In

When you open the app, you see the login screen with four fields:

Search and Discovery

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Search tab is the primary way to find devices in Haltian Field. You can search by text, scan a QR code, or enter a numeric ID.

Android

Text Search

Tap the search field and type any of the following:

Search By	Example
Device name	`Meeting Room Sensor`
Customer Label ID	`LABEL-001`
Vendor Serial	`TSE-12345678`
External ID	`EXT-456`
GIAI	`urn:epc:id:giai:...`

The app shows auto-suggestions as you type (after a brief delay). Tap a suggestion or press search to see full results.

Device Details

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Device Details screen shows comprehensive information about a single device. Access it by tapping any device in search results, favorites, or recents.

Android

iOS

The top bar shows Device Details with a back arrow and a Configure button (visible to Installer, Designer, and Manager roles).

Device Name and Status

At the top of the screen you see:

Measurements

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Haltian Field displays real-time and historical sensor measurements for each device. The measurements shown on the Device Details screen depend on the selected device — the app automatically displays all measurement types that the device reports.

Different devices support different measurements. For example, an environmental sensor may show temperature, humidity, and CO₂ readings, while a presence sensor shows occupancy status and movement counts. Device health measurements like battery level and boot count are common across most device types.

Favorites and Recents

Mon, 01 Jan 0001 00:00:00 +0000

Favorites Dashboard

The Favorites tab is your personal dashboard for monitoring key device measurements at a glance.

Android

iOS

What Favorites Show

Each favorite card displays:

Measurement name (e.g., “Ambient Temperature”)
Device name
Latest value with unit
Relative timestamp (e.g., “2h ago”)
Min/max values from the last 24 hours (shown with ↓ and ↑ arrows)
Sparkline chart — a miniature trend line (when 3 or more data points are available)
Device thumbnail — if a photo has been uploaded to the device

Favorites are displayed as cards in a grid layout.

File Attachments

Mon, 01 Jan 0001 00:00:00 +0000

Overview

You can attach files — typically photos — to any device. File attachments help document device installations, record site conditions, or provide visual reference for field teams.

Viewing Attachments

The thumbnail image area on the Device Details screen shows the most recent photo. If multiple files are attached, you can browse through them.

Adding a Photo

Capture with Camera

Tap the thumbnail area on the Device Details screen (or the “Tap to add photo” placeholder)
Select Take Photo
The camera opens — frame the device and tap the shutter button
The photo is uploaded automatically

Upload from Gallery

Tap the thumbnail area on the Device Details screen
Select Choose File
Pick an image from your device gallery
The file is uploaded automatically

Note

Camera access requires granting the camera permission when prompted. The app works without camera access, but you cannot capture photos or scan QR codes.

Notes

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Device notes let you record metadata, installation details, observations, or other important information about a device and the space where it is installed. For example, you can document mounting height, orientation, nearby equipment, or maintenance instructions.

Notes are visible to all users in your organization who can access the device. They are also available programmatically via the GraphQL API and included in Parquet data exports, making them useful for reporting and integration workflows.

Keywords

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Keywords are tags you assign to devices to organize and categorize them. They help you group devices by function, location, project, or any custom criteria meaningful to your organization.

With keywords, users in your organization can quickly find sets of devices, identify device groups, and see the nature or other specific metadata of a device at a glance. Keywords are also available via the APIs — for example, in Parquet data exports — enabling filtering and grouping in external analytics tools.

Inventory by Keywords

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Inventory by Keywords view lets you browse your entire device fleet organized by keyword tags. Instead of searching for individual devices, you select a keyword and see all devices with that tag — useful for checking groups of devices during field visits or audits.

Requirements

Roles: Viewer, Installer, Designer, Manager

All roles can browse devices by keyword.

Accessing the Keywords Inventory

From the main navigation, open the By keywords view under the Devices section. You see an alphabetical list of all keywords defined in your organization.

Device Groups

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Device groups let you organize devices into logical collections for bulk monitoring and configuration. Unlike keywords (which categorize devices by metadata), groups are explicit lists of devices you assemble for a specific purpose — such as a maintenance batch, a deployment phase, or a set of devices that share the same configuration.

Requirements

Action	Required Role
View groups and members	Viewer, Installer, Designer, Manager
Create, edit, delete groups	Installer, Designer, Manager
Configure group devices	Installer, Designer, Manager

Accessing Device Groups

From the main navigation, tap Device groups under the Devices section. You see a list of all groups with device counts.

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Configuration screen lets you view and manage the settings of a device. Access it by tapping the Configure button on the Device Details screen.

All users can view the current device configuration. Users with Installer, Designer, or Manager roles can also modify settings and send configuration changes to the device.

Note

The configuration page is different for each device type. The available settings and options vary depending on the device model, so you may see different parameters for different devices.

Map and Location

Mon, 01 Jan 0001 00:00:00 +0000

Map View

The Device Details screen includes an interactive map showing where the device is located. The map appears in the Location section when the device has coordinates.

Tap the map preview to expand it to fullscreen
Pinch to zoom in and out
Swipe to pan around
The device location is shown with a pin on the map

You can switch between different map styles (light, dark, and other visual themes) depending on your preference.

Device Alerts

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The Device Alerts dashboard gives you a quick overview of devices that need attention — specifically, devices with low battery voltage and gateways that have gone offline. Use this screen to plan maintenance visits and catch connectivity issues early.

Requirements

Roles: Viewer, Installer, Designer, Manager

All roles can view device alerts.

Accessing Device Alerts

From the main navigation, tap Device alerts under the Devices section.

Alert Types

Battery Voltage Warnings

The system monitors battery voltage for supported device models and flags devices that fall below safe thresholds:

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

Cannot reach server

Symptoms: “Network error: Cannot reach server” or “Connection timeout: Server is not responding” message on login.

Solutions:

Verify the Host URL is correct
Check your internet connection (WiFi or mobile data)
Try opening the Host URL in a web browser to confirm the server is reachable
If using a corporate network, check if a VPN is required
If the server is not responding, try again later or contact your administrator

Invalid credentials

Symptoms: “Login failed: Invalid credentials or server error” message.

Haltian Field on Haltian Developer Documentation

Getting Started

Installation

Android

iOS

Logging In

Search and Discovery

Overview

Text Search

Device Details

Overview

Device Name and Status

Measurements

Overview

Favorites and Recents

Favorites Dashboard

What Favorites Show

File Attachments

Overview

Viewing Attachments

Adding a Photo

Capture with Camera

Upload from Gallery

Notes

Overview

Keywords

Overview

Inventory by Keywords

Overview

Requirements

Accessing the Keywords Inventory

Device Groups

Overview

Requirements

Accessing Device Groups

Configuration

Overview

Map and Location

Map View

Device Alerts

Overview

Requirements

Accessing Device Alerts

Alert Types

Battery Voltage Warnings

Troubleshooting

Login Issues

Cannot reach server

Invalid credentials