This commit updates the user guide to reflect the use of Ubuntu 22.04 LTS
and includes additional prerequisites such as `libssl-dev` and `telnet`.
It also improves the build instructions by clarifying the use of Clang,
setting `LLVM_SYSROOT_CC` to `arm-none-eabi-gcc`.

Signed-off-by: Leandro Belli <leandro.belli@arm.com>

Update the version in Cmake and readme files to
new release version v2.15.
With this patch the change log is updated to contain
description for new features, improvements and fixes contained
in this release.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

When setting the MPMM threshold for a specific core, the MPMMCR value
was increased using OR operators. However, this approach is only valid
if the MPMMCR value is initially 0. Therefore, add a bit-clear
instruction before setting the MPMM threshold.

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

This patch renames FWK_TRACE to FWK_LOG_LOCAL in
the noc_s3 module which was missed in the previous
renaming.

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

Nancy . authored Jun 17, 2024 and Nishant Sharma committed Sep 06, 2024

Reference Design platform RD-Fremont has been renamed to RD-V3.

Signed-off-by: Nancy <nancy@arm.com>
Signed-off-by: Nishant Sharma <nishant.sharma@arm.com>
Change-Id: If83009ba0a9fdcddc0689a85588431d52922bd3f

Cristian Marussi authored Sep 13, 2022 and Md Golam Tanvir Zim committed Sep 05, 2024

Some clocks, like the ones related to CPUs, must not be actionable from
the OSPM agent; while CLOCK_RATE_SET is already inhibited for such clocks,
the same check is missing for CLOCK_CONFIG_SET.

Update the resource permission mask accordingly.

Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>

The description of hnf_pos_end is inaccurate, it still reflects
the description of hnf_pos_start.

Signed-off-by: Zikui Zhao <zhaozikui@eswincomputing.com>

When errors are reported with a status code, this patch updates it
to display the human-readable string representation of the error.

Signed-off-by: Leandro Belli <leandro.belli@arm.com>
Change-Id: I245d9752b29aafba54ac1dc9855501124f512f84

The fwk_module_bind function is currently asserting before printing
the error message. This patch corrects the order so that the error
message is printed first.

Signed-off-by: Leandro Belli <leandro.belli@arm.com>
Change-Id: Id72170768aa5a79bbfc35f26d23a3939feb4931c

Mohamed Omar Asaker authored Aug 14, 2024 and Leandro Belli committed Sep 03, 2024

Adding custom instructions for TC2 to make it work with the latest
SCP.

As TC release uses an old version of SCP before the directory
restructure. Hence, some modification has to be applied to TC
scp build script.

Along with instructions to rebuild only SCP-firmware and all it's
dependencies.

Signed-off-by: Mohamed Omar Asaker <mohamed.omarasaker@arm.com>

This patch adds an error message to `static_assert` statements that
checks structure definitions mapped to real registers.
The LLVM compiler requires these error messages to be present.

Signed-off-by: Leandro Belli <leandro.belli@arm.com>
Change-Id: Iad80357bbc5a788e83cc07389be932f0c92d0bbc

Add test cases for SCMI notification handler and notification subscribe APIs.

Signed-off-by: mohmah01 <mohammed.mahmoud@arm.com>

Add notification subscriber function to requester module to allow agents subscribe to notifications
Add notification handler function to handle the notification of system power change in agent: the function will send a framework notification which can be used by platform system module.

Add bind to notification handler API in the requester modules.

Signed-off-by: mohmah01 <mohammed.mahmoud@arm.com>

The recent change to use `DIRECT_BUILD` introduced an issue where
the `BUILD_PATH` is not being updated as intended. This fix ensures
`PRODUCT_BUILD_DIR` is correctly set and used throughout the
Makefile wrapper.

Signed-off-by: Leandro Belli <leandro.belli@arm.com>
Change-Id: I4551fda576b9dedad33dd4be540dce687aa5bba1

Move the ATU region alignment check to a separate function and
log the region alignment errors in ATU manage mode.

Signed-off-by: Shaileshwar M <shaileshwar.mahadevabatla@arm.com>
Change-Id: Ie606b4f9c82656d11470af0fa052ca88f2d38a26

After initializing each element, the framework should update the element
state to INITIALIZED. However, the module state is updated instead.
The module state should only be updated after all elements are initialized.
This patch rectifies the error.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

Currently, the log files are not being fetched as artifacts due
to a change in the build directories. This is corrected by changing
the extension to .log and recursively finding the artifact files
within the build directory.

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

Currently, in the CI when products are built, the output directory is
replicated by the makefile wrapper. This patch makes build use the new
DIRECT_BUILD flag in the makefile wrapper to ensure the build path is
used directly and not modified.

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

Currently, if you are building with the makefile wrapper, the build
directory that is specified gets modified. There are cases when this
is unwanted, this patch adds a DIRECT_BUILD variable so we can build
directly to a specific directory without having extra fields appended
to our build directory.

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

Tarek El-Sherbiny authored Aug 09, 2024 and Leandro Belli committed Aug 19, 2024

The files were updated after the git revert.
This change corrects the copyright year.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

Tarek El-Sherbiny authored Aug 09, 2024 and Leandro Belli committed Aug 19, 2024

The method of application the mode is largely determined by the type of
monitor being used. Each monitor implementation may require different handling.
From a design perspective, it is preferable to delegate this handling to the
specific monitor driver and keep the smcf code generic.

This reverts commit 9860d64b

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

Signed-off-by: Leandro Belli <leandro.belli@arm.com>
Change-Id: Ie8c1d80b9f32a5004c76a86351a018b4cfb7b2e6

On gcc 13.2.0 the following error is flagged:
storing the address of local variable ‘data_api’ in
‘sensor_smcf_drv_ctx.data_api’ [-Werror=dangling-pointer=].

Storing a local pointer in a global variable should be avoided.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

On gcc 13.2.0 the following error is flagged:
error: comparison of integer expressions of different signedness:
‘int’ and ‘enum pd_idx’ [-Werror=sign-compare]

Positive enum should be compared against unsigned variables.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

On gcc 13.2.0 the following error is flagged:
storing the address of local variable ‘data_api’ in
‘amu_smcf_drv_ctx.data_api’ [-Werror=dangling-pointer=].

Storing a local pointer in a global variable should be avoided.

Signed-off-by: Tarek El-Sherbiny <tarek.el-sherbiny@arm.com>

Programmable System Address Map feature in NoC S3 allows configurable
address map for address‑based routing from each upstream interface to
the corresponding downstream interfaces.

Add the support to configure PSAM during runtime in following mode
1) Static mapping with the information passed through module config.
   It is expected that the statically mapped regions will not change
   during the runtime. Their context is handled by the module.
2) Mapping/Unmapping requested through the APIs exposed by the module.
   These APIs are expected to be used by the modules that will change
   the mapping during the runtime and modules will do additional steps
   such as mapping peripheral base in the address translation unit
   before calling the API. For this reason, the module will maintain the
   context for the blocks that it is managing.

Signed-off-by: Nishant Sharma <nishant.sharma@arm.com>
Change-Id: Ia2c08a76e5d48ecdb6b38d19180e015aca22dc41

The configuration register layout for NoC S3 is laid out in a
multibranch tree format. On the top of the tree is global configuration
node which points to the domain and domains points to components nodes.
The components nodes contains subfeatures that can be used to enable
PSAM, APU, FCU and IDM.

Add the support to validate the part number of NoC S3 and find the
offset address of the configuration registers of all the nodes on the
tree and put that into a table.

For example: The discovery process will convert the following tree
                       Global CFGNI
                       /         \
                      /           \
                    VD0           VD1
                   /              /
                 PD0             PD1
                /               /
              CD0              CD1
             /  \             /
            C0  C1           C2

to the following table containing node offset.
_______________________________________________
Node Type      | Index  |      Node Id         |
---------------|--------|----------------------|
               |        |   0   |   1   |  2   |
---------------|--------|-------|-------|------|
Global CFGNI   |   0    |CFGNI0 |       |      |
Voltage Domain |   1    |VD0    |VD1    |      |
Power Domain   |   2    |PD0    |PD1    |      |
CLock Domain   |   3    |CD0    |CD1    |      |
ASNI           |   4    |C0     |C1     |C2    |
AMNI           |   5    |       |       |      |
PMU            |   6    |       |       |      |
HSNI           |   7    |       |       |      |
HMNI           |   8    |       |       |      |
PMNI           |   9    |       |       |      |

As the node id and type are predefined, the offset of the target node is
fetched in O(1) by using id and type. To get offset of the C2, the user
will access the table using node type 4 and Id 2. Table[4][2] will give
offset of C2

Signed-off-by: Nishant Sharma <nishant.sharma@arm.com>
Change-Id: I221694d12a853e46df0f6c434058eaf6dfb4aa2b

NoC S3 Network-on-Chip Interconnect is a highly configurable
system-level interconnect. This design allows the creation of a highly
optimized, non-coherent interconnect which supports Programmable System
Address Map, Programmable Access Protection Unit, Programmable Fault
Protection Unit and many more.

Add initial framework handlers as preparation to add support for the
NoC S3 features. The handlers added in this change will be consumed by
the subsequent changes.

Signed-off-by: Nishant Sharma <nishant.sharma@arm.com>
Change-Id: I81d9d7175a4c1f43dd84e5118772bc8b9d6826d5

Wei-Chia Su authored Aug 09, 2024 and Leandro Belli committed Aug 12, 2024

In Cortex-M3/M4/M23/M33, a core register block was named the System Control and
ID Register, separate from the System Control Block (SCnSCB). In Cortex-M55/M85,
the same block was renamed to Implementation Control Registers (ICB), creating a
naming discrepancy within the same Cortex v8m family. Therefore, using #ifdef
ARMV7M alone is inadequate. To ensure compatibility, the register's definition
is utilized over the family.

This adjustment should facilitate the build for Cortex-M23 and M33 cores.

Signed-off-by: Wei-Chia Su <Wei-Chia.Su@arm.com>

Wei-Chia Su authored Aug 07, 2024 and Leandro Belli committed Aug 09, 2024

This commit removes the dependencies of clang-tidy including configuration file
located in the parent directory.

Signed-off-by: Wei-Chia Su <Wei-Chia.Su@arm.com>

Wei-Chia Su authored Aug 07, 2024 and Leandro Belli committed Aug 09, 2024

This commit removes the dependencies of IWYU including pragmas in source file.

Signed-off-by: Wei-Chia Su <Wei-Chia.Su@arm.com>

Wei-Chia Su authored Aug 07, 2024 and Leandro Belli committed Aug 09, 2024

This commit removes cmake targets for yamllint by dropping unused cmake and
configuration file. Also, It removes redundant python package and script.

Signed-off-by: Wei-Chia Su <Wei-Chia.Su@arm.com>

Wei-Chia Su authored Aug 06, 2024 and Leandro Belli committed Aug 09, 2024

This commit removes targets for c. All the dependencies of clang-format are
dropped including submodule `run-clang-format`.

Signed-off-by: Wei-Chia Su <Wei-Chia.Su@arm.com>

Haaris Farooq authored Aug 06, 2024 and Leandro Belli committed Aug 09, 2024

Currently, within the deployment and daily pipeline, products are
build sequentially instead of in parallel which is slow. This patch
adds building all products in parallel within the pipelines. In the
deployment pipeline, all products are built with default log level
and in the daily pipeline all products are built with all log levels
(all in parallel).

Signed-off-by: Haaris Farooq <haaris.farooq@arm.com>

Add a function which roughly estimate the overhead of tracing by calling
a FWK_TRACE_START followed by FWK_TRACE_FINISH and calculating how long
the empty trace took.

Signed-off-by: Mohamed Omar Asaker <mohamed.omarasaker@arm.com>

Enable fwk trace by providing the required driver functions.

get_trace_count is implemented by returning the current time provided
by the fwk.

report_trace_entry implemented to use the fwk log to dump the trace
entry.

Signed-off-by: Mohamed Omar Asaker <mohamed.omarasaker@arm.com>

Add the fwk_trace to the scpfw-path to be visible
for optee product.

Signed-off-by: Mohamed Omar Asaker <mohamed.omarasaker@arm.com>

Add a unit test for the fwk_trace component.

Signed-off-by: Mohamed Omar Asaker <mohamed.omarasaker@arm.com>