Apps AddressIT App User Guide

: August 5, 2024
: APPs

Table of Contents

Apps AddressIT App
Product Information
Product Usage Instructions
Overview
Working with job files
To upload or manually create a job
Navigating the system
Addressing controllers
To unlock a controller
Document revision history
Read User Manual Online (PDF format)
Download This Manual (PDF format)

Apps AddressIT App

Product Information

Specifications

Product Name: AddressIT
Catalog No.: 11-808-868-01
Revision Date: 4/24/2024
Supported Controllers: OptiFlexTM, OptiCORETM, TruVuTM
Supported Address Type: IPv4
Maximum Controllers: No limit

Product Usage Instructions

What is the AddressIT app?

AddressIT is a mobile app designed to help you set IP addresses for multiple controllers from one location. It supports OptiFlexTM, OptiCORETM, and TruVuTM controllers, allowing you to manage IP addresses efficiently.

To export a job from SiteBuilder to AddressIT:

PREREQUISITE: Add all networks and controllers
in SiteBuilder and specify the IP addresses before exporting the .job file.
Export a .job file from SiteBuilder:
- Navigate to File > AddressIT > Export.
- Select controllers in the Geographic and Network trees and click Add.
- After adding all controllers, click Export to save a mobile addressing .job file.
- Email the .job file to upload it into AddressIT on a mobile device.

Frequently Asked Questions (FAQ)
Q: Can AddressIT support IPv6 addresses?
A: No, AddressIT only supports IPv4 addresses at the moment.

Important changes are listed in Document Revision History at the end of this document.
All rights reserved. All trademarks are the property of their respective owners.
The content of this guide is furnished for informational use only and is subject to change without notice. Carrier assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide.

What is the AddressIT app?

PREREQUISITES

WebCTRL® or i-Vu® v8.0 or later
Controller driver FWEX 107-06-2074 or later
iOS (14.0 or later) or Android (11.0 or later) tablet or phone
Automated Logic, Carrier, or OEMCtrl wireless service adapter (part no. USB-W)

Overview

AddressIT is a mobile app designed to help you set IP addresses for multiple controllers from one location.
The AddressIT app supports OptiFlex™, OptiCORE™, and TruVu™ controllers, but only IPv4 addresses. There is no limit on the number of controllers you can address.

Basic workflow
In AddressIT, each system of controllers is referred to as a job and the app keeps the settings for each system in a separate job folder.

Building a job
- Controllers for a job must have a name and IP address, at a minimum. You can either import this information from SiteBuilder or enter it manually in AddressIT. If entering manually, you can easily add multiple controllers in a range of addresses.
- Controllers have different icons indicating how far you have taken them through this process.
  Newly added controllers show No serial number.
Associating the controllers in AddressIT with physical controllers AddressIT uses the serial number of each controller to find it over the network. You gather the serial numbers by scanning the QR code. After scanning, the controller shows Serial number scanned.
Once you have completed this process, you could:
- Email the information to import into SiteBuilder for later use
- Email the information to a technician who would set the addresses
- Continue to the next step and set the addresses yourself
Setting the address in the controllers over the network
After scanning the controllers, you can communicate with AddressIT by using the wireless service adapter (part# USB-W) on a single controller. This allows you to set the address of all the controllers, which then show Address set.

Working with job files

To export a job from SiteBuilder to AddressIT

PREREQUISITE You must add all networks and controllers in SiteBuilder and specify the IP addresses before exporting the .job file.

Export a .job file from SiteBuilder

Navigate to File > AddressIT > Export.
Select controllers in the Geographic and Network trees and click Add.
NOTE You can select an area or equipment and all controllers beneath it are included.
After all controllers are added, click Export to save a mobile addressing .job file.
Email the .job file to upload it into AddressIT on a mobile device.

To upload or manually create a job

To upload a .job file

Tap ADD.
Tap Browse to select the .job file.

Tap SAVE.
To manually create a job

Tap ADD and enter a name.
Tap SAVE. The new job is listed on the Jobs screen.
To email and import a job to SiteBuilder from AddressIT

After making changes, such as connecting a controller to a network or setting the IP addresses, you can email the updated .job file to import back into SiteBuilder.

Email a .job file from AddressIT

Press and hold on a job.
Tap email and follow the prompts.

Import a job into SiteBuilder

Navigate to File > AddressIT > Import.
Select the file you want to import.
NOTE The following steps may appear differently, depending on the .job file. Inapplicable steps do not appear in the wizard.
Select controllers marked for deletion and click Next.
Select networks to add controllers to.
NOTE You can view the controllers as a LIST or TREE on the left side of the wizard. The tree shows where the controllers were added in AddressIT. Since AddressIT does not have the network information, you need to add the controllers under the networks in order for SiteBuilder to insert the controllers in the Network tree.
- Select the controller on the left side and the associated network on the right side.
- Click Add.
- Click Next when done.
Select the modified controllers within the .job file you want to import. If needed, check Import Addresses and Import Names.
NOTE Serial numbers are always imported. If the import detects a difference in the controller’s address, the message Address changed appears next to the controller’s name.
Click Next and follow the prompts until the file is imported.

To add or remove controllers
Add areas or controllers

Select the job.
Tap ADD.
Select New Area or New Device(s).
Fill in a descriptive name and all other fields.
NOTE If the number entered in the Number of devices field is greater than 1, the succeeding controllers are automatically numbered. If the Name field ends in a number, the succeeding controllers are automatically numbered relative to that number.
Tap Save.
To add more areas or controllers, tap ADD and repeat steps 1–6.

To delete or restore a job
Delete a job, area, or controller

Press and hold on the job, area, or controller you want to delete.
NOTE You cannot delete an area that you created in SiteBuilder.
Tap delete, and then OK.

Restore deleted jobs

On the Jobs screen, tap RESTORE. Or, tap and select Restore jobs.
Check the job(s) you want to restore. Or, to restore all jobs, check Select all.
Tap RESTORE.

Navigating the system

Areas and controllers
When you select a job, the AddressIT interface shows the top level areas or controllers in the job. You can select an area to display its children. By default, items are listed in a hierarchical TREE view. You can also display items in a flat LIST by tapping . Tap to return to the TREE.
To search for an area or controller by name, tap

Menu options
Tap . Return to the home page by tapping X in the top right corner.

To understand controller states
The icon to the left of each controller indicates one of the following states.

NOTE The controller must be unlocked in order to download. See To unlock a controller (page 8).

To scan the serial number
When initially viewing a controller details screen in AddressIT, the Serial number and Product type fields are blank. Scanning the controller’s QR code automatically populates these fields.

Select a job from the Jobs screen.
Select the controller that needs addressing.
to toggle between TREE and LIST views
Tap SCAN QR CODE.
Scan the physical controller’s QR code with your mobile device.
to activate flash.

If you scanned the QR code from a different controller by accident, you can correct or remove the serial number manually. See To edit controller details (page 6).
NOTE If the product type retrieved from the .job file differs from that of the QR code, a product mismatch message appears. If you want to overwrite the product type retrieved from the .job file with the scanned product type, tap OK.

To edit controller details

Select a controller from the Jobs screen.
Tap to edit the controller’s name and addressing information.
Once you have finished editing, tap SAVE.
NOTE Fields are case-sensitive.

Addressing controllers

If you want to verify the physical location of a controller, you can do so by prompting its LED to blink.
In AddressIT, select a controller and tap BLINK LED. The Sys and Net LEDs blink white, once per second for 10 seconds, and then stop.

To connect to a network

Insert the wireless service adapter (part# USB-W) into the controller’s USB Service Port to communicate with your mobile device. This controller is referred to as the “connected controller”.
CAUTION If the Eth1 port is in use, connect a USB Type-A Male to Female extension cable to the USB Service Port and the wireless service adapter.
In AddressIT, tap CONNECT and then OK.
NOTE The mobile device running AddressIT must support the 5 GHz band.
Select the wireless network using the network SSID and password that are printed on the wireless service adapter.
NOTE When connecting to your mobile device for the first time, you might see a message indicating the there is no internet or that it is unavailable. This is okay and you can continue.
After the connection is made, the CONNECT button turns blue. You can then use AddressIT to set the addresses of controllers.

To set the address
AddressIT can set the IP address(es) of one controller or a group of controllers beneath the tree location you have selected.

Tap SET ADDRESS on the right of the bottom panel.
NOTES
- If the address was set successfully, the controllers shows Address set.
- If the IP address already exists, you will see an address mismatch message and request to overwrite. A request to overwrite occurs only at the controller level.
Tap OK.

Troubleshooting
On the controller details screen, the following error messages appear when the controller and AddressIT have different IP addresses:

IP address mismatch
subnet mask address mismatch
gateway address mismatch
Controller shows Error.
NOTE Any combination of the error states and messages are possible.

To unlock a controller

A controller that is new from the factory or has not been previously configured with an IP address, can always be configured using AddressIT or Local Network Configuration in the WebCTRL® or i-Vu® application. However, once you have assigned a valid IP address, you have up to 24 hours to make any other changes. After 24 hours, the controller is locked and not editable.
Once you have made your .job file, AddressIT needs to communicate with an unlocked controller. You can unlock the OptiFlex™, OptiCORE™, and TruVu™ controllers either from the WebCTRL® or i-Vu® interface or by pressing the DSC button located on the controller. The controller must be powered on.

To unlock from the WebCTRL® interface

Expand the controller’s Driver in the Network tree and select Device.
On the Properties tab, locate Local Network Configuration.
Check Allow Local Network Configuration from other devices on the local network for 24 hours.
Click Accept.

To unlock from the i-Vu® interface

In the navigation tree, right-click the controller and select Driver Properties > Device.
On the Settings tab, locate the Local Network Configuration section.
Check Allow Local Network Configuration from other devices on the local network for 24 hours.
Click Accept.

To unlock using the DSC button
Press the DSC button on an OptiFlex™, OptiCORE™, or TruVu™ controller after the Sys and Net LED lights turn green.
NOTE If you press the DSC button when booting boot up, the controller will not unlock.