TSEC (Tegra Security Co-processor) is a dedicated unit powered by a NVIDIA Falcon microprocessor with crypto extensions.
Driver
A host driver for communicating with the TSEC is mapped to physical address 0x54500000 with a total size of 0x40000 bytes and exposes several registers.
Registers
The TSEC's MMIO space is divided as follows:
- 0x54500000 to 0x54501000: THI (Tegra Host Interface)
- 0x54501000 to 0x54501400: FALCON (Falcon microcontroller)
- 0x54501400 to 0x54501500: SCP (Secure Co-processor)
- 0x54501500 to 0x54501600: RND (Random Number Generator)
- 0x54501600 to 0x54501680: TFBIF (Tegra Framebuffer Interface)
- 0x54501680 to 0x54501700: CG (Clock Gate)
- 0x54501700 to 0x54501800: BAR0 (HOST1X device DMA)
- 0x54501800 to 0x54501900: TEGRA (Miscellaneous interfaces)
Name | Address | Width |
---|---|---|
TSEC_THI_INCR_SYNCPT | 0x54500000 | 0x04 |
TSEC_THI_INCR_SYNCPT_CTRL | 0x54500004 | 0x04 |
TSEC_THI_INCR_SYNCPT_ERR | 0x54500008 | 0x04 |
TSEC_THI_CTXSW_INCR_SYNCPT | 0x5450000C | 0x04 |
TSEC_THI_CTXSW | 0x54500020 | 0x04 |
TSEC_THI_CTXSW_NEXT | 0x54500024 | 0x04 |
TSEC_THI_CONT_SYNCPT_EOF | 0x54500028 | 0x04 |
TSEC_THI_CONT_SYNCPT_L1 | 0x5450002C | 0x04 |
TSEC_THI_STREAMID0 | 0x54500030 | 0x04 |
TSEC_THI_STREAMID1 | 0x54500034 | 0x04 |
TSEC_THI_THI_SEC | 0x54500038 | 0x04 |
TSEC_THI_METHOD0 | 0x54500040 | 0x04 |
TSEC_THI_METHOD1 | 0x54500044 | 0x04 |
TSEC_THI_CONTEXT_SWITCH | 0x54500060 | 0x04 |
TSEC_THI_INT_STATUS | 0x54500078 | 0x04 |
TSEC_THI_INT_MASK | 0x5450007C | 0x04 |
TSEC_THI_CONFIG0 | 0x54500080 | 0x04 |
TSEC_THI_DBG_MISC | 0x54500084 | 0x04 |
TSEC_THI_SLCG_OVERRIDE_HIGH_A | 0x54500088 | 0x04 |
TSEC_THI_SLCG_OVERRIDE_LOW_A | 0x5450008C | 0x04 |
TSEC_THI_CLK_OVERRIDE | 0x54500E00 | 0x04 |
TSEC_FALCON_IRQSSET | 0x54501000 | 0x04 |
TSEC_FALCON_IRQSCLR | 0x54501004 | 0x04 |
TSEC_FALCON_IRQSTAT | 0x54501008 | 0x04 |
TSEC_FALCON_IRQMODE | 0x5450100C | 0x04 |
TSEC_FALCON_IRQMSET | 0x54501010 | 0x04 |
TSEC_FALCON_IRQMCLR | 0x54501014 | 0x04 |
TSEC_FALCON_IRQMASK | 0x54501018 | 0x04 |
TSEC_FALCON_IRQDEST | 0x5450101C | 0x04 |
TSEC_FALCON_GPTMRINT | 0x54501020 | 0x04 |
TSEC_FALCON_GPTMRVAL | 0x54501024 | 0x04 |
TSEC_FALCON_GPTMRCTL | 0x54501028 | 0x04 |
TSEC_FALCON_PTIMER0 | 0x5450102C | 0x04 |
TSEC_FALCON_PTIMER1 | 0x54501030 | 0x04 |
TSEC_FALCON_WDTMRVAL | 0x54501034 | 0x04 |
TSEC_FALCON_WDTMRCTL | 0x54501038 | 0x04 |
TSEC_FALCON_IRQDEST2 | 0x5450103C | 0x04 |
TSEC_FALCON_MAILBOX0 | 0x54501040 | 0x04 |
TSEC_FALCON_MAILBOX1 | 0x54501044 | 0x04 |
TSEC_FALCON_ITFEN | 0x54501048 | 0x04 |
TSEC_FALCON_IDLESTATE | 0x5450104C | 0x04 |
TSEC_FALCON_CURCTX | 0x54501050 | 0x04 |
TSEC_FALCON_NXTCTX | 0x54501054 | 0x04 |
TSEC_FALCON_CTXACK | 0x54501058 | 0x04 |
TSEC_FALCON_FHSTATE | 0x5450105C | 0x04 |
TSEC_FALCON_PRIVSTATE | 0x54501060 | 0x04 |
TSEC_FALCON_MTHDDATA | 0x54501064 | 0x04 |
TSEC_FALCON_MTHDID | 0x54501068 | 0x04 |
TSEC_FALCON_MTHDWDAT | 0x5450106C | 0x04 |
TSEC_FALCON_MTHDCOUNT | 0x54501070 | 0x04 |
TSEC_FALCON_MTHDPOP | 0x54501074 | 0x04 |
TSEC_FALCON_MTHDRAMSZ | 0x54501078 | 0x04 |
TSEC_FALCON_SFTRESET | 0x5450107C | 0x04 |
TSEC_FALCON_OS | 0x54501080 | 0x04 |
TSEC_FALCON_RM | 0x54501084 | 0x04 |
TSEC_FALCON_SOFT_PM | 0x54501088 | 0x04 |
TSEC_FALCON_SOFT_MODE | 0x5450108C | 0x04 |
TSEC_FALCON_DEBUG1 | 0x54501090 | 0x04 |
TSEC_FALCON_DEBUGINFO | 0x54501094 | 0x04 |
TSEC_FALCON_IBRKPT1 | 0x54501098 | 0x04 |
TSEC_FALCON_IBRKPT2 | 0x5450109C | 0x04 |
TSEC_FALCON_CGCTL | 0x545010A0 | 0x04 |
TSEC_FALCON_ENGCTL | 0x545010A4 | 0x04 |
TSEC_FALCON_PMM | 0x545010A8 | 0x04 |
TSEC_FALCON_ADDR | 0x545010AC | 0x04 |
TSEC_FALCON_IBRKPT3 | 0x545010B0 | 0x04 |
TSEC_FALCON_IBRKPT4 | 0x545010B4 | 0x04 |
TSEC_FALCON_IBRKPT5 | 0x545010B8 | 0x04 |
TSEC_FALCON_EXCI | 0x545010D0 | 0x04 |
TSEC_FALCON_SVEC_SPR | 0x545010D4 | 0x04 |
TSEC_FALCON_RSTAT0 | 0x545010D8 | 0x04 |
TSEC_FALCON_RSTAT3 | 0x545010DC | 0x04 |
TSEC_FALCON_UNK_E0 | 0x545010E0 | 0x04 |
TSEC_FALCON_CPUCTL | 0x54501100 | 0x04 |
TSEC_FALCON_BOOTVEC | 0x54501104 | 0x04 |
TSEC_FALCON_HWCFG | 0x54501108 | 0x04 |
TSEC_FALCON_DMACTL | 0x5450110C | 0x04 |
TSEC_FALCON_DMATRFBASE | 0x54501110 | 0x04 |
TSEC_FALCON_DMATRFMOFFS | 0x54501114 | 0x04 |
TSEC_FALCON_DMATRFCMD | 0x54501118 | 0x04 |
TSEC_FALCON_DMATRFFBOFFS | 0x5450111C | 0x04 |
TSEC_FALCON_DMAPOLL_FB | 0x54501120 | 0x04 |
TSEC_FALCON_DMAPOLL_CP | 0x54501124 | 0x04 |
TSEC_FALCON_DBG_STATE | 0x54501128 | 0x04 |
TSEC_FALCON_HWCFG1 | 0x5450112C | 0x04 |
TSEC_FALCON_CPUCTL_ALIAS | 0x54501130 | 0x04 |
TSEC_FALCON_STACKCFG | 0x54501138 | 0x04 |
TSEC_FALCON_IMCTL | 0x54501140 | 0x04 |
TSEC_FALCON_IMSTAT | 0x54501144 | 0x04 |
TSEC_FALCON_TRACEIDX | 0x54501148 | 0x04 |
TSEC_FALCON_TRACEPC | 0x5450114C | 0x04 |
TSEC_FALCON_IMFILLRNG0 | 0x54501150 | 0x04 |
TSEC_FALCON_IMFILLRNG1 | 0x54501154 | 0x04 |
TSEC_FALCON_IMFILLCTL | 0x54501158 | 0x04 |
TSEC_FALCON_IMCTL_DEBUG | 0x5450115C | 0x04 |
TSEC_FALCON_CMEMBASE | 0x54501160 | 0x04 |
TSEC_FALCON_DMEMAPERT | 0x54501164 | 0x04 |
TSEC_FALCON_EXTERRADDR | 0x54501168 | 0x04 |
TSEC_FALCON_EXTERRSTAT | 0x5450116C | 0x04 |
TSEC_FALCON_CG2 | 0x5450117C | 0x04 |
TSEC_FALCON_IMEMC0 | 0x54501180 | 0x04 |
TSEC_FALCON_IMEMD0 | 0x54501184 | 0x04 |
TSEC_FALCON_IMEMT0 | 0x54501188 | 0x04 |
TSEC_FALCON_IMEMC1 | 0x54501190 | 0x04 |
TSEC_FALCON_IMEMD1 | 0x54501194 | 0x04 |
TSEC_FALCON_IMEMT1 | 0x54501198 | 0x04 |
TSEC_FALCON_IMEMC2 | 0x545011A0 | 0x04 |
TSEC_FALCON_IMEMD2 | 0x545011A4 | 0x04 |
TSEC_FALCON_IMEMT2 | 0x545011A8 | 0x04 |
TSEC_FALCON_IMEMC3 | 0x545011B0 | 0x04 |
TSEC_FALCON_IMEMD3 | 0x545011B4 | 0x04 |
TSEC_FALCON_IMEMT3 | 0x545011B8 | 0x04 |
TSEC_FALCON_DMEMC0 | 0x545011C0 | 0x04 |
TSEC_FALCON_DMEMD0 | 0x545011C4 | 0x04 |
TSEC_FALCON_DMEMC1 | 0x545011C8 | 0x04 |
TSEC_FALCON_DMEMD1 | 0x545011CC | 0x04 |
TSEC_FALCON_DMEMC2 | 0x545011D0 | 0x04 |
TSEC_FALCON_DMEMD2 | 0x545011D4 | 0x04 |
TSEC_FALCON_DMEMC3 | 0x545011D8 | 0x04 |
TSEC_FALCON_DMEMD3 | 0x545011DC | 0x04 |
TSEC_FALCON_DMEMC4 | 0x545011E0 | 0x04 |
TSEC_FALCON_DMEMD4 | 0x545011E4 | 0x04 |
TSEC_FALCON_DMEMC5 | 0x545011E8 | 0x04 |
TSEC_FALCON_DMEMD5 | 0x545011EC | 0x04 |
TSEC_FALCON_DMEMC6 | 0x545011F0 | 0x04 |
TSEC_FALCON_DMEMD6 | 0x545011F4 | 0x04 |
TSEC_FALCON_DMEMC7 | 0x545011F8 | 0x04 |
TSEC_FALCON_DMEMD7 | 0x545011FC | 0x04 |
TSEC_FALCON_ICD_CMD | 0x54501200 | 0x04 |
TSEC_FALCON_ICD_ADDR | 0x54501204 | 0x04 |
TSEC_FALCON_ICD_WDATA | 0x54501208 | 0x04 |
TSEC_FALCON_ICD_RDATA | 0x5450120C | 0x04 |
TSEC_FALCON_SCTL | 0x54501240 | 0x04 |
TSEC_FALCON_SSTAT | 0x54501244 | 0x04 |
TSEC_FALCON_UNK_250 | 0x54501250 | 0x04 |
TSEC_FALCON_UNK_260 | 0x54501260 | 0x04 |
TSEC_FALCON_SPROT_IMEM | 0x54501280 | 0x04 |
TSEC_FALCON_SPROT_DMEM | 0x54501284 | 0x04 |
TSEC_FALCON_SPROT_CPUCTL | 0x54501288 | 0x04 |
TSEC_FALCON_SPROT_MISC | 0x5450128C | 0x04 |
TSEC_FALCON_SPROT_IRQ | 0x54501290 | 0x04 |
TSEC_FALCON_SPROT_MTHD | 0x54501294 | 0x04 |
TSEC_FALCON_SPROT_SCTL | 0x54501298 | 0x04 |
TSEC_FALCON_SPROT_WDTMR | 0x5450129C | 0x04 |
TSEC_FALCON_DMAINFO_FINISHED_FBRD_LOW | 0x545012C0 | 0x04 |
TSEC_FALCON_DMAINFO_FINISHED_FBRD_HIGH | 0x545012C4 | 0x04 |
TSEC_FALCON_DMAINFO_FINISHED_FBWR_LOW | 0x545012C8 | 0x04 |
TSEC_FALCON_DMAINFO_FINISHED_FBWR_HIGH | 0x545012CC | 0x04 |
TSEC_FALCON_DMAINFO_CURRENT_FBRD_LOW | 0x545012D0 | 0x04 |
TSEC_FALCON_DMAINFO_CURRENT_FBRD_HIGH | 0x545012D4 | 0x04 |
TSEC_FALCON_DMAINFO_CURRENT_FBWR_LOW | 0x545012D8 | 0x04 |
TSEC_FALCON_DMAINFO_CURRENT_FBWR_HIGH | 0x545012DC | 0x04 |
TSEC_FALCON_DMAINFO_CTL | 0x545012E0 | 0x04 |
TSEC_SCP_CTL0 | 0x54501400 | 0x04 |
TSEC_SCP_CTL1 | 0x54501404 | 0x04 |
TSEC_SCP_CTL_STAT | 0x54501408 | 0x04 |
TSEC_SCP_CTL_LOCK | 0x5450140C | 0x04 |
TSEC_SCP_CFG | 0x54501410 | 0x04 |
TSEC_SCP_CTL_SCP | 0x54501414 | 0x04 |
TSEC_SCP_CTL_PKEY | 0x54501418 | 0x04 |
TSEC_SCP_CTL_DBG | 0x5450141C | 0x04 |
TSEC_SCP_DBG0 | 0x54501420 | 0x04 |
TSEC_SCP_DBG1 | 0x54501424 | 0x04 |
TSEC_SCP_DBG2 | 0x54501428 | 0x04 |
TSEC_SCP_CMD | 0x54501430 | 0x04 |
TSEC_SCP_STAT0 | 0x54501450 | 0x04 |
TSEC_SCP_STAT1 | 0x54501454 | 0x04 |
TSEC_SCP_STAT2 | 0x54501458 | 0x04 |
TSEC_SCP_RND_STAT0 | 0x54501470 | 0x04 |
TSEC_SCP_RND_STAT1 | 0x54501474 | 0x04 |
TSEC_SCP_IRQSTAT | 0x54501480 | 0x04 |
TSEC_SCP_IRQMASK | 0x54501484 | 0x04 |
TSEC_SCP_ACL_ERR | 0x54501490 | 0x04 |
TSEC_SCP_SEC_ERR | 0x54501494 | 0x04 |
TSEC_SCP_CMD_ERR | 0x54501498 | 0x04 |
TSEC_RND_CTL0 | 0x54501500 | 0x04 |
TSEC_RND_CTL1 | 0x54501504 | 0x04 |
TSEC_RND_CTL2 | 0x54501508 | 0x04 |
TSEC_RND_CTL3 | 0x5450150C | 0x04 |
TSEC_RND_CTL4 | 0x54501510 | 0x04 |
TSEC_RND_CTL5 | 0x54501514 | 0x04 |
TSEC_RND_CTL6 | 0x54501518 | 0x04 |
TSEC_RND_CTL7 | 0x5450151C | 0x04 |
TSEC_RND_CTL8 | 0x54501520 | 0x04 |
TSEC_RND_CTL9 | 0x54501524 | 0x04 |
TSEC_RND_CTL10 | 0x54501528 | 0x04 |
TSEC_RND_CTL11 | 0x5450152C | 0x04 |
TSEC_TFBIF_CTL | 0x54501600 | 0x04 |
TSEC_TFBIF_MCCIF_FIFOCTRL | 0x54501604 | 0x04 |
TSEC_TFBIF_THROTTLE | 0x54501608 | 0x04 |
TSEC_TFBIF_DBG_STAT0 | 0x5450160C | 0x04 |
TSEC_TFBIF_DBG_STAT1 | 0x54501610 | 0x04 |
TSEC_TFBIF_DBG_RDCOUNT_LO | 0x54501614 | 0x04 |
TSEC_TFBIF_DBG_RDCOUNT_HI | 0x54501618 | 0x04 |
TSEC_TFBIF_DBG_WRCOUNT_LO | 0x5450161C | 0x04 |
TSEC_TFBIF_DBG_WRCOUNT_HI | 0x54501620 | 0x04 |
TSEC_TFBIF_DBG_R32COUNT | 0x54501624 | 0x04 |
TSEC_TFBIF_DBG_R64COUNT | 0x54501628 | 0x04 |
TSEC_TFBIF_DBG_R128COUNT | 0x5450162C | 0x04 |
TSEC_TFBIF_UNK_30 | 0x54501630 | 0x04 |
TSEC_TFBIF_MCCIF_FIFOCTRL1 | 0x54501634 | 0x04 |
TSEC_TFBIF_WRR_RDP | 0x54501638 | 0x04 |
TSEC_TFBIF_SPROT_EMEM | 0x54501640 | 0x04 |
TSEC_TFBIF_TRANSCFG | 0x54501644 | 0x04 |
TSEC_TFBIF_REGIONCFG | 0x54501648 | 0x04 |
TSEC_TFBIF_ACTMON_ACTIVE_MASK | 0x5450164C | 0x04 |
TSEC_TFBIF_ACTMON_ACTIVE_BORPS | 0x54501650 | 0x04 |
TSEC_TFBIF_ACTMON_ACTIVE_WEIGHT | 0x54501654 | 0x04 |
TSEC_TFBIF_ACTMON_MCB_MASK | 0x54501660 | 0x04 |
TSEC_TFBIF_ACTMON_MCB_BORPS | 0x54501664 | 0x04 |
TSEC_TFBIF_ACTMON_MCB_WEIGHT | 0x54501668 | 0x04 |
TSEC_TFBIF_THI_TRANSPROP | 0x54501670 | 0x04 |
TSEC_CG | 0x545016D0 | 0x04 |
TSEC_BAR0_CTL | 0x54501700 | 0x04 |
TSEC_BAR0_ADDR | 0x54501704 | 0x04 |
TSEC_BAR0_DATA | 0x54501708 | 0x04 |
TSEC_BAR0_TIMEOUT | 0x5450170C | 0x04 |
TSEC_TEGRA_FALCON_IP_VER | 0x54501800 | 0x04 |
TSEC_TEGRA_UNK_04 | 0x54501804 | 0x04 |
TSEC_TEGRA_UNK_08 | 0x54501808 | 0x04 |
TSEC_TEGRA_UNK_0C | 0x5450180C | 0x04 |
TSEC_TEGRA_UNK_10 | 0x54501810 | 0x04 |
TSEC_TEGRA_UNK_14 | 0x54501814 | 0x04 |
TSEC_TEGRA_UNK_18 | 0x54501818 | 0x04 |
TSEC_TEGRA_UNK_1C | 0x5450181C | 0x04 |
TSEC_TEGRA_UNK_20 | 0x54501820 | 0x04 |
TSEC_TEGRA_UNK_24 | 0x54501824 | 0x04 |
TSEC_TEGRA_UNK_28 | 0x54501828 | 0x04 |
TSEC_TEGRA_UNK_2C | 0x5450182C | 0x04 |
TSEC_TEGRA_UNK_30 | 0x54501830 | 0x04 |
TSEC_TEGRA_UNK_34 | 0x54501834 | 0x04 |
TSEC_TEGRA_CTL | 0x54501838 | 0x04 |
TSEC_THI_METHOD0
Bits | Description |
---|---|
0-11 | TSEC_THI_METHOD0_OFFSET |
Used to encode and send a method's ID over HOST1X to TSEC. This register mirrors the functionality of HOST1X's channel opcode submission.
The following methods are available:
ID | Method |
---|---|
0x100 | NOP |
0x140 | PM_TRIGGER |
0x200 | SET_APPLICATION_ID |
0x204 | SET_WATCHDOG_TIMER |
0x240 | SEMAPHORE_A |
0x244 | SEMAPHORE_B |
0x248 | SEMAPHORE_C |
0x24C | |
0x250 | |
0x300 | EXECUTE |
0x304 | SEMAPHORE_D |
0x500 | HDCP_INIT |
0x504 | HDCP_CREATE_SESSION |
0x508 | HDCP_VERIFY_CERT_RX |
0x50C | HDCP_GENERATE_EKM |
0x510 | HDCP_REVOCATION_CHECK |
0x514 | HDCP_VERIFY_HPRIME |
0x518 | HDCP_ENCRYPT_PAIRING_INFO |
0x51C | HDCP_DECRYPT_PAIRING_INFO |
0x520 | HDCP_UPDATE_SESSION |
0x524 | HDCP_GENERATE_LC_INIT |
0x528 | HDCP_VERIFY_LPRIME |
0x52C | HDCP_GENERATE_SKE_INIT |
0x530 | HDCP_VERIFY_VPRIME |
0x534 | HDCP_ENCRYPTION_RUN_CTRL |
0x538 | HDCP_SESSION_CTRL |
0x53C | HDCP_COMPUTE_SPRIME |
0x540 | HDCP_GET_CERT_RX |
0x544 | HDCP_EXCHANGE_INFO |
0x548 | HDCP_DECRYPT_KM |
0x54C | HDCP_GET_HPRIME |
0x550 | HDCP_GENERATE_EKH_KM |
0x554 | HDCP_VERIFY_RTT_CHALLENGE |
0x558 | HDCP_GET_LPRIME |
0x55C | HDCP_DECRYPT_KS |
0x560 | HDCP_DECRYPT |
0x564 | HDCP_GET_RRX |
0x568 | HDCP_DECRYPT_REENCRYPT |
0x56C | |
0x570 | |
0x574 | HDCP_DECRYPT_STORED_KM |
0x578 | |
0x57C | |
0x700 | HDCP_VALIDATE_SRM |
0x704 | HDCP_VALIDATE_STREAM |
0x708 | HDCP_TEST_SECURE_STATUS |
0x70C | HDCP_SET_DCP_KPUB |
0x710 | HDCP_SET_RX_KPUB |
0x714 | HDCP_SET_CERT_RX |
0x718 | HDCP_SET_SCRATCH_BUFFER |
0x71C | HDCP_SET_SRM |
0x720 | HDCP_SET_RECEIVER_ID_LIST |
0x724 | HDCP_SET_SPRIME |
0x728 | HDCP_SET_ENC_INPUT_BUFFER |
0x72C | HDCP_SET_ENC_OUTPUT_BUFFER |
0x730 | HDCP_GET_RTT_CHALLENGE |
0x734 | HDCP_STREAM_MANAGE |
0x738 | HDCP_READ_CAPS |
0x73C | HDCP_ENCRYPT |
0x740 | [6.0.0+] HDCP_GET_CURRENT_NONCE |
0x1114 | PM_TRIGGER_END |
TSEC_THI_METHOD1
Bits | Description |
---|---|
0-31 | TSEC_THI_METHOD1_DATA |
Used to encode and send a method's data over HOST1X to TSEC. This register mirrors the functionality of HOST1X's channel opcode submission.
TSEC_THI_INT_STATUS
Bits | Description |
---|---|
0 | TSEC_THI_INT_STATUS_FALCON_INT |
TSEC_THI_INT_MASK
Bits | Description |
---|---|
0 | TSEC_THI_INT_MASK_FALCON_INT |
TSEC_FALCON_IRQSSET
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQSSET_GPTMR |
1 | TSEC_FALCON_IRQSSET_WDTMR |
2 | TSEC_FALCON_IRQSSET_MTHD |
3 | TSEC_FALCON_IRQSSET_CTXSW |
4 | TSEC_FALCON_IRQSSET_HALT |
5 | TSEC_FALCON_IRQSSET_EXTERR |
6 | TSEC_FALCON_IRQSSET_SWGEN0 |
7 | TSEC_FALCON_IRQSSET_SWGEN1 |
8-15 | TSEC_FALCON_IRQSSET_EXT |
16 | TSEC_FALCON_IRQSSET_DMA |
Used for setting Falcon's IRQs.
TSEC_FALCON_IRQSCLR
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQSCLR_GPTMR |
1 | TSEC_FALCON_IRQSCLR_WDTMR |
2 | TSEC_FALCON_IRQSCLR_MTHD |
3 | TSEC_FALCON_IRQSCLR_CTXSW |
4 | TSEC_FALCON_IRQSCLR_HALT |
5 | TSEC_FALCON_IRQSCLR_EXTERR |
6 | TSEC_FALCON_IRQSCLR_SWGEN0 |
7 | TSEC_FALCON_IRQSCLR_SWGEN1 |
8-15 | TSEC_FALCON_IRQSCLR_EXT |
16 | TSEC_FALCON_IRQSCLR_DMA |
Used for clearing Falcon's IRQs.
TSEC_FALCON_IRQSTAT
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQSTAT_GPTMR |
1 | TSEC_FALCON_IRQSTAT_WDTMR |
2 | TSEC_FALCON_IRQSTAT_MTHD |
3 | TSEC_FALCON_IRQSTAT_CTXSW |
4 | TSEC_FALCON_IRQSTAT_HALT |
5 | TSEC_FALCON_IRQSTAT_EXTERR |
6 | TSEC_FALCON_IRQSTAT_SWGEN0 |
7 | TSEC_FALCON_IRQSTAT_SWGEN1 |
8-15 | TSEC_FALCON_IRQSTAT_EXT |
16 | TSEC_FALCON_IRQSTAT_DMA |
Used for getting the status of Falcon's IRQs.
TSEC_FALCON_IRQMODE
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQMODE_LVL_GPTMR |
1 | TSEC_FALCON_IRQMODE_LVL_WDTMR |
2 | TSEC_FALCON_IRQMODE_LVL_MTHD |
3 | TSEC_FALCON_IRQMODE_LVL_CTXSW |
4 | TSEC_FALCON_IRQMODE_LVL_HALT |
5 | TSEC_FALCON_IRQMODE_LVL_EXTERR |
6 | TSEC_FALCON_IRQMODE_LVL_SWGEN0 |
7 | TSEC_FALCON_IRQMODE_LVL_SWGEN1 |
8-15 | TSEC_FALCON_IRQMODE_LVL_EXT |
16 | TSEC_FALCON_IRQMODE_LVL_DMA |
Used for changing the mode Falcon's IRQs. A value of 1 means level triggered while a value of 0 means edge triggered.
TSEC_FALCON_IRQMSET
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQMSET_GPTMR |
1 | TSEC_FALCON_IRQMSET_WDTMR |
2 | TSEC_FALCON_IRQMSET_MTHD |
3 | TSEC_FALCON_IRQMSET_CTXSW |
4 | TSEC_FALCON_IRQMSET_HALT |
5 | TSEC_FALCON_IRQMSET_EXTERR |
6 | TSEC_FALCON_IRQMSET_SWGEN0 |
7 | TSEC_FALCON_IRQMSET_SWGEN1 |
8-15 | TSEC_FALCON_IRQMSET_EXT |
16 | TSEC_FALCON_IRQMSET_DMA |
Used for setting the mask for Falcon's IRQs.
TSEC_FALCON_IRQMCLR
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQMCLR_GPTMR |
1 | TSEC_FALCON_IRQMCLR_WDTMR |
2 | TSEC_FALCON_IRQMCLR_MTHD |
3 | TSEC_FALCON_IRQMCLR_CTXSW |
4 | TSEC_FALCON_IRQMCLR_HALT |
5 | TSEC_FALCON_IRQMCLR_EXTERR |
6 | TSEC_FALCON_IRQMCLR_SWGEN0 |
7 | TSEC_FALCON_IRQMCLR_SWGEN1 |
8-15 | TSEC_FALCON_IRQMCLR_EXT |
16 | TSEC_FALCON_IRQMCLR_DMA |
Used for clearing the mask for Falcon's IRQs.
TSEC_FALCON_IRQMASK
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQMASK_GPTMR |
1 | TSEC_FALCON_IRQMASK_WDTMR |
2 | TSEC_FALCON_IRQMASK_MTHD |
3 | TSEC_FALCON_IRQMASK_CTXSW |
4 | TSEC_FALCON_IRQMASK_HALT |
5 | TSEC_FALCON_IRQMASK_EXTERR |
6 | TSEC_FALCON_IRQMASK_SWGEN0 |
7 | TSEC_FALCON_IRQMASK_SWGEN1 |
8-15 | TSEC_FALCON_IRQMASK_EXT |
16 | TSEC_FALCON_IRQMASK_DMA |
Used for getting the value of the mask for Falcon's IRQs.
TSEC_FALCON_IRQDEST
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQDEST_HOST_GPTMR |
1 | TSEC_FALCON_IRQDEST_HOST_WDTMR |
2 | TSEC_FALCON_IRQDEST_HOST_MTHD |
3 | TSEC_FALCON_IRQDEST_HOST_CTXSW |
4 | TSEC_FALCON_IRQDEST_HOST_HALT |
5 | TSEC_FALCON_IRQDEST_HOST_EXTERR |
6 | TSEC_FALCON_IRQDEST_HOST_SWGEN0 |
7 | TSEC_FALCON_IRQDEST_HOST_SWGEN1 |
8-15 | TSEC_FALCON_IRQDEST_HOST_EXT |
16 | TSEC_FALCON_IRQDEST_TARGET_GPTMR |
17 | TSEC_FALCON_IRQDEST_TARGET_WDTMR |
18 | TSEC_FALCON_IRQDEST_TARGET_MTHD |
19 | TSEC_FALCON_IRQDEST_TARGET_CTXSW |
20 | TSEC_FALCON_IRQDEST_TARGET_HALT |
21 | TSEC_FALCON_IRQDEST_TARGET_EXTERR |
22 | TSEC_FALCON_IRQDEST_TARGET_SWGEN0 |
23 | TSEC_FALCON_IRQDEST_TARGET_SWGEN1 |
24-31 | TSEC_FALCON_IRQDEST_TARGET_EXT |
Used for routing Falcon's IRQs.
TSEC_FALCON_IRQDEST2
Bits | Description |
---|---|
0 | TSEC_FALCON_IRQDEST2_HOST_DMA |
16 | TSEC_FALCON_IRQDEST2_TARGET_DMA |
Used for routing Falcon's IRQs.
TSEC_FALCON_MAILBOX0
Bits | Description |
---|---|
0-31 | TSEC_FALCON_MAILBOX0_DATA |
Scratch register for reading/writing data to Falcon.
TSEC_FALCON_MAILBOX1
Bits | Description |
---|---|
0-31 | TSEC_FALCON_MAILBOX1_DATA |
Scratch register for reading/writing data to Falcon.
TSEC_FALCON_ITFEN
Bits | Description |
---|---|
0 | TSEC_FALCON_ITFEN_CTXEN |
1 | TSEC_FALCON_ITFEN_MTHDEN |
Used for enabling/disabling Falcon interfaces.
TSEC_FALCON_IDLESTATE
Bits | Description |
---|---|
0 | TSEC_FALCON_IDLESTATE_FALCON_BUSY |
1-15 | TSEC_FALCON_IDLESTATE_EXT_BUSY |
Used for detecting if Falcon is busy or not.
TSEC_FALCON_DEBUG1
Bits | Description |
---|---|
0-15 | TSEC_FALCON_DEBUG1_MTHD_DRAIN_TIME |
16 | TSEC_FALCON_DEBUG1_CTXSW_MODE |
17 | TSEC_FALCON_DEBUG1_TRACE_FORMAT |
TSEC_FALCON_DEBUGINFO
Bits | Description |
---|---|
0-31 | TSEC_FALCON_DEBUGINFO_DATA |
Used for UCODE self revocation. This register takes the base address of the GSC carveout shifted right by 8.
[6.0.0+] nvservices sets this to 0x8005FF00 >> 8 (physical DRAM address inside the GPU UCODE carveout) before starting the nvhost_tsec firmware.
TSEC_FALCON_EXCI
Bits | Description |
---|---|
0-19 | TSEC_FALCON_EXCI_EXPC |
20-23 | TSEC_FALCON_EXCI_EXCAUSE
0x00: TRAP0 0x01: TRAP1 0x02: TRAP2 0x03: TRAP3 0x08: ILL_INS (invalid opcode) 0x09: INV_INS (authentication entry) 0x0A: MISS_INS (page miss) 0x0B: DHIT_INS (page multiple hit) 0x0F: BRKPT_INS (breakpoint hit) |
Contains information about raised exceptions.
TSEC_FALCON_SVEC_SPR
Bits | Description |
---|---|
18 | TSEC_FALCON_SVEC_SPR_SIGPASS |
TSEC_FALCON_RSTAT0
Mirror of the ICD status register 0.
TSEC_FALCON_RSTAT3
Mirror of the ICD status register 3.
TSEC_FALCON_CPUCTL
Bits | Description |
---|---|
0 | TSEC_FALCON_CPUCTL_IINVAL |
1 | TSEC_FALCON_CPUCTL_STARTCPU |
2 | TSEC_FALCON_CPUCTL_SRESET |
3 | TSEC_FALCON_CPUCTL_HRESET |
4 | TSEC_FALCON_CPUCTL_HALTED |
5 | TSEC_FALCON_CPUCTL_STOPPED |
6 | TSEC_FALCON_CPUCTL_ALIAS_EN |
Used for signaling the Falcon CPU.
TSEC_FALCON_BOOTVEC
Bits | Description |
---|---|
0-31 | TSEC_FALCON_BOOTVEC_VEC |
Takes the Falcon's boot vector address.
TSEC_FALCON_HWCFG
Bits | Description |
---|---|
0-8 | TSEC_FALCON_HWCFG_IMEM_SIZE |
9-17 | TSEC_FALCON_HWCFG_DMEM_SIZE |
18-26 | TSEC_FALCON_HWCFG_METHODFIFO_DEPTH |
27-31 | TSEC_FALCON_HWCFG_DMAQUEUE_DEPTH |
TSEC_FALCON_DMACTL
Bits | Description |
---|---|
0 | TSEC_FALCON_DMACTL_REQUIRE_CTX |
1 | TSEC_FALCON_DMACTL_DMEM_SCRUBBING |
2 | TSEC_FALCON_DMACTL_IMEM_SCRUBBING |
3-6 | TSEC_FALCON_DMACTL_DMAQ_NUM |
7 | TSEC_FALCON_DMACTL_SECURE_STAT |
Used for configuring the Falcon's DMA engine.
TSEC_FALCON_DMATRFBASE
Bits | Description |
---|---|
0-31 | TSEC_FALCON_DMATRFBASE_BASE |
Base address of the external memory buffer, shifted right by 8.
The current transfer address is calculated by adding TSEC_FALCON_DMATRFFBOFFS to the base.
TSEC_FALCON_DMATRFMOFFS
Bits | Description |
---|---|
0-15 | TSEC_FALCON_DMATRFMOFFS_OFFS |
For transfers to DMEM: the destination address. For transfers to IMEM: the destination virtual IMEM page.
TSEC_FALCON_DMATRFCMD
Bits | Description |
---|---|
0 | TSEC_FALCON_DMATRFCMD_FULL |
1 | TSEC_FALCON_DMATRFCMD_IDLE |
2-3 | TSEC_FALCON_DMATRFCMD_SEC |
4 | TSEC_FALCON_DMATRFCMD_IMEM |
5 | TSEC_FALCON_DMATRFCMD_WRITE |
8-10 | TSEC_FALCON_DMATRFCMD_SIZE |
12-14 | TSEC_FALCON_DMATRFCMD_CTXDMA |
Used for configuring DMA transfers.
TSEC_FALCON_DMATRFFBOFFS
Bits | Description |
---|---|
0-15 | TSEC_FALCON_DMATRFFBOFFS_OFFS |
For transfers to IMEM: the destination physical IMEM page.
TSEC_FALCON_DMAPOLL_FB
Bits | Description |
---|---|
0 | TSEC_FALCON_DMAPOLL_FB_FENCE_ACTIVE |
1 | TSEC_FALCON_DMAPOLL_FB_DMA_ACTIVE |
4 | TSEC_FALCON_DMAPOLL_FB_CFG_R_FENCE |
5 | TSEC_FALCON_DMAPOLL_FB_CFG_W_FENCE |
16-23 | TSEC_FALCON_DMAPOLL_FB_WCOUNT |
24-31 | TSEC_FALCON_DMAPOLL_FB_RCOUNT |
Contains the status of a DMA transfer between the Falcon and external memory.
TSEC_FALCON_DMAPOLL_CP
Bits | Description |
---|---|
0 | TSEC_FALCON_DMAPOLL_CP_FENCE_ACTIVE |
1 | TSEC_FALCON_DMAPOLL_CP_DMA_ACTIVE |
4 | TSEC_FALCON_DMAPOLL_CP_CFG_R_FENCE |
5 | TSEC_FALCON_DMAPOLL_CP_CFG_W_FENCE |
16-23 | TSEC_FALCON_DMAPOLL_CP_WCOUNT |
24-31 | TSEC_FALCON_DMAPOLL_CP_RCOUNT |
Contains the status of a DMA transfer between the Falcon and the SCP.
TSEC_FALCON_HWCFG1
Bits | Description |
---|---|
0-3 | TSEC_FALCON_HWCFG1_CORE_REV |
4-5 | TSEC_FALCON_HWCFG1_SECURITY_MODEL |
6-7 | TSEC_FALCON_HWCFG1_CORE_REV_SUBVERSION |
8-11 | TSEC_FALCON_HWCFG1_IMEM_PORTS |
12-15 | TSEC_FALCON_HWCFG1_DMEM_PORTS |
16-20 | TSEC_FALCON_HWCFG1_TAG_WIDTH |
27 | TSEC_FALCON_HWCFG1_DBG_PRIV_BUS |
28 | TSEC_FALCON_HWCFG1_CSB_SIZE_16M |
29 | TSEC_FALCON_HWCFG1_PRIV_DIRECT |
30 | TSEC_FALCON_HWCFG1_DMEM_APERTURES |
31 | TSEC_FALCON_HWCFG1_IMEM_AUTOFILL |
TSEC_FALCON_IMCTL
Bits | Description |
---|---|
0-23 | TSEC_FALCON_IMCTL_ADDR_BLK |
24-26 | TSEC_FALCON_IMCTL_CMD
0x00: NOP 0x01: IMINV (ITLB) 0x02: IMBLK (PTLB) 0x03: IMTAG (VTLB) 0x04: IMTAG_SETVLD |
Controls the Falcon TLB.
TSEC_FALCON_IMSTAT
Bits | Description |
---|---|
0-31 | TSEC_FALCON_IMSTAT_VAL |
Returns the result of the last command from TSEC_FALCON_IMCTL.
TSEC_FALCON_TRACEIDX
Bits | Description |
---|---|
0-7 | TSEC_FALCON_TRACEIDX_IDX |
16-23 | TSEC_FALCON_TRACEIDX_MAXIDX |
24-31 | TSEC_FALCON_TRACEIDX_CNT |
Controls the index for tracing with TSEC_FALCON_TRACEPC.
TSEC_FALCON_TRACEPC
Bits | Description |
---|---|
0-23 | TSEC_FALCON_TRACEPC_PC |
Returns the PC of the last call or branch executed.
TSEC_FALCON_IMEMC0
Bits | Description |
---|---|
2-7 | TSEC_FALCON_IMEMC_OFFS |
8-15 | TSEC_FALCON_IMEMC_BLK |
24 | TSEC_FALCON_IMEMC_AINCW |
25 | TSEC_FALCON_IMEMC_AINCR |
28 | TSEC_FALCON_IMEMC_SECURE |
29 | TSEC_FALCON_IMEMC_SEC_ATOMIC |
30 | TSEC_FALCON_IMEMC_SEC_WR_VIO |
31 | TSEC_FALCON_IMEMC_SEC_LOCK |
Used for configuring access to Falcon's IMEM.
TSEC_FALCON_IMEMD0
Bits | Description |
---|---|
0-31 | TSEC_FALCON_IMEMD_DATA |
Returns or takes the value for an IMEM read/write operation.
TSEC_FALCON_IMEMT0
Bits | Description |
---|---|
0-15 | TSEC_FALCON_IMEMT_TAG |
Returns or takes the virtual page index for an IMEM read/write operation.
TSEC_FALCON_DMEMC0
Bits | Description |
---|---|
2-7 | TSEC_FALCON_DMEMC_OFFS |
8-15 | TSEC_FALCON_DMEMC_BLK |
24 | TSEC_FALCON_DMEMC_AINCW |
25 | TSEC_FALCON_DMEMC_AINCR |
Used for configuring access to Falcon's DMEM.
TSEC_FALCON_DMEMD0
Bits | Description |
---|---|
0-31 | TSEC_FALCON_DMEMD_DATA |
Returns or takes the value for a DMEM read/write operation.
TSEC_FALCON_ICD_CMD
Bits | Description |
---|---|
0-3 | TSEC_FALCON_ICD_CMD_OPC
0x00: STOP 0x01: RUN (run from PC) 0x02: JRUN (run from address) 0x03: RUNB (run from PC) 0x04: JRUNB (run from address) 0x05: STEP (step from PC) 0x06: JSTEP (step from address) 0x07: EMASK (set exception mask) 0x08: RREG (read register) 0x09: WREG (write register) 0x0A: RDM (read data memory) 0x0B: WDM (write data memory) 0x0C: RCM (read MMIO/configuration memory) 0x0D: WCM (write MMIO/configuration memory) 0x0E: RSTAT (read status) 0x0F: SBU |
6-7 | TSEC_FALCON_ICD_CMD_SZ
0x00: B (byte) 0x01: HW (half word) 0x02: W (word) |
8-12 | TSEC_FALCON_ICD_CMD_IDX
0x00: REG0 | RSTAT0 | WB0 0x01: REG1 | RSTAT1 | WB1 0x02: REG2 | RSTAT2 | WB2 0x03: REG3 | RSTAT3 | WB3 0x04: REG4 | RSTAT4 0x05: REG5 | RSTAT5 0x06: REG6 0x07: REG7 0x08: REG8 0x09: REG9 0x0A: REG10 0x0B: REG11 0x0C: REG12 0x0D: REG13 0x0E: REG14 0x0F: REG15 0x10: IV0 0x11: IV1 0x12: UNDEFINED 0x13: EV 0x14: SP 0x15: PC 0x16: IMB 0x17: DMB 0x18: CSW 0x19: CCR 0x1A: SEC 0x1B: CTX 0x1C: EXCI 0x1D: SEC1 0x1E: IMB1 0x1F: DMB1 |
14 | TSEC_FALCON_ICD_CMD_ERROR |
15 | TSEC_FALCON_ICD_CMD_RDVLD |
16-31 | TSEC_FALCON_ICD_CMD_PARM
0x0001: EMASK_TRAP0 0x0002: EMASK_TRAP1 0x0004: EMASK_TRAP2 0x0008: EMASK_TRAP3 0x0010: EMASK_EXC_UNIMP 0x0020: EMASK_EXC_IMISS 0x0040: EMASK_EXC_IMHIT 0x0080: EMASK_EXC_IBREAK 0x0100: EMASK_IV0 0x0200: EMASK_IV1 0x0400: EMASK_IV2 0x0800: EMASK_EXT0 0x1000: EMASK_EXT1 0x2000: EMASK_EXT2 0x4000: EMASK_EXT3 0x8000: EMASK_EXT4 |
Used for sending commands to the Falcon's in-chip debugger.
TSEC_FALCON_ICD_ADDR
Bits | Description |
---|---|
0-31 | TSEC_FALCON_ICD_ADDR_ADDR |
Takes the target address for the Falcon's in-chip debugger.
TSEC_FALCON_ICD_WDATA
Bits | Description |
---|---|
0-31 | TSEC_FALCON_ICD_WDATA_DATA |
Takes the data for writing using the Falcon's in-chip debugger.
TSEC_FALCON_ICD_RDATA
Bits | Description |
---|---|
0-31 | TSEC_FALCON_ICD_RDATA_DATA |
Returns the data read using the Falcon's in-chip debugger.
When reading from an internal status register (STAT), the following applies:
Bits | Description |
---|---|
0 | RSTAT0_MEM_STALL |
1 | RSTAT0_DMA_STALL |
2 | RSTAT0_FENCE_STALL |
3 | RSTAT0_DIV_STALL |
4 | RSTAT0_DMA_STALL_DMAQ |
5 | RSTAT0_DMA_STALL_DMWAITING |
6 | RSTAT0_DMA_STALL_IMWAITING |
7 | RSTAT0_ANY_STALL |
8 | RSTAT0_SBFULL_STALL |
9 | RSTAT0_SBHIT_STALL |
10 | RSTAT0_FLOW_STALL |
11 | RSTAT0_SP_STALL |
12 | RSTAT0_BL_STALL |
13 | RSTAT0_IPND_STALL |
14 | RSTAT0_LDSTQ_STALL |
16 | RSTAT0_NOINSTR_STALL |
20 | RSTAT0_HALTSTOP_FLUSH |
21 | RSTAT0_AFILL_FLUSH |
22 | RSTAT0_EXC_FLUSH |
23-25 | RSTAT0_IRQ_FLUSH |
28 | RSTAT0_VALIDRD |
29 | RSTAT0_WAITING |
30 | RSTAT0_HALTED |
31 | RSTAT0_MTHD_FULL |
Bits | Description |
---|---|
0-3 | RSTAT1_WB_ALLOC |
4-7 | RSTAT1_WB_VALID |
8-9 | RSTAT1_WB0_SZ |
10-11 | RSTAT1_WB1_SZ |
12-13 | RSTAT1_WB2_SZ |
14-15 | RSTAT1_WB3_SZ |
16-19 | RSTAT1_WB0_IDX |
20-23 | RSTAT1_WB1_IDX |
24-27 | RSTAT1_WB2_IDX |
28-31 | RSTAT1_WB3_IDX |
Bits | Description |
---|---|
0-3 | RSTAT2_DMAQ_NUM |
4 | RSTAT2_DMA_ENABLE |
5-7 | RSTAT2_LDSTQ_NUM |
16-19 | RSTAT2_EM_BUSY |
20-23 | RSTAT2_EM_ACKED |
24-27 | RSTAT2_EM_ISWR |
28-31 | RSTAT2_EM_DVLD |
Bits | Description |
---|---|
0 | RSTAT3_MTHD_IDLE |
1 | RSTAT3_CTXSW_IDLE |
2 | RSTAT3_DMA_IDLE |
3 | RSTAT3_SCP_IDLE |
4 | RSTAT3_LDST_IDLE |
5 | RSTAT3_SBWB_EMPTY |
6-8 | RSTAT3_CSWIE |
10 | RSTAT3_CSWE |
12-14 | RSTAT3_CTXSW_STATE
0x00: IDLE 0x01: SM_CHECK 0x02: SM_SAVE 0x03: SM_SAVE_WAIT 0x04: SM_BLK_BIND 0x05: SM_RESET 0x06: SM_RESETWAIT 0x07: SM_ACK |
15 | RSTAT3_CTXSW_PEND |
17 | RSTAT3_DMA_FBREQ_IDLE |
18 | RSTAT3_DMA_ACKQ_EMPTY |
19 | RSTAT3_DMA_RDQ_EMPTY |
20 | RSTAT3_DMA_WR_BUSY |
21 | RSTAT3_DMA_RD_BUSY |
22 | RSTAT3_LDST_XT_BUSY |
23 | RSTAT3_LDST_XT_BLOCK |
24 | RSTAT3_ENG_IDLE |
Bits | Description |
---|---|
0-1 | RSTAT4_ICD_STATE
0x00: NORMAL 0x01: WAIT_ISSUE_CLEAR 0x02: WAIT_EXLDQ_CLEAR 0x03: FULL_DBG_MODE |
2-3 | RSTAT4_ICD_MODE
0x00: SUPPRESSICD 0x01: ENTERICD_IBRK 0x02: ENTERICD_STEP |
16 | RSTAT4_ICD_EMASK_TRAP0 |
17 | RSTAT4_ICD_EMASK_TRAP1 |
18 | RSTAT4_ICD_EMASK_TRAP2 |
19 | RSTAT4_ICD_EMASK_TRAP3 |
20 | RSTAT4_ICD_EMASK_EXC_UNIMP |
21 | RSTAT4_ICD_EMASK_EXC_IMISS |
22 | RSTAT4_ICD_EMASK_EXC_IMHIT |
23 | RSTAT4_ICD_EMASK_EXC_IBREAK |
24 | RSTAT4_ICD_EMASK_IV0 |
25 | RSTAT4_ICD_EMASK_IV1 |
26 | RSTAT4_ICD_EMASK_IV2 |
27 | RSTAT4_ICD_EMASK_EXT0 |
28 | RSTAT4_ICD_EMASK_EXT1 |
29 | RSTAT4_ICD_EMASK_EXT2 |
30 | RSTAT4_ICD_EMASK_EXT3 |
31 | RSTAT4_ICD_EMASK_EXT4 |
Bits | Description |
---|---|
0-7 | RSTAT5_LRU_STATE |
TSEC_FALCON_SCTL
Bits | Description |
---|---|
0-1 | TSEC_FALCON_SCTL_SEC_MODE
0: Non-secure 1: Light Secure 2: Heavy Secure |
4-5 | Previous security mode
0: Non-secure 1: Light Secure 2: Heavy Secure |
12-13 | Unknown |
14 | Initialize the transition to LS mode |
TSEC_FALCON_SSTAT
Bits | Description |
---|---|
31 | Set on memory protection violation |
TSEC_FALCON_SPROT_IMEM
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to Falcon IMEM.
TSEC_FALCON_SPROT_DMEM
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to Falcon DMEM.
TSEC_FALCON_SPROT_CPUCTL
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the TSEC_FALCON_CPUCTL register.
TSEC_FALCON_SPROT_MISC
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the following registers:
- TSEC_FALCON_PRIVSTATE
- TSEC_FALCON_SFTRESET
- TSEC_FALCON_ADDR
- TSEC_FALCON_DMACTL
- TSEC_FALCON_IMCTL
- TSEC_FALCON_IMSTAT
- TSEC_FALCON_UNK_250
- TSEC_FALCON_DMAINFO_CTL
TSEC_FALCON_SPROT_IRQ
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the following registers:
- TSEC_FALCON_IRQMODE
- TSEC_FALCON_IRQMSET
- TSEC_FALCON_IRQMCLR
- TSEC_FALCON_IRQDEST
- TSEC_FALCON_GPTMRINT
- TSEC_FALCON_GPTMRVAL
- TSEC_FALCON_GPTMRCTL
- TSEC_FALCON_IRQDEST2
- TSEC_FALCON_UNK_E0
TSEC_FALCON_SPROT_MTHD
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the following registers:
- TSEC_FALCON_ITFEN
- TSEC_FALCON_CURCTX
- TSEC_FALCON_NXTCTX
- TSEC_FALCON_CTXACK
- TSEC_FALCON_MTHDDATA
- TSEC_FALCON_MTHDID
- TSEC_FALCON_MTHDWDAT
- TSEC_FALCON_MTHDCOUNT
- TSEC_FALCON_MTHDPOP
- TSEC_FALCON_MTHDRAMSZ
- TSEC_FALCON_DEBUG1
TSEC_FALCON_SPROT_SCTL
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the TSEC_FALCON_SCTL register.
TSEC_FALCON_SPROT_WDTMR
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to the following registers:
- TSEC_FALCON_WDTMRVAL
- TSEC_FALCON_WDTMRCTL
TSEC_SCP_CTL0
Bits | Description |
---|---|
10 | Enable the LOAD interface |
12 | Enable the STORE interface |
14 | Enable the CMD interface |
16 | Enable the SEQ controller |
20 | Enable the TSEC_SCP_CMD register |
TSEC_SCP_CTL1
Bits | Description |
---|---|
0 | Flush the SEQ controller |
8 | Unknown |
11 | Enable RND test mode |
12 | Enable the RND controller |
16 | Enable LOAD interface dummy mode (all reads return 0) |
20 | Enable LOAD interface bypassing (all reads are dropped) |
24 | Enable STORE interface bypassing (all writes are dropped) |
TSEC_SCP_CTL_STAT
Bits | Description |
---|---|
20 | TSEC_SCP_CTL_STAT_DEBUG_MODE |
TSEC_SCP_CTL_LOCK
Bits | Description |
---|---|
0 | Enable lockdown mode |
1 | Unknown |
2 | Unknown |
3 | Unknown |
4 | Lock the SCP |
5 | Unknown |
6 | Unknown |
7 | Unknown |
Controls lockdown mode and can only be cleared in Heavy Secure mode.
TSEC_SCP_CFG
Bits | Description |
---|---|
0 | Unknown |
1 | Unknown |
2 | Unknown |
3 | Unknown |
4 | Unknown |
8 | Flush the CMD interface |
12-13 | Carry chain size
0: 32 bits 1: 64 bits 2: 96 bits 3: 128 bits |
16-31 | Timeout value |
TSEC_SCP_CTL_SCP
Bits | Description |
---|---|
0 | Swap SCP master |
1 | Current SCP master
0: Falcon 1: External |
TSEC_SCP_CTL_PKEY
Bits | Description |
---|---|
0 | TSEC_SCP_CTL_PKEY_REQUEST_RELOAD |
1 | TSEC_SCP_CTL_PKEY_LOADED |
TSEC_SCP_CTL_DBG
Bits | Description |
---|---|
0 | Unknown |
4 | Unknown |
8 | Unknown |
12 | Unknown |
TSEC_SCP_DBG0
Bits | Description |
---|---|
0-3 | Index |
4 | Automatic increment |
5-6 | Target
0: None 1: STORE 2: LOAD 3: SEQ |
8-12 | SEQ size |
13-16 | Unknown |
17 | SEQ instruction is valid |
18 | SEQ controller is running in HS mode |
19-22 | LOAD size |
23 | LOAD instruction is valid |
24 | LOAD interface is running in HS mode |
25-26 | STORE size |
30 | STORE instruction is valid |
31 | STORE interface is running in HS mode |
Used for debugging crypto controllers such as the SEQ (crypto sequence).
TSEC_SCP_DBG1
Bits | Description |
---|---|
0-3 | SEQ instruction's first operand |
4-9 | SEQ instruction's second operand |
10-14 | SEQ instruction's opcode |
Used for retrieving debug data. Contains information on the last crypto sequence created when debugging the SEQ controller.
TSEC_SCP_DBG2
Bits | Description |
---|---|
0-1 | SEQ controller's state
0: Idle 1: Recording is active (cs0begin/cs1begin) |
4-7 | Number of SEQ instructions left |
12-15 | Active crypto key register |
Used for retrieving additional debug data associated with the SEQ controller.
TSEC_SCP_CMD
Bits | Description |
---|---|
0-3 | Destination register |
8-13 | Source register or immediate value |
20-24 | Command opcode
0x0: nop (fuc5 opcode 0x00) 0x1: cmov (fuc5 opcode 0x84) 0x2: cxsin (fuc5 opcode 0x88) or xdst (with cxset) 0x3: cxsout (fuc5 opcode 0x8C) or xdld (with cxset) 0x4: crnd (fuc5 opcode 0x90) 0x5: cs0begin (fuc5 opcode 0x94) 0x6: cs0exec (fuc5 opcode 0x98) 0x7: cs1begin (fuc5 opcode 0x9C) 0x8: cs1exec (fuc5 opcode 0xA0) 0x9: invalid (fuc5 opcode 0xA4) 0xA: cchmod (fuc5 opcode 0xA8) 0xB: cxor (fuc5 opcode 0xAC) 0xC: cadd (fuc5 opcode 0xB0) 0xD: cand (fuc5 opcode 0xB4) 0xE: crev (fuc5 opcode 0xB8) 0xF: cprecmac (fuc5 opcode 0xBC) 0x10: csecret (fuc5 opcode 0xC0) 0x11: ckeyreg (fuc5 opcode 0xC4) 0x12: ckexp (fuc5 opcode 0xC8) 0x13: ckrexp (fuc5 opcode 0xCC) 0x14: cenc (fuc5 opcode 0xD0) 0x15: cdec (fuc5 opcode 0xD4) 0x16: csigauth (fuc5 opcode 0xD8) 0x17: csigenc (fuc5 opcode 0xDC) 0x18: csigclr (fuc5 opcode 0xE0) |
28 | CMD instruction is valid |
31 | CMD interface is running in HS mode |
Contains information on the last crypto command executed.
TSEC_SCP_STAT0
Bits | Description |
---|---|
0 | SCP is active |
2 | CMD interface is active |
4 | STORE interface is active |
6 | SEQ controller is active |
8 | TSEC_SCP_CMD register is enabled |
10 | LOAD interface is active |
14 | AES controller is active |
16 | RND controller is active |
Contains the status of the crypto controllers and interfaces.
TSEC_SCP_STAT1
Bits | Description |
---|---|
0-1 | Signature comparison result
0: None 1: Running 2: Failed 3: Succeeded |
4 | LOAD interface is running in HS mode |
6 | LOAD interface is ready |
8 | STORE interface is running in HS mode |
10 | STORE interface received a valid instruction |
12 | CMD interface is running in HS mode |
14 | CMD interface received a valid instruction |
Contains the status of the last authentication attempt and other miscellaneous statuses.
TSEC_SCP_STAT2
Bits | Description |
---|---|
0-4 | Current SEQ opcode |
5-9 | Current CMD opcode |
10-14 | Pending CMD opcode |
15-16 | AES operation
0: Encryption 1: Decryption 2: Key expansion 3: Key reverse expansion |
24 | Unknown |
25 | STORE operation is stalled |
26 | LOAD operation is stalled |
27 | RND operation is stalled |
28 | Unknown |
29 | AES operation is stalled |
Contains the status of crypto operations.
TSEC_SCP_RND_STAT0
Bits | Description |
---|---|
0 | RND controller is ready |
4-7 | Unknown |
8-11 | Unknown |
16 | Unknown |
20 | Unknown |
TSEC_SCP_RND_STAT1
Bits | Description |
---|---|
0-15 | Unknown |
16-31 | Unknown |
TSEC_SCP_IRQSTAT
Bits | Description |
---|---|
0 | RND ready |
8 | ACL error |
12 | SEC error |
16 | CMD error |
20 | Single step |
24 | RND operation |
28 | Timeout |
Used for getting the status of crypto IRQs.
TSEC_SCP_IRQMASK
Bits | Description |
---|---|
0 | RND ready |
8 | ACL error |
12 | SEC error |
16 | CMD error |
20 | Single step |
24 | RND operation |
28 | Timeout |
Used for getting the value of the mask for crypto IRQs.
TSEC_SCP_ACL_ERR
Bits | Description |
---|---|
0 | Writing to a crypto register without the correct ACL |
4 | Reading from a crypto register without the correct ACL |
8 | Invalid ACL change (cchmod) |
31 | ACL error occurred |
Contains information on errors generated by the ACL error IRQ.
TSEC_SCP_SEC_ERR
Bits | Description |
---|---|
0 | Unknown |
1-2 | Unknown |
4 | Unknown |
5-6 | Unknown |
16 | Unknown |
17-18 | Unknown |
20 | Unknown |
21-22 | Unknown |
24 | Unknown |
25-26 | Unknown |
31 | SEC error occurred |
TSEC_SCP_CMD_ERR
Bits | Description |
---|---|
0 | Invalid command |
4 | Empty crypto sequence |
8 | Crypto sequence is too long |
12 | Crypto sequence was not finished |
16 | Forbidden signature operation (csigenc, csigclr or csigauth in NS mode) |
20 | Invalid signature operation (csigauth in HS mode) |
24 | Forbidden ACL change (cchmod in NS mode) |
Contains information on errors generated by the CMD error IRQ.
TSEC_RND_CTL0
Bits | Description |
---|---|
0-31 | RND clock trigger lower limit |
TSEC_RND_CTL1
Bits | Description |
---|---|
0-15 | RND clock trigger upper limit |
16-31 | RND clock trigger mask |
TSEC_TFBIF_CTL
Bits | Description |
---|---|
0 | TSEC_TFBIF_CTL_CLR_BWCOUNT |
1 | TSEC_TFBIF_CTL_ENABLE |
2 | TSEC_TFBIF_CTL_CLR_IDLEWDERR |
3 | TSEC_TFBIF_CTL_RESET |
4 | TSEC_TFBIF_CTL_IDLE |
5 | TSEC_TFBIF_CTL_IDLEWDERR |
6 | TSEC_TFBIF_CTL_SRTOUT |
7 | TSEC_TFBIF_CTL_CLR_SRTOUT |
8-11 | TSEC_TFBIF_CTL_SRTOVAL |
12 | TSEC_TFBIF_CTL_VPR |
TSEC_TFBIF_MCCIF_FIFOCTRL
Bits | Description |
---|---|
0 | TSEC_TFBIF_MCCIF_FIFOCTRL_RCLK_OVERRIDE |
1 | TSEC_TFBIF_MCCIF_FIFOCTRL_WCLK_OVERRIDE |
2 | TSEC_TFBIF_MCCIF_FIFOCTRL_WRCL_MCLE2X |
3 | TSEC_TFBIF_MCCIF_FIFOCTRL_RDMC_RDFAST |
4 | TSEC_TFBIF_MCCIF_FIFOCTRL_WRMC_CLLE2X |
5 | TSEC_TFBIF_MCCIF_FIFOCTRL_RDCL_RDFAST |
6 | TSEC_TFBIF_MCCIF_FIFOCTRL_CCLK_OVERRIDE |
7 | TSEC_TFBIF_MCCIF_FIFOCTRL_RCLK_OVR_MODE |
8 | TSEC_TFBIF_MCCIF_FIFOCTRL_WCLK_OVR_MODE |
TSEC_TFBIF_MCCIF_FIFOCTRL1
Bits | Description |
---|---|
0-15 | TSEC_TFBIF_MCCIF_FIFOCTRL1_SRD2MC_REORDER_DEPTH_LIMIT |
16-31 | TSEC_TFBIF_MCCIF_FIFOCTRL1_SWR2MC_REORDER_DEPTH_LIMIT |
TSEC_TFBIF_THROTTLE
Bits | Description |
---|---|
0-11 | TSEC_TFBIF_THROTTLE_BUCKET_SIZE |
16-27 | TSEC_TFBIF_THROTTLE_LEAK_COUNT |
30-31 | TSEC_TFBIF_THROTTLE_LEAK_SIZE |
TSEC_TFBIF_DBG_STAT0
Bits | Description |
---|---|
0 | TSEC_TFBIF_DBG_STAT0_1K_TRANSFER |
1 | TSEC_TFBIF_DBG_STAT0_RREQ_ISSUED |
2 | TSEC_TFBIF_DBG_STAT0_WREQ_ISSUED |
3 | TSEC_TFBIF_DBG_STAT0_TAGQ_ISSUED |
4 | TSEC_TFBIF_DBG_STAT0_STALL_RDATQ |
5 | TSEC_TFBIF_DBG_STAT0_STALL_RACKQ |
6 | TSEC_TFBIF_DBG_STAT0_STALL_WREQQ |
7 | TSEC_TFBIF_DBG_STAT0_STALL_WDATQ |
8 | TSEC_TFBIF_DBG_STAT0_STALL_WACKQ |
9 | TSEC_TFBIF_DBG_STAT0_STALL_RREQ_PENDING |
10 | TSEC_TFBIF_DBG_STAT0_STALL_WREQ_PENDING |
11 | TSEC_TFBIF_DBG_STAT0_STALL_MREQ |
12 | TSEC_TFBIF_DBG_STAT0_ENGINE_IDLE |
13 | TSEC_TFBIF_DBG_STAT0_RMCCIF_IDLE |
14 | TSEC_TFBIF_DBG_STAT0_WMCCIF_IDLE |
15 | TSEC_TFBIF_DBG_STAT0_CSB_IDLE |
16 | TSEC_TFBIF_DBG_STAT0_RU_IDLE |
17 | TSEC_TFBIF_DBG_STAT0_WU_IDLE |
19 | TSEC_TFBIF_DBG_STAT0_UNWEIGHT_ACTMON_ACTIVE |
20 | TSEC_TFBIF_DBG_STAT0_UNWEIGHT_ACTMON_MCB |
TSEC_TFBIF_SPROT_EMEM
Bits | Description |
---|---|
0-3 | Read access level |
4-7 | Write access level |
Controls accesses to external memory regions. Accessible in HS mode only.
TSEC_TFBIF_TRANSCFG
Bits | Description |
---|---|
0 | TSEC_TFBIF_TRANSCFG_ATT0_SWID |
4 | TSEC_TFBIF_TRANSCFG_ATT1_SWID |
8 | TSEC_TFBIF_TRANSCFG_ATT2_SWID |
12 | TSEC_TFBIF_TRANSCFG_ATT3_SWID |
16 | TSEC_TFBIF_TRANSCFG_ATT4_SWID |
20 | TSEC_TFBIF_TRANSCFG_ATT5_SWID |
24 | TSEC_TFBIF_TRANSCFG_ATT6_SWID |
28 | TSEC_TFBIF_TRANSCFG_ATT7_SWID |
Configures the software ID per CTXDMA port for memory transactions. Software ID 0 (HW_SWID) forces all transactions to go through the SMMU while software ID 1 (PHY_SWID) bypasses it. Accessible in HS mode only.
[6.0.0+] The nvhost_tsec firmware sets this register to 0x10 or 0x111110 before reading memory from the GPU UCODE carveout.
TSEC_TFBIF_REGIONCFG
Bits | Description |
---|---|
0-2 | TSEC_TFBIF_REGIONCFG_T0_APERT_ID |
3 | TSEC_TFBIF_REGIONCFG_T0_VPR |
4-6 | TSEC_TFBIF_REGIONCFG_T1_APERT_ID |
7 | TSEC_TFBIF_REGIONCFG_T1_VPR |
8-10 | TSEC_TFBIF_REGIONCFG_T2_APERT_ID |
11 | TSEC_TFBIF_REGIONCFG_T2_VPR |
12-14 | TSEC_TFBIF_REGIONCFG_T3_APERT_ID |
15 | TSEC_TFBIF_REGIONCFG_T3_VPR |
16-18 | TSEC_TFBIF_REGIONCFG_T4_APERT_ID |
19 | TSEC_TFBIF_REGIONCFG_T4_VPR |
20-22 | TSEC_TFBIF_REGIONCFG_T5_APERT_ID |
23 | TSEC_TFBIF_REGIONCFG_T5_VPR |
24-26 | TSEC_TFBIF_REGIONCFG_T6_APERT_ID |
27 | TSEC_TFBIF_REGIONCFG_T6_VPR |
28-30 | TSEC_TFBIF_REGIONCFG_T7_APERT_ID |
31 | TSEC_TFBIF_REGIONCFG_T7_VPR |
Configures the aperture ID and VPR mode per CTXDMA port for memory region accessing. Accessible in HS mode only.
[6.0.0+] The nvhost_tsec firmware sets this register to 0x20 or 0x140 before reading memory from the GPU UCODE carveout.
TSEC_TFBIF_ACTMON_ACTIVE_MASK
Bits | Description |
---|---|
0 | TSEC_TFBIF_ACTMON_ACTIVE_MASK_STARVED_MC |
1 | TSEC_TFBIF_ACTMON_ACTIVE_MASK_STALLED_MC |
2 | TSEC_TFBIF_ACTMON_ACTIVE_MASK_DELAYED_MC |
3 | TSEC_TFBIF_ACTMON_ACTIVE_MASK_ACTIVE |
Takes the memory access mask for the Activity Monitor. Disconnected on the TSEC, but available on NVDEC, NVENC and NVJPG.
TSEC_TFBIF_ACTMON_ACTIVE_BORPS
Bits | Description |
---|---|
0 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_STARVED_MC_POLARITY |
1 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_STARVED_MC_OPERATION |
2 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_STALLED_MC_POLARITY |
3 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_STALLED_MC_OPERATION |
4 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_DELAYED_MC_POLARITY |
5 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_DELAYED_MC_OPERATION |
6 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_ACTIVE_POLARITY |
7 | TSEC_TFBIF_ACTMON_ACTIVE_BORPS_ACTIVE_OPERATION |
Takes the billions of records per second count for the Activity Monitor. Disconnected on the TSEC, but available on NVDEC, NVENC and NVJPG.
TSEC_TFBIF_ACTMON_ACTIVE_WEIGHT
Bits | Description |
---|---|
0-31 | TSEC_TFBIF_ACTMON_ACTIVE_WEIGHT_VAL |
Controls the Activity Monitor. Disconnected on the TSEC, but available on NVDEC, NVENC and NVJPG.
TSEC_CG
Bits | Description |
---|---|
0-5 | TSEC_CG_IDLE_CG_DLY_CNT |
6 | TSEC_CG_IDLE_CG_EN |
16-18 | TSEC_CG_WAKEUP_DLY_CNT |
19 | TSEC_CG_WAKEUP_DLY_EN |
TSEC_BAR0_CTL
Bits | Description |
---|---|
0 | TSEC_BAR0_CTL_READ |
1 | TSEC_BAR0_CTL_WRITE |
4-7 | TSEC_BAR0_CTL_BYTE_MASK |
12-13 | TSEC_BAR0_CTL_STATUS
0: Idle 1: Busy 2: Error 3: Disabled |
31 | TSEC_BAR0_CTL_INIT |
A BAR0 DMA read/write operation requires bits TSEC_BAR0_CTL_INIT and TSEC_BAR0_CTL_READ/TSEC_BAR0_CTL_WRITE to be set in TSEC_BAR0_CTL.
During the transfer, TSEC_BAR0_CTL_STATUS is set to "Busy".
Accessing an invalid address sets TSEC_BAR0_CTL_STATUS to "Error".
TSEC_BAR0_ADDR
Bits | Description |
---|---|
0-31 | TSEC_BAR0_ADDR_VAL |
Takes the address for DMA transfers between TSEC and HOST1X (master and clients).
TSEC_BAR0_DATA
Bits | Description |
---|---|
0-31 | TSEC_BAR0_DATA_VAL |
Takes the data for DMA transfers between TSEC and HOST1X (master and clients).
TSEC_BAR0_TIMEOUT
Bits | Description |
---|---|
0-31 | TSEC_BAR0_TIMEOUT_VAL |
Takes the timeout value for DMA transfers between TSEC and HOST1X (master and clients).
TSEC_TEGRA_CTL
Bits | Description |
---|---|
16 | TSEC_TEGRA_CTL_TKFI_KFUSE |
17 | TSEC_TEGRA_CTL_TKFI_RESTART_FSM_KFUSE |
24 | TSEC_TEGRA_CTL_TMPI_FORCE_IDLE_INPUTS_I2C |
25 | TSEC_TEGRA_CTL_TMPI_RESTART_FSM_HOST1X |
26 | TSEC_TEGRA_CTL_TMPI_RESTART_FSM_APB |
27 | TSEC_TEGRA_CTL_TMPI_DISABLE_OUTPUT_I2C |
Falcon
"Falcon" (FAst Logic CONtroller) is a proprietary general purpose CPU which can be found inside various hardware blocks that require some sort of logic processing such as TSEC (TSECA and TSECB), NVDEC, NVENC, NVJPG, VIC, GPU PMU and XUSB.
Processor Registers
A total of 32 processor registers are available in the Falcon CPU.
REG0-REG15
These are 16 32-bit GPRs (general purpose registers).
IV0
This is a SPR (special purpose register) that holds the address for interrupt vector 0.
IV1
This is a SPR (special purpose register) that holds the address for interrupt vector 1.
IV2
This is a SPR (special purpose register) that holds the address for interrupt vector 2. This register is considered "UNDEFINED" and appears to be unused.
EV
This is a SPR (special purpose register) that holds the address for the exception vector.
Alternative name (envytools): "tv".
SP
This is a SPR (special purpose register) that holds the current stack pointer.
PC
This is a SPR (special purpose register) that holds the current program counter.
IMB
This is a SPR (special purpose register) that holds the external base address for IMEM transfers.
Alternative name (envytools): "xcbase".
DMB
This is a SPR (special purpose register) that holds the external base address for DMEM transfers.
Alternative name (envytools): "xdbase".
CSW
This is a SPR (special purpose register) that holds various flag bits.
Bits | Description |
---|---|
0-7 | General purpose predicates |
8 | ALU carry flag |
9 | ALU signed overflow flag |
10 | ALU sign flag |
11 | ALU zero flag |
12-15 | Unused |
16 | Interrupt 0 enable |
17 | Interrupt 1 enable |
18 | Interrupt 2 enable (undefined) |
19 | Unused |
20 | Interrupt 0 saved enable |
21 | Interrupt 1 saved enable |
22 | Interrupt 2 saved enable (undefined) |
23 | Unused |
24 | Exception active |
25 | Unused |
26 | Unknown |
27-28 | Unused |
29 | Unknown |
30-31 | Unused |
Alternative name (envytools): "flags".
CCR
This is a SPR (special purpose register) that holds configuration bits for the SCP DMA override functionality. The value of this register is set using the "cxset" instruction which provides a way to change the behavior of a variable amount of successively executed DMA-related instructions ("xdwait", "xdst" and "xdld").
Bits | Description |
---|---|
0-4 | Number of instructions the override is valid for (0x1F means infinite) |
5 | Crypto destination/source select
0: Crypto register 1: Crypto stream |
6 | External memory override
0: Disabled 1: Enabled |
7 | Internal memory select
0: DMEM 1: IMEM |
8-31 | Unused |
Alternative name (envytools): "cx".
SEC
This is a SPR (special purpose register) that holds configuration bits for the SCP authentication process.
Bits | Description |
---|---|
0-7 | Start of region to authenticate (in 0x100 pages) |
8-15 | Unused |
16 | Mark all subsequent code transfers as secret |
17 | Region is encrypted |
18 | Unknown (set in HS mode) |
19 | Block traps and interrupts (set in HS mode) |
20-23 | Unused |
24-31 | Size of region to authenticate (in 0x100 pages) |
Alternative name (envytools): "cauth".
CTX
This is a SPR (special purpose register) that holds configuration bits for the CTXDMA ports.
Bits | Description |
---|---|
0-2 | CTXDMA port for code loads (xcld) |
3 | Unused |
4-6 | CTXDMA port for code stores (invalid) |
7 | Unused |
8-10 | CTXDMA port for data loads (xdld) |
11 | Unused |
12-14 | CTXDMA port for data stores (xdst) |
15-31 | Unused |
Alternative name (envytools): "xtargets".
EXCI
This is a SPR (special purpose register) that holds information on raised exceptions.
Bits | Description |
---|---|
0-19 | Exception PC |
20-23 | Exception cause |
24-31 | Unused |
Alternative name (envytools): "tstatus".
SEC1
Unknown. Marked as "RESERVED".
IMB1
Unknown. Marked as "RESERVED".
DMB1
Unknown. Marked as "RESERVED".
SCP
Part of the information here (which hasn't made it into envytools documentation yet) was shared by mwk from reverse engineering falcon processors over the years.
Heavy Secure Mode
Entry
From non-secure mode, upon jumping to a page marked as secret, a secret fault occurs. This causes the CPU to verify the region specified in $cauth against the MAC loaded in $c6. If the comparison is successful, the valid bit (bit0) is set on all pages in the $cauth region, and $pc is set to the base of the $cauth region. If the comparsion fails, the CPU is halted.
Exit
The CPU automatically goes back to non-secure mode when returning back into non-secret pages. When this happens, the valid bit (bit0) in the TLB flags is cleared for all secret pages.
Implementation
Under certain circumstances, it is possible to observe sigauth being briefly written to TSEC_SCP_CMD as "csigauth $c4 $c6" while the opcodes in TSEC_SCP_STAT2 are set to "cxsin" and "csigauth", respectively.
Via TSEC_SCP_DBG0 it can be observed that a 3-sized macro sequence is loaded into cs0 during a secure mode transition.
Operations
Opcode | Name | Operand0 | Operand1 | Operation | Condition |
---|---|---|---|---|---|
0 | nop | N/A | N/A | ||
1 | mov | $cX | $cY | $cX = $cY; ACL(X) = ACL(Y); |
|
2 | sin | $cX | N/A | $cX = read_stream(); ACL(X) = ???; |
|
3 | sout | $cX | N/A | write_stream($cX); |
? |
4 | rnd | $cX | N/A | $cX = read_rnd(); ACL(X) = ???; |
|
5 | s0begin | immX | N/A | record_macro_for_N_instructions(0, immX); |
|
6 | s0exec | immX | N/A | execute_macro_N_times(0, immX); |
|
7 | s1begin | immX | N/A | record_macro_for_N_instructions(1, immX); |
|
8 | s1exec | immX | N/A | execute_macro_N_times(1, immX); |
|
9 | <invalid> | ||||
0xA | chmod | $cX | immY | Complicated, see ACL. | |
0xB | xor | $cX | $cY | $cX ^= $cY; |
(ACL(X) & 2) && (ACL(Y) & 2)
|
0xC | add | $cX | immY | $cX += immY; |
(ACL(X) & 2)
|
0xD | and | $cX | $cY | $cX &= $cY; |
(ACL(X) & 2) && (ACL(Y) & 2)
|
0xE | rev | $cX | $cY | $cX = endian_swap128($cY); ACL(X) = ACL(Y); |
|
0xF | gfmul | $cX | $cY | $cX = gfmul($cY); ACL(X) = ACL(Y); |
(ACL(Y) & 2)
|
0x10 | secret | $cX | immY | $cX = load_secret(immY); ACL(X) = load_secret_acl(immY); |
|
0x11 | keyreg | immX | N/A | active_key_idx = immX; |
|
0x12 | kexp | $cX | $cY | $cX = aes_kexp($cY); ACL(X) = ACL(Y); |
|
0x13 | krexp | $cX | $cY | $cX = aes_kexp_reverse($cY); ACL(X) = ACL(Y); |
|
0x14 | enc | $cX | $cY | $cX = aes_enc(active_key_idx, $cY); ACL(X) = ACL(active_key_idx) & ACL(Y); |
|
0x15 | dec | $cX | $cY | $cX = aes_dec(active_key_idx, $cY); ACL(X) = ACL(active_key_idx) & ACL(Y); |
|
0x16 | sigauth | $cX | $cY | if (hash_verify($cX, $cY)) { has_sig = true; current_sig = $cX; } |
? |
0x17 | sigclr | N/A | N/A | has_sig = false; |
|
0x18 | sigenc | $cX | $cY | if (has_sig) { $cX = aes_enc($cY, current_sig); ACL(X) = 0x13; } |
sigauth
00000000: f5 3c XY d8 csigauth $cY $cX
Takes 2 crypto registers as operands and is automatically executed when jumping to a code region previously uploaded as secret. This instruction does not work in secure mode.
sigclr
00000000: f5 3c 00 e0 csigclr
This instruction takes no operands and clears the saved cauth signature used by the csigenc instruction.
chmod
00000000: f5 3c XY a8 cchmod $cY 0X
or 00000000: f5 3c XY a9 cchmod $cY 1X
This instruction takes a crypto register and a 5 bit immediate value which represents the ACL mask to set.
rnd
00000000: f5 3c 0X 90 crnd $cX
This instruction initializes a crypto register with random data.
Executing this instruction only succeeds if the RND interface is enabled for the SCP, which requires taking the following steps:
- Write 0x7FFF to TSEC_RND_CTL0.
- Write 0x3FF0000 to TSEC_RND_CTL1.
- Write 0xFF00 to TSEC_RND_CTL11.
- Write 0x1000 to TSEC_SCP_CTL1.
Otherwise it hangs forever.
ACL
Bit | Meaning |
---|---|
0 | Secure key. Forced set if bit1 is set. Once cleared, cannot be set again. |
1 | Secure readable. Once cleared, cannot be set again. |
2 | Insecure key. Forced set if bit3 is set. Forced clear if bit0 is clear. Can be toggled back and forth. |
3 | Insecure readable. Forced clear if bit1 is clear. Can be toggled back and forth. |
4 | Insecure overwritable. Can be toggled back and forth. |
Initial values
On SCP boot, the ACL is 0x1F for all $cX.
Loading into $cX using xdst instruction sets ACL($cX) to 0x13 and 0x1F, for secure and insecure mode respectively.
Spilling a $cX to DMEM using xdld instruction is allowed if (ACL($cX) & 2) or (ACL($cX) & 8), for secure and insecure mode respectively.
Loading a secret into $cX sets a per-secret ACL, unconditionally.
Secrets
Falcon's Heavy Secure Mode has access to 64 128-bit keys which are burned at factory. These keys can be loaded using the $csecret instruction which takes the target crypto register and the key index as arguments.
Secrets are specific to each Falcon unit with the exception of secret 0x3F. This secret is effectively empty (all zeros), but is configured to be overwritten with the KFUSE private key once the KFUSE clock is enabled. The KFUSE private key is console-unique.
Index | ACL | Notes |
---|---|---|
0x00 | 0x13 | Used by Keygen, nvhost_tsec, nvhost_nvdec_bl020_prod, nvhost_nvdec020_prod, nvhost_nvdec020_ns and acr_ucode firmwares. |
0x01 | 0x10 | Used by nvhost_nvdec_bl020_prod firmware. |
0x02 | 0x10 | |
0x03 | 0x11 | Used by nvhost_tsec, nvhost_nvdec020_prod and nvhost_nvdec020_ns firmwares. |
0x04 | 0x10 | Used by nvhost_tsec, nvhost_nvdec020_prod and nvhost_nvdec020_ns firmwares. |
0x05 | 0x13 | Used by nvhost_tsec, nvhost_nvdec_bl020_prod, nvhost_nvdec020_prod, nvhost_nvdec020_ns and acr_ucode firmwares. |
0x06 | 0x11 | Used by the SCP as key to encrypt/decrypt data during authentication (decided by bit 17 from the SEC/cauth register). |
0x07 | 0x11 | Used by [6.0.0+] nvhost_tsec firmware. |
0x08 | 0x10 | |
0x09 | 0x13 | Used by nvhost_tsec firmware. |
0x0A | 0x11 | |
0x0B | 0x10 | Used by nvhost_tsec, nvhost_nvdec020_prod and nvhost_nvdec020_ns firmwares. |
0x0C | 0x13 | |
0x0D | 0x11 | |
0x0E | 0x10 | |
0x0F | 0x13 | Used by nvhost_tsec firmware. |
0x10 | 0x11 | Used by [1.0.0-5.1.0] nvhost_tsec firmware. |
0x11 | 0x10 | |
0x12 | 0x13 | |
0x13 | 0x11 | |
0x14 | 0x10 | |
0x15 | 0x13 | Used by nvhost_nvdec_bl020_prod, [5.0.0+] nvhost_nvdec020_prod, [5.0.0+] nvhost_nvdec020_ns and [6.0.0+] nvhost_tsec firmwares. |
0x16 | 0x11 | |
0x17 | 0x10 | |
0x18 | 0x13 | |
0x19 | 0x11 | |
0x1A | 0x10 | |
0x1B | 0x13 | |
0x1C | 0x11 | |
0x1D | 0x10 | |
0x1E | 0x13 | |
0x1F | 0x11 | |
0x20 | 0x10 | |
0x21 | 0x13 | |
0x22 | 0x11 | |
0x23 | 0x10 | |
0x24 | 0x13 | |
0x25 | 0x11 | |
0x26 | 0x10 | Used by KeygenLdr and SecureBoot |
0x27 | 0x13 | |
0x28 | 0x11 | |
0x29 | 0x10 | |
0x2A | 0x13 | |
0x2B | 0x11 | |
0x2C | 0x10 | |
0x2D | 0x13 | |
0x2E | 0x11 | |
0x2F | 0x10 | |
0x30 | 0x13 | |
0x31 | 0x11 | |
0x32 | 0x10 | |
0x33 | 0x13 | |
0x34 | 0x11 | |
0x35 | 0x10 | |
0x36 | 0x13 | |
0x37 | 0x11 | |
0x38 | 0x10 | |
0x39 | 0x13 | |
0x3A | 0x11 | |
0x3B | 0x10 | |
0x3C | 0x13 | Used by nvhost_tsec firmware. |
0x3D | 0x11 | |
0x3E | 0x10 | |
0x3F | 0x10 | Used by Keygen, nvhost_tsec, nvhost_nvdec020_prod and nvhost_nvdec020_ns firmwares. |