xref: /rk3399_ARM-atf/changelog.yaml (revision 33e6aaacf1e8f327b33fe2db1f5e964b0adb41c7)
1#
2# Copyright (c) 2021-2024, Arm Limited. All rights reserved.
3#
4# SPDX-License-Identifier: BSD-3-Clause
5#
6
7#
8# The following block describes the top-level sections of the changelog. Commits are categorized
9# into these top-level sections based on the commit message "type":
10#
11#     feat(xyz): add the xyz feature
12#     ^^^^
13#
14
15sections:
16  - title: New Features
17    description: A new feature
18    type: feat
19
20  - title: Resolved Issues
21    description: A bug fix
22    type: fix
23
24  - title: Build System
25    description: Changes that affect the build system or external dependencies
26    type: build
27    hidden: true
28
29  - title: Continuous Integration
30    description: Changes to our CI configuration files and scripts
31    type: ci
32    hidden: true
33
34  - title: Documentation
35    description: Documentation-only changes
36    type: docs
37    hidden: true
38
39  - title: Performance Improvements
40    description: A code change that improves performance
41    type: perf
42    hidden: true
43
44  - title: Code Refactoring
45    description: A code change that neither fixes a bug nor adds a feature
46    type: refactor
47    hidden: true
48
49  - title: Reverted Changes
50    description: Changes that revert a previous change
51    type: revert
52    hidden: true
53
54  - title: Style
55    description: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
56    type: style
57    hidden: true
58
59  - title: Tests
60    description: Adding missing tests or correcting existing tests
61    type: test
62    hidden: true
63
64  - title: Miscellaneous
65    description: Any other change
66    type: chore
67    hidden: true
68
69#
70# The following block describes the sub-sections of the changelog. These sub-sections may appear in
71# any of the top-level sections, and describe the individual components that a change may relate to.
72#
73# Sub-sections have an optional associated commit message "scope":
74#
75#     feat(xyz): add the xyz feature
76#          ^^^
77#
78# This file also describes deprecated scopes, which are scopes that were used before we introduced
79# scope enforcement. These will not pass CI checks when used, but they will be used to generate the
80# changelog.
81#
82# Please note that new scopes should be kebab-case: https://en.wiktionary.org/wiki/kebab_case
83#
84
85subsections:
86  - title: Architecture
87
88    subsections:
89      - title: Activity Monitors Extension (FEAT_AMU)
90        scope: amu
91
92      - title: Branch Record Buffer Extension (FEAT_BRBE)
93        scope: brbe
94
95      - title: Branch Target Identification Extension
96        scope: bti
97
98      - title: Confidential Compute Architecture (CCA)
99        scope: cca
100
101      - title: Extended Cache Index (FEAT_CCIDX)
102        scope: ccidx
103
104      - title: Extended Translation Control Register (FEAT_TCR2).
105        scope: tcr2
106
107      - title: Fine-grained Traps 2 (FEAT_FGT2).
108        scope: fgt2
109
110      - title: CPU feature / ID register handling in general
111        scope: cpufeat
112
113      - title: Debug Extension (FEAT_Debugv8p9)
114        scope: debugv8p9
115
116      - title: Guarded Control Stack (FEAT_GCS)
117        scope: gcs
118
119      - title: Support for the `HCRX_EL2` register (FEAT_HCX)
120        scope: hcx
121
122      - title: Memory Partitioning and Monitoring (MPAM) Extension (FEAT_MPAM)
123        scope: mpam
124
125      - title: Memory Tagging Extension2
126        scope: mte2
127
128        deprecated:
129          - mte
130
131      - title: Pointer Authentication Extension
132        scope: pauth
133
134      - title: Performance Monitors Extension (FEAT_PMUv3)
135        scope: pmu
136
137      - title: Trapping support for RNDR/RNDRRS (FEAT_RNG_TRAP)
138        scope: rng-trap
139
140      - title: Scalable Matrix Extension (FEAT_SME, FEAT_SME2)
141        scope: sme
142
143      - title: Statistical profiling Extension (FEAT_SPE)
144        scope: spe
145
146      - title: Scalable Vector Extension (FEAT_SVE)
147        scope: sve
148
149      - title: System Register Trace Extensions (FEAT_ETMv4, FEAT_ETE and FEAT_ETEv1.1)
150        scope: sys-reg-trace
151
152        deprecated:
153          - sys_reg_trace
154
155      - title: Trace Buffer Extension (FEAT_TRBE)
156        scope: trbe
157
158      - title: Self-hosted Trace Extensions (FEAT_TRF)
159        scope: trf
160
161      - title: DynamIQ Shared Unit (DSU)
162        scope: dsu
163
164  - title: Platforms
165    scope: platforms
166
167    deprecated:
168      - plat/common
169      - plat
170
171    subsections:
172      - title: Allwinner
173        scope: allwinner
174
175        deprecated:
176          - plat/allwinner
177
178      - title: Arm
179        scope: arm
180
181        deprecated:
182          - plat/arm
183
184        subsections:
185          - title: A5DS
186            scope: a5ds
187
188          - title: CSS
189            scope: css
190
191            deprecated:
192              - plat/arm/css
193              - plat/css
194
195          - title: FPGA
196            scope: fpga
197
198            deprecated:
199              - arm_fgpa
200              - plat/arm_fpga
201              - arm/fpga
202
203          - title: FVP
204            scope: fvp
205
206            deprecated:
207              - plat/fvp
208              - fvp/tsp_manifest
209
210          - title: FVP-R
211            scope: fvp-r
212
213            deprecated:
214              - fvp_r
215
216          - title: FVP Versatile Express
217            scope: fvp_ve
218
219          - title: Juno
220            scope: juno
221
222          - title: Morello
223            scope: morello
224
225          - title: N1SDP
226            scope: n1sdp
227
228          - title: Neoverse-RD
229            scope: neoverse-rd
230
231            subsections:
232              - title: SGI-575
233                scope: sgi575
234
235              - title: RD-E1-Edge
236                scope: rde1edge
237
238              - title: RD-N1-Edge
239                scope: rdn1edge
240
241              - title: RD-V1
242                scope: rdv1
243
244              - title: RD-V1-MC
245                scope: rdv1mc
246
247              - title: RD-N2
248                scope: rdn2
249
250              - title: RD-V3
251                scope: rdv3
252
253                deprecated:
254                  - board/rdn2
255
256            deprecated:
257              - neoverse
258
259          - title: TC
260            scope: tc
261
262            deprecated:
263              - plat/tc
264
265            subsections:
266              - title: TC0
267                scope: tc0
268
269                deprecated:
270                  - plat/tc0
271
272          - title: Corstone-1000
273            scope: corstone-1000
274
275      - title: Aspeed
276        scope: aspeed
277
278        subsections:
279          - title: AST2700
280            scope: ast2700
281
282      - title: Broadcom
283        scope: brcm
284
285      - title: Cadence
286        scope: cadence
287
288      - title: HiSilicon
289        scope: hisilicon
290
291        subsections:
292          - title: HiKey
293            scope: hikey
294
295          - title: HiKey960
296            scope: hikey960
297
298      - title: Intel
299        scope: intel
300
301        subsections:
302          - title: SoC
303            scope: soc
304
305      - title: Marvell
306        scope: marvell
307
308        deprecated:
309          - plat/marvell
310
311        subsections:
312          - title: Armada
313            scope: armada
314
315            deprecated:
316              - plat/marvell/armada
317
318            subsections:
319              - title: A3K
320                scope: a3k
321
322                deprecated:
323                  - plat/marvell/a3k
324
325              - title: A8K
326                scope: a8k
327
328                deprecated:
329                  - plat/marvell/a8k
330
331      - title: MediaTek
332        scope: mediatek
333
334        deprecated:
335          - plat/mediatek/common
336          - plat/mediatek
337
338        subsections:
339          - title: MT8183
340            scope: mt8183
341
342            deprecated:
343              - plat/mediatek/mt8183
344
345          - title: MT8186
346            scope: mt8186
347
348            deprecated:
349              - plat/mediatek/mt8186
350              - mt8186-emi-mpu
351
352          - title: MT8188
353            scope: mt8188
354
355          - title: MT8192
356            scope: mt8192
357
358            deprecated:
359              - plat/mdeiatek/mt8192
360
361          - title: MT8195
362            scope: mt8195
363
364            deprecated:
365              - plat/mediatek/me8195
366              - plat/mediatek/mt8195
367              - plat/mdeiatek/mt8195
368
369      - title: NVIDIA
370        scope: nvidia
371
372        subsections:
373          - title: Tegra
374            scope: tegra
375
376            deprecated:
377              - plat/tegra
378
379            subsections:
380              - title: Tegra 132
381                scope: tegra132
382
383              - title: Tegra 194
384                scope: tegra194
385
386              - title: Tegra 210
387                scope: tegra210
388
389      - title: NXP
390        scope: nxp
391
392        deprecated:
393          - plat/nxp
394          - plat/nxp/common
395
396        subsections:
397          - title: i.MX
398            scope: imx
399
400            deprecated:
401              - plat/imx
402              - plat/imx/imx
403
404            subsections:
405              - title: i.MX 8M
406                scope: imx8m
407
408                deprecated:
409                  - plat/imx8m
410                  - plat/imx/imx8m
411
412                subsections:
413                  - title: i.MX 8M Nano
414                    scope: imx8mn
415
416                    deprecated:
417                      - plat/imx/imx8m/imx8mn
418
419                  - title: i.MX 8M Mini
420                    scope: imx8mm
421
422                    deprecated:
423                      - plat/imx/imx8m/imx8mm
424
425                  - title: i.MX 8M Plus
426                    scope: imx8mp
427
428                    deprecated:
429                      - plat/imx/imx8m/imx8mp
430
431                  - title: i.MX 8Q
432                    scope: imx8mq
433
434                    deprecated:
435                      - plat/imx/imx8m/imx8mq
436
437              - title: i.MX 8
438                scope: imx8
439
440              - title: i.MX 8ULP
441                scope: imx8ulp
442
443              - title: i.MX 9
444                scope: imx9
445
446                subsections:
447                  - title: i.MX93
448                    scope: imx93
449
450          - title: Layerscape
451            scope: layerscape
452
453            deprecated:
454              - docs/nxp/layerscape
455
456            subsections:
457              - title: LS1028A
458                scope: ls1028a
459
460                deprecated:
461                  - plat/nxp/ls1028a
462
463                subsections:
464                  - title: LS1028ARDB
465                    scope: ls1028ardb
466
467                    deprecated:
468                      - plat/nxp/ls1028ardb
469
470              - title: LS1043A
471                scope: ls1043a
472
473                deprecated:
474                  - plat/nxp/ls1043a
475
476                subsections:
477                  - title: LS1043ARDB
478                    scope: ls1043ardb
479
480                    deprecated:
481                      - plat/nxp/ls1043ardb
482
483              - title: LX2
484                scope: lx2
485
486                deprecated:
487                  - plat/nxp/lx2
488
489                subsections:
490                  - title: LX216
491                    scope: lx216
492
493                    deprecated:
494                      - plat/nxp/lx216x
495
496                    subsections:
497                      - title: LX2160
498                        scope: lx2160
499
500                        deprecated:
501                          - plat/soc-lx2160
502
503              - title: LS1046A
504                scope: ls1046a
505
506                subsections:
507                  - title: LS1046ARDB
508                    scope: ls1046ardb
509
510                  - title: LS1046AFRWY
511                    scope: ls1046afrwy
512
513                  - title: LS1046AQDS
514                    scope: ls1046aqds
515
516              - title: LS1088A
517                scope: ls1088a
518
519                subsections:
520                  - title: LS1088ARDB
521                    scope: ls1088ardb
522
523                  - title: LS1088AQDS
524                    scope: ls1088aqds
525
526          - title: S32G274A
527            scope: s32g274a
528
529            subsections:
530              - title: S32G274ARDB
531                scope: s32g274ardb
532
533      - title: QEMU
534        scope: qemu
535
536        deprecated:
537          - plat/qemu
538
539        subsections:
540          - title: SBSA
541            scope: qemu-sbsa
542
543            deprecated:
544              - qemu_sbsa
545
546      - title: QTI
547        scope: qti
548
549        deprecated:
550          - plat/qti
551
552        subsections:
553          - title: SC1780
554            scope: sc7180
555
556            deprecated:
557              - plat/qti/sc7180
558
559          - title: SC7280
560            scope: sc7280
561
562            deprecated:
563              - plat/qti/sc7280
564
565          - title: MSM8916
566            scope: msm8916
567
568      - title: Raspberry Pi
569        scope: rpi
570
571        subsections:
572          - title: Raspberry Pi 3
573            scope: rpi3
574
575          - title: Raspberry Pi 4
576            scope: rpi4
577
578          - title: Raspberry Pi 5
579            scope: rpi5
580
581      - title: Renesas
582        scope: renesas
583
584        subsections:
585          - title: R-Car
586            scope: rcar
587
588            deprecated:
589              - plat/rcar
590
591            subsections:
592              - title: R-Car 3
593                scope: rcar3
594
595                deprecated:
596                  - plat/rcar3
597
598      - title: Rockchip
599        scope: rockchip
600
601        subsections:
602          - title: RK3399
603            scope: rk3399
604
605            deprecated:
606              - rockchip/rk3399
607              - rk3399/suspend
608
609          - title: RK3328
610            scope: rk3328
611
612      - title: Socionext
613        scope: socionext
614
615        subsections:
616          - title: Synquacer
617            scope: synquacer
618
619            deprecated:
620              - plat/synquacer
621
622      - title: ST
623        scope: st
624
625        deprecated:
626          - plat/st
627
628        subsections:
629          - title: STM32MP1
630            scope: stm32mp1
631
632            deprecated:
633              - plat/st/stm32mp1
634
635            subsections:
636              - title: STM32MP13
637                scope: stm32mp13
638
639              - title: STM32MP15
640                scope: stm32mp15
641
642          - title: STM32MP2
643            scope: stm32mp2
644
645      - title: Texas Instruments
646        scope: ti
647
648        subsections:
649          - title: K3
650            scope: k3
651
652            deprecated:
653              - ti-k3
654
655      - title: Xilinx
656        scope: xilinx
657
658        deprecated:
659          - plat/xilinx
660
661        subsections:
662          - title: DCC (Debug Communication Channel)
663            scope: dcc
664
665          - title: Versal
666            scope: versal
667
668            deprecated:
669              - plat/xilinx/versal/include
670              - plat/xilinx/versal
671              - plat/versal
672
673          - title: Versal NET
674            scope: versal-net
675
676            deprecated:
677              - versal_net
678
679          - title: ZynqMP
680            scope: zynqmp
681
682            deprecated:
683              - plat/zynqmp
684              - plat/xilinx/zynqmp
685
686      - title: AMD
687        scope: amd
688
689        subsections:
690          - title: Versal Gen 2
691            scope: versal2
692
693      - title: Nuvoton
694        scope: nuvoton
695
696        subsections:
697          - title: npcm845x
698            scope: npcm845x
699
700  - title: Bootloader Images
701    scope: bl
702
703    deprecated:
704      - bl_common
705
706    subsections:
707      - title: BL1
708        scope: bl1
709
710      - title: BL2
711        scope: bl2
712
713      - title: BL31
714        scope: bl31
715
716      - title: BL32
717        scope: bl32
718
719        subsections:
720          - title: TSP
721            scope: tsp
722
723  - title: Services
724    scope: services
725
726    subsections:
727      - title: FF-A
728        scope: ff-a
729
730        deprecated:
731          - ffa
732
733      - title: RME
734        scope: rme
735
736        deprecated:
737          - rme/fid
738
739        subsections:
740          - title: TRP
741            scope: trp
742
743          - title: RMMD
744            scope: rmmd
745
746          - title: RMM
747            scope: rmm
748
749      - title: SPM
750        scope: spm
751
752        subsections:
753          - title: EL3 SPM
754            scope: el3-spm
755
756          - title: EL3 SPMC
757            scope: el3-spmc
758
759            deprecated:
760              - spmc
761
762          - title: SPMD
763            scope: spmd
764
765          - title: SPM MM
766            scope: spm-mm
767
768      - title: DRTM
769        scope: drtm
770
771      - title: TRNG
772        scope: trng
773
774      - title: ERRATA ABI
775        scope: errata-abi
776
777        deprecated:
778          - errata_abi
779
780      - title: ChromeOS
781        scope: cros
782
783  - title: Libraries
784    scope: lib
785
786    subsections:
787      - title: CPU Support
788        scope: cpus
789
790        deprecated:
791          - cpu
792          - errata
793          - errata_report
794
795      - title: EL3 Runtime
796        scope: el3-runtime
797
798        deprecated:
799          - el3_runtime
800
801        subsections:
802          - title: Context Management
803            scope: cm
804
805          - title: RAS
806            scope: ras
807
808      - title: FCONF
809        scope: fconf
810
811      - title: MPMM
812        scope: mpmm
813
814      - title: OP-TEE
815        scope: optee
816
817        deprecated:
818          - lib/optee
819
820      - title: PSCI
821        scope: psci
822
823      - title: ROMlib
824        scope: romlib
825
826      - title: GPT
827        scope: gpt
828
829        deprecated:
830          - gpt_rme
831
832      - title: SMCCC
833        scope: smccc
834
835      - title: Translation Tables
836        scope: xlat
837
838      - title: C Standard Library
839        scope: libc
840
841      - title: Locks
842        scope: locks
843
844      - title: PSA
845        scope: psa
846
847        deprecated:
848          - lib/psa
849
850      - title: DICE Protection Environment
851        scope: dice
852
853      - title: Context Management
854        scope: context-mgmt
855
856        deprecated:
857          - context mgmt
858
859      - title: Semihosting
860        scope: semihosting
861
862      - title: Firmware Handoff
863        scope: handoff
864
865      - title: Exception Handling Framework (EHF)
866        scope: ehf
867
868  - title: Drivers
869
870    subsections:
871      - title: Authentication
872        scope: auth
873
874        deprecated:
875          - driver/auth
876
877        subsections:
878          - title: CryptoCell-713
879            scope: cc-713
880
881          - title: Crypto
882            scope: crypto
883
884          - title: mbedTLS
885            scope: mbedtls
886
887          - title: mbedTLS-PSA
888            scope: mbedtls-psa
889
890      - title: Console
891        scope: console
892
893      - title: Generic Clock
894        scope: clk
895
896      - title: FWU
897        scope: fwu
898
899        deprecated:
900          - fwu_metadata
901
902      - title: I/O
903        scope: io
904
905        subsections:
906          - title: MTD
907            scope: mtd
908
909            deprecated:
910              - io_mtd
911
912      - title: Measured Boot
913        scope: measured-boot
914
915        deprecated:
916          - measured boot
917          - measured_boot
918
919      - title: MMC
920        scope: mmc
921
922        deprecated:
923          - drivers/mmc
924
925      - title: MTD
926        scope: mtd
927
928        deprecated:
929          - drivers/mtd
930
931        subsections:
932          - title: NAND
933            scope: nand
934
935            subsections:
936              - title: SPI NAND
937                scope: spi-nand
938
939                deprecated:
940                  - spi_nand
941
942      - title: GUID Partition Tables Support
943        scope: guid-partition
944
945        deprecated:
946          - partition
947
948      - title: SCMI
949        scope: scmi
950
951        deprecated:
952          - scmi_common
953          - drivers/scmi-msg
954          - scmi-msg
955
956      - title: UFS
957        scope: ufs
958
959      - title: Arm
960        scope: arm-drivers
961
962        subsections:
963          - title: Ethos-N
964            scope: ethos-n
965
966            deprecated:
967              - drivers/arm/ethosn
968
969          - title: GIC
970            scope: gic
971
972            subsections:
973              - title: GICv3
974                scope: gicv3
975
976                deprecated:
977                  - gicv3/multichip
978
979                subsections:
980                  - title: GIC-600
981                    scope: gic600
982
983                  - title: GIC-600AE
984                    scope: gic600ae
985
986              - title: GICv2
987                scope: gicv2
988
989          - title: SMMU
990            scope: smmu
991
992          - title: MHU
993            scope: mhu
994
995            deprecated:
996              - drivers/arm/mhu
997
998          - title: RSE
999            scope: rse
1000
1001            deprecated:
1002              - drivers/arm/rss
1003              - rss
1004
1005          - title: TZC
1006            scope: tzc
1007
1008            subsections:
1009              - title: TZC-400
1010                scope: tzc400
1011
1012                deprecated:
1013                  - drivers/tzc400
1014
1015              - title: TZC-380
1016                scope: tzc380
1017
1018                deprecated:
1019                  - drivers/tzc380
1020
1021          - title: SBSA
1022            scope: sbsa
1023
1024      - title: Marvell
1025        scope: marvell-drivers
1026
1027        subsections:
1028          - title: COMPHY
1029            scope: marvell-comphy
1030
1031            deprecated:
1032              - drivers/marvell/comphy
1033
1034            subsections:
1035              - title: Armada 3700
1036                scope: marvell-comphy-3700
1037
1038                deprecated:
1039                  - drivers/marvell/comphy-3700
1040
1041              - title: CP110
1042                scope: marvell-comphy-cp110
1043
1044                deprecated:
1045                  - drivers/marvell/comphy-cp110
1046
1047          - title: UART
1048            scope: marvell-uart
1049
1050            deprecated:
1051              - plat/marvell/uart
1052
1053          - title: Armada
1054            scope: armada-drivers
1055
1056            subsections:
1057              - title: A3K
1058                scope: a3k-drivers
1059
1060                subsections:
1061                  - title: A3720
1062                    scope: a3720-uart
1063
1064                    deprecated:
1065                      - plat/marvell/a3720/uart
1066
1067      - title: MediaTek
1068        scope: mediatek-drivers
1069
1070        subsections:
1071          - title: APU
1072            scope: mediatek-apu
1073
1074            deprecated:
1075              - plat/mediatek/apu
1076
1077          - title: EMI MPU
1078            scope: mediatek-emi-mpu
1079
1080            deprecated:
1081              - plat/mediatek/mpu
1082
1083          - title: PMIC Wrapper
1084            scope: mediatek-pmic-wrapper
1085
1086            deprecated:
1087              - plat/mediatek/pmic_wrap
1088
1089          - title: MT8192
1090            scope: mt8192-drivers
1091
1092            subsections:
1093              - title: SPM
1094                scope: mt8192-spm
1095
1096                deprecated:
1097                  - mediatek/mt8192/spm
1098
1099      - title: NXP
1100        scope: nxp-drivers
1101
1102        subsections:
1103          - title: DCFG
1104            scope: nxp-dcfg
1105
1106            deprecated:
1107              - driver/nxp/dcfg
1108
1109          - title: FLEXSPI
1110            scope: flexspi
1111
1112            deprecated:
1113              - include/drivers/flexspi
1114              - driver/nxp/xspi
1115
1116          - title: SCFG
1117            scope: nxp-scfg
1118
1119            deprecated:
1120              - nxp/scfg
1121
1122          - title: SFP
1123            scope: nxp-sfp
1124
1125            deprecated:
1126              - drivers/nxp/sfp
1127
1128          - title: QSPI
1129            scope: nxp-qspi
1130
1131          - title: NXP Crypto
1132            scope: nxp-crypto
1133
1134          - title: DDR
1135            scope: nxp-ddr
1136
1137          - title: GIC
1138            scope: nxp-gic
1139
1140          - title: CSU
1141            scope: nxp-csu
1142
1143          - title: IFC NAND
1144            scope: nxp-ifc-nand
1145
1146          - title: IFC NOR
1147            scope: nxp-ifc-nor
1148
1149          - title: TZC-380
1150            scope: nxp-tzc380
1151
1152          - title: TRDC
1153            scope: imx-trdc
1154
1155          - title: Clock
1156            scope: nxp-clk
1157
1158      - title: Renesas
1159        scope: renesas-drivers
1160
1161        subsections:
1162          - title: R-Car3
1163            scope: rcar3-drivers
1164
1165            deprecated:
1166              - drivers/rcar3
1167
1168      - title: ST
1169        scope: st-drivers
1170
1171        deprecated:
1172          - drivers/st
1173
1174        subsections:
1175          - title: BSEC
1176            scope: st-bsec
1177
1178          - title: Clock
1179            scope: st-clock
1180
1181            deprecated:
1182              - stm32mp_clk
1183              - drivers/st/clk
1184              - stm32mp1_clk
1185
1186          - title: Crypto
1187            scope: st-crypto
1188
1189          - title: DDR
1190            scope: st-ddr
1191
1192          - title: I/O
1193            scope: st-io-drivers
1194
1195            subsections:
1196              - title: STM32 Image
1197                scope: st-io-stm32image
1198
1199                deprecated:
1200                  - io-stm32image
1201                  - io_stm32image
1202
1203          - title: I2C
1204            scope: st-i2c
1205
1206          - title: FMC
1207            scope: st-fmc
1208
1209          - title: GPIO
1210            scope: st-gpio
1211
1212          - title: SDMMC2
1213            scope: st-sdmmc2
1214
1215            deprecated:
1216              - stm32_sdmmc2
1217
1218          - title: ST PMIC
1219            scope: st-pmic
1220
1221            deprecated:
1222              - drivers/st/pmic
1223
1224          - title: STPMIC1
1225            scope: stpmic1
1226
1227          - title: Regulator
1228            scope: st-regulator
1229
1230          - title: Reset
1231            scope: st-reset
1232
1233          - title: SPI
1234            scope: st-spi
1235
1236          - title: UART
1237            scope: st-uart
1238
1239            subsections:
1240              - title: STM32 Console
1241                scope: stm32-console
1242
1243                deprecated:
1244                  - stm32_console
1245
1246          - title: USB
1247            scope: st-usb
1248
1249            deprecated:
1250              - drivers/st/usb
1251
1252          - title: Watchdog
1253            scope: st-iwdg
1254
1255      - title: USB
1256        scope: usb
1257
1258        deprecated:
1259          - drivers/usb
1260
1261  - title: Miscellaneous
1262
1263    subsections:
1264      - title: AArch64
1265        scope: aarch64
1266
1267      - title: Debug
1268        scope: debug
1269
1270        deprecated:
1271          - common/debug
1272
1273      - title: CRC32
1274        scope: crc32
1275
1276        subsections:
1277          - title: Hardware CRC32
1278            scope: hw-crc32
1279
1280            deprecated:
1281              - hw_crc
1282              - hw_crc32
1283
1284          - title: Software CRC32
1285            scope: sw-crc32
1286
1287            deprecated:
1288              - sw_crc32
1289
1290      - title: DT Bindings
1291        scope: dt-bindings
1292
1293      - title: FDT Wrappers
1294        scope: fdt-wrappers
1295
1296      - title: FDTs
1297        scope: fdts
1298
1299        deprecated:
1300          - fdt
1301
1302        subsections:
1303          - title: Morello
1304            scope: morello-fdts
1305
1306            deprecated:
1307              - fdts/morello
1308
1309          - title: STM32MP1
1310            scope: stm32mp1-fdts
1311
1312            deprecated:
1313              - fdts stm32mp1
1314
1315            subsections:
1316              - title: STM32MP13
1317                scope: stm32mp13-fdts
1318
1319              - title: STM32MP15
1320                scope: stm32mp15-fdts
1321
1322          - title: STM32MP2
1323            scope: stm32mp2-fdts
1324
1325      - title: PIE
1326        scope: pie
1327
1328      - title: PIE/POR
1329        scope: pie/por
1330
1331      - title: Security
1332        scope: security
1333
1334      - title: SDEI
1335        scope: sdei
1336
1337      - title: TBBR
1338        scope: tbbr
1339
1340      - title: NXP
1341
1342        subsections:
1343          - title: OCRAM
1344            scope: nxp-ocram
1345
1346            deprecated:
1347              - nxp/common/ocram
1348
1349          - title: PSCI
1350            scope: nxp-psci
1351
1352            deprecated:
1353              - plat/nxp/common/psci
1354
1355      - title: UUID
1356        scope: uuid
1357
1358  - title: Documentation
1359    scope: docs
1360
1361    deprecated:
1362      - doc
1363
1364    subsections:
1365      - title: Changelog
1366        scope: changelog
1367
1368      - title: Commit Style
1369        scope: commit-style
1370
1371      - title: Contribution Guidelines
1372        scope: contributing
1373
1374        deprecated:
1375          - contribution-guidelines
1376          - docs-contributing.rst
1377
1378      - title: Maintainers
1379        scope: maintainers
1380
1381      - title: Prerequisites
1382        scope: prerequisites
1383
1384      - title: Threat Model
1385        scope: threat-model
1386
1387      - title: Porting Guide
1388        scope: porting
1389
1390  - title: Build System
1391    scope: build
1392
1393    deprecated:
1394      - makefile
1395      - Makefile
1396
1397    subsections:
1398      - title: Git Hooks
1399        scope: hooks
1400
1401        deprecated:
1402          - git-hooks
1403
1404  - title: Tools
1405
1406    subsections:
1407      - title: STM32 Image
1408        scope: stm32image
1409
1410        deprecated:
1411          - tools/stm32image
1412
1413      - title: NXP Tools
1414        scope: nxp-tools
1415
1416      - title: Firmware Image Package Tool
1417        scope: fiptool
1418
1419      - title: Secure Partition Tool
1420        scope: sptool
1421
1422      - title: Certificate Creation Tool
1423        scope: cert-create
1424
1425      - title: Firmware Encryption Tool
1426        scope: encrypt-fw
1427
1428      - title: Memory Mapping Tool
1429        scope: memmap
1430
1431        deprecated:
1432          - cert_create
1433
1434      - title: Marvell Tools
1435        scope: marvell-tools
1436
1437      - title: Renesas Tools
1438        scope: renesas-tools
1439
1440        subsections:
1441          - title: R-Car Layout Tool
1442            scope: rcar-layout
1443
1444          - title: R/ZG Layout Tool
1445            scope: rzg-layout
1446
1447  - title: Dependencies
1448    scope: deps
1449
1450    subsections:
1451      - title: checkpatch
1452        scope: checkpatch
1453
1454      - title: commitlint
1455        scope: commitlint
1456
1457      - title: Compiler runtime libraries
1458        scope: compiler-rt
1459
1460      - title: libfdt
1461        scope: libfdt
1462
1463      - title: Node Package Manager (NPM)
1464        scope: npm
1465
1466      - title: Poetry
1467        scope: poetry
1468
1469      - title: zlib
1470        scope: zlib
1471