From 2300f8a445e16b233765f78dbe2ebb99e5d58c29 Mon Sep 17 00:00:00 2001 From: Yong Cong Sin Date: Wed, 24 Jan 2024 15:04:15 +0800 Subject: [PATCH] doc: migration-guide: 3.7: add note on multilevel interrupt arch changes Add a note on the revamp of the multilevel interrupt architecture, the changes to be made, and new macros to help with the update. Signed-off-by: Yong Cong Sin --- doc/releases/migration-guide-3.7.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/releases/migration-guide-3.7.rst b/doc/releases/migration-guide-3.7.rst index 5dc2312a57d..27834decc3f 100644 --- a/doc/releases/migration-guide-3.7.rst +++ b/doc/releases/migration-guide-3.7.rst @@ -301,6 +301,20 @@ Input Interrupt Controller ==================== +* The static auto-generation of the multilevel interrupt controller lookup table has been + deprecated, and will be compiled only when the new compatibility Kconfig: + :kconfig:option:`CONFIG_LEGACY_MULTI_LEVEL_TABLE_GENERATION` is enabled, which will eventually + be removed in the coming releases. + + Multi-level interrupt controller drivers should be updated to use the newly created + ``IRQ_PARENT_ENTRY_DEFINE`` macro to register itself with the new multi-level interrupt + architecture. To make the macro easier to use, ``INTC_INST_ISR_TBL_OFFSET`` macro is made to + deduce the software ISR table offset for a given driver instance, for pseudo interrupt controller + child, use the ``INTC_CHILD_ISR_TBL_OFFSET`` macro instead. New devicetree macros + (``DT_INTC_GET_AGGREGATOR_LEVEL`` & ``DT_INST_INTC_GET_AGGREGATOR_LEVEL``) have been added + for an interrupt controller driver instance to pass its aggregator level into the + ``IRQ_PARENT_ENTRY_DEFINE`` macro. + LED Strip =========