Copyright (c) 2019-2023, Arm Limited and Contributors. All rights reserved.
-
Documentation:
- security.md file: Add the details of the SCP FW security process
-
Framework:
- FWK_TRACE: Allows printing of per-module enabled logs
-
Modules:
- SCMI System Power requestor: It is a module that takes an SCMI SYSTEM POWER command and forwards it to its element, in such a way that it is received by them as if it were purely a System Power command.
-
Platforms:
- OPTEE FVP platform product
- stm32mp1 OP-TEE platform product
-
Documentation:
- maintainers: Update maintainers list
-
Build system:
- Remove all Makefile deprecated files
- cmake: Add a command for merging SCP libraries
- cmake: add option to replace modules
- Remove Makefile references in documentation
-
Framework:
- Rename
FWK_LOG_LEVEL_TRACEtoFWK_LOG_LEVEL_DEBUG
- Rename
-
Modules:
- power_domain: Add warm reset notifications
- Use transport module instead of smt and remove smt
- platform_system: Add warm reset support
- scmi_perf: Add logs when multiple fast channels events are queued
- scmi_perf: Add initial UT for plugins-handler extension
- thermal_mgmt: Add UT and activity factor
-
Platforms:
- Rename RD-Edmunds to RD-V2
- All platforms: Move from module smt to transport
- morello: Configure the default OPP to the highest
- rdfremont/lcp: Append bl2 to firmware target
- product/rdn2: Add support for variant 3 of rdn2 platform3
- platform/rdn2: Enable soc expansion block on RD-N2-Cfg2
- tc2: Add support for TC2_VAR_EXPERIMENT_POWER
- product/tc2: Add the core HUNTER_ELP
-
Build system:
- cmake: fix IPO dependant option
- ci_cmake: Add missing version 3 for RD-N2 build
-
Framework:
- fwk_core/fwk_arch: Fix buffered log output behaviour
-
Modules:
- cmn600: add missing revision r3p2
- cmn600: fix print of RN-F and RN-D counts
- power_domain: Fix return status for notify_warm_reset
- system_power: respond with correct status for shutdown/reboot
- module_common: fix FWK_SRC scoping
- scmi_clock: Fix policy reference counter mismatch
-
Platforms:
- synquacer: allocate secure DRAM for BL31
- Platforms:
- tc0: Deprecate platform
- RDN2 fails to boot. Refer to the following github issue for more details and the available temporary workaround: ARM-software#781
-
Architecture:
- ARMv8-M support and V8 MPU support
-
New modules:
- SCMI requester core module support
- SCMI Sensor requester module
- Transport module
- MHUv3 support
-
Platforms:
- TC2 platform support
- rdfremont: Add new plaform (initial support)
-
Tools:
- Update CMSIS to newer version 5.8.0
- Unit Test framework and Mocking
-
Build system:
- ci: Print build output/information
- cmake: update LLVM to ver 13
-
Framework:
- fwk: Add support of OS interrupt operation
- fwk: Add stop sequence
-
Platforms:
- n1sdp: Introduce trusted board boot
- n1sdp: Replace sensor library with a dummy source file
- product/rdn2: add support for rdn2 platform variant 2
- product/rdn2: Update configuration data for SCMI perf
- product/rdv1mc: Update configuration data for SCMI perf
- product/rdv1: Update configuration data for SCMI perf
- rdn2: Add variant 1 and 2
- product/rdn2: enable sp805 watchdog module
- product/tc2: Add support for TC2/RSS boot flow
-
Modules:
- scmi: separate scmi base protocol
- fip: extend fip module to accept custom uuid through module config
- scmi-perf: move fast channel alarm to event context
- thermal-mgmt: Move power allocation to a separate file
- sensor: typedef included to give signed or unsigned value options
- power-mgmt: add per-domain control loop
- thermal-mgmt: add temperature protection functionality
- SCMI: Rename BUILD_HAS_FAST_CHANNELS with SCMI_PERF
- scmi: add unit tests
- scmi_clock: add unit test
- module/mhu2: add support for transport module and in-band messages
- scmi_perf: Add initial unit tests
-
Build system:
- ci_cmake: Add flag to skip container execution
- cmake: Fix ArmClang generated images
- ci: fix pycodestyle violations in ci_cmake.py
- CMake: Add elf extension to firmware target
-
Modules:
- modules: Compile without notifications
- scmi_clock: fix set_rate flag mask defect
- cmn700: fix SYS_CACHE_GRP_SN_NODEID calculation
- cmn700: ccg: various fixes
-
Platforms:
- morello: fix timestamp in debug logs
- product/morello: align DVFS frequency values of FVP with SoC
- juno: Fix the number of rates returns for triplet rate array format
-
CLI:
- cli: stop alarm when cli is open
The codebase attempts to follow MISRA-2012 rules to the extent detailed in doc/code_rules.md.
The maintainers are gradually introducing tools in the attempt to improve the overall robustness of the codebase. Since v.2.10, Unit Testing has been introduced on a module-level. The final aim is to run unit tests for any new modules and any new additions to modules. To allow contributors to some time to familiarise with the tool and to avoid imposing additional efforts out-of-the-blue, in this release we ask contributors to provide basic unit tests for new modules and new additions. This can be done by adding unit tests on the same patches adding new features or in separate patches, but need to be within the same PR. For work that is already in the RFC in PR, we may make an exception to the request. We foresee that once the unit test framework support is consolidated, it will be possible to contribute to the project only if unit test is also included in the contributions.
-
Build system:
- Stable CMake support has been added
- Make build system is being deprecated in this release, and in a future release will be removed completely. No further patches related to the old make build system will be accepted.
- LLVM support for armv7-m platforms
-
New modules:
- Max Power Mitigation Mechanism (MPMM) (initial support)
- Traffic Cop performance plugin (initial support)
- Added Thermal management (initial support)
-
Platforms:
- Morello platform support
-
Framework:
- Removed multi-threading feature, all platforms are now single threaded There is no longer any thread concept, please see relevant commits for details.
- framework: Add fwk_string interface
Arm is committed to making the language we use inclusive, meaningful, and respectful. Offensive terminology has been replaced with more inclusive terms throughout the codebase.
The codebase now follows MISRA-2012 rules to the extent detailed in doc/code_rules.md.
-
Build system:
- Add target "doc" to cmake build system
-
Framework:
- fwk: Remove deprecated function put_event_and_wait
- fwk: Reduce SCP power consumption by suspending execution
-
Platforms:
- tc0: Add cmake support for plugins handler
- tc0: Add Power Model
- tc0: Add support for Build Variants
- tc0: Add PLATFORM_VARIANT feature flag
- sgi575/rdn1e1/rdv1/rdv1mc: add cmn650 mapping for 64-bit pcie mmio address space
- rdn1e1/rdv1/rdv1mc/rdn2/sgi575: fix gtimer module config in mcp ramfw
- synquacer: implement system power-off
- rdn2: add mapping for cmn700 address space
-
Modules:
- scmi_perf: clean up scmi_perf_notify_limits_updated()
- scmi_pd: Add power domain set state sync request handling
- scmi_sensor/sensor: Multi axis support ` - scmi_sensor/sensor: add timestamp support
- scmi_sensor/sensor: Extended Attributes Support
- perf_plugins_handler: Allow multiple plugins
- perf_plugins_handler: Add support for full data snapshot
- gtimer: add new flag for CNTCONTROL register initialization
-
Build system:
- Fix SCP_ENABLE_DEBUGGER feature flag
-
Modules:
- scmi: shrink log strings to fix error messages
- plugins_handler: fix cmake build
-
Platforms:
- tc0: Fix Voltage Domain configuration
- synquacer: enable DDR DQS gate training workaround
- synquacer: fix spi nor flash software reset handling
-
Framework:
- Add light events
- fwk_log: Add option for minimal banner
-
New modules:
- Mock Voltage Domain driver
- PMI and DWT PMI driver
- PCIE integration control register
- CMN Skeena
- Cadence I2C
-
SCMI:
- scmi_perf: Add performance plugins handler extension
-
Build system:
- CMake: Add support for parallel build
- CMake: Add support for framework tests
-
Documentation:
- clock: Add documentation for Clock Management Framework
-
Arch:
- arm: Add interrupt disable/enable inline calls
-
Framework:
- Remove Signals
- Remove module name parameter
-
Modules:
- clock: Add Clock Management Framework
- mod_resource_perms: Fix recursion on mod_res_message_id_to_index
- cmn700: Add support to configure additional non-hash mem regions
- cmn700: Update root node offset calculation for bigger mesh
- cmn700: Add hierarchical hashing support with 3 SN mode
- psu: Add error return from mod_psu_process_bind_request
- sds: Clear data valid flag after SCP RAM FW has been transferred
-
Platforms:
- juno/scmi_perf: Simplify configuration of FastChannels
- juno/software_mmap: Remove unused SCMI_FAST_CHANNEL_SIZE
- juno: Provide PMI and DWT PMI config
- n1sdp: Enable non-secure CoreSight access in C2C setup
- n1sdp: Add dynamic calculations of PLL parameters
- morello: Restructure dmc_bing module
- rdv1mc, sgi575: Add config for MCP
- Add support for tc1
- tc0: Add SCMI FastChannels configuration
- tc0: Use separate PLLs for seperate core types
- tc0: Add example configuration for Voltage Domain
- tc0: Enable DVFS for Matterhorn ELP Arm cores
- tc0: Update SCP PIK
- rdv1mc: Add support for DVFS and SCMI Perf
- rdv1mc: Enable fast channel
- rdv1mc: Add mock PSU for dvfs
- rdn2: Update register layout for pik's in rdn2 platform
- rdn2: Disable NEWLIB_NANO for RD-N2 platform
- rdn2: Add support for variant 1 of rdn2 platform
- rdn2: Add ecam and mmio memory regions in cmn700 config
- rdn2: Update NCI GPV region 0 in cmn700 config
- rdn2: Add all NCI GPV regions in cmn700 config
- rdn2: Add config data for pcie integ control module
- rdn2: Add support for mcp ramfw
- rdv1: Add config data for mcp romfw bootloader module
- rdv1: Add config data for clock module in MCP RAM firmware
- rdv1: Add config data for pl011 UART module in mcp ramfw
- rdv1: Add configuration data for MPU module in mcp ramfw
- rdv1: Add generic timer config data for mcp ramfw
- rdv1: Add timer HAL config data for mcp ramfw
- rdv1: Add platform specific definitions for rtx
- rdv1: Add mcp_platform module for rdv1
- rdv1: Add build support for mcp ram firmware
- rdv1: Add debugger CLI module config data for mcp ramfw
- synquacer: Add shutdown handler in ppu_v0_synquacer module
-
MISRA C:2012:
- SCMI, Framework: Fix rule 9.5 violations
- mod_resource_perms: Fix rule 16.5 violations
- fwk: Fix rules 11.9, 16.3 and 17.7 violations
- arch: Fix rule 15.6 violations
- arch/armv7-m: Fix rules 10.1 and 17.7 violations
-
Support for the following platforms has been added:
- Morello platform
- RD-N2 platform (initial support)
-
New modules:
- apremap (AP remap)
- CMN-700 interconnect
- mock_clock
-
Framework:
- fwk: Add fwk_thread_signal API
- fwk: Add MT fwk_thread_put_signal API
- framework: add optional identifier support
-
Renamings:
- RD-Daniel is now RD-V1
- RD-Daniel Config-XLR is now RD-V1-MC
- module: rename cmn_rhodes to cmn-650
-
MISRA C:2012
- Mandatory fixes have been resolved
-
SCMI:
- Sensor protocol: Add support for SENSOR_TRIP_POINT_CONFIG
- Sensor protocol: Add support for SENSOR_TRIP_POINT_NOTIFY
-
Build system:
- Support for CMake has been added.
-
Doc:
- Add cmake_readme.md
-
Documentation:
- doc: SCP Firmware Threat Model
- user_guide: Add LLVM instructions
- user_guide: Update prerequisite of TF-A version
- maintainers: Update maintainers and codeowners
-
Framework:
- fwk_multi_thread: Minor optimisation in MT fwk_thread_put_event
- fwk sub-element index to identifier getter
- fwk: Add a check for valid fwk_id type to the framework
- fwk_thread: Log allocated event instead of submitted event
- fwk_multi_thread: Log allocated event instead of submitted event
-
Modules:
- bootloader: ensure module config is provided
- cmn-650: Add support for port aggregation
- dvfs: Add signal_handler to DVFS
- isys_rom: idle on failure to boot from ram firmware
- fip: move fip config parameters to caller module
- ppu_v1: Assigning opmode from product configurations
- isys_rom: use fwk_trap() for idling
- scmi: Deny access for PSCI agent for configured protocols
- scmi_system_power/boards: Add default timer_id and add extra check
- scmi: Assorted fixes for SCMI 2.0 compliance
-
Platforms:
- juno: Disable Resource Permissions for juno
- juno: Disable Debug Module by default
- juno/sensor: Rename sensors
- n1sdp: Separated Driver code from mod_n1sdp_sensor.c
- n1sdp:Enable L3 cache from BOOTGPR1 reg
- rcar: Various additions for timers, power domain, dvfs, system power
- sgm775: Enable access to CLOCK_CONFIG_SET command
- RD-X platforms: migrate to isys_rom
- sgi575/rdn1e1: Add disabled PSCI protocols without resource permissions
- sgm775/sgm776/tc0: Add disabled PSCI protocols without resource permissions
- tc0: Add support for Theodul cluster
- tc0: add clock and dvfs support for all cores
- product/rdv1mc: add port aggregation related config data
CMake: please note that cmake is consolidation phase and the current make build system is still supported. We strongly encourage contributors to move to cmake.
-
Support for the following platforms has been added:
- Total Compute (tc0) platform
- Renesas R-Car
- RD-Daniel Config-XLR
-
Support for interactive debugger and CLI has been added.
-
New modules:
- Voltage Domain driver and related SCMIv3 protocol driver
- gtimer: Add framework time driver implementation
- module: statistics: add basic functionality
- fip: Introduce 'fip' parser module
-
SCMI Enhancements:
- SCMI: Resource Permissions Module
- SCMIv2: Implement SCMIv2 fast channels performance protocol API
- SCMIv2: Implement notifications for SCMIv2
- scmi_perf: Add support for performance statistics
- SCMI: Clock Protocol policy handler
- SCMI: Performance Protocol policy handler
- SCMI: Power Domain Protocol policy handler
- SCMI: System Power Protocol policy handler
- SCMI: Reset Domain Protocol policy handler
- SCMI: Base Protocol Permissions
- SCMI: Clock Protocol Permissions
- SCMI: System Power Protocol Permissions
- SCMI: Power Domain Protocol Permissions
- SCMI: Performance Protocol Permissions
- SCMI: Sensor Protocol Permissions
- SCMI: Reset Domain Protocol Permissions
- SCMI: Device permissions
-
Framework:
- fwk: Use standard library memory allocator
- fwk: Integrate logging functionality into the framework
- fwk/thread: Single-threaded mode for blocking events
- fwk: Introduce input/output component
-
Documentation:
- doc: SCP Firmware Threat Model
- doc: Add clang-format configuration
- doc: Recreate Doxyfile with Doxywizard
-
Framework:
- fwk: Remove dependency on RTX threads
- fwk: Add support for static element tables
- fwk: Rework assertion logic
- fwk: Initialize module context structures early
-
Modules:
- bootloader: Add support for SDS-less boot
- DVFS: Allow inexact performance levels
- DVFS/SCMI-perf: Abstract performance levels
- scmi_system_power: Add graceful system power support
- bootloader: Unify bootloader messages
- module/scmi: Add SCMI notifications handling APIs
This release implements full SCMI v2 support but we do not guarantee complete compliance with the SCMI v2.0 specification at the moment.
-
Support for the following platforms has been added :-
- Juno Arm Development Platform
- Neoverse N1 Software Development Platform
- SGM-776
- RD-N1-Edge
- RD-N1-Edge Dual-Chip
- RD-Daniel Config-M
-
New modules:
- DMC500
- XRP7724
- CDCEL937
- I2C
- dw_apb_i2c (Synopsis DesignWare I2C controller)
- mock_sensor
- Debug Module
- System Info
-
Build System: static analysis: Add suppression list for Cppcheck Static Code Analysis tools: Add script to check usage of banned functions build: enhance entry guards in internal header files
-
Documentation: DVFS: Document DVFS architecture doc: Fix link location for Cppcheck suppression list doc: Correct Cppcheck invocation description doc: Add notification information to the documentation doc: Clarify contributors' and Maintainers' responsibilities doc: Update list of maintainers for SCP-firmware doc: Add documentation for deferred responses doc: Add glossary to Doxygen configuration input
-
Framework: fwk/notification: Allow use of provided source_id for notify thread: Get head of delayed response list module: Add FWK_ID_NONE source_id for notifications fwk: Delete fwk_module_check_call implementation fwk: Extend delayed response support fwk: Split delayed response from fwk_multi_thread fwk_interrupt: add missing declaration of exported functions fwk_thread: Clarify support for delayed responses fwk: Rename fwk_errno.h to fwk_status.h fwk_errno: Add FWK_PENDING return value fwk_module: Extend fwk_module_get_data for sub-elements framework: allow product to define notification count
-
Modules: DVFS: Add support for pending requests clock: Add full support for asynchronous drivers scmi_clock: Add support for pending requests scmi_sensor: Add support for pending responses sensor: Add support for asynchronous drivers arch/armv7-m: Split exception table from handlers arm7-m: Add support for custom default exception handler
-
Modules:
- CMN600 support
- DMC620 support
- apcontext: New module to zero the AP context area
-
Platforms:
- Support for the SGI-575 platform
- Support for the Neoverse N1 reference design
Note: Juno, Neoverse N1 SDP, Neoverse E1 reference design and SynQuacer products are NOT part of this release.
-
Build System:
- Name firmware bin and elf file by the name of the firmware
-
Documentation:
- Emphasized that the order of the modules in the BS_FIRMWARE_MODULES list in the firmware definition makefiles is the order in which the modules are initialized, bound and started during the pre-runtime phase.
- Expand Doxygen use of param [out]
- Improve coding style and rules
-
Framework:
- Improve error codes and their documentation
- Add fwk_module_get_sub_element_count API
- Improve unit testing of fwk_module.c
- Replace base alignment reference type with
max_align_t
-
Modules:
- sds: Make initialization deferring optional
- sds: Send notification once SDS is initialized
- scmi: Subscribe to SMT ready notifications and send notification when service is initialized
- smt: Add logging on mailbox ownership error
- smt: Send notification when each SMT mailbox is initialized
- sid: Move to an always available interface
- system_power: Introduce platform interrupts and enable a configurable number of system PPUs
- cmn600: Add the ccix programming for cmn600
-
Build System:
- Disable generation of unaligned accesses
-
Framework:
- list: Always zero list nodes when removed from a list
- Zero event list node when duplicating an event
-
Modules:
- cmn600: Fix inappropriately-initialised global state
- cmn600: Stop checking type of external nodes
- ppu_v0: Ensure bound_id is set when bound by system_power
- system_power: Fix extented PPU support
-
Module-based architecture with an event-driven execution model:
- Firmware code is organized into modules, where a module fulfills a well- defined role (driver HAL, driver, protocol or service).
- A framework drives the initialization, orchestration of, and interactions between modules.
-
Processor-agnostic module code enables firmware portability across systems:
- Processor-dependent features (e.g. interrupt handling) are abstracted from the modules by the framework.
- The framework relies on an interface whose implementation is processor- dependent to provide these features.
-
Module configurability easing the re-use of modules on different platforms:
- Strict split between the hardware and software feature configuration data and module code.
-
A native framework test suite provides rapid development and validation of the core framework implementation.
-
Support for Armv7-M control processor architecture based on CMSIS v5 and Keil RTX 5.
-
Provides system initialization support to enable boot of the application cores.
-
Provides the following runtime services:
- Power domain management
- System power management
- Performance domain management (Dynamic voltage and frequency scaling)
- Clock management
- Sensor management
-
Provides a reference implementation of the System Control and Management Interface v1.0 (SCMI, platform-side). The SCMI specification can be found here.
-
Provides a build system supporting:
- The GNU Arm Embedded and Arm Compiler 6 toolchains
- Platforms with multiple firmware images
-
In-source Doxygen documentation
-
Support for the SGM-775 platform
- The Juno platform is extremely limited with regards to available memory. As a result the debug experience is poor, and the ability to add new features severely restricted.
- arm-compiler-6 does not support LTO with our build system. No runs can be done when the SCP-firmware is built with arm-compiler-6 due to space limitations.