Home Explore Help
Sign In
OWEALs
/
arm-trusted-firmware
mirror of https://github.com/ARM-software/arm-trusted-firmware
2
0
Fork 0
Files Issues 1 Wiki
Branch: master
Branches Tags
arm-trusted-fir...
/
docs
/
components
/
ven-el3-service.rst

ven-el3-service.rst 4.6 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 
  1. Vendor Specific EL3 Monitor Service Calls
    2. 

  2. =========================================
    3. 

  3. 

  4. This document enumerates and describes the Vendor Specific EL3 Monitor Service
    5. 

  5. Calls.
    6. 

  6. 

  7. These are Service Calls defined by the vendor of the EL3 Monitor.
    8. 

  8. They are accessed via ``SMC`` ("SMC calls") instruction executed from Exception
    9. 

  9. Levels below EL3. SMC calls for Vendor Specific EL3 Monitor Services:
    10. 

  10. 

  11. -  Follow `SMC Calling Convention`_;
    12. 

  12. -  Use SMC function IDs that fall in the vendor-specific EL3 range, which are
    13. 

  13. 

  14. +---------------------------+--------------------------------------------------+
    15. 

  15. | SMC Function Identifier   | Service Type                                     |
    16. 

  16. +===========================+==================================================+
    17. 

  17. | 0x87000000 - 0x8700FFFF   | SMC32: Vendor Specific EL3 Monitor Service Calls |
    18. 

  18. +---------------------------+--------------------------------------------------+
    19. 

  19. | 0xC7000000 - 0xC700FFFF   | SMC64: Vendor Specific EL3 Monitor Service Calls |
    20. 

  20. +---------------------------+--------------------------------------------------+
    21. 

  21. 

  22. Vendor-specific EL3 monitor services are as follows:
    23. 

  23. 

  24. +-----------------------------------+-----------------------+---------------------------------------------+
    25. 

  25. | SMC Function Identifier           | Service Type          | FID's Usage                                 |
    26. 

  26. +===================================+=======================+=============================================+
    27. 

  27. | 0x87000010 - 0x8700001F (SMC32)   | DebugFS Interface     | | 0 - 11 are in use.                        |
    28. 

  28. +-----------------------------------+                       | | 12 - 15 are reserved for future expansion.|
    29. 

  29. | 0xC7000010 - 0xC700001F (SMC64)   |                       |                                             |
    30. 

  30. +-----------------------------------+-----------------------+---------------------------------------------+
    31. 

  31. | 0x87000020 - 0x8700002F (SMC32)   | Performance           | | 0,1 is in use.                            |
    32. 

  32. +-----------------------------------+ Measurement Framework | | 2 - 15 are reserved for future expansion. |
    33. 

  33. | 0xC7000020 - 0xC700002F (SMC64)   | (PMF)                 |                                             |
    34. 

  34. +-----------------------------------+-----------------------+---------------------------------------------+
    35. 

  35. | 0x87000030 - 0x8700FFFF (SMC32)   | Reserved              | | reserved for future expansion             |
    36. 

  36. +-----------------------------------+                       |                                             |
    37. 

  37. | 0xC7000030 - 0xC700FFFF (SMC64)   |                       |                                             |
    38. 

  38. +-----------------------------------+-----------------------+---------------------------------------------+
    39. 

  39. 

  40. Source definitions for vendor-specific EL3 Monitor Service Calls used by TF-A are located in
    41. 

  41. the ``ven_el3_svc.h`` header file.
    42. 

  42. 

  43. +----------------------------+----------------------------+--------------------------------+
    44. 

  44. | VEN_EL3_SVC_VERSION_MAJOR  | VEN_EL3_SVC_VERSION_MINOR  | Changes                        |
    45. 

  45. +============================+============================+================================+
    46. 

  46. |                          1 |                          0 | Added Debugfs and PMF services.|
    47. 

  47. +----------------------------+----------------------------+--------------------------------+
    48. 

  48. 

  49. *Table 1: Showing different versions of Vendor-specific service and changes done with each version*
    50. 

  50. 

  51. Each sub service will have its own version, one FID allocated for sub service version.
    52. 

  52. 

  53. Some ground rules when one should update top level version.
    54. 

  54.  - VEN_EL3_SVC_VERSION_MAJOR is incremented when any of the sub service version discovery
    55. 

  55.    FID changes or the FID that was allocated for discovery changes. So any breaking subfeature
    56. 

  56.    discovery changes will lead to major version update.
    57. 

  57.  - VEN_EL3_SVC_VERSION_MINOR is incremented when we add a new FID or a new sub service.
    58. 

  58.    For example adding an new monitor service at 0x30, Debugfs starts at 0x10 and PMF
    59. 

  59.    starts at 0x20 next one will start at 0x30, this will need a update to minor version.
    60. 

  60. 

  61. Performance Measurement Framework (PMF)
    62. 

  62. ---------------------------------------
    63. 

  63. 

  64. The :ref:`Performance Measurement Framework <firmware_design_pmf>`
    65. 

  65. allows callers to retrieve timestamps captured at various paths in TF-A
    66. 

  66. execution.
    67. 

  67. 

  68. DebugFS interface
    69. 

  69. -----------------
    70. 

  70. 

  71. The optional DebugFS interface is accessed through Vendor specific EL3 service. Refer
    72. 

  72. to :ref:`DebugFS interface` documentation for further details and usage.
    73. 

  73. 

  74. --------------
    75. 

  75. 

  76. *Copyright (c) 2024, Arm Limited and Contributors. All rights reserved.*
    77. 

  77. 

  78. .. _SMC Calling Convention: https://developer.arm.com/docs/den0028/latest
    79.