Skip to content
On this page

deviceLowPowerModeEnabledError

  • Code: 4
  • Cause: A session was requested to run while the device is in 'Low Power' mode.
  • Solution: The user should open the device settings and turn off 'Low Power Mode' or charge your device until the 'Low Power Mode' turns off.

deviceTorchUnavailableError

  • Code: 6
  • Cause: A PPG session was requested to run, but the SDK could not activate the flashlight. It could be either because the device has no flashlight or due to a software or hardware issue.
  • Solution: The user should verify that the device flashlight works properly and retry.

deviceTorchShutDownError

  • Code: 7
  • Cause: The flashlight was shut down while a PPG session was running.
  • Solution: The user should verify that device flashlight works properly and retry.

deviceMinimumOsVersionError

  • Code: 8
  • Cause: The device's operating system version is lower than the minimum version required to run the SDK.
  • Solution: Upgrade the device operating system or use another device.

deviceMinimumBatteryLevelError

  • Code: 14
  • Cause: The battery level is below 20% and prevents accurate measurement.
  • Solution: The user should connect the device to a charger and wait until battery is sufficiently charged.

deviceClockSkewError

  • Code: 17
  • Cause: Severe clock skew detected
  • Solution: The user should verify that the device date, time, and timezone are set correctly. It is recommended to set the date and time automatically in the device settings.

deviceBluetoothIsOffError

  • Code: 19
  • Cause: The Bluetooth is off.
  • Solution: Instruct the user to turn on Bluetooth.

deviceBluetoothMissingPermissionsError

  • Code: 20
  • Cause: The application does not have Bluetooth permissions.
  • Solution: Instruct the user to grant the application permissions to use the Bluetooth.

cameraNoCameraError

  • Code: 1001
  • Cause: The session.start() command was called, but the device has no camera with the required specifications.
  • Solution: The camera must support a resolution of 640x480 at 30FPS. The rear camera requires a flashlight for finger measurements. The user should verify that the device camera works properly.

cameraCameraOpenError

  • Code: 1002
  • Cause: Could not operate the camera.
  • Solution: The user should verify that the device camera works properly and try again. If the problem persists, the user should restart the application.

cameraCameraMissingPermissionsError

  • Code: 1005
  • Cause: The application does not have permission to access the camera.
  • Solution: The user should access the device settings and grant the application permission to use the camera.

licenseActivationLimitReachedError

  • Code: 2002
  • Cause: No more devices can be used with your license
  • Solution: Contact the sales team to increase the number of device authorizations in your license.

licenseMeterAttributeUsesLimitReachedError

  • Code: 2003
  • Cause: No more measurements are allowed for the provided license. (Relevant only for customers with a 'per session' license).
  • Solution: Contact the sales team to increase the number of measurements in your license.

licenseAuthenticationFailedError

  • Code: 2004
  • Cause: Several issues might cause this error: clock skew detected, the SDK was unable to authenticate the license, a bad token was received from the license server
  • Solution: The user should take the following actions: Check the internet connection. Set the device time correctly. Verify that the device has sufficient storage.

licenseInvalidLicenseKeyError

  • Code: 2007
  • Cause: The provided license key is invalid.
  • Solution: Use the license key provided by the support team. If the problem persists, contact the support team.

licenseRevokedLicenseError

  • Code: 2010
  • Cause: The license was revoked.
  • Solution: Contact the customer support team.

licenseInternalError9

  • Code: 2016
  • Cause: SSL error. Unable to authenticate the license server response.
  • Solution: The user should check the device's local time, internet connection, try a different network, or try again later.

licenseLicenseExpiredError

  • Code: 2017
  • Cause: The license has expired.
  • Solution: Contact the customer support team.

licenseLicenseSuspendedError

  • Code: 2018
  • Cause: The license is suspended.
  • Solution: Contact the customer support team.

licenseNetworkIssuesError

  • Code: 2024
  • Cause: No internet connection.
  • Solution: Check your internet connection and The user should check the internet connection and try again. again

licenseSslHandshakeError

  • Code: 2025
  • Cause: SSL certificate security warning.
  • Solution: The user should check the device's local time, internet connection, try a different network, or try again later.

licenseInputLicenseKeyEmptyError

  • Code: 2032
  • Cause: No license key was provided to the SDK.
  • Solution: Initiate the SDK with a valid license key, provided by the support team.

licenseInputProductIdIllegalError

  • Code: 2034
  • Cause: An invalid product ID was provided.
  • Solution: The product ID must be null when establishing a session.

licenseCannotOpenFileForReadError

  • Code: 2035
  • Cause: The SDK cannot read from the file system, or a file may be corrupted.
  • Solution: Instruct the user to check the installation integrity.

licenseMonthlyUsageTrackingRequiresSyncError

  • Code: 2036
  • Cause: The SDK failed to authenticate with the license server as required by the license type.
  • Solution: Instruct the user to check the internet connection and try again.

licenseSslHandshakeDeviceDateError

  • Code: 2037
  • Cause: SSL certificate security warning.
  • Solution: The user should check the device's local time, internet connection, try a different network, or try again later.

licenseSslHandshakeCertificateExpiredError

  • Code: 2038
  • Cause: SSL certificate security warning.
  • Solution: The user should check the device's local time, internet connection, try a different network, or try again later.

licenseMinSdkError

  • Code: 2039
  • Cause: The SDK version is too old to be used with this license.
  • Solution: Upgrade to the latest SDK version or contact the support team.

licenseNetworkTimeoutError

  • Code: 2042
  • Cause: Network timeout reached for a single call
  • Solution: Advise the user to try the following steps: verify the internet connection speed, restart the application, wait briefly, attempt using another network, or try again later. If the issue persists, please contact our support team.

measurementMisdetectionDurationExceedsLimitError

  • Code: 3003
  • Cause: The face or finger were not detected for a period of over 0.5 seconds several times.
  • Solution: The user should ensure that the face or finger remains still during the measurement and follow the best practices provided by the provider for taking accurate measurements.

measurementInvalidRecentDetectionRateError

  • Code: 3004
  • Cause: More than 2 periods of multiple frame losses were detected during the measurement.
  • Solution: The user should make sure that the device is not overheating or low on resources. The user should not use debugging tools or developer tools or perform intensive logging during the measurement. If the problem persists, the user should close other applications or services, or restart the device. The user should make sure to follow the best practices for taking a measurement.

measurementLicenseActivationFailedError

  • Code: 3006
  • Cause: The license activation failed.
  • Solution: The user should check the device's internet connection, and should check that no invalid proxy configuration is used. If the problem persists, the user should contact the support team.

measurementInvalidMeasurementAverageDetectionRateError

  • Code: 3008
  • Cause: The average frame rate is significantly lower than expected.
  • Solution: Instruct the user to close resource-intensive applications. Ensure the device isn't busy, overloaded, overheated, or affected by OS, software, or hardware issues. Allow the device to cool down and retry. If the problem persists, consider using another device.

measurementTooManyFramesInorderError

  • Code: 3009
  • Cause: Multiple consecutive frames were received in incorrect timestamp order. This error occurs if warning 3506 is issued multiple times.
  • Solution: The user should rerun the measurement.

measurementExternalPpgDeviceMisplacedError

  • Code: 3010
  • Cause: The sensor is misplaced, removed, or not fastened to the skin.
  • Solution: Instruct the user to wear the PPG device snugly over a clean area of skin on their non-dominant upper arm. Ensure direct contact with the skin (underneath clothing) and avoid placing it over tattoos. If issues persist, clean the device and the skin area, and fasten the band securely.

measurementMisdetectionDurationExceedsLimitWarning

  • Code: 3500
  • Cause: The face/finger was not detected for a period of over 0.5 seconds.
  • Solution: The instantaneous vital signs should not be displayed to the user for a few seconds until the algorithms overcome the face/finger detection issues. The user should make sure to follow the best practices for taking a measurement.

measurementInvalidRecentFPSRateWarning

  • Code: 3505
  • Cause: Camera FPS is degraded and may affect the measurement quality.
  • Solution: The user should make sure to follow the best practices for taking a measurement.

measurementMeasurementMisplacedFrameWarning

  • Code: 3506
  • Cause: A frame was received in incorrect timestamp order.
  • Solution: The user should proceed with the measurement.

vitalSignBloodPressureProcessingFailedWarning

  • Code: 4505
  • Cause: Failure to calculate blood pressure in this measurement. This warning does not impact other vital sign measurements. The failure may have been caused by corrupted installation files.
  • Solution: Blood pressure will not be calculated for this measurement session. The other vital sign results will be presented. The user can retry the measurement. If the problem persists, the user should reinstall/repair the app.

vitalSignMeasuringWithNoEnabledVitalSignsWarning

  • Code: 4506
  • Cause: No vital signs were processed as part of this measurement.
  • Solution: This warning is issued when the license does not support the calculation of any vital signs, or when the SDK cannot access license information. The user should check the internet connection and try another measurement.

sessionIllegalStartCallError

  • Code: 6004
  • Cause: A session start call was made when the session is not in READY state
  • Solution: Wait for session state to become READY before calling start.

sessionIllegalStopCallError

  • Code: 6005
  • Cause: A session stop call was made when the session is not in PROCESSING state
  • Solution: Call stop only when session is processing.

initializationInvalidProcessingTimeError

  • Code: 7002
  • Cause: An invalid session time was provided when creating a session.
  • Solution: Use a valid session time. The valid session time range is between 20-180 seconds.

initializationInvalidLicenseFormat

  • Code: 7005
  • Cause: The provided license key is either empty or its format is invalid.
  • Solution: Check the SDK license key provided by the support team. Ensure it is not empty and follows a valid format - avoid including spaces, newlines, or special characters.

initializationUnsupportedUserWeight

  • Code: 7007
  • Cause: The weight submitted by the user is not supported. The supported weight range is between 40 to 200 kilograms.
  • Solution: The user should either submit a weight within the supported range, or not specify a weight at all.

initializationUnsupportedUserAge

  • Code: 7008
  • Cause: The age submitted by the user is not supported. The supported age range is between 18 to 110 years.
  • Solution: The user should either submit an age within the supported range or not specify an age at all.

initializationConcurrentSessionsError

  • Code: 7009
  • Cause: Trying to create a new session before terminating the previous session.
  • Solution: The previous session should be terminated before establishing a new one.

ppgDeviceConnectionTimeoutError

  • Code: 8003
  • Cause: It took too long to the Bluetooth device to respond to the connection request.
  • Solution: Instruct the user to turn off the bluetooth device and after a while turn it back on and try again to connect.

ppgDeviceInvalidDeviceIdError

  • Code: 8004
  • Cause: The requested ID of the Bluetooth device has an invalid format.
  • Solution: Make sure to provide a valid Bluetooth device ID.

ppgDeviceUnsupportedFirmwareVersionError

  • Code: 8005
  • Cause: The Bluetooth device firmware version is not supported.
  • Solution: Upgrade the Bluetooth device firmware or try another device.

ppgDeviceUnsupportedDeviceModelError

  • Code: 8006
  • Cause: The Bluetooth device hardware is not supported.
  • Solution: Instruct the user to use another Bluetooth device.

ppgDeviceConnectionError

  • Code: 8007
  • Cause: The Bluetooth device was disconnected.
  • Solution: Instruct the user to check the Bluetooth device battery, turn the Bluetooth off and back on and to try connecting again.