In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "Hardware/AES engine"

From WiiBrew
Jump to navigation Jump to search
Line 6: Line 6:
 
| hwdirq = 2
 
| hwdirq = 2
 
}}
 
}}
{| border="1"
+
The Hollywood's AES Engine encrypts/decrypts 16-byte blocks using AES-128 in Cipher Block Chaining mode.
! base      !! function !! offset !! description !! contents/example
+
 
|-||0x0D020000||AES       ||
+
== Register List ==
|-
+
{{reglist|NAND Interface}}
||          ||          || 0000 W  || command || 980000LL to start operation (L = len in 16 byte blocks -1)
+
{{rla|0x0d020000|32|AES_CTRL|AES Control and Status}}
|-
+
{{rla|0x0d020004|32|AES_SRC|Source memory address}}
||           ||         ||        ||        || 980010LL start operation and "do not reload IV"??
+
{{rla|0x0d020008|32|AES_DEST|Destination memory address}}
|-
+
{{rla|0x0d02000c|32|AES_KEY|Key FIFO}}
||          ||          ||        ||         || 00000000 reset
+
{{rla|0x0d020010|32|AES_IV|IV FIFO}}
|-
 
||          ||          || 0000 R  || status || MSB means busy
 
|-
 
||           ||         || 0004 W  || data addr || source DMA
 
|-
 
||          ||          || 0008 W  || data addr|| dst DMA
 
|-
 
||          ||          || 000C W  || key fifo || write 4 words to set key
 
|-
 
||          ||          || 0010 W  || IV fifo || write 4 words to set IV
 
 
|}
 
|}
 +
== Register Details ==
 +
{{reg32 | AES_CTRL | addr = 0x0d020000 | hifields = 6 | lofields = 4 |
 +
|1|1|1|1|1|7|
 +
|R/W|R/W|R?|R/W|R/W|U|
 +
|EXEC|IRQ|ERR|CMD|MODE|||
 +
|3|1|12|
 +
|U|W|W|
 +
||IV||BLOCKS|
 +
}}
 +
This register controls the state of the AES engine.
 +
{{regdesc
 +
|EXEC|Write 1: initiate AES command<br/>Read: AES engine busy
 +
|IRQ|Set to enable IRQ generation when command is complete
 +
|ERR|If set, AES error occured (?){{check}}
 +
|ENA|Enable en/decryption. If clear, the data is copied straight from source to destination without change (useful as a DMA copy engine?).
 +
|MODE|0 for encrypt, 1 for decrypt.
 +
|IV|If set, use the supplied IV. If clear, chain from last command (continue CBC mode).
 +
|DATALEN|Number of 16-byte blocks to process, minus one. 0 means one block.
 +
}}
 +
----
 +
{{regsimple | AES_SRC | addr = 0x0d020004 | bits = 32 | access = R/W }}
 +
This register contains the DMA address of the source data. The same buffer can be used for source and destination. The bottom 4 bits are ignored (must be 16-byte aligned).
 +
----
 +
{{regsimple | AES_SRC | addr = 0x0d020008 | bits = 32 | access = R/W }}
 +
This register contains the DMA address of the destination data. The same buffer can be used for source and destination. The bottom 4 bits are ignored (must be 16-byte aligned).
 +
----
 +
{{regsimple | AES_KEY | addr = 0x0d02000c | bits = 32 | access = W }}
 +
This register implements a FIFO that accepts the AES key. A sequence of four 32-bit writes will set the AES key (starting with the leftmost 32-bit word).
 +
----
 +
{{regsimple | AES_KEY | addr = 0x0d02000c | bits = 32 | access = W }}
 +
This register implements a FIFO that accepts the AES IV. A sequence of four 32-bit writes will set the AES IV (starting with the leftmost 32-bit word).
 +
Set the IV bit in the [[#AES_CTRL|AES_CTRL]] register to restart the CBC encryption using this IV instead of using the last encrypted block.

Revision as of 21:03, 10 March 2009

AES engine
Access
BroadwayNone
StarletFull
Registers
Base0x0d020000
Length0x14
Access size32 bits
Byte orderBig Endian
IRQs
Hollywood2
This box: view  talk  edit

The Hollywood's AES Engine encrypts/decrypts 16-byte blocks using AES-128 in Cipher Block Chaining mode.

Register List

NAND Interface
Address Bits Name Description
0x0d020000 32 AES_CTRL AES Control and Status
0x0d020004 32 AES_SRC Source memory address
0x0d020008 32 AES_DEST Destination memory address
0x0d02000c 32 AES_KEY Key FIFO
0x0d020010 32 AES_IV IV FIFO

Register Details

AES_CTRL (0x0d020000)
  31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16
Access R/W R/W R? R/W R/W U
Field EXEC IRQ ERR CMD MODE
  15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Access W W colspan="

" |

Field BLOCKS colspan="

" | B12

This register controls the state of the AES engine.

Field Description
EXEC Write 1: initiate AES command
Read: AES engine busy
IRQ Set to enable IRQ generation when command is complete
ERR If set, AES error occured (?)[check]
ENA Enable en/decryption. If clear, the data is copied straight from source to destination without change (useful as a DMA copy engine?).
MODE 0 for encrypt, 1 for decrypt.
IV If set, use the supplied IV. If clear, chain from last command (continue CBC mode).
DATALEN Number of 16-byte blocks to process, minus one. 0 means one block.

AES_SRC (0x0d020004)
  310
Access R/W

This register contains the DMA address of the source data. The same buffer can be used for source and destination. The bottom 4 bits are ignored (must be 16-byte aligned).


AES_SRC (0x0d020008)
  310
Access R/W

This register contains the DMA address of the destination data. The same buffer can be used for source and destination. The bottom 4 bits are ignored (must be 16-byte aligned).


AES_KEY (0x0d02000c)
  310
Access W

This register implements a FIFO that accepts the AES key. A sequence of four 32-bit writes will set the AES key (starting with the leftmost 32-bit word).


AES_KEY (0x0d02000c)
  310
Access W

This register implements a FIFO that accepts the AES IV. A sequence of four 32-bit writes will set the AES IV (starting with the leftmost 32-bit word). Set the IV bit in the AES_CTRL register to restart the CBC encryption using this IV instead of using the last encrypted block.