Error messages

This is a list of error messages that the "Software update" application will show when something goes wrong:

File operation errorsMessageReason(s)
FILE_NOT_FOUNDRequested file was not found.Requested file was not found.
IO_EXCEPTIONIO exception occurred.

Retry or reboot the device and try again. If the problem persists please contact us.

FILE_DOWNLOAD_ERRORError while downloading file.

The file cannot be found. Check the file is present and the URI syntax is correct.

INCORRECT_FILE_PATHFile path is incorrect.Supplied file path was incorrect.
JSON_PARSING_ERRORError while parsing Json file.

Unable to parse JSON file. This could be caused by syntax errors like missing brackets, commas or quotes.

UNSUPPORTED_SCHEMAJson file with unsupported schema was provided.

The mentioned schema version is not supported.Check update-locations and package-list schema versions are correct.

FILE_DELETE_ERRORError while deleting file.

Unable to delete a file. Retry or reboot the device and try again. If the problem persists please contact us

UNSUPPORTED_FILE_TYPE

Unsupported file type specified in package-list file. Only .zip, .apk and .ttpkg files are supported.

Unsupported file type was provided. Only ttpkg, apk and zip files are supported. Check for typos or unsupported packages.

FILE_CREATE_ERROR>Error while creating file

Retry or reboot the device and try again. If the problem persists please contact us

FILE_NAME_TOO_LONGThe file name is too long.

The file name is too long. Maximum file name length is 255 characters.

File download errorsMessageReason(s)
MALFORMED_URL_ERRORThe specified URL is not correct.

Provided URL is malformed. The specified URL is incomplete, check spelling. If you copy/pasted ensure you copied the whole URL.

UNKNOWNN_HOST_ERRORThe specified host not found.

The host cannot be found. There may be a problem with the host or the host was incorrectly specified.

SERVER_CONNECTION_ERRORError while downloading file.

Server did not respond correctly to connection request. Check there's not a problem on the server.

REDIRECT_NOT_ALLOWED_ERROR

The server redirected to a different location which is not allowed.

The server tried to re-direct to another location. This is restricted for security reasons. Ensure your packages are stored on the same server as the package-list.

Security errorsMessageReason(s)
INVALID_KEYThe verification key is invalid. Please use a different key.

The specified key was not used to create the signature. Check you used the intended key to sign the file.

INVALID_VERIFICATION_LIST

The list of verification keys contains invalid keys. Please use a valid list.

Check the specified keyword in verification-public keys are correct and that the filename doesn't contain a "/" (forward slash).

NO_SUCH_ALGORITHMNo algorithm was found.

This is a problem with the device platform. Please contact us if you see this error.

CERTIFICATE_ERRORIncorrect certificate.

Https certificate related error. Check the certificates you provided match the ones on the server.

KEYSTORE_ERRORKeystore error.

The provided certificate is invalid, please chec the certificate validity. If the certificate is valid and you continue to see this error please contact us.

KEY_MANAGEMENT_ERRORKey management error.

This is a problem with the device platform. Please contact us if you see this error.

NO_VERIFICATION_KEYS

No verification keys found. The SD card or USB storage must contain the correctly signed software configuration.

One or more verification key is specified in verification-public-keys but the key cannot be found. Check the key is present on micro sd card or USB storage.

SIGNATURE_CHECK_FAILEDFile signature check failed. Please use a valid signature file.

The private key used to generate the signature does not match the provided public key.

SIGNATURE_FILE_NOT_FOUNDSignature file not found.

No .sig file can be found for the package-list or update-locations.

SSL_HANDSHAKE_ERRORSSL handshake error.

SSL handshake did not succeed. The provided certificates do not match the certificates on the server.

File contents errorsMessageReason(s)
LAYOUT_SPECIFIED_MORE_THAN_ONCE

XXXXX: Tile layout has been specified more than once. Remove duplicate tile layouts and try again.

Tile layout has been specified more than once. You can only specify one tile home screen layout per tile layout

NO_LAYOUT_FOUND

XXXXXX: No tile layout found for screen size, please specify an XxX layout.

No tile layout has been found that fits the screen size of the display, create the specified size and try again. In general it's a good idea to specify them all.

BOOTSTRAP_UNEXPECTED_SCHEMA_ERRORUnexpected schema, version X, found in Y

The specified schema version in the new update-locations does not match the directory on the micro sd card. For example "schema": "2" is specified in update-locations but update-locations is in the \boot\2\bridge\ directory.

BOOTSTRAPCOPY_ERRORThe software update configuration could not be updated.

Please check that the update-locations file (and bridge directory) are complete and correct. If this does not solve the problem reboot the device and try again. If the problem still persists please contact us.

EMPTY_NETWORKS_VALUENo network type specified.

No network type specified. For example, "networks_for_scan" : "[ ]"

INVALID_PACKAGE_DESCRIPTIONOne of the packages is missing the name or the path

Package name or path are missing in package description, these are mandatory.

INVALID_BOOLEAN_VALUE

Incorrect boolean value given, only "true" and "false" is permitted

Provided boolean package attribute is not of boolean type, only 'true' or 'false' are allowed.Check for typos or spelling mistakes.

PACKAGE_LOCATIONS_UNKNOWNNo package-list locations were provided.

Locations of package-list files are unknown. Specify either "file" or "uri" for each package-list.

NO_PACKAGES_IN_FILEPackage-list file contains no packages.No packages have been specified in the package-list.
PACKAGE_DEFINED_TWICEThe same package was added twice without being excluded.

The same package is defined twice but not excluded. If you specify a package more than once you must exclude it. See Exclude packages from other package lists
for more information.

PACKAGE_EXCLUDED_ONLYPackage is excluded but it had never been added.

Package is excluded, but was not defined anywhere else. Check you have included the package in a package-list that is being used. See Exclude packages from other package lists
for more information

PACKAGE_CONSISTENCY_ERROR

Package name and version information does not match the name and version in the package-list file.

Name or version of the package do not match with information in package-list file. Check that the package is defined correctly or for typos in the package-list.

PACKAGE_CORRUPT

The content of the package is corrupt or missing required information.

The package does not contain the required information, is failing checksum or is corrupt. Try installing the package again or check the source is not corrupt.

PACKAGE_LIST_TOO_LARGEThe package-list file is too large.

The package list is too long. The maximum package-list file size is 2MB

UNKNOWN_PACKAGE_TYPEPackage type not known for package.

Only .apk, .ttpkg and .zip files are supported, check the file has a file extension and that the file extension is correct.

UNSUPPORTED_SCAN_INTERVAL_VALUEUnsupported value for update scan interval.

Unsupported value for update_scan_interval. Only positive integer values (1 or higher) or 'never' are supported.

UNSUPPORTED_NETWORK_VALUEUnsupported value for network type.

Unsupported value for network type. Only "wifi" or "any" are supported.

OVERLAPPING_CONTENTS_ERROR

Contents of the zip file duplicate contents of another zip file to be installed or already installed zip file.

Zip files to be installed have duplicated content. Either with device database or with other zip files to be installed.

INCONSISTENT_PACKAGE_ATTRSPackage has inconsistent attributes.Check the package does not have conflicting attributes
UNSUPPORTED_UPDATE_MODEThe specified update mode is not supported.

Only "adaptive" and "safe" are supported. See Update modes
for more details.

EMPTY_NETWORKS_VALUENo network type specified.

Empty value for network type in one of the package lists. Please check provided package lists.

PACKAGE_PARENT_NOT_FOUNDSpecified parent is not present.

A package has a parent specified but the specified parent is not present in the package-list. Make sure that the parent is present and spelled correctly

PACKAGE_PARENT_HAS_PARENTSpecified parent also has a parent.

The specified parent also has a parent. Make sure that the parent package doesn't have a parent

PACKAGE_GROUP_VERSION_MISMATCHTwo or more packages in the same group have different versions.

All packages in a group must have the same version. Make sure that all packages in the group have the same version number.

PARENT_OR_GROUP_NOT_SPECIFIED

Map area packages require a parent and a group in order to be installed. Make sure that the overview map is specified as parent.

You have modified a TomTom package-list, we don't recommend this unless you pull out the whole line for the map area. Re-download the package-list and try again.

NDS_MAP_UPDATER_BUSYAnother application is modifying the map. Please try again later.

Only one application can modify the map at a time. Wait for the Navigation application to finish and then try again.

CONFIGURATION_INVALID

The specified map format is not compatible with the specified build.

Bridge has moved to a new map format which requires a different build from the old map format. Please check that the map format is compatible with the specified build.

Installation errorsMessageReason(s)
INSTALLATION_ERRORUnknown error during installation.

Android cannot install a package. Please retry, if the problem persists please contact us.

NO_UPDATE_LOCATIONSThe system is not configured.

The device needs to be configured before it can check for updates. See Software update
for details.

UNINSTALLATION_ERRORUnknown error during uninstallation.

Android cannot uninstall a package. Please retry, if the problem persists please contact us.

LOW_BATTERY_ERRORBattery too low.

Informs the user that the battery level is too low to continue installation. Please charge battery to at least 50% to update your device.

NO_SD_INSERTED

No SD card found. Insert the SD card that contains the software update to continue.

Informs the user that no SD card was found, while the update should happen by means of the SD card. Please insert an SD card that contains a software update to continue.

SD_REMOVED

SD card removed. Insert the SD card to continue the software update.

Informs the user that the SD card got disconnected during an update (ejected, removed, ...). Re-insert the SD card to continue the software update.

NO_EXTERNAL_STORAGE_FOUND

No external storage found. Insert the SD card or connect the USB storage that contains the software update to continue.

Informs the user that no external storage was found, while the update should happen by means of the SD card or USB storage. Please insert an SD card or attach USB storage that contains a software update to continue.

EXTERNAL_STORAGE_REMOVED

External storage removed. Insert the SD card or connect the USB storage to continue the software update.

Informs the user that the SD card or USB storage were disconnected during an update (ejected, removed, ...). Re-insert the SD card or re-attach USB storage to continue the software update.

DISK_FULL_ERROR

Not enough space. There is not enough disk space for this software update. Delete some files and try again.

Informs the user that there is not enough disk space; this can occur before and while doing an update.

UNSUPPORTED_SOFTWARE_VERSION (≥17.1)

Software version is not supported on this device. Install version XX.X or higher.

The device is only compatible with the specified software versions. Check that you are not trying to install an older version on the device.

UNSUPPORTED_SOFTWARE_VERSIONSoftware version is not supported on this device.

Devices that have an OJ serial number prefix (4FI76 model) are only compatible with software version 16.4 or higher. Check that you are not trying to install an older version on an OJ device.

INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES

An application currently installed on the device is being upgraded but it's signature does not match the signature of the installed version. In order to be able to upgrade applications their APKs must be signed with the same certificate.

For more details on this error please check this page
on the Android Developers portal.

PARENT_OR_GROUP_NOT_SPECIFIEDMap area package has no parent and/or group specified.

Map area packages require a parent and a group in order to be installed. Make sure that the overview map is specified as parent.

INCORRECT_OVERVIEW_MAP

Map area package version is a different version to the overview map package, or no overview map package is specified.

Before installing a map area package an overview map needs to be installed. The map area package must be the same version as the overview package or the installation will fail.

Network errorsMessageReason(s)
UNREACHABLE_HOST_ERROR

Specified host is not reachable. Something is wrong with your network connection.

The host cannot be found via the network the device is connected to. Check that the network is configured correctly.

UNREACHABLE_PROXY

Proxy server not found. Check the proxy settings of your WiFi connection.

The set proxy cannot be found. Check that the set proxy is correct and that there are no network issues.

SETTINGSUPDATE_ERROR

The settings could not be applied. An error has occurred during the update process

The application of settings timed out, please retry. If the problem persists please contact us.

NO_WIFI_CONNECTION

No WiFi connection. Connect to a WiFi network to check for software updates.

Informs the user that there is no WiFi connection, which is required for an update. To search for updates or to download packages you need to be connected to WiFi.

CONNECTION_LOSTConnect to a WiFi network to check for software updates.

Informs the user that there is no WiFi connection while searching for an update. To search for updates, you need to be connected to WiFi.

NO_NETWORK_CONNECTION

No network connection. Connect to the network to check for software updates.

Informs the user that they need to connect to the network in order to check if updates are available.

WIFI_LOST

WiFi connection lost. Reconnect to the WiFi network to continue the software update.

Informs the user that the WiFi connection was lost while updating.

NETWORK_LOST

Network connection lost. Reconnect to the network to continue the software update.

Informs the user that they need to connect to the network in order to continue the update.