Hardware reference
AES/CCMP engine
On this page
The AES engine at 0x09c5_0000 performs CCMP. Keys, the CCM context and the additional authenticated data (AAD) go through a FIFO; the frame payload moves through packet RAM by DMA. The engine handles one transfer at a time.
Registers
| Offset | Address | Register | Type | Description |
|---|---|---|---|---|
+0x00 |
0x09c5_0000 |
COMMAND_STATUS |
u32 RW | Write a command word; read status. |
+0x04 |
0x09c5_0004 |
FIFO |
u32 WO | Little-endian key, CCM context and AAD words. |
+0x08 |
0x09c5_0008 |
INIT_PORT |
u32 WO | Initialization stream; see the start-up self-test. |
+0x10 |
0x09c5_0010 |
SOURCE |
u32 RW | DMA source, cpu & 0xf6ff_ffff. |
+0x14 |
0x09c5_0014 |
DESTINATION |
u32 RW | DMA destination, same encoding. |
+0x18 |
0x09c5_0018 |
LENGTH |
u32 RW | Payload length in octets, excluding CCMP header and MIC. |
Source: AesRegisters · 28 bytes
COMMAND_STATUS
Read side of COMMAND_STATUS. Writes are command words.
| Bits | Field | Description |
|---|---|---|
| 13 | FIFO_READY |
The FIFO accepts words. Later stages wait for it as well. |
| 12 | BUSY |
Busy: a command written now is not accepted. Wait for it to clear before every command. |
| 0 | AUTH_OK |
Authenticated result. Sampled after the completion interrupt of a decryption: set when the MIC matched. |
Source: AesStatus · 4 bytes
Command words
Each stage writes its input words to FIFO, then a command to COMMAND_STATUS. An unchanged key need not be reloaded.
| Command | Stage | FIFO input |
|---|---|---|
0x1100 |
Load key | Four words: the 16 key bytes, little-endian, in their WSM order |
0x1240 |
CCM context | One 16-byte block: [0] = 1, [1] = TID, [2..8] = A2, [8..14] = PN5…PN0, [14..16] = payload length, big-endian |
0x1403 / 0x1402 |
First AAD block | The first 16 bytes of the AAD stream; transmit / receive |
0x148b / 0x148a |
AAD tail, 22-byte AAD | Three addresses, no QoS; TX / RX |
0x14ab / 0x14aa |
AAD tail, 24-byte AAD | Three addresses, QoS; TX / RX |
0x14eb / 0x14ea |
AAD tail, 28-byte AAD | Four addresses, no QoS; TX / RX |
0x140b / 0x140a |
AAD tail, 30-byte AAD | Four addresses, QoS; TX / RX |
0x3008_1009 |
Start encryption | Length already in LENGTH; encrypts in place when source and destination are equal |
0x3008_1008 |
Start decryption | The firmware decrypts in place, with source equal to destination |
0x9000 |
Initialize | After the 430-byte stream through INIT_PORT |
Every receive command is the transmit command minus one.
AAD
The AAD is sent as a 32-byte stream: a 2-byte big-endian length, then masked frame control, A1, A2, A3, masked sequence control, [A4] and [QoS control], padded with zeros.
FIFO bytes 0..15 of the stream
command 0x1403 (TX) / 0x1402 (RX)
FIFO bytes 16..31 of the stream
the AAD tail command for the header shape
... source, destination, length, then the start command
The tail commands’ 22, 24, 28 and 30 bytes are the total AAD length for each header shape.
In the frame control the firmware clears Retry, Power Management and More Data; for non-management frames it also clears subtype bits 4–6, and for QoS data the Order bit, bit 15. It sets the Protected bit for management and data frames. In the sequence control it keeps the fragment number and clears the sequence number.
Completion
Completion arrives on IRQ 18 or IRQ 20. For a decryption, AUTH_OK then reports the MIC check. The engine runs one transfer at a time, and the firmware queues the rest.
Start-up self-test
Right after the host handshake the firmware initializes the engine and checks it:
- Write
COMMAND_STATUS = 0and wait forBUSYto clear. - Stream the 430 initialization bytes to
INIT_PORT, one byte per 32-bit write, with bit 31 set on the first. - Write
COMMAND_STATUS = 0x9000and wait forBUSYto clear. - Run a fixed frame through CCMP in HIF output buffer 0 and compare the result with one computed at build time.
The result word is 1 on success, or 0xe0xx naming the failed step.
CCMP encryption gives the transfer sequence step by step.