Mobile-911 iOS Help
Mobile-911 is an iOS application that allows users to receive and acknowledge alarms from SCADA/HMI packages through WIN-911. It does this by utilizing Apple’s push notification service and by connecting directly to the Mobile-911 Server, a web server component that communicates with WIN-911. Users may also receive data reports from SCADA packages that are compatible with WIN-911’s reporting features.
- Internet connectivity
- Network access to your Mobile-911 Server
- iOS 4 or 5
How it Works
When an alarm is passed to WIN-911, it determines which devices should receive alarm notifications for that event based on its configuration. The alarm is then forwarded along to the Mobile-911 Server along with a Mobile-911 Code. This code, generated by the mobile application, identifies the device that should receive the alarm notification. The Mobile-911 Server checks to see if that device is currently connected to its web server, if the device isn’t connected, a notification message is generated and sent out to Apple’s push notification service, which then, using the Mobile-911 Code once again, forwards that message along to the proper device. When it is received, an audio alert is played along with a visual notification. When the notification is tapped,the Mobile-911 app will be launched and the full alarm details displayed.
Users are able to acknowledge alarms with their acknowledgement code directly from the Mobile-911 application. Users may also request alarms and data reports. All communications that occur while the application is open are conducted using the Mobile-911 Server’s web server component, not through Apple’s push notification service.
In order to communicate with your Mobile-911 server, you must specify its IP address or hostname, as well as the port number that it listens on. The default port number is 59112. The port number is configurable, so be sure to check with your network administrator for the correct number. You will be prompted for these settings on the initial launch. Configure them on the Settings screen, under the Primary Server options. Use the Test Connection button to verify that your settings are correct. You will not be able to save these settings if Mobile-911 is unable to connect to the server at the address specified, so verify that your server is configured properly before attempting to configure any Mobile-911 client applications.
Just as the Mobile-911 application needs to know where the Mobile-911 server resides, the server needs to know how to reach your mobile device through Apple’s push notification service. It does this with your Mobile-911 Code, a unique number generated by your Mobile-911 application. Because this number is fairly long, we’ve made it easy to send it through email to whoever is responsible for configuring your WIN-911 system. Click the Send Mobile-911 Code button on your iOS device and an email containing the code will be created. Send this to the individual responsible for setting up your WIN-911 system so that it may be entered into WIN-911’s phonebook.
You may configure two Mobile-911 server connections. When a failover is detected, that is, when the previously inactive server sends a new alarm message, all existing alarms will be removed from your alarm list and only alarms from the newly active server will be displayed. Alarm and report requests will be sent only to the active server.
- Maximum Alarms – Limits the number of alarms displayed in Mobile-911. This is set to 100 by default. Increasing this number may have an impact on your application’s performance.
- Confirm Ack – While this option is enabled, Mobile-911 will prompt you to confirm all acknowledgements in an attempt to prevent an inadvertant alarm acknowledgement.
- Ack Code – You may store your acknowledgement code to make acknowledging an alarm easier.
- Confirm Delete – While this option is enabled, you will be asked to confirm alarm deletions.
- Delete Unacked – By default, this option is disabled. Enabling this option allows you to delete unacknowledged alarms.
- Send Mobile-911 Code – Click this button to send your Mobile-911 Code over email to the person responsible for maintaining your WIN-911 system. This will allow your Mobile-911 code to be pasted into your WIN-911 configuration.
- Language – Currently, the only supported language is English.
- About Mobile-911 – Check your Mobile-911 version number here or view important legal information.
Alarms are displayed in a list on the alarm summary screen. Tap any alarm to view its details. Alarms may be deleted or acknowledged from the details screen. You may also swipe left or right to navigate between alarms.
Each alarm is displayed with an icon that represents its state. An alarm may be active or inactive and acknowledged or unacknowledged. There are a few other error states as well, which usually indicate that an attempt to acknowledge the alarm has failed for one reason or another.
Active alarm icons are red. Inactive icons are green. Acknowledged alarms are represented with a check mark. Unacknowledged alarms are displayed with an exclamation point. Errors are indicated with a small red “X” displayed on the top right of any icon.
|An active unacknowledged alarm|
|An inactive unacknowledged alarm|
|An active acknowledged alarm|
|An inactive acknowledged alarm|
|Mobile-911 has sent a request to acknowledge this alarm and is awaiting a response from WIN-911|
Alarms may be requested from your Mobile-911 Server from the alarm summary screen. This feature is useful for requesting alarms that you may have received, but already deleted from your device or alarms that were sent out while you weren’t on duty. You may request all alarms or alarms that have a certain state. The full list of requestable alarm states appears below.
Notice that the “inactive acked” state does not appear in the above list. You cannot request alarms that are inactive and acknowledged. Once an alarm reaches that state, WIN-911 considers the lifetime of that alarm over.
Mobile-911 is able to display reports from SCADA packages that support WIN-911’s reporting features. These reports are simply collections of values from data points in your SCADA package that are pulled when a report is requested. In WIN-911, each of these reports is given a number. Each point in the report is numbered, beginning at one, in the order they appear in your report.
In order to access reports hosted by WIN-911, they must be configured in your Mobile-911 client application. Go to the Reports screen and tap the “+” icon on the top right to add a report to Mobile-911. The name field does not correspond to any setting on WIN-911. It is simply the name of the report as it will be displayed on your device application. Enter the report number as well. This number must match the report number specified in WIN-911. By default, the “Include All Items” option is selected. Leave it selected if you would like to receive all points listed in your report. Deselect the option if you would like to specify only one report item to receive. When your settings are correct, tap “Save.”
Reports are also viewed from the same Reports screen. Tap the report you wish to view. It will be loaded as the page opens. Click the refresh icon to reload your report.
You may delete or edit your report settings by holding your finger over your report from the Reports screen.
Check the status of your Mobile-911 server from the health screen. Tap the Primary or Secondary button to check the corresponding server. Your server configuration as well as its status will be displayed. Remember that WIN-911 and your Mobile-911 are two separate components and that they may even be running on two different machines. Verify that both WIN-911 and Mobile-911 display “Healthy” in the status window. If there is any issue with either component, an appropriate error message will be displayed on this screen.
Notice that there are two server status indicators at the top right of your screen. The primary server is represented with a “P” and the secondary server, as you may have guessed, is represented with an “S.” These icons are green when Mobile-911 is actively connected to your server. When disconnected or unconfigured, these icons are red.