Skip to contentSkip to conversation

zynqmp: restore the jtag interface

PATCH In review Jorge Ramirez-Ortiz 2 participants 5 messages Jul 16, 2021 – Aug 27, 2021

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 zynqmp: restore the jtag interface

As a security feature, if boot.bin was configured for secure boot the CSU will disable the JTAG interface on all cases.

Some boards might rely on this interface for flashing to QSPI in which case those systems might end up bricked during development.

This commit attempts to restore the interface - if the CSU allows for it.

---
 arch/arm/mach-zynqmp/Kconfig                 |  9 ++++++++
 arch/arm/mach-zynqmp/include/mach/hardware.h | 23 +++++++++++++------
 board/xilinx/zynqmp/zynqmp.c                 | 24 ++++++++++++++++++++
 3 files changed, 49 insertions(+), 7 deletions(-)
arch/arm/mach-zynqmp/Kconfig +9 -0
index 39144d654e..1e551c0020 100644
@@ -149,6 +149,15 @@ config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED
 	  Overwrite bootmode selected via boot mode pins to tell SPL what should
 	  be the next boot device.
 
+config SPL_ZYNQMP_RESTORE_JTAG
+       bool "Restore JTAG"
+       depends on SPL
+       default n
+       help
+	 Booting SPL in secure mode causes the CSU to disable the JTAG interface
+	 even if no eFuses were burnt. This option restores the interface if
+	 possible.
+
 config ZYNQ_SDHCI_MAX_FREQ
 	default 200000000
 
arch/arm/mach-zynqmp/include/mach/hardware.h +16 -7
index 3776499070..58822e3f25 100644
@@ -42,17 +42,20 @@
 struct crlapb_regs {
 	u32 reserved0[36];
 	u32 cpu_r5_ctrl; /* 0x90 */
-	u32 reserved1[37];
+	u32 reserved1[7];
+	u32 dbg_lpd_ctrl; /* 0xB0 */
+	u32 reserved2[29];
 	u32 timestamp_ref_ctrl; /* 0x128 */
-	u32 reserved2[53];
+	u32 reserved3[53];
 	u32 boot_mode; /* 0x200 */
-	u32 reserved3_0[7];
+	u32 reserved4_0[7];
 	u32 reset_reason; /* 0x220 */
-	u32 reserved3_1[6];
+	u32 reserved4_1[6];
 	u32 rst_lpd_top; /* 0x23C */
-	u32 reserved4[4];
+	u32 rst_lpd_dbg; /* 0x240 */
+	u32 reserved5[3];
 	u32 boot_pin_ctrl; /* 0x250 */
-	u32 reserved5[21];
+	u32 reserved6[21];
 };
 
 #define crlapb_base ((struct crlapb_regs *)ZYNQMP_CRL_APB_BASEADDR)
@@ -141,9 +144,15 @@ struct apu_regs {
 struct csu_regs {
 	u32 reserved0[4];
 	u32 multi_boot;
-	u32 reserved1[11];
+	u32 reserved1[7];
+	u32 jtag_chain_status_wr;
+	u32 jtag_chain_status;
+	u32 jtag_sec;
+	u32 jtag_dap_cfg;
 	u32 idcode;
 	u32 version;
+	u32 reserved2[3055];
+	u32 pcap_prog;
 };
 
 #define csu_base ((struct csu_regs *)ZYNQMP_CSU_BASEADDR)
board/xilinx/zynqmp/zynqmp.c +24 -0
index 1748fec2e4..feffda54e7 100644
@@ -355,6 +355,25 @@ static int multi_boot(void)
 	return 0;
 }
 
+#if defined(CONFIG_SPL_BUILD) && defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+static void restore_jtag(void)
+{
+	const u32 disable_security_gate = 0xff;
+	const u32 setup_clock = 0x01002002;
+	const u32 setup_jtag = 0x3;
+	const u32 release_pl = 0x1;
+	const u32 enable_debug = 0xff;
+	const u32 do_reset = 0x0;
+
+	writel(disable_security_gate, &csu_base->jtag_sec);
+	writel(enable_debug, &csu_base->jtag_dap_cfg);
+	writel(setup_jtag, &csu_base->jtag_chain_status_wr);
+	writel(setup_clock, &crlapb_base->dbg_lpd_ctrl);
+	writel(do_reset, &crlapb_base->rst_lpd_dbg);
+	writel(release_pl, &csu_base->pcap_prog);
+}
+#endif
+
 #define PS_SYSMON_ANALOG_BUS_VAL	0x3210
 #define PS_SYSMON_ANALOG_BUS_REG	0xFFA50914
 
@@ -374,6 +393,11 @@ int board_init(void)
 		zynqmp_pmufw_load_config_object(zynqmp_pm_cfg_obj,
 						zynqmp_pm_cfg_obj_size);
 	printf("Silicon version:\t%d\n", zynqmp_get_silicon_version());
+
+#if defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+	/* the CSU disables the JTAG interface when secure boot is enabled */
+	restore_jtag();
+#endif
 #else
 	if (CONFIG_IS_ENABLED(DM_I2C) && CONFIG_IS_ENABLED(I2C_EEPROM))
 		xilinx_read_eeprom();
Signature · 1 line
2.31.1
#1 lore raw

On 16/07/21, Jorge Ramirez-Ortiz wrote:

reminder

Quoted 128 lines

As a security feature, if boot.bin was configured for secure boot the CSU will disable the JTAG interface on all cases.

Some boards might rely on this interface for flashing to QSPI in which case those systems might end up bricked during development.

This commit attempts to restore the interface - if the CSU allows for it.

---
 arch/arm/mach-zynqmp/Kconfig                 |  9 ++++++++
 arch/arm/mach-zynqmp/include/mach/hardware.h | 23 +++++++++++++------
 board/xilinx/zynqmp/zynqmp.c                 | 24 ++++++++++++++++++++
 3 files changed, 49 insertions(+), 7 deletions(-)
arch/arm/mach-zynqmp/Kconfig +9 -0
index 39144d654e..1e551c0020 100644
@@ -149,6 +149,15 @@ config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED
 	  Overwrite bootmode selected via boot mode pins to tell SPL what should
 	  be the next boot device.
 
+config SPL_ZYNQMP_RESTORE_JTAG
+       bool "Restore JTAG"
+       depends on SPL
+       default n
+       help
+	 Booting SPL in secure mode causes the CSU to disable the JTAG interface
+	 even if no eFuses were burnt. This option restores the interface if
+	 possible.
+
 config ZYNQ_SDHCI_MAX_FREQ
 	default 200000000
 
arch/arm/mach-zynqmp/include/mach/hardware.h +16 -7
index 3776499070..58822e3f25 100644
@@ -42,17 +42,20 @@
 struct crlapb_regs {
 	u32 reserved0[36];
 	u32 cpu_r5_ctrl; /* 0x90 */
-	u32 reserved1[37];
+	u32 reserved1[7];
+	u32 dbg_lpd_ctrl; /* 0xB0 */
+	u32 reserved2[29];
 	u32 timestamp_ref_ctrl; /* 0x128 */
-	u32 reserved2[53];
+	u32 reserved3[53];
 	u32 boot_mode; /* 0x200 */
-	u32 reserved3_0[7];
+	u32 reserved4_0[7];
 	u32 reset_reason; /* 0x220 */
-	u32 reserved3_1[6];
+	u32 reserved4_1[6];
 	u32 rst_lpd_top; /* 0x23C */
-	u32 reserved4[4];
+	u32 rst_lpd_dbg; /* 0x240 */
+	u32 reserved5[3];
 	u32 boot_pin_ctrl; /* 0x250 */
-	u32 reserved5[21];
+	u32 reserved6[21];
 };
 
 #define crlapb_base ((struct crlapb_regs *)ZYNQMP_CRL_APB_BASEADDR)
@@ -141,9 +144,15 @@ struct apu_regs {
 struct csu_regs {
 	u32 reserved0[4];
 	u32 multi_boot;
-	u32 reserved1[11];
+	u32 reserved1[7];
+	u32 jtag_chain_status_wr;
+	u32 jtag_chain_status;
+	u32 jtag_sec;
+	u32 jtag_dap_cfg;
 	u32 idcode;
 	u32 version;
+	u32 reserved2[3055];
+	u32 pcap_prog;
 };
 
 #define csu_base ((struct csu_regs *)ZYNQMP_CSU_BASEADDR)
board/xilinx/zynqmp/zynqmp.c +24 -0
index 1748fec2e4..feffda54e7 100644
@@ -355,6 +355,25 @@ static int multi_boot(void)
 	return 0;
 }
 
+#if defined(CONFIG_SPL_BUILD) && defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+static void restore_jtag(void)
+{
+	const u32 disable_security_gate = 0xff;
+	const u32 setup_clock = 0x01002002;
+	const u32 setup_jtag = 0x3;
+	const u32 release_pl = 0x1;
+	const u32 enable_debug = 0xff;
+	const u32 do_reset = 0x0;
+
+	writel(disable_security_gate, &csu_base->jtag_sec);
+	writel(enable_debug, &csu_base->jtag_dap_cfg);
+	writel(setup_jtag, &csu_base->jtag_chain_status_wr);
+	writel(setup_clock, &crlapb_base->dbg_lpd_ctrl);
+	writel(do_reset, &crlapb_base->rst_lpd_dbg);
+	writel(release_pl, &csu_base->pcap_prog);
+}
+#endif
+
 #define PS_SYSMON_ANALOG_BUS_VAL	0x3210
 #define PS_SYSMON_ANALOG_BUS_REG	0xFFA50914
 
@@ -374,6 +393,11 @@ int board_init(void)
 		zynqmp_pmufw_load_config_object(zynqmp_pm_cfg_obj,
 						zynqmp_pm_cfg_obj_size);
 	printf("Silicon version:\t%d\n", zynqmp_get_silicon_version());
+
+#if defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+	/* the CSU disables the JTAG interface when secure boot is enabled */
+	restore_jtag();
+#endif
 #else
 	if (CONFIG_IS_ENABLED(DM_I2C) && CONFIG_IS_ENABLED(I2C_EEPROM))
 		xilinx_read_eeprom();
Signature · 1 line
2.31.1
#2 lore raw
In reply to Jorge Ramirez-Ortiz
Quoted 7 lines · Jorge Ramirez-Ortiz

As a security feature, if boot.bin was configured for secure boot the CSU will disable the JTAG interface on all cases.

Some boards might rely on this interface for flashing to QSPI in which case those systems might end up bricked during development.

This commit attempts to restore the interface - if the CSU allows for it.

sorry I missed this.

Quoted 13 lines
---
 arch/arm/mach-zynqmp/Kconfig                 |  9 ++++++++
 arch/arm/mach-zynqmp/include/mach/hardware.h | 23 +++++++++++++------
 board/xilinx/zynqmp/zynqmp.c                 | 24 ++++++++++++++++++++
 3 files changed, 49 insertions(+), 7 deletions(-)
arch/arm/mach-zynqmp/Kconfig +0 -0
index 39144d654e..1e551c0020 100644

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 155

Quoted 7 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
@@ -149,6 +149,15 @@ config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED
 	  Overwrite bootmode selected via boot mode pins to tell SPL what should
 	  be the next boot device.
 
+config SPL_ZYNQMP_RESTORE_JTAG
+       bool "Restore JTAG"
+       depends on SPL
+       default n

no need for default n - that's default option anyway.

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 159

Quoted 4 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
+       help
+	 Booting SPL in secure mode causes the CSU to disable the JTAG interface
+	 even if no eFuses were burnt. This option restores the interface if
+	 possible.

Indentation is weird. Please look at tabs/spaces.

Quoted 59 lines
arch/arm/mach-zynqmp/Kconfig +1 -0
+
 config ZYNQ_SDHCI_MAX_FREQ
 	default 200000000
 
arch/arm/mach-zynqmp/include/mach/hardware.h +16 -7
index 3776499070..58822e3f25 100644
@@ -42,17 +42,20 @@
 struct crlapb_regs {
 	u32 reserved0[36];
 	u32 cpu_r5_ctrl; /* 0x90 */
-	u32 reserved1[37];
+	u32 reserved1[7];
+	u32 dbg_lpd_ctrl; /* 0xB0 */
+	u32 reserved2[29];
 	u32 timestamp_ref_ctrl; /* 0x128 */
-	u32 reserved2[53];
+	u32 reserved3[53];
 	u32 boot_mode; /* 0x200 */
-	u32 reserved3_0[7];
+	u32 reserved4_0[7];
 	u32 reset_reason; /* 0x220 */
-	u32 reserved3_1[6];
+	u32 reserved4_1[6];
 	u32 rst_lpd_top; /* 0x23C */
-	u32 reserved4[4];
+	u32 rst_lpd_dbg; /* 0x240 */
+	u32 reserved5[3];
 	u32 boot_pin_ctrl; /* 0x250 */
-	u32 reserved5[21];
+	u32 reserved6[21];
 };
 
 #define crlapb_base ((struct crlapb_regs *)ZYNQMP_CRL_APB_BASEADDR)
@@ -141,9 +144,15 @@ struct apu_regs {
 struct csu_regs {
 	u32 reserved0[4];
 	u32 multi_boot;
-	u32 reserved1[11];
+	u32 reserved1[7];
+	u32 jtag_chain_status_wr;
+	u32 jtag_chain_status;
+	u32 jtag_sec;
+	u32 jtag_dap_cfg;
 	u32 idcode;
 	u32 version;
+	u32 reserved2[3055];
+	u32 pcap_prog;
 };
 
 #define csu_base ((struct csu_regs *)ZYNQMP_CSU_BASEADDR)
board/xilinx/zynqmp/zynqmp.c +0 -0
index 1748fec2e4..feffda54e7 100644
@@ -355,6 +355,25 @@ static int multi_boot(void)
 	return 0;
 }

board/xilinx/zynqmp/zynqmp.c static int multi_boot(void) · line 366

Quoted 10 lines
board/xilinx/zynqmp/zynqmp.c +9 -0
 
+#if defined(CONFIG_SPL_BUILD) && defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+static void restore_jtag(void)
+{
+	const u32 disable_security_gate = 0xff;
+	const u32 setup_clock = 0x01002002;
+	const u32 setup_jtag = 0x3;
+	const u32 release_pl = 0x1;
+	const u32 enable_debug = 0xff;
+	const u32 do_reset = 0x0;

All above should be just macros. Please put them to hardware.h

Quoted 14 lines
board/xilinx/zynqmp/zynqmp.c +10 -0
+
+	writel(disable_security_gate, &csu_base->jtag_sec);
+	writel(enable_debug, &csu_base->jtag_dap_cfg);
+	writel(setup_jtag, &csu_base->jtag_chain_status_wr);
+	writel(setup_clock, &crlapb_base->dbg_lpd_ctrl);
+	writel(do_reset, &crlapb_base->rst_lpd_dbg);
+	writel(release_pl, &csu_base->pcap_prog);
+}
+#endif
+
 #define PS_SYSMON_ANALOG_BUS_VAL	0x3210
 #define PS_SYSMON_ANALOG_BUS_REG	0xFFA50914
 

board/xilinx/zynqmp/zynqmp.c int board_init(void) · line 400

Quoted 8 lines
board/xilinx/zynqmp/zynqmp.c +5 -0
@@ -374,6 +393,11 @@ int board_init(void)
 		zynqmp_pmufw_load_config_object(zynqmp_pm_cfg_obj,
 						zynqmp_pm_cfg_obj_size);
 	printf("Silicon version:\t%d\n", zynqmp_get_silicon_version());
+
+#if defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+	/* the CSU disables the JTAG interface when secure boot is enabled */
+	restore_jtag();
+#endif

As checkpatch suggests
WARNING: Use 'if (IS_ENABLED(CONFIG...))' instead of '#if or #ifdef' where possible

board/xilinx/zynqmp/zynqmp.c int board_init(void) · line 403

Quoted 4 lines
board/xilinx/zynqmp/zynqmp.c +0 -0
 #else
 	if (CONFIG_IS_ENABLED(DM_I2C) && CONFIG_IS_ENABLED(I2C_EEPROM))
 		xilinx_read_eeprom();

Thanks,
Michal

Signature · 5 lines
Michal Simek, Ing. (M.Eng), OpenPGP -> KeyID: FE3D1F91
w: www.monstr.eu p: +42-0-721842854
Maintainer of Linux kernel - Xilinx Microblaze
Maintainer of Linux kernel - Xilinx Zynq ARM and ZynqMP ARM64 SoCs
U-Boot custodian - Xilinx Microblaze/Zynq/ZynqMP/Versal SoCs
#3 lore raw
Quoted 29 lines · Michal Simek
Quoted 7 lines · Jorge Ramirez-Ortiz

As a security feature, if boot.bin was configured for secure boot the CSU will disable the JTAG interface on all cases.

Some boards might rely on this interface for flashing to QSPI in which case those systems might end up bricked during development.

This commit attempts to restore the interface - if the CSU allows for it.

sorry I missed this.

Quoted 16 lines
---
 arch/arm/mach-zynqmp/Kconfig                 |  9 ++++++++
 arch/arm/mach-zynqmp/include/mach/hardware.h | 23 +++++++++++++------
 board/xilinx/zynqmp/zynqmp.c                 | 24 ++++++++++++++++++++
 3 files changed, 49 insertions(+), 7 deletions(-)
arch/arm/mach-zynqmp/Kconfig +0 -0
index 39144d654e..1e551c0020 100644
@@ -149,6 +149,15 @@ config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED
 	  Overwrite bootmode selected via boot mode pins to tell SPL what should
 	  be the next boot device.
 
Quoted 6 lines

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 155

Quoted 4 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
+config SPL_ZYNQMP_RESTORE_JTAG
+       bool "Restore JTAG"
+       depends on SPL
+       default n

no need for default n - that's default option anyway.

ok

Quoted 7 lines

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 159

Quoted 5 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
+       help
+	 Booting SPL in secure mode causes the CSU to disable the JTAG interface
+	 even if no eFuses were burnt. This option restores the interface if
+	 possible.

Indentation is weird. Please look at tabs/spaces.

ok

Quoted 61 lines
Quoted 61 lines
arch/arm/mach-zynqmp/Kconfig +1 -0
+
 config ZYNQ_SDHCI_MAX_FREQ
 	default 200000000
 
arch/arm/mach-zynqmp/include/mach/hardware.h +16 -7
index 3776499070..58822e3f25 100644
@@ -42,17 +42,20 @@
 struct crlapb_regs {
 	u32 reserved0[36];
 	u32 cpu_r5_ctrl; /* 0x90 */
-	u32 reserved1[37];
+	u32 reserved1[7];
+	u32 dbg_lpd_ctrl; /* 0xB0 */
+	u32 reserved2[29];
 	u32 timestamp_ref_ctrl; /* 0x128 */
-	u32 reserved2[53];
+	u32 reserved3[53];
 	u32 boot_mode; /* 0x200 */
-	u32 reserved3_0[7];
+	u32 reserved4_0[7];
 	u32 reset_reason; /* 0x220 */
-	u32 reserved3_1[6];
+	u32 reserved4_1[6];
 	u32 rst_lpd_top; /* 0x23C */
-	u32 reserved4[4];
+	u32 rst_lpd_dbg; /* 0x240 */
+	u32 reserved5[3];
 	u32 boot_pin_ctrl; /* 0x250 */
-	u32 reserved5[21];
+	u32 reserved6[21];
 };
 
 #define crlapb_base ((struct crlapb_regs *)ZYNQMP_CRL_APB_BASEADDR)
@@ -141,9 +144,15 @@ struct apu_regs {
 struct csu_regs {
 	u32 reserved0[4];
 	u32 multi_boot;
-	u32 reserved1[11];
+	u32 reserved1[7];
+	u32 jtag_chain_status_wr;
+	u32 jtag_chain_status;
+	u32 jtag_sec;
+	u32 jtag_dap_cfg;
 	u32 idcode;
 	u32 version;
+	u32 reserved2[3055];
+	u32 pcap_prog;
 };
 
 #define csu_base ((struct csu_regs *)ZYNQMP_CSU_BASEADDR)
board/xilinx/zynqmp/zynqmp.c +0 -0
index 1748fec2e4..feffda54e7 100644
@@ -355,6 +355,25 @@ static int multi_boot(void)
 	return 0;
 }
 
Quoted 11 lines

board/xilinx/zynqmp/zynqmp.c static int multi_boot(void) · line 366

Quoted 9 lines
board/xilinx/zynqmp/zynqmp.c +9 -0
+#if defined(CONFIG_SPL_BUILD) && defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+static void restore_jtag(void)
+{
+	const u32 disable_security_gate = 0xff;
+	const u32 setup_clock = 0x01002002;
+	const u32 setup_jtag = 0x3;
+	const u32 release_pl = 0x1;
+	const u32 enable_debug = 0xff;
+	const u32 do_reset = 0x0;

All above should be just macros. Please put them to hardware.h

you mean something like #define CSU_SETUP_CLOCK 0x01002002? I dont really agree with that because we'll lose the context where it is being used (and the context is given by the restore jtag function) unless we do CSU_RESTORE_JTAG_SETUP_CLOCK ....
is this what you want?

Quoted 44 lines
Quoted 15 lines
board/xilinx/zynqmp/zynqmp.c +10 -0
+
+	writel(disable_security_gate, &csu_base->jtag_sec);
+	writel(enable_debug, &csu_base->jtag_dap_cfg);
+	writel(setup_jtag, &csu_base->jtag_chain_status_wr);
+	writel(setup_clock, &crlapb_base->dbg_lpd_ctrl);
+	writel(do_reset, &crlapb_base->rst_lpd_dbg);
+	writel(release_pl, &csu_base->pcap_prog);
+}
+#endif
+
 #define PS_SYSMON_ANALOG_BUS_VAL	0x3210
 #define PS_SYSMON_ANALOG_BUS_REG	0xFFA50914
 

board/xilinx/zynqmp/zynqmp.c int board_init(void) · line 400

Quoted 8 lines
board/xilinx/zynqmp/zynqmp.c +5 -0
@@ -374,6 +393,11 @@ int board_init(void)
 		zynqmp_pmufw_load_config_object(zynqmp_pm_cfg_obj,
 						zynqmp_pm_cfg_obj_size);
 	printf("Silicon version:\t%d\n", zynqmp_get_silicon_version());
+
+#if defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+	/* the CSU disables the JTAG interface when secure boot is enabled */
+	restore_jtag();
+#endif

As checkpatch suggests
WARNING: Use 'if (IS_ENABLED(CONFIG...))' instead of '#if or #ifdef' where possible

board/xilinx/zynqmp/zynqmp.c int board_init(void) · line 403

Quoted 4 lines
board/xilinx/zynqmp/zynqmp.c +0 -0
 #else
 	if (CONFIG_IS_ENABLED(DM_I2C) && CONFIG_IS_ENABLED(I2C_EEPROM))
 		xilinx_read_eeprom();

Thanks,
Michal

Signature · 5 lines
Michal Simek, Ing. (M.Eng), OpenPGP -> KeyID: FE3D1F91
w: www.monstr.eu p: +42-0-721842854
Maintainer of Linux kernel - Xilinx Microblaze
Maintainer of Linux kernel - Xilinx Zynq ARM and ZynqMP ARM64 SoCs
U-Boot custodian - Xilinx Microblaze/Zynq/ZynqMP/Versal SoCs
#4 lore raw
Quoted 122 lines · Foundries
Quoted 29 lines · Michal Simek
Quoted 7 lines · Jorge Ramirez-Ortiz

As a security feature, if boot.bin was configured for secure boot the CSU will disable the JTAG interface on all cases.

Some boards might rely on this interface for flashing to QSPI in which case those systems might end up bricked during development.

This commit attempts to restore the interface - if the CSU allows for it.

sorry I missed this.

Quoted 16 lines
---
 arch/arm/mach-zynqmp/Kconfig                 |  9 ++++++++
 arch/arm/mach-zynqmp/include/mach/hardware.h | 23 +++++++++++++------
 board/xilinx/zynqmp/zynqmp.c                 | 24 ++++++++++++++++++++
 3 files changed, 49 insertions(+), 7 deletions(-)
arch/arm/mach-zynqmp/Kconfig +0 -0
index 39144d654e..1e551c0020 100644
@@ -149,6 +149,15 @@ config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED
 	  Overwrite bootmode selected via boot mode pins to tell SPL what should
 	  be the next boot device.
 
Quoted 6 lines

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 155

Quoted 4 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
+config SPL_ZYNQMP_RESTORE_JTAG
+       bool "Restore JTAG"
+       depends on SPL
+       default n

no need for default n - that's default option anyway.

ok

Quoted 7 lines

arch/arm/mach-zynqmp/Kconfig config SPL_ZYNQMP_ALT_BOOTMODE_ENABLED · line 159

Quoted 5 lines
arch/arm/mach-zynqmp/Kconfig +4 -0
+       help
+	 Booting SPL in secure mode causes the CSU to disable the JTAG interface
+	 even if no eFuses were burnt. This option restores the interface if
+	 possible.

Indentation is weird. Please look at tabs/spaces.

ok

Quoted 61 lines
Quoted 61 lines
arch/arm/mach-zynqmp/Kconfig +1 -0
+
 config ZYNQ_SDHCI_MAX_FREQ
 	default 200000000
 
arch/arm/mach-zynqmp/include/mach/hardware.h +16 -7
index 3776499070..58822e3f25 100644
@@ -42,17 +42,20 @@
 struct crlapb_regs {
 	u32 reserved0[36];
 	u32 cpu_r5_ctrl; /* 0x90 */
-	u32 reserved1[37];
+	u32 reserved1[7];
+	u32 dbg_lpd_ctrl; /* 0xB0 */
+	u32 reserved2[29];
 	u32 timestamp_ref_ctrl; /* 0x128 */
-	u32 reserved2[53];
+	u32 reserved3[53];
 	u32 boot_mode; /* 0x200 */
-	u32 reserved3_0[7];
+	u32 reserved4_0[7];
 	u32 reset_reason; /* 0x220 */
-	u32 reserved3_1[6];
+	u32 reserved4_1[6];
 	u32 rst_lpd_top; /* 0x23C */
-	u32 reserved4[4];
+	u32 rst_lpd_dbg; /* 0x240 */
+	u32 reserved5[3];
 	u32 boot_pin_ctrl; /* 0x250 */
-	u32 reserved5[21];
+	u32 reserved6[21];
 };
 
 #define crlapb_base ((struct crlapb_regs *)ZYNQMP_CRL_APB_BASEADDR)
@@ -141,9 +144,15 @@ struct apu_regs {
 struct csu_regs {
 	u32 reserved0[4];
 	u32 multi_boot;
-	u32 reserved1[11];
+	u32 reserved1[7];
+	u32 jtag_chain_status_wr;
+	u32 jtag_chain_status;
+	u32 jtag_sec;
+	u32 jtag_dap_cfg;
 	u32 idcode;
 	u32 version;
+	u32 reserved2[3055];
+	u32 pcap_prog;
 };
 
 #define csu_base ((struct csu_regs *)ZYNQMP_CSU_BASEADDR)
board/xilinx/zynqmp/zynqmp.c +0 -0
index 1748fec2e4..feffda54e7 100644
@@ -355,6 +355,25 @@ static int multi_boot(void)
 	return 0;
 }
 
Quoted 11 lines

board/xilinx/zynqmp/zynqmp.c static int multi_boot(void) · line 366

Quoted 9 lines
board/xilinx/zynqmp/zynqmp.c +9 -0
+#if defined(CONFIG_SPL_BUILD) && defined(CONFIG_SPL_ZYNQMP_RESTORE_JTAG)
+static void restore_jtag(void)
+{
+	const u32 disable_security_gate = 0xff;
+	const u32 setup_clock = 0x01002002;
+	const u32 setup_jtag = 0x3;
+	const u32 release_pl = 0x1;
+	const u32 enable_debug = 0xff;
+	const u32 do_reset = 0x0;

All above should be just macros. Please put them to hardware.h

Quoted 5 lines

you mean something like #define CSU_SETUP_CLOCK 0x01002002? I dont really agree with that because we'll lose the context where it is being used (and the context is given by the restore jtag function) unless we do CSU_RESTORE_JTAG_SETUP_CLOCK ....
is this what you want?

Macro name is up to you but should register description.

For example yours disable_security_gate
is based on reg database ssss_pmu_sec + ssss_pltap_sec + ssss_dap_sec together.

#define CSU_JTAG_SEC_GATE_DISABLE 0x1ff

And then you can use directly:

writel(CSU_JTAG_SEC_GATE_DISABLE, &csu_base->jtag_sec);

Thanks,
Michal