User guide for version 7.10
Previous versions: 7.9 | 7.8 | 7.7
×
 

Driver identification by Face ID

Mettax cameras can recognize a driver’s face and send the driver’s identifier to PILOT. After successful recognition, PILOT automatically assigns the driver to the object in the same way as with iButton and RFID tags.
This feature makes it possible to identify who is driving a vehicle when several drivers use the same object.
 

Preparing drivers on the device

Drivers must first be registered on the Mettax device. After registration, the device creates a faceId for each driver.
The procedure for adding drivers depends on the camera model and its settings. If you do not know how to register drivers on the device, contact the specialist who installed or configured the camera.
After a driver is registered, the device must:
1. Recognize the driver’s face
2. Send the generated faceId to PILOT
3. Send the recognition result in the faceRecogn parameter
The faceId is generated by the Mettax device. The value received from the device is linked to the corresponding driver card in PILOT.
 

Recognition data

When checking a face, the device sends the following parameters to PILOT:
  • faceId — the driver identifier generated on the device
  • faceRecogn — the recognition result
  • alarm — the type of verification performed
The faceRecogn parameter can have the following values:
  • 1 — the face was successfully recognized
  • 0 — the verification failed
  • 2 — the face could not be identified
  • 3 — the comparison failed
For automatic driver assignment, the device must send faceRecogn=1.
The camera can send the following verification events:
  • alarm=647 — periodic driver verification
  • alarm=648 — driver verification when the ignition is switched on
     

Recognition data in raw data points

When checking a face, the Mettax camera sends the alarm, faceId, and faceRecogn parameters in the object’s raw data.
The highlighted row in the example contains the following values:
alarm=647; faceId=1; faceRecogn=1
Here:
  • alarm=647 — the camera performed a periodic driver verification
  • faceId=1 — the device sent driver identifier 1
  • faceRecogn=1 — the face was successfully recognized
In the rows above, the camera sent:
faceId=20210301001; faceRecogn=0;
The faceRecogn=0 value indicates that the face could not be recognized.
In the row containing alarm=648, verification was initiated when the ignition was switched on. The faceRecogn=0 value also means that the face was not recognized.
For automatic driver assignment, the faceId and the successful faceRecogn=1 result must be received in the same data point. The received faceId must match the value in the iButton field of the driver profile.
 

Configuring the Face ID sensor

To allow PILOT to use the received faceId to identify the driver, create a special sensor with the iButton function on the object.
1. Add a new sensor to the object
2. Specify the following parameters
  • Function — iButton
  • Type — Special
  • Name and Description
  • Field — for example, faceId
  • Conversion formula — *%faceRecogn%. It multiplies the faceId value by the recognition result. When recognition is successful (faceRecogn=1), the faceId remains unchanged, allowing PILOT to match it with the identifier in the driver profile. For other values, the formula result does not match the original faceId;
  • Maximum value — a value large enough to accommodate the faceId identifiers in use
3. If necessary, enable Close driver’s session on ignition off. After the ignition is switched off, the assigned driver will no longer be considered active for the object.
4. Save the sensor

Testing the formula

Test the formula using sample data before saving the sensor.
1. Click Test next to the conversion formula
2. In the window that opens, find the faceid and faceRecogn parameters
3. For faceid, enter a test driver identifier, for example: faceid=20210301001
4. Replace the automatically generated faceRecogn value with 1: faceRecogn=1
5. Click Test
If the test is successful, the result must match the faceid value: Success: 20210301001
The *%faceRecogn% formula multiplies faceid by the recognition result. When faceRecogn=1, it returns the original driver identifier. For other values, the formula result does not match the original faceId.
The automatically generated test values are not data received from the device. Before running the test, replace faceRecogn with one of the values supported by the Mettax camera: 0, 1, 2, or 3.
 

Linking Face ID to a driver

When a driver is registered, the Mettax device generates a unique faceId for that driver. To allow PILOT to identify the driver automatically, specify this identifier in the driver profile.
1. Find the faceId assigned to the driver by the Mettax device
2. Copy the faceId value
3. Open the corresponding driver profile in PILOT
4. Go to the Main tab
5. Paste the faceId value into the iButton field
Driver identification by Face ID
6. Save the changes
The value in the iButton field must exactly match the faceId sent by the camera. A separate identifier is used for each driver.
After successful recognition, the camera sends faceId and faceRecogn=1. PILOT matches the received faceId with the value in the iButton field and assigns the corresponding driver to the object.