8.3 The configuration file

The configuration file settings.ini configures the information to be logged by the Generic Graphics Accelerator and configures whether OpenGL ES calls are handled only by the Generic Graphics Accelerator, or additionally by the Mali driver on the target.

Location of the configuration file

You must copy settings.ini from the following directory into the directory to boot your Android target:

  • On Linux: <installation_directory>/GGA/reconciler/linux-x86_64/gcc-x.x.x/rel/, where x.x.x is the GCC version number.

  • On Windows: <installation_directory>\GGA\reconciler\win_32-x86_64\cl-18.00.31101\rel\

Options in the configuration file

The configuration options are:

  • LogLevel: Specifies the information to be logged. It uses numbers to indicate log levels. The default setting is LogLevel 1.

    The numbers are:

    • 0: Represents LOG_LEVEL_OFF, which disables logs from the Generic Graphics Accelerator.
    • 1: Represents LOG_LEVEL_FATA, which logs fatal issues from the Generic Graphics Accelerator.
    • 2: Represents LOG_LEVEL_ERROR, which only logs errors generated by the Generic Graphics Accelerator.
    • 3: Represents LOG_LEVEL_WARN, which only logs warnings generated by the Generic Graphics Accelerator.
    • 6565: Represents LOG_LEVEL_INFO, which logs the OpenGL ES API execution sequences.
    • 6566: Represents LOG_LEVEL_DEBUG, which logs the executed API names and parameters.
    • 6567: Represents LOG_LEVEL_TRACE, which logs more detailed information generated by the Generic Graphics Accelerator.
  • callOnTargetAPI: Specifies whether the OpenGL ES APIs interact with only the Generic Graphics Accelerator or with both the Generic Graphics Accelerator and the Mali graphics driver.

    Values for this option are:

    • 0: APIs interact only with the Generic Graphics Accelerator.
    • 1: APIs interact with both the Generic Graphics Accelerator and the Mali graphics driver.
  • checkErrorCode: Enables or disables the Error Code Check function. This function examines the execution of OpenGL ES APIs in the target graphics driver. This option is valid only if callOnTargetAPI is set to 1.

    Values for this option are:

    • 0: Disables Error Code Check.
    • 1: Enables Error Code Check.
  • enableErrorCheckWhiteList: Specifies whether the Error Code Check function should check errors from all OpenGL ES APIs or from specific OpenGL ES APIs. This option is valid only if both callOnTargetAPI and checkErrorCode are set to 1.

    Values for this option are:

    • 0: To examine all APIs.
    • 1: To examine specific APIs.

    For more details about the use of the Error Code Check function, see Examining OpenGL ES execution in the graphics driver.

Non-ConfidentialPDF file icon PDF version100965_1180_00_en
Copyright © 2014–2019 Arm Limited or its affiliates. All rights reserved.