xref: /rk3399_ARM-atf/changelog.yaml (revision 1bd4f3c1a32c7701ab4182272ce5a1b26b12fa82)
1#
2# Copyright (c) 2021-2025, 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: CPU feature like FEAT_XXXX / ID register handling in general
90        scope: cpufeat
91
92        deprecated:
93          - amu
94          - brbe
95          - bti
96          - cca
97          - ccidx
98          - d128
99          - debugv8p9
100          - fgt2
101          - fpmr
102          - gcs
103          - hcx
104          - mops
105          - mpam
106          - mte
107          - mte2
108          - pauth
109          - pmu
110          - pmuv3
111          - rng-trap
112          - sctlr2
113          - feat_sctlr2
114          - sme
115          - spe
116          - sve
117          - sys-reg-trace
118          - sys_reg_trace
119          - tcr2
120          - trbe
121          - trf
122          - the
123
124      - title: DynamIQ Shared Unit (DSU)
125        scope: dsu
126
127  - title: Platforms
128    scope: platforms
129
130    deprecated:
131      - plat/common
132      - plat
133
134    subsections:
135      - title: Allwinner
136        scope: allwinner
137
138        deprecated:
139          - plat/allwinner
140
141      - title: AMLogic
142        scope: amlogic
143
144        subsections:
145          - title: GXL
146            scope: gxl
147
148      - title: Arm
149        scope: arm
150
151        deprecated:
152          - plat/arm
153
154        subsections:
155          - title: Common
156            scope: common
157
158          - title: A5DS
159            scope: a5ds
160
161          - title: CSS
162            scope: css
163
164            deprecated:
165              - plat/arm/css
166              - plat/css
167
168          - title: FPGA
169            scope: fpga
170
171            deprecated:
172              - arm_fgpa
173              - plat/arm_fpga
174              - arm/fpga
175
176          - title: FVP
177            scope: fvp
178
179            deprecated:
180              - plat/fvp
181              - fvp/tsp_manifest
182
183          - title: FVP Versatile Express
184            scope: fvp_ve
185
186          - title: Juno
187            scope: juno
188
189          - title: Morello
190            scope: morello
191
192          - title: N1SDP
193            scope: n1sdp
194
195          - title: Neoverse-RD
196            scope: neoverse-rd
197
198            subsections:
199              - title: RD-N2
200                scope: rdn2
201
202              - title: RD-V3
203                scope: rdv3
204
205                deprecated:
206                  - board/rdn2
207                  - rdfremont
208
209            deprecated:
210              - neoverse
211              - neoverse_rd
212
213          - title: TC
214            scope: tc
215
216            deprecated:
217              - plat/tc
218
219          - title: Corstone-1000
220            scope: corstone-1000
221
222            deprecated:
223              - corstone1000
224
225          - title: Automotive RD
226            scope: automotive_rd
227
228            subsections:
229              - title: RD-1 AE
230                scope: rd1ae
231
232              - title: RD-Aspen
233                scope: rdaspen
234
235      - title: Aspeed
236        scope: aspeed
237
238        subsections:
239          - title: AST2700
240            scope: ast2700
241
242      - title: Broadcom
243        scope: brcm
244
245      - title: Cadence
246        scope: cadence
247
248      - title: HiSilicon
249        scope: hisilicon
250
251        subsections:
252          - title: HiKey
253            scope: hikey
254
255          - title: HiKey960
256            scope: hikey960
257
258          - title: Poplar
259            scope: poplar
260
261      - title: Intel
262        scope: intel
263
264        subsections:
265          - title: SoC
266            scope: soc
267
268      - title: Marvell
269        scope: marvell
270
271        deprecated:
272          - plat/marvell
273
274        subsections:
275          - title: Armada
276            scope: armada
277
278            deprecated:
279              - plat/marvell/armada
280
281            subsections:
282              - title: A3K
283                scope: a3k
284
285                deprecated:
286                  - plat/marvell/a3k
287
288              - title: A8K
289                scope: a8k
290
291                deprecated:
292                  - plat/marvell/a8k
293
294      - title: MediaTek
295        scope: mediatek
296
297        deprecated:
298          - plat/mediatek/common
299          - plat/mediatek
300
301        subsections:
302          - title: MT8183
303            scope: mt8183
304
305            deprecated:
306              - plat/mediatek/mt8183
307
308          - title: MT8186
309            scope: mt8186
310
311            deprecated:
312              - plat/mediatek/mt8186
313              - mt8186-emi-mpu
314
315          - title: MT8188
316            scope: mt8188
317
318          - title: MT8189
319            scope: mt8189
320
321          - title: MT8192
322            scope: mt8192
323
324            deprecated:
325              - plat/mdeiatek/mt8192
326
327          - title: MT8195
328            scope: mt8195
329
330            deprecated:
331              - plat/mediatek/me8195
332              - plat/mediatek/mt8195
333              - plat/mdeiatek/mt8195
334
335          - title: MT8196
336            scope: mt8196
337
338      - title: NVIDIA
339        scope: nvidia
340
341        subsections:
342          - title: Tegra
343            scope: tegra
344
345            deprecated:
346              - plat/tegra
347
348            subsections:
349              - title: Tegra 132
350                scope: tegra132
351
352              - title: Tegra 194
353                scope: tegra194
354
355              - title: Tegra 210
356                scope: tegra210
357
358      - title: NXP
359        scope: nxp
360
361        deprecated:
362          - plat/nxp
363          - plat/nxp/common
364
365        subsections:
366          - title: i.MX
367            scope: imx
368
369            deprecated:
370              - plat/imx
371              - plat/imx/imx
372
373            subsections:
374              - title: i.MX 8M
375                scope: imx8m
376
377                deprecated:
378                  - plat/imx8m
379                  - plat/imx/imx8m
380
381                subsections:
382                  - title: i.MX 8M Nano
383                    scope: imx8mn
384
385                    deprecated:
386                      - plat/imx/imx8m/imx8mn
387
388                  - title: i.MX 8M Mini
389                    scope: imx8mm
390
391                    deprecated:
392                      - plat/imx/imx8m/imx8mm
393
394                  - title: i.MX 8M Plus
395                    scope: imx8mp
396
397                    deprecated:
398                      - plat/imx/imx8m/imx8mp
399
400                  - title: i.MX 8Q
401                    scope: imx8mq
402
403                    deprecated:
404                      - plat/imx/imx8m/imx8mq
405
406              - title: i.MX 8
407                scope: imx8
408
409              - title: i.MX 8ULP
410                scope: imx8ulp
411
412              - title: i.MX 9
413                scope: imx9
414
415                subsections:
416                  - title: i.MX93
417                    scope: imx93
418
419                  - title: i.MX94
420                    scope: imx94
421
422                  - title: i.MX95
423                    scope: imx95
424
425          - title: Layerscape
426            scope: layerscape
427
428            deprecated:
429              - docs/nxp/layerscape
430
431            subsections:
432              - title: LS1028A
433                scope: ls1028a
434
435                deprecated:
436                  - plat/nxp/ls1028a
437
438                subsections:
439                  - title: LS1028ARDB
440                    scope: ls1028ardb
441
442                    deprecated:
443                      - plat/nxp/ls1028ardb
444
445              - title: LS1043A
446                scope: ls1043a
447
448                deprecated:
449                  - plat/nxp/ls1043a
450
451                subsections:
452                  - title: LS1043ARDB
453                    scope: ls1043ardb
454
455                    deprecated:
456                      - plat/nxp/ls1043ardb
457
458              - title: LX2
459                scope: lx2
460
461                deprecated:
462                  - plat/nxp/lx2
463
464                subsections:
465                  - title: LX216
466                    scope: lx216
467
468                    deprecated:
469                      - plat/nxp/lx216x
470
471                    subsections:
472                      - title: LX2160
473                        scope: lx2160
474
475                        deprecated:
476                          - plat/soc-lx2160
477
478              - title: LS1046A
479                scope: ls1046a
480
481                subsections:
482                  - title: LS1046ARDB
483                    scope: ls1046ardb
484
485                  - title: LS1046AFRWY
486                    scope: ls1046afrwy
487
488                  - title: LS1046AQDS
489                    scope: ls1046aqds
490
491              - title: LS1088A
492                scope: ls1088a
493
494                subsections:
495                  - title: LS1088ARDB
496                    scope: ls1088ardb
497
498                  - title: LS1088AQDS
499                    scope: ls1088aqds
500
501          - title: S32G274A
502            scope: s32g274a
503
504            subsections:
505              - title: S32G274ARDB
506                scope: s32g274ardb
507
508      - title: QEMU
509        scope: qemu
510
511        deprecated:
512          - plat/qemu
513
514        subsections:
515          - title: SBSA
516            scope: qemu-sbsa
517
518            deprecated:
519              - qemu_sbsa
520
521      - title: QTI
522        scope: qti
523
524        deprecated:
525          - plat/qti
526
527        subsections:
528          - title: SC1780
529            scope: sc7180
530
531            deprecated:
532              - plat/qti/sc7180
533
534          - title: SC7280 Chrome
535            scope: sc7280_chrome
536
537            deprecated:
538              - plat/qti/sc7280
539              - sc7280
540
541          - title: MSM8916
542            scope: msm8916
543
544          - title: Kodiak
545            scope: kodiak
546
547          - title: RB3Gen2
548            scope: rb3gen2
549
550      - title: Raspberry Pi
551        scope: rpi
552
553        subsections:
554          - title: Raspberry Pi 3
555            scope: rpi3
556
557          - title: Raspberry Pi 4
558            scope: rpi4
559
560          - title: Raspberry Pi 5
561            scope: rpi5
562
563      - title: Renesas
564        scope: renesas
565
566        subsections:
567          - title: R-Car
568            scope: rcar
569
570            deprecated:
571              - plat/rcar
572
573            subsections:
574              - title: R-Car 3
575                scope: rcar3
576
577                deprecated:
578                  - plat/rcar3
579
580              - title: R-Car 4
581                scope: rcar4
582
583      - title: Rockchip
584        scope: rockchip
585
586        subsections:
587          - title: PX30
588            scope: px30
589
590          - title: RK3288
591            scope: rk3288
592
593          - title: RK3328
594            scope: rk3328
595
596          - title: RK3399
597            scope: rk3399
598
599            deprecated:
600              - rockchip/rk3399
601              - rk3399/suspend
602
603          - title: RK3568
604            scope: rk3568
605
606          - title: RK3576
607            scope: rk3576
608
609          - title: RK3588
610            scope: rk3588
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            subsections:
646              - title: STM32MP21
647                scope: stm32mp21
648
649              - title: STM32MP23
650                scope: stm32mp23
651
652              - title: STM32MP25
653                scope: stm32mp25
654
655      - title: Texas Instruments
656        scope: ti
657
658        subsections:
659          - title: K3
660            scope: k3
661
662          - title: K3 Low Power Devices
663            scope: k3low
664
665            deprecated:
666              - ti-k3
667
668      - title: Xilinx
669        scope: xilinx
670
671        deprecated:
672          - plat/xilinx
673
674        subsections:
675          - title: DCC (Debug Communication Channel)
676            scope: dcc
677
678          - title: Versal
679            scope: versal
680
681            deprecated:
682              - plat/xilinx/versal/include
683              - plat/xilinx/versal
684              - plat/versal
685
686          - title: Versal NET
687            scope: versal-net
688
689            deprecated:
690              - versal_net
691
692          - title: ZynqMP
693            scope: zynqmp
694
695            deprecated:
696              - plat/zynqmp
697              - plat/xilinx/zynqmp
698
699      - title: AMD
700        scope: amd
701
702        subsections:
703          - title: Versal Gen 2
704            scope: versal2
705
706      - title: Nuvoton
707        scope: nuvoton
708
709        subsections:
710          - title: npcm845x
711            scope: npcm845x
712
713      - title: Altera
714        scope: altera
715
716        subsections:
717          - title: Agilex3
718            scope: agilex3
719
720  - title: Bootloader Images
721    scope: bl
722
723    deprecated:
724      - bl_common
725
726    subsections:
727      - title: BL1
728        scope: bl1
729
730      - title: BL2
731        scope: bl2
732
733      - title: BL31
734        scope: bl31
735
736      - title: BL32
737        scope: bl32
738
739        subsections:
740          - title: TSP
741            scope: tsp
742
743  - title: Services
744    scope: services
745
746    deprecated:
747      - std_svc
748
749    subsections:
750      - title: FF-A
751        scope: ff-a
752
753        deprecated:
754          - ffa
755
756      - title: RME
757        scope: rme
758
759        deprecated:
760          - rme/fid
761
762        subsections:
763          - title: TRP
764            scope: trp
765
766          - title: RMMD
767            scope: rmmd
768
769          - title: RMM
770            scope: rmm
771
772      - title: SPM
773        scope: spm
774
775        subsections:
776          - title: EL3 SPM
777            scope: el3-spm
778
779          - title: EL3 SPMC
780            scope: el3-spmc
781
782            deprecated:
783              - el3_spmc
784              - spmc
785
786          - title: SPMD
787            scope: spmd
788
789          - title: SPM MM
790            scope: spm-mm
791
792            deprecated:
793              - spm_mm
794
795      - title: DRTM
796        scope: drtm
797
798      - title: TRNG
799        scope: trng
800
801      - title: ERRATA ABI
802        scope: errata-abi
803
804        deprecated:
805          - errata_abi
806
807      - title: ChromeOS
808        scope: cros
809
810      - title: Live Firmware Activation
811        scope: lfa
812
813      - title: Secure Payload Dispatcher
814        scope: spd
815
816        subsections:
817          - title: OP-TEE
818            scope: optee
819
820            deprecated:
821              - lib/optee
822
823          - title: ProvenCore
824            scope: pncd
825
826          - title: Trusted Little Kernel
827            scope: tlkd
828
829          - title: Trusty
830            scope: trusty
831
832          - title: TSP
833            scope: tspd
834
835  - title: Libraries
836    scope: lib
837
838    subsections:
839      - title: CPU Support
840        scope: cpus
841
842        deprecated:
843          - cpu
844          - errata
845          - errata_report
846
847      - title: Debug FS
848        scope: debugfs
849
850      - title: EL3 Runtime
851        scope: el3-runtime
852
853        deprecated:
854          - el3_runtime
855
856        subsections:
857          - title: Context Management
858            scope: cm
859
860          - title: RAS
861            scope: ras
862
863          - title: SIMD
864            scope: simd
865
866      - title: FCONF
867        scope: fconf
868
869      - title: HOB
870        scope: hob
871
872      - title: MPMM
873        scope: mpmm
874
875      - title: Per-cpu
876        scope: per-cpu
877
878      - title: PSCI
879        scope: psci
880
881      - title: ROMlib
882        scope: romlib
883
884      - title: Granule Protection Tables
885        scope: gpt
886
887        deprecated:
888          - gpt_rme
889
890      - title: SMCCC
891        scope: smccc
892
893      - title: Translation Tables
894        scope: xlat
895
896        deprecated:
897          - xlat_tables_v2
898
899      - title: C Standard Library
900        scope: libc
901
902      - title: Locks
903        scope: locks
904
905      - title: PSA
906        scope: psa
907
908        deprecated:
909          - lib/psa
910
911      - title: DICE Protection Environment
912        scope: dice
913
914      - title: Context Management
915        scope: context-mgmt
916
917        deprecated:
918          - context mgmt
919
920      - title: Semihosting
921        scope: semihosting
922
923      - title: Firmware Handoff
924        scope: handoff
925
926      - title: Exception Handling Framework (EHF)
927        scope: ehf
928
929  - title: Drivers
930
931    subsections:
932      - title: Authentication
933        scope: auth
934
935        deprecated:
936          - driver/auth
937
938        subsections:
939          - title: CryptoCell-713
940            scope: cc-713
941
942          - title: Crypto
943            scope: crypto
944
945          - title: mbedTLS
946            scope: mbedtls
947
948          - title: mbedTLS-PSA
949            scope: mbedtls-psa
950
951      - title: Console
952        scope: console
953
954      - title: Delay Timer
955        scope: delay-timer
956
957      - title: Generic Clock
958        scope: clk
959
960      - title: FWU
961        scope: fwu
962
963        deprecated:
964          - fwu_metadata
965
966      - title: I/O
967        scope: io
968
969        subsections:
970          - title: MTD
971            scope: mtd
972
973            deprecated:
974              - io_mtd
975
976      - title: Measured Boot
977        scope: measured-boot
978
979        deprecated:
980          - measured boot
981          - measured_boot
982
983      - title: MMC
984        scope: mmc
985
986        deprecated:
987          - drivers/mmc
988
989      - title: MTD
990        scope: mtd
991
992        deprecated:
993          - drivers/mtd
994
995        subsections:
996          - title: NAND
997            scope: nand
998
999            subsections:
1000              - title: SPI NAND
1001                scope: spi-nand
1002
1003                deprecated:
1004                  - spi_nand
1005
1006      - title: GUID Partition Tables Support
1007        scope: guid-partition
1008
1009        deprecated:
1010          - partition
1011
1012      - title: SCMI
1013        scope: scmi
1014
1015        deprecated:
1016          - scmi_common
1017          - drivers/scmi-msg
1018          - scmi-msg
1019
1020      - title: TPM
1021        scope: tpm
1022
1023      - title: UFS
1024        scope: ufs
1025
1026      - title: Arm
1027        scope: arm-drivers
1028
1029        subsections:
1030          - title: Ethos-N
1031            scope: ethos-n
1032
1033            deprecated:
1034              - drivers/arm/ethosn
1035
1036          - title: GIC
1037            scope: gic
1038
1039            subsections:
1040              - title: GICv5
1041                scope: gicv5
1042
1043              - title: GICv3
1044                scope: gicv3
1045
1046                deprecated:
1047                  - gicv3/multichip
1048
1049                subsections:
1050                  - title: GIC-600
1051                    scope: gic600
1052
1053                  - title: GIC-600AE
1054                    scope: gic600ae
1055
1056              - title: GICv2
1057                scope: gicv2
1058
1059          - title: SMMU
1060            scope: smmu
1061
1062          - title: MHU
1063            scope: mhu
1064
1065            deprecated:
1066              - drivers/arm/mhu
1067
1068          - title: RSE
1069            scope: rse
1070
1071            deprecated:
1072              - drivers/arm/rss
1073              - rss
1074
1075          - title: TZC
1076            scope: tzc
1077
1078            subsections:
1079              - title: TZC-400
1080                scope: tzc400
1081
1082                deprecated:
1083                  - drivers/tzc400
1084
1085              - title: TZC-380
1086                scope: tzc380
1087
1088                deprecated:
1089                  - drivers/tzc380
1090
1091          - title: SBSA
1092            scope: sbsa
1093
1094      - title: Marvell
1095        scope: marvell-drivers
1096
1097        subsections:
1098          - title: COMPHY
1099            scope: marvell-comphy
1100
1101            deprecated:
1102              - drivers/marvell/comphy
1103
1104            subsections:
1105              - title: Armada 3700
1106                scope: marvell-comphy-3700
1107
1108                deprecated:
1109                  - drivers/marvell/comphy-3700
1110
1111              - title: CP110
1112                scope: marvell-comphy-cp110
1113
1114                deprecated:
1115                  - drivers/marvell/comphy-cp110
1116
1117          - title: UART
1118            scope: marvell-uart
1119
1120            deprecated:
1121              - plat/marvell/uart
1122
1123          - title: Armada
1124            scope: armada-drivers
1125
1126            subsections:
1127              - title: A3K
1128                scope: a3k-drivers
1129
1130                subsections:
1131                  - title: A3720
1132                    scope: a3720-uart
1133
1134                    deprecated:
1135                      - plat/marvell/a3720/uart
1136
1137      - title: MediaTek
1138        scope: mediatek-drivers
1139
1140        subsections:
1141          - title: APU
1142            scope: mediatek-apu
1143
1144            deprecated:
1145              - plat/mediatek/apu
1146
1147          - title: EMI MPU
1148            scope: mediatek-emi-mpu
1149
1150            deprecated:
1151              - plat/mediatek/mpu
1152
1153          - title: PMIC Wrapper
1154            scope: mediatek-pmic-wrapper
1155
1156            deprecated:
1157              - plat/mediatek/pmic_wrap
1158
1159          - title: MT8192
1160            scope: mt8192-drivers
1161
1162            subsections:
1163              - title: SPM
1164                scope: mt8192-spm
1165
1166                deprecated:
1167                  - mediatek/mt8192/spm
1168
1169      - title: NXP
1170        scope: nxp-drivers
1171
1172        subsections:
1173          - title: DCFG
1174            scope: nxp-dcfg
1175
1176            deprecated:
1177              - driver/nxp/dcfg
1178
1179          - title: FLEXSPI
1180            scope: flexspi
1181
1182            deprecated:
1183              - include/drivers/flexspi
1184              - driver/nxp/xspi
1185
1186          - title: SCFG
1187            scope: nxp-scfg
1188
1189            deprecated:
1190              - nxp/scfg
1191
1192          - title: SFP
1193            scope: nxp-sfp
1194
1195            deprecated:
1196              - drivers/nxp/sfp
1197
1198          - title: QSPI
1199            scope: nxp-qspi
1200
1201          - title: NXP Crypto
1202            scope: nxp-crypto
1203
1204          - title: DDR
1205            scope: nxp-ddr
1206
1207          - title: GIC
1208            scope: nxp-gic
1209
1210          - title: CSU
1211            scope: nxp-csu
1212
1213          - title: IFC NAND
1214            scope: nxp-ifc-nand
1215
1216          - title: IFC NOR
1217            scope: nxp-ifc-nor
1218
1219          - title: TZC-380
1220            scope: nxp-tzc380
1221
1222          - title: TRDC
1223            scope: imx-trdc
1224
1225          - title: Clock
1226            scope: nxp-clk
1227
1228          - title: uSDHC
1229            scope: nxp-mmc
1230
1231      - title: Renesas
1232        scope: renesas-drivers
1233
1234        subsections:
1235          - title: R-Car3
1236            scope: rcar3-drivers
1237
1238            deprecated:
1239              - drivers/rcar3
1240
1241      - title: ST
1242        scope: st-drivers
1243
1244        deprecated:
1245          - drivers/st
1246
1247        subsections:
1248          - title: BSEC
1249            scope: st-bsec
1250
1251          - title: Clock
1252            scope: st-clock
1253
1254            deprecated:
1255              - stm32mp_clk
1256              - drivers/st/clk
1257              - stm32mp1_clk
1258
1259          - title: Crypto
1260            scope: st-crypto
1261
1262          - title: DDR
1263            scope: st-ddr
1264
1265          - title: I/O
1266            scope: st-io-drivers
1267
1268            subsections:
1269              - title: STM32 Image
1270                scope: st-io-stm32image
1271
1272                deprecated:
1273                  - io-stm32image
1274                  - io_stm32image
1275
1276          - title: I2C
1277            scope: st-i2c
1278
1279          - title: FMC
1280            scope: st-fmc
1281
1282          - title: GPIO
1283            scope: st-gpio
1284
1285          - title: SDMMC2
1286            scope: st-sdmmc2
1287
1288            deprecated:
1289              - stm32_sdmmc2
1290
1291          - title: ST PMIC
1292            scope: st-pmic
1293
1294            deprecated:
1295              - drivers/st/pmic
1296
1297          - title: STPMIC1
1298            scope: stpmic1
1299
1300          - title: Regulator
1301            scope: st-regulator
1302
1303          - title: Reset
1304            scope: st-reset
1305
1306          - title: SPI
1307            scope: st-spi
1308
1309          - title: UART
1310            scope: st-uart
1311
1312            subsections:
1313              - title: STM32 Console
1314                scope: stm32-console
1315
1316                deprecated:
1317                  - stm32_console
1318
1319          - title: USB
1320            scope: st-usb
1321
1322            deprecated:
1323              - drivers/st/usb
1324
1325          - title: Watchdog
1326            scope: st-iwdg
1327
1328      - title: USB
1329        scope: usb
1330
1331        deprecated:
1332          - drivers/usb
1333
1334  - title: Miscellaneous
1335
1336    subsections:
1337      - title: AArch64
1338        scope: aarch64
1339
1340      - title: AArch32
1341        scope: aarch32
1342
1343      - title: Debug
1344        scope: debug
1345
1346        deprecated:
1347          - common/debug
1348
1349      - title: CRC32
1350        scope: crc32
1351
1352        subsections:
1353          - title: Hardware CRC32
1354            scope: hw-crc32
1355
1356            deprecated:
1357              - hw_crc
1358              - hw_crc32
1359
1360          - title: Software CRC32
1361            scope: sw-crc32
1362
1363            deprecated:
1364              - sw_crc32
1365
1366      - title: DT Bindings
1367        scope: dt-bindings
1368
1369      - title: FDT Wrappers
1370        scope: fdt-wrappers
1371
1372      - title: FDTs
1373        scope: fdts
1374
1375        deprecated:
1376          - fdt
1377
1378        subsections:
1379          - title: Arm
1380
1381            subsections:
1382              - title: Morello
1383                scope: morello-fdts
1384
1385                deprecated:
1386                  - fdts/morello
1387
1388          - title: ST
1389
1390            subsections:
1391              - title: STM32MP1
1392                scope: stm32mp1-fdts
1393
1394                deprecated:
1395                - fdts stm32mp1
1396
1397                subsections:
1398                  - title: STM32MP13
1399                    scope: stm32mp13-fdts
1400
1401                  - title: STM32MP15
1402                    scope: stm32mp15-fdts
1403
1404              - title: STM32MP2
1405                scope: stm32mp2-fdts
1406
1407                subsections:
1408                  - title: STM32MP21
1409                    scope: stm32mp21-fdts
1410
1411                  - title: STM32MP23
1412                    scope: stm32mp23-fdts
1413
1414                  - title: STM32MP25
1415                    scope: stm32mp25-fdts
1416
1417      - title: PIE
1418        scope: pie
1419
1420      - title: PIE/POR
1421        scope: pie/por
1422
1423      - title: Security
1424        scope: security
1425
1426      - title: SDEI
1427        scope: sdei
1428
1429      - title: TBBR
1430        scope: tbbr
1431
1432      - title: NXP
1433
1434        subsections:
1435          - title: OCRAM
1436            scope: nxp-ocram
1437
1438            deprecated:
1439              - nxp/common/ocram
1440
1441          - title: PSCI
1442            scope: nxp-psci
1443
1444            deprecated:
1445              - plat/nxp/common/psci
1446
1447      - title: UUID
1448        scope: uuid
1449
1450  - title: Documentation
1451    scope: docs
1452
1453    deprecated:
1454      - doc
1455
1456    subsections:
1457      - title: Changelog
1458        scope: changelog
1459
1460      - title: Commit Style
1461        scope: commit-style
1462
1463      - title: Contribution Guidelines
1464        scope: contributing
1465
1466        deprecated:
1467          - contribution-guidelines
1468          - docs-contributing.rst
1469
1470      - title: Maintainers
1471        scope: maintainers
1472
1473      - title: Prerequisites
1474        scope: prerequisites
1475
1476      - title: Threat Model
1477        scope: threat-model
1478
1479      - title: Porting Guide
1480        scope: porting
1481
1482  - title: Build System
1483    scope: build
1484
1485    deprecated:
1486      - makefile
1487      - Makefile
1488
1489    subsections:
1490      - title: Git Hooks
1491        scope: hooks
1492
1493        deprecated:
1494          - git-hooks
1495
1496      - title: Visual Studio Code
1497        scope: vscode
1498
1499  - title: Tools
1500    scope: tools
1501
1502    subsections:
1503      - title: Clang-Format
1504        scope: clang-format
1505
1506      - title: Dependabot
1507        scope: dependabot
1508
1509      - title: STM32 Image
1510        scope: stm32image
1511
1512        deprecated:
1513          - tools/stm32image
1514
1515      - title: NXP Tools
1516        scope: nxp-tools
1517
1518      - title: Firmware Image Package Tool
1519        scope: fiptool
1520
1521      - title: Secure Partition Tool
1522        scope: sptool
1523
1524      - title: Certificate Creation Tool
1525        scope: cert-create
1526
1527      - title: Firmware Encryption Tool
1528        scope: encrypt-fw
1529
1530      - title: Memory Mapping Tool
1531        scope: memmap
1532
1533        deprecated:
1534          - cert_create
1535
1536      - title: Marvell Tools
1537        scope: marvell-tools
1538
1539      - title: Renesas Tools
1540        scope: renesas-tools
1541
1542        subsections:
1543          - title: R-Car Layout Tool
1544            scope: rcar-layout
1545
1546          - title: R/ZG Layout Tool
1547            scope: rzg-layout
1548
1549      - title: Chain of Trust device tree to C source file
1550        scope: cot-dt2c
1551
1552  - title: Dependencies
1553    scope: deps
1554
1555    subsections:
1556      - title: checkpatch
1557        scope: checkpatch
1558
1559      - title: commitlint
1560        scope: commitlint
1561
1562      - title: Compiler runtime libraries
1563        scope: compiler-rt
1564
1565      - title: Development dependencies
1566        scope: dev-deps
1567
1568      - title: libfdt
1569        scope: libfdt
1570
1571      - title: Node Package Manager (NPM)
1572        scope: npm
1573
1574      - title: Poetry
1575        scope: poetry
1576
1577      - title: zlib
1578        scope: zlib
1579