Skip to content

Devices#

To perform hardware-software integration of LP5/LUNA CARS for access control, it is necessary to use devices - a terminal, cameras, etc.

All fields are required unless otherwise stated in the description.

Beward#

The biometric terminal with temperature measurement, mask detection, and built-in relay.

  • Supported devices: TFR80-210T1Q / TFR80-210.
  • Supported firmware versions: 1.2.13.0 / 2.1.6.0.

Beward settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
successful_pass_message_template Message on successful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Any text names and Full name variables. Only Latin characters are supported. It is not recommended to enter more than 33 characters Welcome!
unsuccessful_pass_message_template Message on unsuccessful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Any text names. Only Latin characters are supported. It is not recommended to enter more than 33 characters Face is not identified
group List name for grouping components Any numeric or text values -
host IP address of the server where Beward is installed IP address in the form of X.X.X.X -
port Port of the server where Beward is deployed - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login Beward user login. Input of Latin characters, numbers and symbols is supported. The user created in Beward -
password Beward user password. Input of Latin characters, numbers and symbols is supported. User password -
open_door_time Relay closing time in milliseconds The time is taken from the relay manual 2000
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
handler_id UUID of the passage event handler, created in Luna - -
time_change_interval The frequency of time updates on the device. It is recommended to use it if the time on the terminal is lost. Set in hours 0

BioSmart Quasar#

  • Supported devices: BioSmart Quasar.
  • Supported firmware versions: 2.3.0.46.

BioSmart Quasar settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of the server where Quasar is installed IP address in the form of X.X.X.X -
port Port of the server where Quasar is deployed - 80
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
luna_id Drop-down list with Luna service IDs in Access - -
min_face_similarity Minimum face similarity threshold when performing verification. The value is formed at the design stage and corrected at the testing stage. 0.00...1.00

To subscribe to events, go to “Settings” on the terminal → go to “Server Identification” → select the server type: BioSmartLite → enter the endpoint for sending data: http://server_IP/vl-access/webhook/biosmart/ → save the settings.

The device does not generate events and does not put anything in the queue. Requests to Luna are sent directly from endpoints.

Dahua#

Some models of Dahua cameras have a relay and the ability to control it programmatically.

During the implementation of the project, LP5 is integrated with this functionality, which allows to control the relay when a face from a certain list appears in the frame.

For example, it is possible to send a signal to an electronic door lock so that the door opens or does not open.

The device starts a stream connection, generates, and puts a face detection event in the queue.

Dahua settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
device_id Internal ID of the device. Specified in the device settings - -
host Dahua camera IP address IP address in the form of X.X.X.X -
port Port for connecting to Dahua camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login Dahua user login. Input of Latin characters, numbers and symbols is supported. The user created in Beward -
password Dahua user password. Input of Latin characters, numbers and symbols is supported. User password -

DahuaThermo#

Some models of Dahua cameras have a relay and the ability to control it programmatically.

During the implementation of the project, LP5 is integrated with this functionality, which allows to control the relay when a face from a certain list appears in the frame.

For example, it is possible to send a signal to an electronic door lock so that the door opens or does not open.

  • Supported system version: 2.631.0000000.31.T, build date 2020-07-06.

The device starts an HTTP stream connection to the thermal imaging camera and captures faces by sending a thermal detection event of the face to the queue.

DahuaThermo settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of Dahua Thermo camera IP address in the form of X.X.X.X -
port Port for connecting to Dahua Thermo camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login Dahua Thermo user login. Input of Latin characters, numbers and symbols is supported. The user created in Beward -
password Dahua Thermo user password. Input of Latin characters, numbers and symbols is supported. User password -
timeout Timeout for an unsuccessful attempt to connect to the service. It is necessary to increase the time if there is a large delay between servers The time is selected based on the delay in the network to maintain performance -

Fortuna315#

Generates Thermo events in the SendThermalEventToLuna queue based on the received data from devices. Includes paired devices — thermal imaging camera and camera.

Supported firmware versions of the camera: V4.02.00, the camera thermal imaging camera: 2.20.0.0.R26130.alpha8 V1.0. Supported hardware versions: V1.0. Supported algorithm versions: smart2.0.0-06-2020.06.17.16:06:42.

Fortuna315 settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
device_id Internal ID of the device. Specified in the device settings - -
host IP address of Fortuna315 camera IP address in the form of X.X.X.X -
port Port for connecting to Fortuna315 camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
thermo_host IP address of the Fortuna315 thermal imaging camera IP address in the form of X.X.X.X -
thermo_port Port of the Fortuna315 thermal imaging camera - -

HikvisionCamera#

A camera for generating a video stream for LP5 with subsequent integration with ACS.

  • Supported devices: DS-2CD3126G2-IS.
  • Supported firmware versions: V5.5.134 build 200430.

The device generates events of type FaceDetectionEvent.

HikvisionCamera settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of the HikvisionCamera camera IP address in the form of X.X.X.X -
port Port for connecting to HikvisionCamera camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login HikvisionCamera user login. Input of Latin characters, numbers and symbols is supported. User created to access the device -
password HikvisionCamera user password. Input of Latin characters, numbers and symbols is supported. User password -
timeout Timeout for an unsuccessful attempt to connect to the service. It is necessary to increase the time if there is a large delay between servers The time is selected based on the delay in the network to maintain performance 10

HikvisionCameraThermo#

A camera with temperature measurement and data transfer functions in LP5.

  • Supported devices: DS-2CD3126G2-IS.
  • Supported firmware versions: V5.5.134 build 200430.

Events in the queue are of type ThermalEvent.

HikvisionCameraThermo settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of the HikvisionCameraThermo camera IP address in the form of X.X.X.X -
port Port for connecting to HikvisionCameraThermo camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login HikvisionCameraThermo user login. Input of Latin characters, numbers and symbols is supported. User created to access the device -
password HikvisionCameraThermo user password. Input of Latin characters, numbers and symbols is supported. User password -
timeout Timeout for an unsuccessful attempt to connect to the service. It is necessary to increase the time if there is a large delay between servers The time is selected based on the delay in the network to maintain performance 10

HikvisionRecognitionOnBoard terminal#

A biometric terminal with face recognition function.

  • Supported devices: DS-K1T341AMF, DS-K1T341AM, DS-K1T680D-E1.
  • Supported firmware versions: V3.2.30 build 220210.

Open the device's web interface, go to ""Configuration"" → ""Access Control"" → ""Face Recognition Parameters"" → ""Working Mode"" and make sure that the ""Permission Free Mode"" mode is set.

After adding, the faces from the specified list will be replicated to the device's memory. You can add/remove faces in Luna, the changes will be automatically applied to the device.

  • the following format of the user_data field is required:
name;card number
  • do not set or change the external_id field.

Updating of face data during editing is not supported. If it is necessary to update the data of a person, delete this person and add it again with the necessary data.

Events in the queue are of type FaceDetectionEvent.

HikvisionRecognitionOnBoard settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
host IP address of the HikvisionRecognitionOnBoard camera IP address in the form of X.X.X.X -
port Port for connecting to HikvisionRecognitionOnBoard camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login HikvisionRecognitionOnBoard user login. Input of Latin characters, numbers and symbols is supported. User created to access the device -
password HikvisionRecognitionOnBoard user password. Input of Latin characters, numbers and symbols is supported. User password -
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
luna_id Drop-down list with Luna service IDs in Access - -
recognition_interval Interval between the start of recognition. It is set depending on the flow of people 1...10 1
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
time_change_interval The frequency of time updates on the device. Set in hours 0...100

HikvisionTerminalThermo terminal#

The biometric terminal with temperature measurement, mask detection, and built-in relay.

Only events of the AccessControllerEvent type (having a measured temperature) will be processed, events of this type come from the terminal.

Events in the queue are of type ThermalEvent.

Hikvision terminal with temperature measurement function.

  • Supported devices: DS-K1TA70MI-T, DS-K1T671TM-3XF, DS-K5671-3XF/ZU.
  • Supported firmware versions: V3.2.32 build 210525.

HikvisionTerminalThermo settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
successful_pass_message Message on successful identificationTo display the username on the terminal screen upon successful identification, you must use the special flag. The order of words in the greeting message can be any. Any text names. Any text names and Full name variables. Only Latin characters are supported. It is not recommended to enter more than 50 characters. Welcome
unsuccessful_pass_message_template Message on unsuccessful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. It is not recommended to enter more than 50 characters Face is not identified
host IP address of the HikvisionTerminalThermo camera IP address in the form of X.X.X.X -
port Port for connecting to HikvisionTerminalThermo camera - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login HikvisionTerminalThermo user login. Input of Latin characters, numbers and symbols is supported. User created to access the device -
password HikvisionTerminalThermo user password. Input of Latin characters, numbers and symbols is supported. User password -
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
card_recognition_interval Interval between card recognitions 0...10 3
face_recognition_interval Interval between recognizing images with faces 1...10 3
liveness_level Degree of checking the level of liveness low— fast processing speed, accuracy is reduced; low
middle — average processing speed and recognition accuracy;
high — accurate definition, increased resource consumption
attempts_check_liveness Number of attempts to pass the liveness check.It is necessary to increase the number of verification attempts at complex angles and shooting conditions in order to avoid false positive recognitions 5...15 10
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
light_brightness_led Brightness level of the LED backlight. The darker the area in front of the terminal, the brighter the backlight should be 0...100 50
light_brightness_ir Brightness level of the infrared (IR) illumination. The darker the area in front of the terminal, the brighter the illumination should be 0...100 50
voice_prompt Terminal voice prompts about pass events or errors. To set up the prompts, see the official documentation of the terminal. On/Off Off
handler_id UUID of the passage event handler, created in Luna - -
time_change_interval The frequency of time updates on the device. Set in hours 0...100

LunaFast4A1#

The biometric terminal with recognition function.

  • Supported devices: DS-K1T680D-E1, DS-K1T341AMF, DS-K1T341AM, VL LUNA FAST 4A1, VL LUNA FAST 8A1, 671, DS-K1T671M, ACT-T1341M, DS-K1T680DF-E1, DS-K5671-ZU.
  • Supported firmware versions: V3.2.30 build 210415, V3.2.30 build 210525, V3.2.30 build 210526, V3.2.30 build 210812, V3.2.30 build 211025, V3.2.30 build 220607, V3.2.30 build 220803, V3.2.30 build 221027, V3.2.33 build 210816, V3.2.35 build 220415, V3.2.35 build 220817.

Events in the queue are of type FaceDetectionEvent.

To disable the output of the greeting on the terminal screen, you must disable the LunaEventListener pipeline.

LunaFast4A1 settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
successful_pass_message Message on successful identificationTo display the username on the terminal screen upon successful identification. The order of words in the greeting message can be any. Any text names. Any text names and Full name variables. It is not recommended to enter more than 50 characters. Welcome
Full name example: Welcome, {fullname}.
unsuccessful_pass_message_template Message on unsuccessful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Only Latin characters are supported. It is not recommended to enter more than 50 characters Face is not identified
host IP address of the LunaFast4A1 camera IP address in the form of X.X.X.X -
port Port for connecting to the LunaFast4A1 terminal - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
login LunaFast4A1 user login. Input of Latin characters, numbers and symbols is supported. User created to access the device -
password LunaFast4A1 user password. Input of Latin characters, numbers and symbols is supported. User password -
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
card_recognition_interval Interval between card recognitions 0...10 3
face_recognition_interval Interval between recognizing images with faces 1...10 3
liveness_level The degree of checking the level of liveness low— fast processing speed, accuracy is reduced; low
middle — average processing speed and recognition accuracy;
high — accurate definition, increased resource consumption
attempts_check_liveness Number of attempts to pass the liveness check.It is necessary to increase the number of verification attempts at complex angles and shooting conditions in order to avoid false positive recognitions Values > 0 10
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
light_brightness_led Brightness level of the LED backlight. The darker the area in front of the terminal, the brighter the backlight should be 0...100 50
light_brightness_ir Brightness level of the infrared (IR) illumination. The darker the area in front of the terminal, the brighter the illumination should be 0...100 50
voice_prompt Terminal voice prompts about pass events or errors. To set up the prompts, see the official documentation of the terminal. On/Off Off
handler_id UUID of the passage event handler, created in Luna - -
time_change_interval The frequency of time updates on the device. Set in hours 0...100

Panda#

A thermal imaging camera with face recognition.

  • Supported devices: SN-T5/13, SN-F22-13.
  • Supported firmware versions: v3.6.0825.1004.1.0.23.0.0, v3.6.0840.1004.1.45.1.0.2.

Events in the queue are of type ThermalEvent.

Panda settings#

To subscribe to events, create a device with the following settings:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of the Panda camera IP address in the form of X.X.X.X -
port Port for connecting to Panda camera - 80
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled

Go to the web interface of the device → sign in → go to the “Configuration” tab → select the “Network Service” section on the left panel → go to “CGI Alarm Service Center”.

Fill in the fields in the “CGIAlarm” section: assign endpoint as URL Start and URL End to send data to Access — http://<vl_access_host>:<vl_access_port>/vl-access/webhook/device/<component_id>/event/handle_event/. If necessary, in the “Proxy Settings” section, fill in the Address and Port fields: Access host and Access port, respectively. Save settings after configuring.

R20Face terminal#

The biometric terminal with protective mask detection and centralized control.

  • Supported devices: R20-Face-T8.
  • Supported firmware versions: GD-V32.7267.

R20Face settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
successful_pass_message_template Message on successful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Any text names and Full name variables. Only Latin characters are supported. It is not recommended to enter more than 33 characters Welcome!
unsuccessful_pass_message Message on unsuccessful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Any text names. Only Latin characters are supported. It is not recommended to enter more than 33 characters Face is not identified
host IP address of the server where R20Face is installed IP address in the form of X.X.X.X -
port Port of the server where R20Face is deployed - 8080
password Terminal user password User password -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
time_zone Time zone -12...+12 +3
handler_id UUID of the passage event handler, created in Luna - -
handle_detection_events Enabling the terminal detection event processing mode On/Off Off

UniUbi terminal#

The biometric terminal with temperature measurement, mask detection, and built-in relay control functions.

  • Supported devices: Uface 8-C temp, Uface 8T temp, R20-Face-T8.
  • Supported firmware versions: GD-V30.7219, GD-V32.7247, GD-V32.7267.

When using a terminal without measuring the temperature, you need to change the SentThermalEventToLuna pipeline to SendToLuna.

UniUbi settings#

To subscribe to events, create a device of the UniUbi type.

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
handler_id UUID of the passage event handler, created in Luna - -
group List name for grouping components Any numeric or text values -
host IP address of the UniUbi terminal IP address in the form of X.X.X.X -
port Port for connecting to the UniUbi terminal - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
password UniUbi user password User password -
enabled_temp_mode Temperature measurement mode. If disabled, change the SentThermalEventToLuna pipeline to SendToLuna. On — enabled; On
Off — disabled
vl_access_host IP address of the server where Access is installed IP address in the form of X.X.X.X -
vl_access_port Port of the server where Access is deployed - 9091
event_expiry_time Event validity time (in seconds). It is necessary to reduce the time, with a large flow of people, as the device cache may overflow >10 60
time_zone Time zone -12...+12 +3
successful_pass_message_template Message on successful identification. To display the username on the terminal screen upon successful identification, you must use the full name variables. The order of words in the greeting message can be any. Any text names and Full name variables. Only Latin characters are supported. It is not recommended to enter more than 27 characters Welcome
unsuccessful_pass_message Message on unsuccessful identification Any text names. Only Latin characters are supported. It is not recommended to enter more than 27 characters Face is not identified

VKVision02#

Terminal with functions of video recording and display of images on the screen.

  • Supported devices: VANCOR VK VISION 02.

VKVision02 settings#

The following settings are used when creating a new device:

Parameter Description Values Default value
name Device name specified by the user Any text names. Only Latin characters are supported. It is not recommended to enter more than 30 characters -
group List name for grouping components Any numeric or text values -
host IP address of the VKVision01 terminal IP address in the form of X.X.X.X -
port Port for connecting to the VKVision01 terminal - -
enable_ssl SSL encryption support for messages.Activate if privacy is required. When activated, the load on the device and the message transmission time increases On — enabled; Off
Off — disabled
success_status_image_ttl Display time (ms) of the image on the terminal with the status “Success” (in seconds) 5000...20000 10000
success_status_image_ttl Display time (ms) of the image on the terminal with the status “Denied” (in seconds) 5000...20000 10000
luna_id Drop-down list with Luna service IDs in Access - -