====== Devices ======

You can connect different devices to ActiveView, in particular ActiveGuards and ActiveTracks. To open a list of all devices, select //Management -> Devices// in the main menu..

{{ av_manual:dev.png |Device list}} 

In this list, you can see the current state of all devices (updated automatically, without reloading the page by the user):
  * connection status:
    * {{av_manual:state_gprs_white_24.png|Ethernet/GPRS}} Ethernet/GPRS
    * {{av_manual:state_sms_white_24.png|SMS}}SMS
    * {{av_manual:state_disconnected_white_24.png|Disconnected}}Disconnected
  * signal strength (no information when the device is disconnected, dimmed when the status is out of date);
  * battery level (no information when the device is disconnected, dimmed when the status is out of date).

**NOTE**:Device configuration should have selected additional data.

{{ av_manual:additional_data.png |additional data}}

You cannot create a new device yourself. It has to be assigned to you by an ActiveView administrator. Then you can edit or remove the device.

{{ av_manual:device.png |Device list and AT details}}

Every device has the following properties:
  * **Name** – device name. When the device is assigned by the administrator to an organization (a tenant of the ActiveView), it gets a name in the following form: <type>; <serial number>; <date and time>
  * **Type** – device type.
  * **Serial No** – device serial number. The pair “type – serial number” is always unique.
  * **Connection status** – the channel the device is using to connect to the ActiveView. One of the following:
    * Ethernet/ GPRS
    * SMS
    * Disconnected
  * **Signal strength** – signal strength of the GSM network. The “?” stands for one of the following:
    * the device is disconnected;
    * the device does not send status information;
    * status information is out of date.
  * **Battery level** – battery level of the device. The “?” has the same meaning as for signal strength.
  * **Last update** – date and time when the device sent a status information for the last time. The “?” means one of the following:
    * the device is disconnected;
    * the device does not send status information.
  * **Company** – the company the device is linked to.
  * **Site** – the site this device is linked to.
  * **Position** [ActiveTrack only] – shows the current position (latitude and longitude) of the device (dimmed when the status is out of date). Clicking it opens a new panel with a map (see below).
  * **Position timestamp** [ActiveTrack only] – date and time when the device sent its position for the last time.
  * **Phone number** – phone number of the device, displayed in alarm details.
  * **Assignable to a guard** – if set to “Yes”, the device can be linked to a guard. You can choose the guard manually or you can read a guard’s identifier with it (a special tag assigned to the guard) and it will be linked automatically.
  * **Guard** [available if //Assignable to a guard// is set to //Yes//] – linked guard’s name.
  * **Enter/Exit work mode** – if set to //Yes//, the device can operate in //Enter work mode// and //Exit work mode//. These modes are changed by reading appropriate tags (see [[Tags]] for details). If set to //No//, reading those special tags has no effect.
  * **Work mode** [available if //Enter/Exit work mode// is set to //Yes//] – the current enter/exit work mode.
  * **Dynamically assignable to site** – if set to //Yes//, reading a checkpoint will automatically link this device to the company and site the checkpoint is connected with.

===== Active Track Mobile =====

ActiveTrackMobile is a mobile app designed for Android smartphones. The purpose of this app is to provide functions similar to those offered by the ActiveTrack hardware. As different smartphones offer various hardware functions/options, the ATM app enables only those functions that are supported on the specific device.

===ATM Features===

   *Enrolling and collecting app settings;
   *Adding mobile devices and editing settings for the mobile app (defined phone numbers, frequency of sharing GPS position information);
   *Relevant status and modes indicate device status. The “Online”/”Offline” status indicates access to the OSM system, while the “On Patrol”/”Idle” mode is related to turning on/off the smartphone tracking. Features:
             *  Triggering the “Panic” alarm – sends the “Panic” message to request support for a security guard. Available in modes //“On Patrol”/“Idle”//,
             *  Location sharing function sends the current position of the device. Available in modes //“On Patrol”/“Idle//,
             * QR code read – enables the user to scan a QR code tag. Available in modes //“On Patrol”/“Idle”//,
             * NFC code read – enables the user to scan a NFC code tag. Available in modes //“On Patrol”/“Idle”//,
             * Brings up an app designed to make calls. Available in modes //“On Patrol”/“Idle”//,
             * The picture function allows to take a picture and save it in the phone storage system. Available in modes //“On Patrol”/“Idle”//,
             * Temporary location sharing function allows to send the current device position in a regular manner. Available only in the //“On Patrol”// mode,
             * Non-activity monitoring – monitors the non-activity of the device. It the device remains motionless for longer than defined, the function sends a signal. Available only in the “On Patrol” mode.

===Device enrolment===

An AV user with admin permissions can add a new device in the following tab: //“Administration”//→ //“Devices”// →//“Create device”//.

{{ :av_manual:av_devices_en2.png |}}

When a new device is defined, a device profile is created automatically for the selected tenant. The name and series number of the device are created automatically.

        * //Name//;
        * //Pattern//;
        * //GPRS interval// – defines how often (in seconds) the position of the device in the “On Patrol” mode should be sent;
        * //Man down interval//;
        * //Phone numbers// – a defined list of phone numbers that will be sent to the device and displayed if the button //„Make a call”// is pressed;
        * //Configuration// – generates and displays a QR code.

In order to enrol your device into the ATM app, select //Settings// in the Home screen, then select //Register device// and scan the QR code from AV that is displayed after clicking //Generate link for configuration//.

{{:av_manual:screenshot_20200409-120419.png?300}} {{ :av_manual:screenshot_20200409-120429.png?300|}}


===== Connection status =====

The device connection status depends on the last event sent by the device. The rules are as follows:
  * the device sent any event other than //SMS_RECEIVED//, //DISCONNECT//, //STILL_DISCONNECTED// and //TIMEOUT// – status changes to //GPRS//;
  * the device sent an //SMS_RECEIVED// event – status changes to SMS (text messages);
  * the device sent a //DISCONNECT//, //STILL_DISCONNECTED// or //TIMEOUT// event – status changes to //Disconnected//;
  * the device has not sent any events over a period defined by the administrator (e.g. for five minutes) – status changes to //Disconnected//.


===== Device on a map =====

Clicking on the position option on an ActiveTrack details panel opens a new panel with a map showing the current location of the device.

{{ av_manual:mapdevice.png |ActiveTrack details and map panel}}

Above the map there is a date range filter. Choose appropriate dates and click the **>** button to view the device’s trace from the chosen date range.

The trace is limited to number of nodes set in the user settings (the default is 100; see [[User menu#User settings]] for details). If there are more locations of the device recorded, they are filtered evenly. If you need more precision, try narrowing down the date range.

You can click on a node to see some details, like time and date, exact position, speed, etc.

===== Sending commands =====

You can select one or more devices and send a command to them. To do this, use //Send command via OSM// from the context menu or from the tools menu.

**NOTE**: //OSM// is a special software ActiveView uses to communicate with devices. List of commands find in device manual.
The commands use without service code infront.

{{ av_manual:send_command.png |Device list and send command panel}}

The **Send command panel** contains the following elements:
  * **Target device list** – list of devices which the command will be sent to.
  * **Command to send** – this text will be sent to the devices as a command when you choose the Send option.
  * **OSM answer** – answers from devices which OSM sent to ActiveView. If you close the panel before these answers arrive, you will not be able to see them (the answers will be lost).

===== Removing a device =====

Removing a device does not affect past events or alarms. They are still available unchanged in the alarms browser and in the reports.

**NOTE**: You cannot open the details of a deleted device, so it is impossible to see its past trace from there. Events and alarms report, however, has an option to show events on a map. See [[Reports#Events and alarms report|Events and alarms report]] for details.