Introducing OEM Safety Key

The OEM Safety Key is an application-defined string of characters. Any character except the null character is allowed. The string length is unlimited.

When the application sets the ProgramOemSafetyKey GenApi feature with the OEM Safety Key value, the eGrabber driver computes an encrypted version of the OEM Safety Key and stores it in the non-volatile memory of the frame grabber.

The encrypted value can be retrieved by getting the value of EncryptedOemSafetyKey immediately after having set ProgramOemSafetyKey.

Only the same application process having set ProgramOemSafetyKey is allowed to retrieve the encrypted value. This is only allowed until any other GenApi feature is set.

The application has to select one OemSafetyKeyVerification value of the

In order to verify the OEM Safety Key of a frame grabber, the application sets a "challenge" value to the CheckOemSafetyKey[selector] feature.

When the [selector] argument is set to EncryptedKey, the set action terminates normally only when the challenge string is identical to the encrypted OEM Safety Key string.

When the [selector] argument is set to ProgrammingKey, the set action terminates normally only when the challenge string is identical to the programming OEM Safety Key string.

When the [selector] argument is set to ProgrammingKeyOrEncryptedKey, or omitted, the set action terminates normally only when the challenge string is identical to the original OEM Safety Key string or to the encrypted OEM Safety Key string.

Euresys recommends using the EncryptedKey selector. This improves the security level since the programming key doesn't need to appear anywhere in the end user application. Having only the encrypted key, the end user cannot retrieve the original programming key.