View source for Amber Alert scenario

==Amber Alert scenario for GH5200==

The purpose for the Amber Alert function is for lone workers to be able to start a countdown timer when
entering a dangerous situation and start a call. Countdown timer lasts for as long   as they expect to stay in this
situation. If the timer is not cancelled before it ends, an SOS alert will be sent from the device and a
call will be made to a configured emergency contact. 

<b>Amber Alert scenario:</b>

A social worker, goes to a 20 story building where position can be acquired by a Satellite signal. 
Entering a potentially dangerous location, an Amber Alert activation button is pushed to make a call, that a person is going to X location. 
Once the button is pushed, a configured countdown timer starts, for example, 20 minutes. 
An user can extend a countdown by pushing a button again to extend the time. If an user gets attacked by the client in the dangerous location, when the countdown timer ends,
an emergency call is triggered and call is initiated to inform the authorities where the user can be found.<br>

* When '''Amber Alert''' button is pushed, a '''time-out''' countdown starts. 
* Before the countdown, '''Pre-Alarm event''' is generated, which indicates that an '''Alarm Event''' is going to be activated, if the button to cancel the '''Alarm''' is not pushed in time. 
* After '''time-out''' countdown ends, if an user has not clicked a button to cancel '''Amber Alert''', an '''Alarm Event''' is generated and a Call to the '''configured number''' or an '''SMS message''' is sent. 

<b>Amber Alert description:</b>

Amber Alert is a function that can be enabled by pre configured buttons. When the function is enabled, count down timer starts and event with I/O ID 400 is generated. After that SMS and call to initial number can be processed. The duration of the initial call is limited to 60s. When the count down timer is disabled, event with IO ID 400 is generated and SMS with call to alarm number can be processed. If conversation time is less than 5s, device will repeat the call up to 10 times. The duration of the alarm call is unlimited. If Deactivate after alarm call option is enabled, the feature will be turned off as soon as a successful alarm call ends.<br>

<b>Extend timer</b><br>

The count down timer can be restarted to initial value by pressing button with “Amber Alert On” action. Value is equal to “Timeout” value.<br>

<b>Without timer</b><br>

Functionality can be used without a count down timer. “Timeout” must be set to "Disable". Device generates event with IO ID 400 with value 4 and SMS with call can be processed. The functionality then shuts down automatically, but no more events are generated.<br>

<b>Pre-Alarm</b><br>

Pre-Alarm indication will start when the count down timer value is less then configured Pre-Alarm value. The Pre-Alarm start time can be calculated by subtracting the Pre-Alarm value from the Timeout value.<br>

'''Example:'''<br>

The Timeout value is 1800s and the Pre-Alarm value is 300s. 1800 - 300 = 1500. When the feature was enabled, the Pre-Alarm will start after 1500s.
No records are created when Pre-Alarm indication starts.<br>

<b>1.</b> In order to start GH5200 Amber Alert testing you should download testing firmware, configurator. 

{|style="width: 100%;" 
<b>2.</b> Open configurator and connect GH5200: 
<br><br>[[File:AmberAlertFW.png|frameless|center|800px]]
<br><br>
|<b>3.</b> Update device with the latest Amber Alert firmware version <b>55.0.0.10.Rev.01 and up</b>:
<br>
[[File:AmberAlertFWupload.png|frameless|center|800px]]
<br>
<b>NOTE!</b> After firmware update – format device memory by pressing Format as shown below. Format button is on "Status" section.
[[File:Format GH.png|frameless|center|800px]]
<br><br>
<b>4.</b> If you plan to use server - configure APN, server address and port. These settings can be found in GPRS section.
<br><br>
[[File:Server info GH.png|frameless|center|800px]]
<br><br>

In configurator, Amber Alert configuration looks like in the figure below.<br>
[[File:AmberAlertFeature.png|center|]] <br>

<b>Timeout:</b>	Defines time until Amber Alert alarm is processed. <br>
<b>Pre-Alarm:</b> Sets the remaining time, when the pre-alarm should be triggered.<br>
<b>Order Priority:</b> Defines call or record priority. <br>
When <code>Call</code> is selected, device will call to defined number and creates Amber Alert record. <br>
When <code>Record</code> is selected, device will create Amber Alert record and calls to defined number. <br>
<b>Initial call number:</b> Select a number from 10 GSM Predefined Numbers list to which alarm call will be made.<br>
<b>Alarm call number:</b> Select a number from 10 GSM Predefined Numbers list to which alarm call will be made.<br>
<b>Send SMS To:</b>Selects number from 10 GSM Predefined Numbers list to which Amber Alert SMS will be send.<br>
<b>SMS Text:</b>Defines SMS text that will be send when Amber Alert event will be generated.<br>
<br>

==Keyboard actions==

In the example below, the buttons are configured as following:

* 1 - Click: Amber Alert On
* 2 - Click: Amber Alert Off
* Long Click: Amber Alert Switch

[[File:AmberAlertKeyboard.png|frameless|800px]] <br>


{| class="wikitable" style="margin: 1em auto;"    
|-
!<b>Action</b> !!<b>Description</b> !!<b>Button action</b> !! <b>Text message</b>
|-
| Amber Alert On || Enables Amber Alert feature or resets count down timer to initial value. ||[[File:GH5200_AmberAlert_on_300px_no_text.gif]]|| [[File:Amber_Alert_Val_1.png|frameless]]
|-
| Amber Alert Off || Disables Amber Alert feature. ||[[File:GH5200_AmberAlertSwitch_on_300px_no_text.gif]]||[[File:Amber_Alert_Val_0.png|frameless]]
|-
| Amber Alert Switch || Toggles On or toggles Off Amber Alert feature. Reset count down timer functionality is not available on this button.||[[File:GH5200_AmberAlert_longClick_300px_no_text.gif]]||[[File:Amber_Alert_Val_0.png|frameless]]↓[[File:Amber_Alert_Val_1.png|frameless]]↑
|-
|}
<br>
{| class="wikitable" style="border-style: solid; border-width: 0px; margin: 1em auto 1em auto;"
|+ 
|-
| style="{{{GH5200_note|}}}text-align: left; background: #F6F6FB;"         | [[Image:Bw_nb.png|50px]]
| style="{{{GH5200_note|}}}text-align: left; background: #F6F6FB;"         | <b>NOTE!</b> Amber Alert feature should be enabled using configured keyboard buttons.
|}
<br>
<b>When Amber Alert alarm event is generated, following text message is sent:</b><br>

[[File:Amber_Alert_Val_3.png|frameless|center]]

==AVL ID and Data Structure==
<b> Amber Alert feature sends records with AVL ID 400 and AVL ID 401. </b> <br>


{| class="wikitable" style="margin: 1em auto;"    
|-
|rowspan="7" style="text-align: center;" | <b> AVL ID 400</b>
|-
| <b>Cause</b>
| <b> Value </b>
|-
| Turned Off || 0
|-
| Turned On, count down timer started || 1
|-
| Amber Alert On button pressed to restart active timer || 2
|-
| Alarm || 3
|-
| Amber Alert turned On, when timer is set to 0 seconds || 4
|-
|<b> AVL ID 401</b>
|colspan="2" | Sends Amber Alert time-out configured value.
|-
|}


When Amber Alert is Turned Off:<br>
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|000000000000005B8E0100000175E61B9A10010F0D2DCD209614B8000000000000000190000D000600F00100150500C800004502007164019000000500B5000000B6000000
1800000043108000440000000200F10000601A01910000003C00000000010000117A
|}
[[File:AmberAlert-off.png|frameless|center|800px]]
<br>

Amber Alert Feature is Turned On, count down timer started:
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|000000000000005B8E0100000175E61BC120010F0D2DCD209614B8000000000000000190000D000600F00100150500C800004502007164019001000500B5000000B6000000
1800000043108000440000000200F10000601A01910000003C00000000010000383F
|}

[[File:AmberAlert-On.png|frameless|center|800px]]
<br>

Amber Alert Count down timer has been restarted:
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|000000000000005B8E0100000175E6290790010F0D2DCD209614B8000000000000000190000D000600F00100150500C800004502007164019002000500B5000000B6000000
1800000043107F00440000000200F10000601A01910000003C000000000100003E8B
|}

[[File:AmberAlert-restarted.png|frameless|center|800px]]
<br>

Amber Alert Alarm event:
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|000000000000005B8E0100000175E61CAB80010F0D2DCD209614B8000000000000000190000D000600F00100150500C800004502007164019003000500B5000000B6000000
1800000043107F00440000000200F10000601A01910000003C000000000100002655 
|}

[[File:AmberAlert-Alarm.png|frameless|center|800px]]
<br>



<b>Example of the server view: </b> <br>
<b>Note:</b> In the example shown, Time-out has been configured to 60 seconds.

[[File:AmberAlert-Server_view.png|frameless|center|1000px]]

[[Category: GH5200 FAQ]]