GTE Application (app/gte-app.c)

Table of Contents

• Hardware Configuration
• Software Configuration
  • AGX Xavier
  • AGX Orin
  • Orin Nano
• Result

This section explains how to use the generic time-stamping engine (GTE).

The GTE snoops a set of signals and presents the timestamped events to the software using FIFOs. There are three GTE instances/slices available to AON/SPE and each is 32 bits wide. Refer to gte-tegra-hw.h for more information about signals mapping to slices.

To determine the GTE pin mapping, refer to the pin-mux spreadsheet that corresponds to your module. There is a hidden column in the spreadsheet called "GTE" that lists the bit in slice 2 that corresponds to that pin.

Hardware Configuration

The application demonstrates the GTE driver APIs and works with gpio-app to monitor the interrupt on the GPIO_APP_IN line. Refer to GPIO Application, for more information about wiring details.

Software Configuration

AGX Xavier

1. In soc/t19x/target_specific.mk, set ENABLE_GPIO_APP := 1, rebuild the application, and copy the output to ${L4T}/bootloader/spe_t194.bin.
2. Disable GTE driver in the Linux kernel device tree and ensure that no other processors using the driver, and run source_sync.sh. The resulting dtsi file is located at Linux_for_Tegra/sources/hardware/nvidia/platform/t19x/galen/kernel-dts/common/tegra194-p2822-0000-a00.dtsi.

   gte@c1e0000 {
           status = "disabled";
   };

3. Rebuild the device tree and copy the dtb file to Linux_for_Tegra/dtb/ directory.
4. Reflash all partitions to ensure that the dtb settings are updated on the board.

AGX Orin

1. In soc/t23x/target_specific.mk, set ENABLE_GTE_APP := 1, rebuild the application, and copy the output to ${L4T}/bootloader/spe_t234.bin.
2. Disable GTE driver in the Linux kernel device tree, ensure that no other processors using the driver, and run source_sync.sh. The resulting dtsi file is located at Linux_for_Tegra/sources/hardware/nvidia/platform/t23x/concord/kernel-dts/cvb/tegra234-p3737-0000-a00.dtsi.

   gte@c1e0000 {
           status = "disabled";
   };

3. Rebuild the device tree and copy the dtb file to Linux_for_Tegra/dtb/ directory.
4. Modify firewall setting in ${L4T}/bootloader/tegra234-mb2-bct-scr-p3701-0000-override.dts to allow SPE to read/write to the GTE register.

   +++ b/bootloader/tegra234-mb2-bct-scr-p3701-0000-override.dts
   @@ -24,6 +24,11 @@
                value = <0x18000606>;
            };
   
   +        reg@1359 { /* GTE_GPIO_SCR_TESCR_0 */
   +            exclusion-info = <2>;
   +            value = <0x38001232>;
   +        };
   +
            reg@5114 { /* CBB_CENTRAL_CBB_FIREWALL_PWM5_BLF, READ_CTL */

5. Reflash all partitions to ensure that the dtb and firewall settings are updated on the board.

Orin Nano

1. In soc/t23x/target_specific.mk, set ENABLE_GTE_APP := 1 and ENABLE_SPE_FOR_ORIN_NANO := 1. Rebuild the application, and copy the output to ${L4T}/bootloader/spe_t234.bin.
2. Disable GTE driver in the Linux kernel device tree, ensure that no other processors using the driver, and run source_sync.sh. The resulting dtsi file is located at Linux_for_Tegra/sources/hardware/nvidia/platform/t23x/p3768/kernel-dts/cvb/tegra234-p3768-0000-a0.dtsi.

   gte@c1e0000 {
           status = "disabled";
   };

3. Rebuild the device tree and copy the dtb file to Linux_for_Tegra/dtb/ directory.
4. Modify firewall setting in ${L4T}/bootloader/tegra234-firewall-config-base.dtsi to allow SPE to read/write to the GTE register.

   +++ b/bootloader/tegra234-firewall-config-base.dtsi
   @@ -6814,7 +6814,7 @@
        };
   
           reg@1359 { /* GTE_GPIO_SCR_TESCR_0 */
               exclusion-info = <3>;
   -           value = <0x38000222>;
   +           value = <0x38001232>;
           };

5. Reflash all partitions to ensure that the dtb and firewall settings are updated on the board.

Result

GTE ISR is called when the FIFO reaches the GTE_FIFO_OCCUPANCY threshold. On successful execution, GTE ISR following message:

gpio_app_task - Setting GPIO_APP_OUT to 1 - IRQ should trigger
Slice Id: xx, Event Id: xx (Other), Edge = rising, Raw Time stamp = xx, Timestamp in nanosec = xx
can_gpio_irq_handler - gpio irq triggered - setting GPIO_APP_OUT to 0