/
User Guide: Installer App

User Guide: Installer App

Introduction

The Installation App is a web application used during the installation process for various types of devices (Gateways, Sensors, etc.) at different sites. It allows installers to take photos of the devices and their locations, with the images uploaded alongside corresponding device details. All this information is stored in a database for future reference, ensuring proper documentation of each installation.

Getting Started

Logging In

  1. Open the Atria App in your web browser by visiting Atria App

  2. You'll see the blue login screen with the Milvian logo

  3. Enter your Email address in the designated field

  4. Enter your Password in the designated field

  5. Click the "Sign In" button

  6. If your credentials are correct, you'll be directed to the main dashboard

  7. If you've forgotten your password, use the "Forgot your password?" link to reset it

Main Dashboard

After logging in, you'll see the main dashboard with various application tiles. Select the "Installer" app to begin the installation process.

Site Information

  • Enter Site ID:
    1. Enter the Site ID in the field provided
    2. Click the "Start Site Install" button
    3. If the Site ID exists, you'll be redirected to the device installation form
    4. If the Site ID doesn't exist, you'll see an error message: "Site ID does not exist. Please enter a valid Site ID."

  • After Site ID Validation:
    You'll be redirected to the device installation form where you can:
    1. Change sites using the "Switch Sites" button
    2. Add device installation details

Device Details

1. Device Category Selection:

  • Click on the Device Category dropdown and select either "Gateway" or "Sensor"

  • Different device models will be shown different form fields based on their capabilities

2. Device ID Entry:

  • Enter the last 5 digits of the DevEUI in the field marked with a asterisk

  • The system will validate the DevEUI against the LoRaWAN Device/ Gateway table.

  • A confirmation message will appear with the device model if found (e.g., "✓ Device Model Detected: ENL-STS-P - Pulse Conversion Factor enabled" or "✓ Device Model Detected: MTCAP2-915-042A").

  • If a device model is recognized, additional fields specific to that device may appear

3. AssetName Information:

What is an Asset Name? It's a label that helps identify where and what type of device you're installing.

How to Choose:

  1. Look at the dropdown menu and select the pattern that matches your installation

  2. The app will show you a preview of the final name

  3. Enter any required numbers or descriptions

Asset Name Options:

Pattern

When to Use

Example

Pattern

When to Use

Example

MAIN

Main water, gas, or electric line feeding the building

MAIN

PART_MAIN_##

When the main line splits and needs two meters

PART_MAIN_01

SUB_**

Submeter feeding a specific part of a building after the main(like break room, floor)

SUB_BREAK_ROOM

DD_###

Dock door sensors

DD_001

ZN_**

Zone sensors (air quality, occupancy)

ZN_POLE_Q1

GW_**

Gateway devices

GW_NW_WALL

Quick Guide:

  • Water/Gas/Electric main line → Use MAIN

  • Split main line → Use PART_MAIN_## (enter number)

  • Submeter after main → Use SUB_**(enter area name)

  • Dock door → Use DD_### (enter door number)

  • Air quality/Occupancy/Noise sensor → Use ZN_** (enter zone name/description)

  • Gateway device → Use GW_** (enter location description)

4. Location Information:

  • Select the Location Type from the dropdown menu (Column, Dock Door, Roof, Shelves, Utility, Other, etc.)

  • Enter a detailed description in the Location Number/Description field (e.g., "11 floor" or "Pole") where device is installed

Pulse Counter Configuration

This section appears automatically when installing devices that support pulse counting, like the ENL-STS-P, ELT2, EM300-DI sensors and Pulse Conversion Factor is enabled for these sensors

1. Pulse Conversion Factor Section:

You'll see a "Pulse Conversion Factor" section with a light blue background.
Message: "Choose what type of meter is connected to this pulse input (like Water Meter, Electricity Meter etc), then select the appropriate measurement unit and register value."

2. Add Pulse Counters:

  • Click "+Add Pulse" to add pulse conversion values (up to 3 pulse counters)

3. Device Type Selection:

Click the "Select Device Type" dropdown and choose from options like:

  • Pulse Water Meter

  • Pulse Gas Meter

  • Pulse Electricity Meter

4. Register (Conversion) Value:

  • Enter the conversion value in the field labeled "Value (e.g. 0.0001)"

5. Unit Selection:

  • Click the "Select Unit" dropdown to choose the appropriate measurement unit

  • Available units are filtered based on the selected Device Type

Go-live Date Functionality

The Go-Live Date (UTC) allows the user/installer to specify when a device’s data should begin to be treated as valid, typically once calibration, configuration, and installation are complete. Any data collected before the Go-Live Date should be considered invalid and should NOT be used for analysis, interpretation, alerts, downstream reporting, or related purposes.

The process for setting it during a first-time install is slightly different from updating it for an existing install.

Note: On the Installation Details page, the Go-Live Date (UTC) section appears after entering the last 5 digits of the DevEUI. This is because the device type determines the section’s location, as specified below.

  1. First-Time Install:
    For a first-time install, the Go-Live Date can be left blank (recommended) or set manually.

    • If left blank, the system automatically uses the submission time (UTC) when the device is submitted from the ‘Devices Ready for Installation’ queue on the ‘Installation Summary & Review’ page.

    • If a value is entered, that value is used instead.

    • The value can be edited later if needed (refer to: Existing Installs / Updating the Go-Live Date).

  • Pulse Counter Devices

    • Each attached meter can have a different Go-Live Date.

    • The field is available for each meter in the Pulse Counter Configuration section, directly below its Units dropdown (Figure 1).

Figure 1

  • Direct / Non-Pulse Counter Devices

    • The Go-Live Date (UTC) field appears directly above the Asset Name Configuration section (Figure 2).

Figure 2

  • Steps to set Go-Live Date for the First Time (Pulse and Non-Pulse Devices)

    • Leave the Go-Live Date blank or enter a UTC date/time.

    • Click Review and Complete Install.

    • If needed, edit the information from the Edit button in the Devices Ready for Installation queue.

    • Click Submit All.

    • After successful submission, a confirmation modal displays the Go-Live Date.

  1. Existing Installs

  • To update an existing Go-Live Date:

    • Open the Installation Summary & Review page.

    • Click Connected Sensors or Failed Sensors and select the required sensor.

    • Click Edit (Figure 3).

    • On the Edit Device Details page, update the Go-Live Date in the same location shown in Figure 1 or Figure 2.

    • Click Update Device to save the change.

Figure 3

Note: This Go-Live Date (UTC) is now displayed in Site Report, Device Editor and Device List applets. Reports in these applets, also updated, where needed.

Weather Monitoring Configuration

This section appears automatically for devices that support weather monitoring, like the RAK2560 sensor:

1. Weather Monitoring Section:

  • For weather monitoring sensors, you'll see a "Weather Monitoring" section with a light green background

  • The main field is "Directional degrees:"

2. Directional Degrees Configuration:

  • Enter a value between 0 and 360 in the field labeled "Enter degrees (0-360)"
    The field is followed by a degree symbol (°)

  • Below the field, there's helper text: "Wind direction in degrees (0 = North, 90 = East, 180 = South, 270 = West)"

Image Upload

1. Image Upload Section:

  • Every installation requires at least one image

  • You'll see a blue information box: "Image Upload: 0/3 images selected"

  • With an important note: "Important: At least 1 image must be selected"

2. Taking/Selecting Photos:

One button is available:

  • "Gallery": Opens your device's photo gallery to select an existing image

3. Image Management:

  • After uploading, images will be displayed with preview thumbnails

  • You can upload up to 3 images per device installation

  • Images are automatically converted (HEIC/HEIF to JPEG) and optimized

  • Maximum file size: 10MB per image

  • Supported formats: JPG, JPEG, PNG, HEIC, HEIF

4. Editing Existing Images:

  • When editing an existing device, you'll see: "Image Upload: X/3 images selected (includes existing images)"

  • Existing images will be labeled with an "EXISTING" tag

Completing an Installation

You have two options for completing your device installation:

  1. Add Another Device:

    • Click the green "Add Another Device" button to save the entered form details in the device queue

    • This action will save all the current device information to the device queue

    • After adding, the form will be reset, allowing you to enter details for another device installation immediately

    • This is useful when you need to install multiple devices at the same site

  2. Review and Complete Install:

    • Click the "Review" button to validate the installation

    • It will process your submission and take you to the “Installation Summary & Review” page

    • You will be redirected to “Device Ready for Installation” section from where you can edit or delete added devices

    • If all looks good then click on button “Submit All”

    • If installation is successful then you will get a pop up of “Submission Complete” and it will show which devices are installed

    • After submission, scroll down to the Verify & Handoff section at the bottom of the review page to verify your installed devices and sign off before leaving the site.

Installations Summary & Review

This page helps you manage and view installed devices:

1. Accessing Installed Devices Counts:

You'll see an Installation Summary screen with counts of:

  • Connected Gateways

  • Connected Sensors

  • Failed Gateways

  • Failed Sensors

2. Managing Failed Installations:

  • Click to expand/collapse details of failed installations

  • For each failed device, you'll see:

    • Device EUI (e.g., "GatewayEui: 16261")

    • Last Uplink (if available)

    • Status (e.g., "Not Found In IoTCore")

    • Location

3. Actions for Devices:

  • Edit: Click to modify the installation details and retry

  • Delete: Remove the device record (for failed devices only)

4. Navigation Options:

  • Back to form: Proceed with installation workflow.

  • Switch Sites: To switch sites

5. Inactive Threshold Settings:

  • Set the time threshold for considering a device inactive

  • Default is 15 minutes

  • Maximum allowed is 2 months (60 days, 1,440 hours, 86,400 minutes)

  • Use the "Refresh" button to update the view

5. Reports and Tools:

  • Download PDF Report: Generate reports with device pictures, Dev EUI, and location

  • Check Internet Speed: Verify your connection speed

5. Verify & Handoff:

  • Run data verification on all installed devices at the site

  • Review pass/warning/fail results per device, and sign off on the installation

  • See the Verify & Handoff section below for details.

Legacy Devices at this Site

Below the Installation Status Summary (Connected Gateways, Connected Sensors, Failed Gateways, Failed Sensors), you’ll see a section “Legacy Devices at this Site” with a count. These are LoRaWAN sensors and gateways at the site that do not yet have an installer record (e.g. devices that were at the site before the Atria Installer app or were never added through the installer).

  • Edit: For a device, click Edit to open the Device Editor and change LoRaWAN metadata (Site, AssetName, location, etc.).

  • Add to installer: Click Add to installer to open the Add Device form with that device’s data pre-filled from LoRaWAN. Add photos and any extra details, then submit to create an installer record for the device. After that, the device will appear in the installed counts and no longer in the Legacy list.

Verify & Handoff

After installing devices at a site, the Verify & Handoff section appears at the bottom of the Installation Summary & Review page. It automatically runs data verification on all installed devices to check for configuration issues, data freshness, and device health.

Verification Results

  1. Each device gets a status:

  • Pass (green): All verification rules passed

  • Warning (yellow): One or more warning-level issues found

  • Fail (red): One or more failure-level issues found

  1. Click any device row to expand and see the specific issues detected.

  2. Use the Refresh button to re-run verification (e.g., after fixing a configuration issue).

  3. Click View in Data Verification Applet to open the full verification detail for the site in a new tab.

Note: Newly installed devices may take 15-30 minutes before data appears in Timestream. If devices show "No Timestream data," wait and click Refresh.

Installer Sign-Off

After reviewing verification results, you can sign off on the installation:

  • If all devices pass: The sign-off notes are optional

  • If any device has warnings or failures: You must provide a note explaining why you are signing off with issues before the Sign Off button is enabled

  • Click Sign Off & Complete to record your sign-off

The sign-off records your email, timestamp, verification status, and notes in the installer database.

Previous Sign-Off

If a previous installer has already signed off for this site, you will see a blue banner showing:

  • Who signed off previously

  • When they signed off

  • The verification status at the time

  • Any notes they left

You can still re-verify and sign off again if needed. The new sign-off will overwrite the previous one.

Managing Failed or Inactive Devices

The Install App allows you to edit or delete and re-add devices that are marked as "failed" or "inactive." It will also allow to edit connected devices

Steps to Edit or Delete a Device:

  1. Navigate to the Installation Summary & Review page:

  2. Click to expand the appropriate device category (Connected/Failed)

    • Each device entry shows:

      • DevEui (e.g., "DevEui: 11111")

      • Last Uplink

      • Device status (e.g., "Not Found In IoTCore" or "Inactive")

      • Location information

  3. Find the device you need to update

  4. Click "Edit" to modify details or "Delete" to remove (for failed devices only)

Edit a Device:

  • Click the "Edit" button next to the device

  • You'll be taken back to the installation form with the device's details pre-filled

  • Make the necessary changes to the location or other fields

  • Click "Update Device" to save your changes

Delete or Move a Device

When you click "Delete" on a failed device, a modal appears with two options:

Delete Only:

  1. Click the "Delete" button next to the device

  2. In the modal, select the "Delete only" tab

  3. Optionally select a quick warehouse button (Warehouse US, Warehouse UK, Warehouse India) or type a target Site ID manually

  4. The target Site ID is used to update the device's site in the LoRaWAN backend (the device record is removed from the Installer app)

  5. Click "Delete" to confirm

  6. The device will be removed from the Installer app and the LoRaWAN table's Site field will be updated to the target site

Delete & Move:

  1. Click the "Delete" button next to the device

  2. In the modal, select the "Delete & move" tab

  3. Enter the new Site ID where the device should be moved to (the site must exist in the system and cannot be a warehouse site)

  4. Click "Delete & Move" to confirm — the system will validate the target site before proceeding

  5. The device's Installer record will be moved to the new site (preserving all installation details like photos, location, installer info)

  6. The LoRaWAN table will be updated with the new Site.

Key differences between the two options:

 

Delete Only

Delete & Move

 

Delete Only

Delete & Move

Installer record

Removed

Moved to new site

LoRaWAN Site

Updated to target

Updated to target

Photos

Deleted

Copied to new site

Target site validation

No (any site ID accepted)

Yes (must exist, no warehouses)

Notes:

  • The original installer's details (name, email, company) are preserved on moved records

  • After a move, the device will appear in the installation summary of the new site

Adjusting Inactive Threshold

If a device was recently installed but isn't appearing in the Failed list, you can adjust the Inactive Threshold to make it visible:

  1. Locate the Inactive Threshold Setting:

    • At the bottom of the Failed Installations page, find the "Inactive Threshold:" section

    • The default setting is 15 minutes