Skip to contentSkip to conversation

Low Power Mode: Package TIFS Stub in BeaglePlay

PATCH Superseded Dhruva Gole 1 participant 7 messages Jul 4, 2024 Arm (32-bit)

v4 of 8 Superseded Latest is v8 →

lore
Share & tools
lore
#0 lore raw

v4 cover Low Power Mode: Package TIFS Stub in BeaglePlay

This series includes the binman related changes required to package TIFS Stub to support Low Power Modes on BeaglePlay.
It also documents the boot flow and tispl packaging details regarding the same.

Changelog:
* Add more documentation around TIFS Stub for AM62, 62A and 62P
* Fix documentation formatting errors.
* Add entry to MAINTAINERS for doc/board/ti

Link to previous series:
https://lore.kernel.org/u-boot/[email protected]/

Dhruva Gole (6):
arm: dts: k3-am625-beagleplay: Package TIFS Stub
doc: beagle: am62x_beagleplay: Update the boot flow to show TIFS Stub
doc: beagle: am62x_beagleplay: Add TIFS Stub in image format
doc: ti: k3: Add TIFS Stub documentation
doc: ti: am62*: Mention TIFS Stub in img fmts and boot flow
MAINTAINERS: Include the TI docs under ARM TI

 MAINTAINERS                                  |    1 +
 arch/arm/dts/k3-am625-beagleplay-u-boot.dtsi |   33 +-
 doc/board/beagle/am62x_beagleplay.rst        |    4 +-
 doc/board/ti/am62ax_sk.rst                   |    4 +-
 doc/board/ti/am62px_sk.rst                   |    4 +-
 doc/board/ti/am62x_sk.rst                    |    4 +-
 doc/board/ti/img/boot_diagram_am62.svg       | 1983 ++++++++++++++++++
 doc/board/ti/img/tifsstub_dm_tispl.bin.svg   |  353 ++++
 doc/board/ti/k3.rst                          |    5 +
 9 files changed, 2382 insertions(+), 9 deletions(-)
 create mode 100644 doc/board/ti/img/boot_diagram_am62.svg
 create mode 100644 doc/board/ti/img/tifsstub_dm_tispl.bin.svg

base-commit: 0f073e022ddc5070e5df1d053e4bdc1874fbcc0f

Signature · 1 line
2.34.1
#1 lore raw

PATCH v4 1/6 arm: dts: k3-am625-beagleplay: Package TIFS Stub

Add support for packaging the TIFS Stub as it's required for basic Low Power Modes like Deep Sleep.

---
 arch/arm/dts/k3-am625-beagleplay-u-boot.dtsi | 33 +++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)
arch/arm/dts/k3-am625-beagleplay-u-boot.dtsi +32 -1
index 467cac68d0f6..a067b0ba3543 100644
@@ -78,6 +78,23 @@
 		};
 	};
 
+	tifsstub-gp {
+		filename = "tifsstub.bin_gp";
+		ti-secure-rom {
+			content = <&tifsstub_gp>;
+			core = "secure";
+			load = <0x60000>;
+			sw-rev = <CONFIG_K3_X509_SWRV>;
+			keyfile = "ti-degenerate-key.pem";
+			tifsstub;
+		};
+		tifsstub_gp: tifsstub-gp.bin {
+			filename = "ti-sysfw/ti-fs-stub-firmware-am62x-gp.bin";
+			type = "blob-ext";
+			optional;
+		};
+	};
+
 	ti-spl_unsigned {
 		filename = "tispl.bin_unsigned";
 		symlink = "tispl.bin";
@@ -115,6 +132,19 @@
 					};
 				};
 
+				tifsstub-gp {
+					description = "tifsstub";
+					type = "firmware";
+					arch = "arm32";
+					compression = "none";
+					os = "tifsstub-gp";
+					load = <0x9dc00000>;
+					entry = <0x9dc00000>;
+					blob-ext {
+						filename = "tifsstub.bin_gp";
+					};
+				};
+
 				dm {
 					description = "DM binary";
 					type = "firmware";
@@ -158,7 +188,8 @@
 				conf-0 {
 					description = "k3-am625-beagleplay";
 					firmware = "atf";
-					loadables = "tee", "dm", "spl";
+					loadables = "tee", "dm", "spl",
+					"tifsstub-gp";
 					fdt = "fdt-0";
 				};
 			};
Signature · 1 line
2.34.1
#2 lore raw

PATCH v4 2/6 doc: beagle: am62x_beagleplay: Update the boot flow to show TIFS Stub

In reply to Dhruva Gole

Add the AM62x boot flow to show at which point the TIFS Stub actually gets loaded.

---
 doc/board/beagle/am62x_beagleplay.rst  |    2 +-
 doc/board/ti/img/boot_diagram_am62.svg | 1983 ++++++++++++++++++++++++
 2 files changed, 1984 insertions(+), 1 deletion(-)
 create mode 100644 doc/board/ti/img/boot_diagram_am62.svg
doc/board/beagle/am62x_beagleplay.rst +1 -1
index 01f04beb55aa..375f26fc5f3e 100644
@@ -23,7 +23,7 @@ Boot Flow:
 ----------
 Below is the pictorial representation of boot flow:
 
-.. image:: ../ti/img/boot_diagram_k3_current.svg
+.. image:: ../ti/img/boot_diagram_am62.svg
   :alt: Boot flow diagram
 
 - On this platform, 'TI Foundational Security' (TIFS) functions as the
doc/board/ti/img/boot_diagram_am62.svg new file +1983 -0

1,983 lines not on this page · raw message

Signature · 1 line
2.34.1
#3 lore raw

PATCH v4 3/6 doc: beagle: am62x_beagleplay: Add TIFS Stub in image format

In reply to Dhruva Gole

Mention the TIFS Stub in the TISP image format

---
 doc/board/beagle/am62x_beagleplay.rst      |   2 +-
 doc/board/ti/img/tifsstub_dm_tispl.bin.svg | 353 +++++++++++++++++++++
 2 files changed, 354 insertions(+), 1 deletion(-)
 create mode 100644 doc/board/ti/img/tifsstub_dm_tispl.bin.svg
doc/board/beagle/am62x_beagleplay.rst +1 -1
index 375f26fc5f3e..e7347610173e 100644
@@ -86,7 +86,7 @@ Image formats
 
 - tispl.bin
 
-.. image:: ../ti/img/dm_tispl.bin.svg
+.. image:: ../ti/img/tifsstub_dm_tispl.bin.svg
   :alt: tispl.bin image format
 
 Additional hardware for U-Boot development
doc/board/ti/img/tifsstub_dm_tispl.bin.svg new file +353 -0

353 lines not on this page · raw message

Signature · 1 line
2.34.1
#4 lore raw

PATCH v4 4/6 doc: ti: k3: Add TIFS Stub documentation

In reply to Dhruva Gole

Add documentation to briefly explain the role of TIFS Stub in relevant K3 SoC's.

---
 doc/board/ti/k3.rst | 5 +++++
 1 file changed, 5 insertions(+)
doc/board/ti/k3.rst +5 -0
index 67b066a07d3a..2f63852b3801 100644
@@ -193,6 +193,11 @@ online
     device resources such as power, clock, interrupts, dma etc. This firmware
     runs on a dedicated or multi-use microcontroller outside the security
     enclave.
+  * **TIFS Stub** - A small piece of code that helps restore the remaining
+    context and resume the TIFS firmware when resuming from Low Power Modes
+    like Suspend-to-RAM/ Deep Sleep. It is loaded into the ATCM (Tightly
+    Coupled Memory 'A' of the DM R5) during DM startup. This applies only
+    to AM62x, AM62A and AM62P based devices.
 
  OR
 
Signature · 1 line
2.34.1
#5 lore raw

PATCH v4 5/6 doc: ti: am62*: Mention TIFS Stub in img fmts and boot flow

In reply to Dhruva Gole

Since AM62x, AM62P and AM62A all use similar boot flows and their low power mode s/w ARCH is also similar in the way that they make use of the TIFS Stub, update their documentation to show where TIFS Stub is.

---
 doc/board/ti/am62ax_sk.rst | 4 ++--
 doc/board/ti/am62px_sk.rst | 4 ++--
 doc/board/ti/am62x_sk.rst  | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)
doc/board/ti/am62ax_sk.rst +2 -2
index 60726b6652ce..92da6f65f9d5 100644
@@ -47,7 +47,7 @@ Boot Flow:
 ----------
 Below is the pictorial representation of boot flow:
 
-.. image:: img/boot_diagram_k3_current.svg
+.. image:: img/boot_diagram_am62.svg
   :alt: Boot flow diagram
 
 - Here TIFS acts as master and provides all the critical services. R5/A53
@@ -144,7 +144,7 @@ Image formats:
 
 - tispl.bin
 
-.. image:: img/dm_tispl.bin.svg
+.. image:: img/tifsstub_dm_tispl.bin.svg
   :alt: tispl.bin image format
 
 Switch Setting for Boot Mode
doc/board/ti/am62px_sk.rst +2 -2
index c80b50681176..3396aae471c6 100644
@@ -55,7 +55,7 @@ Boot Flow:
 The bootflow is exactly the same as all SoCs in the am62xxx extended SoC
 family. Below is the pictorial representation:
 
-.. image:: img/boot_diagram_k3_current.svg
+.. image:: img/boot_diagram_am62.svg
   :alt: Boot flow diagram
 
 - Here TIFS acts as master and provides all the critical services. R5/A53
@@ -153,7 +153,7 @@ Image formats:
 
 - tispl.bin
 
-.. image:: img/dm_tispl.bin.svg
+.. image:: img/tifsstub_dm_tispl.bin.svg
   :alt: tispl.bin image format
 
 OSPI:
doc/board/ti/am62x_sk.rst +2 -2
index 2a25e84f6c97..68ddd2ac94ff 100644
@@ -46,7 +46,7 @@ Boot Flow:
 ----------
 Below is the pictorial representation of boot flow:
 
-.. image:: img/boot_diagram_k3_current.svg
+.. image:: img/boot_diagram_am62.svg
   :alt: Boot flow diagram
 
 - Here TIFS acts as master and provides all the critical services. R5/A53
@@ -161,7 +161,7 @@ Image formats:
 
 - tispl.bin
 
-.. image:: img/dm_tispl.bin.svg
+.. image:: img/tifsstub_dm_tispl.bin.svg
   :alt: tispl.bin image format
 
 OSPI:
Signature · 1 line
2.34.1
#6 lore raw

PATCH v4 6/6 MAINTAINERS: Include the TI docs under ARM TI

In reply to Dhruva Gole

Add entry for the TI boards documentation under ARM TI

---
 MAINTAINERS | 1 +
 1 file changed, 1 insertion(+)
MAINTAINERS +1 -0
index 6b32a6d94644..da730c6e4840 100644
@@ -733,6 +733,7 @@ F:	arch/arm/mach-omap2/
 F:	arch/arm/include/asm/arch-omap*/
 F:	arch/arm/include/asm/ti-common/
 F:	board/ti/
+F:	doc/board/ti/
 F:	drivers/dma/ti*
 F:	drivers/dma/ti*/
 F:	drivers/firmware/ti_sci.*
Signature · 1 line
2.34.1