mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-18 02:24:18 +00:00
273b898388
Move debugfs to Vendor-Specific EL3 Monitor Service Calls. Function Identifier for Vendor-Specific EL3 Monitor Service is '7' and allocated subranges of Function identifiers to different services are: 0x87000000-0x8700FFFF-SMC32: Vendor-Specific EL3 Monitor Service Calls 0xC7000000-0xC700FFFF-SMC64: Vendor-Specific EL3 Monitor Service Calls Amend Debugfs FID's to use this range and id. Add a deprecation notice to inform debugfs moved from arm-sip range to Vendor-Specific EL3 range. Debugfs support from arm-sip range will be removed and will not be available after TF-A 2.12 release. Reference to debugfs component level documentation: https://trustedfirmware-a.readthedocs.io/en/latest/components/debugfs-design.html#overview Change-Id: I97a50170178f361f70c95ed0049bc4e278de59d7 Signed-off-by: Govindraj Raja <govindraj.raja@arm.com>
46 lines
2.3 KiB
ReStructuredText
46 lines
2.3 KiB
ReStructuredText
Vendor Specific EL3 Monitor Service Calls
|
|
=========================================
|
|
|
|
This document enumerates and describes the Vendor Specific EL3 Monitor Service
|
|
Calls.
|
|
|
|
These are Service Calls defined by the vendor of the EL3 Monitor.
|
|
They are accessed via ``SMC`` ("SMC calls") instruction executed from Exception
|
|
Levels below EL3. SMC calls for Vendor Specific EL3 Monitor Services:
|
|
|
|
- Follow `SMC Calling Convention`_;
|
|
- Use SMC function IDs that fall in the vendor-specific EL3 range, which are
|
|
|
|
+---------------------------+--------------------------------------------------+
|
|
| SMC Function Identifier | Service Type |
|
|
+===========================+==================================================+
|
|
| 0x87000000 - 0x8700FFFF | SMC32: Vendor Specific EL3 Monitor Service Calls |
|
|
+---------------------------+--------------------------------------------------+
|
|
| 0xC7000000 - 0xC700FFFF | SMC64: Vendor Specific EL3 Monitor Service Calls |
|
|
+---------------------------+--------------------------------------------------+
|
|
|
|
Vendor-specific EL3 monitor services are as follows:
|
|
|
|
+-----------------------------------+-----------------------+---------------------------------------------+
|
|
| SMC Function Identifier | Service Type | FID's Usage |
|
|
+===================================+=======================+=============================================+
|
|
| 0x87000010 - 0x8700001F (SMC32) | DebugFS Interface | | 0 - 11 are in use |
|
|
+-----------------------------------+ | | 12 - 15 are reserved for future expansion |
|
|
| 0xC7000010 - 0xC700001F (SMC64) | | |
|
|
+-----------------------------------+-----------------------+---------------------------------------------+
|
|
|
|
Source definitions for vendor-specific EL3 Monitor Service Calls are located in
|
|
the ``ven_el3_svc.h`` header file.
|
|
|
|
|
|
DebugFS interface
|
|
-----------------
|
|
|
|
The optional DebugFS interface is accessed through Vendor specific EL3 service. Refer
|
|
to :ref:`DebugFS interface` documentation for further details and usage.
|
|
|
|
--------------
|
|
|
|
*Copyright (c) 2024, Arm Limited and Contributors. All rights reserved.*
|
|
|
|
.. _SMC Calling Convention: https://developer.arm.com/docs/den0028/latest
|