Arm Mobile Studio Release History

Here, you can find details about what changed with each new release of Arm Mobile Studio.

To download the latest version, go to Downloads.

Arm Mobile Studio

Version 2021.3

Released: August 26, 2021

  • Arm Mobile Studio: 2021.3 August 26, 2021

    What's new in 2021.3

      

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to the previous version:

    Arm Mobile Studio 2021.3

    • Mobile Studio tools no longer include tool usage telemetry.
    • Mobile Studio for Unity package, available on GitHub, now exposes a counter annotation API. This allows C# scripts to emit software-generated Streamline counters directly into the application profile.

    For this release we have tested and confirmed that the following devices work with Mobile Studio tools:

    • Samsung Galaxy A32
    • Samsung Galaxy A32 5G

    Check supported devices list for the complete list of devices that we have tested for compatibility.


    Streamline 7.8

    • Software profiling will more accurately cost leaf functions for code compiled with the clang compiler
    • Mali GPU templates (Bifrost/Valhall) extended to show geometry shading efficiency metrics: the number of position shader invocations per input primitive, and the number of varying shader invocations per visible primitive
    • Mali GPU templates (Bifrost/Valhall) extended to show fragment front-end read bandwidth in the per-shader core "L2 memory reads" and "External memory reads" statistics

    Performance Advisor 1.6

    • Interactive Streamline captures using the Performance Advisor lwi_me.py to set up a layer driver will now work cleanly with Streamline device connection
    • Bug fix: The lwi_me.py helper script now correctly loads the Vulkan layer driver

    Graphics Analyzer 5.9

    • R11G11B10f framebuffers now display correctly in framebuffer views

    Mali Offline Compiler 7.4

    • Compiler backend for Bifrost GPUs updated to match the r32p0 driver
    • Compiler backend for Valhall GPUs updated to match the r32p0 driver
    • GPU support added for Mali-G310, Mali-G510, Mali-G610, and Mali-G710 products
    • The packaged glslangValidator  Vulkan compiler frontend for generating SPIR-V has been updated to the latest version
    • Vulkan shaders requiring SPIR-V 1.3 or higher can now be compiled from source, provided that the target GPU supports the required SPIR-V feature level

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Email us at mobilestudio@arm.com.

    Known issues

    • No new issues

    Refer to our FAQ page for answers to common problems and workarounds. 

  • Arm Mobile Studio: 2021.2 July 09, 2021

    What's new in 2021.2

      

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2021.1.

    Arm Mobile Studio 2021.2

    • This release of Arm Mobile Studio is a patch release to fix a number of errata in Graphics Analyzer. Other tools in the bundle are unchanged in this release.

    Streamline 7.7

    • No new changes in this release.

    Performance Advisor 1.5

    • No new changes in this release.

    Graphics Analyzer 5.8.1

    • Shader costings presented in the Shader tab performance tables now consistently reset at the start of each frame.
    • Copying rows from the Shader tab performance table to the clipboard now copies the correct data.
    • Debug visualizations using shader replacement, such as overdraw and fragment count mode, now report correct results and show correctly scaled framebuffer visualization for floating point frame buffer
    • The overdraw mode histogram X-axis labels are now correctly ordered

    Mali Offline Compiler 7.3

    • No new changes in this release.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Email us at mobilestudio@arm.com.

    Known issues

    • No new issues

    Refer to our FAQ page for answers to common problems and workarounds. 

  • Arm Mobile Studio: 2021.1 May 27, 2021

    What's new in 2021.1

      

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2021.0.

    Arm Mobile Studio 2021.1


    Streamline 7.7

    • The software profiler now supports profiling Android applications that load native libraries using a direct memory mapping from the APK. In earlier releases of Streamline it would fail to associate the symbol information from the library .so file with the application. 
    • The Timeline view chart visualization and templating system now supports wildcard patterns for selecting counters to convert into series. The series name of pattern matched counters must have a fixed prefix, but can have an arbitrary post-fix, allowing a template to match multiple namespaced counters using a generic pattern.
    • The Mali counter templates have been updated to use wildcard patterns to select and visualize software counters captured using the lightweight interceptor (LWI), such as the application frame rate, render pass per frame count, and draw call per frame count. 

    Note: Streamline 7.7 can open capture files that were taken with previous versions, from version 7.0 onwards. Captures taken with Arm Development Studio can not be opened with an Arm Mobile Studio starter edition license. If you need to open captures taken with Arm Development Studio, you will need an Arm Mobile Studio professional edition license.

    Performance Advisor 1.5

    • Fixed an issue where tooltips could stop displaying resulting in poor performance in HTML reports with a large amount of data.

     

    Graphics Analyzer 5.8

    • No new changes in this release.

     

    Mali Offline Compiler 7.3

    • No new changes in this release.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Email us at mobilestudio@arm.com.

    Known issues

    • In some cases, the playback and capture buttons are disabled in Graphics Analyzer - here's a workaround.
    • When capturing screenshots with Performance Advisor on Vulkan applications, the capture slows down significantly and fails. Here's a workaround.

    Refer to our FAQ page for answers to common problems and workarounds. 

  • Arm Mobile Studio: 2021.0 March 12, 2021

    What's new in 2021.0

      

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2020.2.

    Arm Mobile Studio

    • Arm Mobile Studio now supports the following devices:
      • Samsung Galaxy A10
      • Samsung Galaxy A21s
      • Samsung Galaxy S21
      • Oppo Reno4 Z
      • Huawei P40 Pro

      Refer to the supported devices page for a full list of supported devices. 


    Streamline 7.6

    • Support for Mali-G68 and Mali-G78 GPUs.
    • Symbols are now correctly reported from libraries mapped direct from an APK without extraction.
    • Better handling of APKs attached to the analysis where multiple bitness library versions are found.
    • Ability to provide a fixed point scale in the Streamline Annotations header.
    • Fixed an issue with process/thread attribution in a multi-process/-thread SPE capture.
    • Minor usability improvements to the Android connection view.
    • New tutorial - Android performance triage with Streamline.

    Note: Streamline 7.6 can open capture files that were taken with previous versions, from version 6.9 onwards. Captures taken with Arm Development Studio can not be opened with an Arm Mobile Studio starter edition license. If you need to open captures taken with Arm Development Studio, you will need an Arm Mobile Studio professional edition license.

    Performance Advisor 1.4

    • The required syntax when providing a file containing command-line options to the pa command has changed. You must now use the equals sign (=) between the option name and its value instead of spaces, and each option must be given on a separate line in the file. Options which accept a string, such as --application-name no longer need to be enclosed within double quotes when they contain multiple words.
    • The lwi_me.py script has undergone a number of usability improvements.
      • When running the script from the Arm Mobile Studio installation directory, there is no longer a need to specify the path to the gatord daemon, or the layer library file. The script will locate these files automatically.
      • The script assumes that your app is 64-bit by default. To profile a 32-bit app, specify the --32bit option when running the script.
      • The script assumes that your app uses OpenGL ES by default. To profile a Vulkan app, specify the --lwi-api=vulkan option when running the script.
        Refer to Get started with Performance Advisor for instructions on how to run the script, and The lwi_me.py script options in the Performance Advisor User Guide for details on all the command-line options.
    • The core count of the GPU in the device is now exposed in reports.
    • To aid writing parsers, JSON Schema definitions are now provided in the performance_advisor/json_schemas directory.
    • Performance improvements to the charts in HTML reports.
    • New tutorials:

     

    Graphics Analyzer 5.8

    • Support for tracing 32-bit applications on a 64-bit Android device.

     

    Mali Offline Compiler 7.3

    • No new changes in this release.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Known issues

    • In some cases, the playback and capture buttons are disabled in Graphics Analyzer - here's a workaround.
    • When capturing screenshots with Performance Advisor on Vulkan applications, the capture slows down significantly and fails. Here's a workaround.

    Refer to our FAQ page for answers to common problems and workarounds. 

  • Arm Mobile Studio: 2020.3 December 11, 2020

    What's new in 2020.3

      

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2020.2.

    Arm Mobile Studio

    • Samsung Galaxy A51 added as a supported device.
    • Oppo Reno3 5G added as a supported device.

    Streamline 7.5

    • Android device connection can now be established using only the GUI. When you launch Streamline, you can connect to a device directly from the Start tab without the need to run the  gator_me.py script. Watch this video to see how easy connection is, and refer to Get started with Streamline for full instructions.

      Note: The gator_me.py script is still required for headless modes of operation.
    • Mali GPU configuration parameter's for shader core count, L2 cache slice count, and external bus width are now available as expression variables.
    • Mali GPU template expressions for external memory stall percentages now correctly reflect the number of GPU cache slices in the target design. 
    • Mali GPU template expressions for external memory bandwidth counters now correctly reflect the GPU bus width in the target design.
    • Mali GPU templates for the Valhall family now include a measure of the number of fragment using advanced shader-based blend functions.
    Note: Streamline 7.5 can open capture files that were taken with previous versions, from version 6.9 onwards. Captures taken with Arm Development Studio can not be opened with an Arm Mobile Studio starter edition license. If you need to open captures taken with Arm Development Studio, you will need an Arm Mobile Studio professional edition license.

    Performance Advisor 1.3

    • Report chart visualizations can now be customized, allowing them to be tuned to their target audience.

    • JSON reports can now be compared using the new diff report generator, allowing simple comparative analysis of two builds.
    • Frame numbers are now displayed under each chart in the HTML file, and for each region in the JSON file.

     

    Graphics Analyzer 5.7

    • OpenGL ES applications on Android 8 or 9 no longer need an integrated interceptor library to be added at build time; the only requirement for any API or Android version is that the application is debuggable.

     

    Mali Offline Compiler 7.3

    • Input shaders can now be read from stdin instead of file; specify the input path as the "-" character.
    • Output reports can now be written to file instead of stdout; use the -o/-output command line option.
    • SPIR-V binary modules are now auto-detected, and most shader properties are inferred from the module content. This significantly shortens the command lines needed for SPIR-V binary inputs.
    • Process exit codes due to bad compiles (exit code 1) are now distinct from tool errors such a bad command line parameters (exit code 2). This helps integrating JSON reports into other tools more reliably; JSON reports are only produced by tool invocations returning exit code 0 or 1.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Known issues

    The issues listed here are new in this release. Refer to our FAQ page for answers to common problems and workarounds. 

     

  • Arm Mobile Studio: 2020.2 September 03, 2020

    What's new in 2020.2

    This release of Arm Mobile Studio includes:

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2020.1.

    Streamline 7.4

    • Improved device connection user interface and workflow. When you launch Streamline, you now see a Start tab that lists any connected devices, and enables you to quickly start capturing data. Refer to Connect Streamline to your device for details.
    • You can now visualize Arm NN timeline trace data. This allows you see what your machine learning application, built with Arm NN, is doing, and how it is interacting with accelerator hardware such as the GPU.
    Note: Streamline 7.4 can open capture files that were taken with previous versions, from version 6.9 onwards. Captures taken with Arm Development Studio can not be opened with an Arm Mobile Studio starter edition license. If you need to open captures taken with Arm Development Studio, you will need an Arm Mobile Studio professional edition license.

    Performance Advisor 1.2

    • You can set per-frame performance budgets for a range of metrics, that are then shown on the charts in the Performance Advisor report.
      GPU cycles per frame chart with a cycles budget of 33 million cycles per frame
      Use the following command-line options when running the  pa command to specify budgets:
      --bandwidth-budget <value>
      --cpu-cycles-budget <value> 
      --draw-calls-budget <value> 
      --gpu-cycles-budget <value> 
      --overdraw-budget <value> 
      --pixels-budget <value>
      --primitives-budget <value> 
      --shader-cycles-budget <value> 
      --vertices-budget <value>
    • Specify command-line options to the pa command, using a file containing a list of options. Refer to Command-line options configuration file in the Performance Advisor user guide.
    • When using the --clip-start or --clip-end options to define a specific region of the Streamline capture to analyze with Performance Advisor, you can now specify the frame number, instead of the timestamp in milliseconds. For example, --clip-end=7000f ends the region at frame 7000.
    • Frame numbers are shown in the report.
    • Wildcard operator support when manually defining regions start and end with a regions file. Refer to Specify a CSV file containing the regions in the Performance Advisor user guide.
    • Improved region summary messaging in the report.
    • Pretty-printed JSON is now an option and not the default for JSON reports. This makes the default JSON format consumable by 3rd party database and visualization tools such as ELK stack. If you want to output more human-readable pretty-printed JSON, use the --pretty-print option to the pa command.
    • Vertex data has been renamed to 'non-fragment'. Refer to Non-fragment bound for advice.
    • Changes to command-line interface:
      • The default setting for --lwi-mode is now none. This means that Performance Advisor will perform the capture without attempting to capture images of slow frames, and you no longer need to specify the --lwi-out-dir option by default. If you want to see the frame capture images in the Performance Advisor report, you need to set --lwi-mode to capture, and define an output directory for the frame images with --lwi-out-dir
      • The default setting for --lwi is now on.
      • The default setting for --lwi-fps-threshold is now 30.
    • For Arm Mobile Studio Professional users, there’s a new tutorial and helper script, to help you set up automated performance analysis with Arm Mobile Studio as part of your continuous integration workflow.

     

    Graphics Analyzer 5.6

    • Improved device connection support. You no longer need to use the aga_me.py script, to connect to your device; this functionality is now part of the Device Manager, which is launched when you start Graphics Analyzer. Refer to Capture a trace for details.
    • Updated API tracing support to include basic trace-only support for the latest Open GL ES extensions as well as for Vulkan 1.1, 1.2 and related extensions.
    • Removed support for:
      • Pre-Android 10 system-wide (rooted mode) tracing on Android targets.
      • OpenCL tracing on Android targets.
    • There's a new video to help you get up and running with Graphics Analyzer.

     

    Mali Offline Compiler 7.2

    • Mali Offline Compiler can now be used to generate reports for devices with Mali-G57, Mali-G68, Mali-G77 and Mali-G78 GPUs, based on Arm’s latest Valhall architecture. For arithmetic-heavy shaders you can now see the instruction cycles split by the arithmetic pipeline they are using: CVT, FMA, and SFU.
    • Stack and register usage reporting for Mali Bifrost and Valhall GPUs has been improved:
      • The number of work registers in use is now accurate, previously, this number would only report whether the number was below 32 or between 32 and 64.
      • See whether any variables are spilled to stack memory, and how many bytes per thread are spilled.
      • See the percentage of arithmetic operations that are performed efficiently, at 16-bit precision or lower.
    • Shader properties are now reported to help you identify opportunities for optimization.
    • For vertex shaders, Mali Offline Compiler reports separate performance tables for position and varying shaders.
    • Information is listed for supported Vulkan SPIR-V feature level and extensions.
    • You can now export Mali Offline Compiler reports as machine-readable JSON files, so that you can build your own dashboard to monitor shader performance over time. To do this, run malioc with the --format json option.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Known issues

    The issues listed here are new in this release. Refer to our FAQ page for answers to common problems and workarounds. 


  • Arm Mobile Studio: 2020.1 June 10, 2020

    What's new in 2020.1

    This release of Arm Mobile Studio includes:

    • Streamline, to profile application performance.
    • Performance Advisor, to generate at-a-glance application performance summary reports.
    • Graphics Analyzer, to debug graphics API usage.
    • Mali Offline Compiler, to perform static analysis of GPU shader programs.

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    This release introduces the following changes and updates compared to Arm Mobile Studio 2020.0.

    Arm Mobile Studio 2020.1

    This is the first release of Arm Mobile Studio professional edition, a licensing option to enable development teams to integrate performance analysis tools into their continuous integration workflow, enabling large-scale automated testing across multiple Android devices. If you would like to purchase professional edition, please submit a request using the form here.


    Streamline 7.3

    This release includes the following feature enhancements:

    • Support for collecting performance counters on Arm Ethos NPUs via  the ArmNN library.
    • Support for the Exynos M5 microarchitecture (recognised by name only, no specific counters).
    Note: Streamline 7.3 can open capture files that were taken with previous versions, from version 6.9 onwards. Captures taken with Arm Development Studio can not be opened with an Arm Mobile Studio starter edition license. If you need to open captures taken with Arm Development Studio, you will need an Arm Mobile Studio professional edition license.

    Performance Advisor 1.1

    • Performance Advisor now supports captures taken with devices with Mali-G57 and Mali-G77 GPUs, based on Arm’s latest Valhall architecture. For arithmetic-heavy shaders you can now see the execution cycles split down by the arithmetic pipeline they are using, with CVT, FMA, and SFU cycles shown separately in the shader cycles per frame chart:
      Performance Advisor shader cycles per frame chart
    • A new chart to visualize CPU cycles per frame is available. Monitor FPS alongside the number of CPU cycles per frame so that you can look for areas of correlation that might indicate a CPU load problem:
      Performance Advisor CPU cycles per frame chart
    • Generate a performance report from a section of a Streamline capture, by defining start and end times with a timestamp, or by defining annotated region names. Refer to section 6.3 in the Performance Advisor user guide.
    • Use the -mspf option with the pa command to display time per frame in milliseconds throughout the HTML report, instead of FPS. 
    • For Android 10 devices, you can connect to your application running on the device using an Open GL ES or Vulkan layer library, instead of packaging the LWI library in your application. Use the –lwi-gles-layer-lib or –lwi-vk-layer-lib options when running the connection script, to specify the path to the required layer library file. Refer to Get started with Performance Advisor for instructions.
    • You can now click and drag to zoom in on all line charts in the report, in the same way as you can with the FPS chart.
    • Performance Advisor reports have been refined to improve chart consistency, speed up analysis time, and to reduce the size of the generated report.

    • The JSON key targetInfo has changed to deviceInfo. If you were using the JSON output format in a previous release of Arm Mobile Studio, you will need to update the name in your existing JSON reports to maintain compatibility. For more information, refer to our FAQ topic.


    Graphics Analyzer 5.5

    There are no new features in this release.

    Mali Offline Compiler 7.1

    There are no new features in this release.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio starter edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    With an Arm Mobile Studio professional edition license, you get access to world-class Arm support. To raise a request for help, go to the Arm support portal.

    Known issues

    The issues listed here are new in this release. Refer to our FAQ page for answers to common problems and workarounds.

    Streamline

    • SDDAP-9658 - Device reboots while running gatord as root.

    Refer to the latest FAQs for all known issues and workarounds.


  • Arm Mobile Studio: 2020.0 February 28, 2020

    What's new in 2020.0

    Arm Mobile Studio is a suite of performance analysis tools that enables Android application developers to detect performance bottlenecks in their software and rendering through analysis of performance counters and graphics API traces.

    This release of Arm Mobile Studio includes:

    • Streamline 7.2, to profile application performance.
    • Performance Advisor 1.0, to generate at-a-glance application performance summary reports.
    • Graphics Analyzer 5.5, to debugging graphics API usage.
    • Mali Offline Compiler 7.1, to perform static analysis of GPU shader programs.

    This is the first release of Performance Advisor, an data analysis tool that can post-process a Streamline data capture from a Mali system to provide an at-a-glance HTML report that summarizes the application performance characteristics and provides advice about where to optimize.

    System Requirements

    Arm Mobile Studio is officially supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.13 (High Sierra) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    Arm Mobile Studio 2020.0 introduces the following the following changes and updates compared to Arm Mobile Studio 2019.2.

    Arm Mobile Studio 2020.0

    This release includes the following feature enhancements:

    • Windows installer adds Performance Advisor and Mali Offline Compiler to the PATH.
    • Windows installer associates the .mgd file extension with Graphics Analyzer.
    • All tools updated to use the latest OpenJDK Java 11 JVM.

    Streamline 7.2

    This release includes the following feature enhancements:

    • Support for Cortex-A34 and Cortex-A77 CPUs.
    • Support for Mali-G57 and Mali-G77 GPUs.
    • Support for selecting from multiple connected devices in gator_me.py.

    Performance Advisor 1.0

    This release is the first release of Performance Advisor.

    • Includes Performance Advisor for data analysis and report generation.
    • Includes a light-weight interceptor that can provide API-level metrics and screenshots, for low run-time overhead.

    Graphics Analyzer 5.5

    This release includes the following feature enhancements:

    • Support for API capture on Android 10 devices, including support for using an OpenGL ES layer driver.

    Note: For Android 10 the recommended interception method is to use layer drivers for both OpenGL ES and Vulkan. The legacy method of bundling the interceptor inside your application APK is unreliable.

    Mali Offline Compiler 7.1

    This release includes the following feature enhancements:

    • Updated to the latest Khronos glslangValidator SPIR-V cross-compiler build, for improved Vulkan language support and bug fixes.
    • Improved error forwarding from the Khronos glslangValidator for Vulkan source shaders that fail to compile in to SPIR-V, showing the error messages in the malioc output report. 

     

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:

    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio Starter Edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    Known Issues

    The following known issues are present in this release:

    Graphics Analyzer

    • MGD-4152: Linux build host tool GUI panels can fail to respond to mouse wheel events.
    • MGD-3735: Debug frame capture views (overdraw map, shader map) can fail for Unity applications. 
     

    Mali Offline Compiler

    • OSC-485: Invoking malioc on macOS 10.15 (Catalina) returns the following security warning, because the binary is not in the ".app" format:

      "malioc" cannot be opened because the developer cannot be verified.

      You can verify the integrity of the binary by using this command in a Terminal window:

      spctl -a -vv malioc
      > malioc: rejected (the code is valid, but does not seem to be an app)
      > origin=Developer ID Application: ARM Ltd (S345482SL3)
      Gatekeeper checks can be disabled by manually removing the com.apple.quarantine flag from the installed Mali Offline Compiler binary. Open a Terminal window, and run the following commands to disable gatekeeper:
      cd /Applications/Arm_Mobile_Studio_2020.0/mali_offline_compiler/ 
      sudo xattr -d com.apple.quarantine malioc

    Refer to the latest FAQs for further details.


  • Arm Mobile Studio: 2019.2 November 21, 2019

    What's new in 2019.2

    Arm Mobile Studio is a suite of performance analysis tools enabling Android application developers to detect performance bottlenecks in their software and rendering through analysis of performance counters and graphics API traces.

    This release of Arm Mobile Studio includes:

    • Streamline 7.1, for profiling application performance.
    • Graphics Analyzer 5.4, for debugging usage of graphics APIs.
    • Mali Offline Compiler 7.0, for static analysis of GPU shader programs.

    Note: The macOS package for Arm Mobile Studio was updated on November 21st, to provide an essential fix to Graphics Analyzer. If you were affected by this, download the latest version here.

    System Requirements

    Arm Mobile Studio is supported on 64-bit versions of the following host platforms:

    • Windows 10
    • macOS 10.11 (el Capitan) or newer
    • Linux Ubuntu 16.04 (Xenial Xerus) or newer

    Arm Mobile Studio is supported on 32-bit and 64-bit versions of the following target platforms:

    • Android 8.0 (Oreo) or newer

    Not all Android devices provide complete performance data. Check our supported devices page to see which platforms we recommend.

    Changes in this release

    Arm Mobile Studio 2019.2 introduces the following the following changes and updates compared to Arm Mobile Studio 2019.1.

    Arm Mobile Studio 2019.2

    This release includes the following feature enhancements:

    • Mali Offline Compiler added to the studio package, enabling static analysis profiling of OpenGL ES and Vulkan shader programs, as well as OpenCL kernels.

    Graphics Analyzer 5.4

    This release includes the following feature enhancements:

    • Device connection: Non-root single application profiling Android device setup provided via a new aga_me.py Python script, which is necessary to run the Graphics Analyzer Daemon inside the application security sandbox.

    The following features are deprecated and will be removed in Arm Mobile Studio 2020.0:

    • Android Daemon APK: The daemon APK is deprecated in this release; it is replaced by the command line daemon run via the aga_me.py script, in order to correctly function within the target application's Android security sandbox.
    • Trace replay: The Trace Replay feature is deprecated in this release; no replacement is planned. More capable open source alternatives such as PATrace (OpenGL ES) and VKTrace (Vulkan) are available.

    Mali Offline Compiler 7.0

    This release includes the following feature enhancements:

    • GPU Support: Mali-G52 and Mali-G76 support has been added.
    • GPU Support: Bifrost GPU static analysis reporting more accurately reflects GPU pipelines and performance. 

    The following features have been removed since the previous release:

    • Shader binary shader generation is no longer supported; use the on-device driver to generate program binaries.
    • Mali-400 series and Mali-T600 series GPUs are no longer supported.
    • Reported performance statistics now always use the latest driver for each GPU.

    Streamline 7.1

    This release includes the following feature enhancements:
    • Device connection: Non-root single application profiling Android device setup is now enabled using a new gator_me.py Python script, replacing the prototype gatorme.bat and gatorme.sh scripts.
    • Device connection: Mali GPU is now reliably auto-detected, so users no longer need to manually specify this on the gator command line when connecting to the device.
    • Timeline view: Built-in counter templates will now handle arbitrary numbers of CPU clusters, and will no longer emit duplicate charts for the first cluster.
    • Timeline view: Chart title column now auto-sizes to the required width for the enabled counters when a capture is opened.

    The following features are deprecated in this release and will be removed in Arm Mobile Studio 2020.0.

    • Device connection: Kernel-mode captures using gator.ko are deprecated in this release; users should switch to user-mode captures which use the underlying Linux Perf infrastructure.

    Get started

    For instructions on how to install and get started with Arm Mobile Studio, refer to the following topics on the Arm Developer website:


    Further learning resources including user guides, tutorials and videos are available on the Arm Developer website.

    Feedback and support

    For Arm Mobile Studio Starter Edition you can raise queries and support issues relating to both the tools and general performance analysis on the Arm Community website.

    Known Issues

    The following known issues are present in this release:

    Graphics Analyzer

    • The Graphics Analyzer device connection wizard does not work for non-root Android profiling. Use the supplied aga_me.py Python script to set up the on-device components. See Get started with Graphics Analyzer for further details.
    • The Graphics Analyzer system-wide Android profiling setup process does not correctly set up the Vulkan interceptor, and it will fail on some devices. Use single application interception instead.
    • The Graphics Analyzer capture does not show texture updates from partial surface replacement; e.g. using glTexSubImage2D().
    • The Graphics Analyzer capture does not support tracing applications using GL_EXT_disjoint_timer_query.
    • Shader compilation, used for static analysis reporting, can fail if the host locale uses "," as a decimal separator. It is possible to force an alternative locale by setting the environment variable LANG to the value "C".
    • Graphics Analyzer does not intercept API calls from applications containing native C++ code on devices running Android 10(Q). The interceptor starts normally, but shuts down after the application starts, there are no error messages. If you are able to modify the activity source code of your application, you can workaround this issue by moving the 'System.loadLibrary()' call from the start of the main activity to inside the Native C++ activity constructor. Call the load method after the 'super.onCreate()' call in the onCreate method: public class YourNativeActivity extends NativeActivity {
          @Override
          protected void onCreate(Bundle savedInstanceState) {
              // Call super-class onCreate first
              super.onCreate(savedInstanceState);
       
              // Load interceptor second
              try {
                  System.loadLibrary("AGA");
              } catch (UnsatisfiedLinkError e) {
                  e.printStackTrace();
              }
              ...
          }
      }

    Note: The macOS package for Arm Mobile Studio was updated on November 21st, to provide an essential fix to Graphics Analyzer. If you were affected by this, download the latest version here.

    Mali Offline Compiler

    • Mali Offline Compiler only supports OpenCL kernels using version 1.x features. Compiling kernels using OpenCL 2.0 features is not supported, even for GPUs that would support OpenCL 2.0 when using the production drivers.

    Streamline

    • The Streamline connection wizard does not work for non-root Android profiling. Use the supplied gator_me.py Python script to set up the on-device components. See Get started with Streamline for further details.

    Refer to the latest FAQs for further details.