Usage and Options

The emc_log utility has the following basic syntax:

emc_log [options]

The emc_log Options

The following table describes the available options:

Option Description
-group <group_name> Collects statistics for all clients in <group_name>. If the group contains two or more clients, emc_log samples two clients at a time in a round-robin fashion.
-client <client_name> Collects statistics for the clients. You can specify multiple ??client options in one command. If more than two clients are specified, the clients are sampled two at a time in a round-robin fashion.
-window <ms> Samples every <ms> milliseconds. The default is 1000.
-startdelay <s> Specifies a delay for <s> seconds before sampling the counters. The default is 1.
-length <s> Samples for at least <s> seconds. The default is 1.
-period <n>

Specifies the period that a client is sampled in a round-robin fashion. The default is 1.

For example, if four clients and a period of 3 are specified, the sampling order is:

First sampling: client 1 and client 2

Second sampling: client 1 and client 2

Third sampling: client 1 and client 2

Fourth sampling: client 3 and client 4

Fifth sampling: client 3 and client 4

Sixth sampling: client 3 and client 4

Seventh sampling: client 1 and client 2.
-total Collects total statistics for all the specified clients.
-o <file_name> Outputs data to <file_name> if the option is specified; otherwise, outputs data to stdout.
-help Prints descriptions for the supported command-line options. Also lists all supported client names, client IDs, and group names on the platform.
Note: Clients and groups (listed in the table) are platform-specific. Enter emc_log help to obtain a list of the supported groups and clients for your platform.

Restrictions

The emc_log utility will not function if either the hypervisor restrictions are in place or the MC/EMC firewall is fully operational. For the safety build package, emc_log does not have access to the MMIO registers unless the safety build package is configured with the prod_debug_extra PCT variant. The standard build does not have this restriction. To relax the MC/EMC firewall settings, remove dts nodes before creating images for flashing.

The dts nodes to remove are in this file:

<TEGRA_TOP>/hardware/nvidia/platform/t23x/common/bct/firewall/tegra234-firewall-config-base.dtsi

reg@4336 { /* CBB_CENTRAL_CBB_FIREWALL_MC0_BLF, CTL_SETTING */
        };
        reg@4339 { /* CBB_CENTRAL_CBB_FIREWALL_MC1_BLF, CTL_SETTING */ 
        };
        reg@4342 { /* CBB_CENTRAL_CBB_FIREWALL_MC10_BLF, CTL_SETTING */
        }; 
        reg@4345 { /* CBB_CENTRAL_CBB_FIREWALL_MC11_BLF, CTL_SETTING */
        }; 
        reg@4348 { /* CBB_CENTRAL_CBB_FIREWALL_MC12_BLF, CTL_SETTING */
        };
        reg@4351 { /* CBB_CENTRAL_CBB_FIREWALL_MC13_BLF, CTL_SETTING */
        };
        reg@4354 { /* CBB_CENTRAL_CBB_FIREWALL_MC14_BLF, CTL_SETTING */
        };      
        reg@4357 { /* CBB_CENTRAL_CBB_FIREWALL_MC15_BLF, CTL_SETTING */
        };
        reg@4360 { /* CBB_CENTRAL_CBB_FIREWALL_MC2_BLF, CTL_SETTING */
        };
        reg@4363 { /* CBB_CENTRAL_CBB_FIREWALL_MC3_BLF, CTL_SETTING */
        };
        reg@4366 { /* CBB_CENTRAL_CBB_FIREWALL_MC4_BLF, CTL_SETTING */
        };
        reg@4369 { /* CBB_CENTRAL_CBB_FIREWALL_MC5_BLF, CTL_SETTING */
        };
        reg@4372 { /* CBB_CENTRAL_CBB_FIREWALL_MC6_BLF, CTL_SETTING */
        };
        reg@4375 { /* CBB_CENTRAL_CBB_FIREWALL_MC7_BLF, CTL_SETTING */
        };
        reg@4378 { /* CBB_CENTRAL_CBB_FIREWALL_MC8_BLF, CTL_SETTING */
        };
        reg@4381 { /* CBB_CENTRAL_CBB_FIREWALL_MC9_BLF, CTL_SETTING */
        };        
        reg@4387 { /* CBB_CENTRAL_CBB_FIREWALL_MCB_BLF, CTL_SETTING */
        };
        reg@3538 { /* CBB_CENTRAL_CBB_FIREWALL_EMC0_CORE_BLF, CTL_SETTING */
        };
        reg@3553 { /* CBB_CENTRAL_CBB_FIREWALL_EMC10_CORE_BLF, CTL_SETTING */
        };        
        reg@3568 { /* CBB_CENTRAL_CBB_FIREWALL_EMC11_CORE_BLF, CTL_SETTING */
        };
        reg@3583 { /* CBB_CENTRAL_CBB_FIREWALL_EMC12_CORE_BLF, CTL_SETTING */
        };
        reg@3598 { /* CBB_CENTRAL_CBB_FIREWALL_EMC13_CORE_BLF, CTL_SETTING */
        };
        reg@3613 { /* CBB_CENTRAL_CBB_FIREWALL_EMC14_CORE_BLF, CTL_SETTING */
        };
        reg@3628 { /* CBB_CENTRAL_CBB_FIREWALL_EMC15_CORE_BLF, CTL_SETTING */
        };
        reg@3643 { /* CBB_CENTRAL_CBB_FIREWALL_EMC1_CORE_BLF, CTL_SETTING */
        };    
        reg@3658 { /* CBB_CENTRAL_CBB_FIREWALL_EMC2_CORE_BLF, CTL_SETTING */
        };     
        reg@3673 { /* CBB_CENTRAL_CBB_FIREWALL_EMC3_CORE_BLF, CTL_SETTING */
        };       
        reg@3688 { /* CBB_CENTRAL_CBB_FIREWALL_EMC4_CORE_BLF, CTL_SETTING */
        };        
        reg@3703 { /* CBB_CENTRAL_CBB_FIREWALL_EMC5_CORE_BLF, CTL_SETTING */
        };        
        reg@3718 { /* CBB_CENTRAL_CBB_FIREWALL_EMC6_CORE_BLF, CTL_SETTING */
        };        
        reg@3733 { /* CBB_CENTRAL_CBB_FIREWALL_EMC7_CORE_BLF, CTL_SETTING */
        };        
        reg@3748 { /* CBB_CENTRAL_CBB_FIREWALL_EMC8_CORE_BLF, CTL_SETTING */
        };        
        reg@3763 { /* CBB_CENTRAL_CBB_FIREWALL_EMC9_CORE_BLF, CTL_SETTING */
        };        
        reg@3787 { /* CBB_CENTRAL_CBB_FIREWALL_EMCB_CORE_BLF, CTL_SETTING */
        };