Hardware reference
Platform control
The first 0xc0 bytes of the 0x0ac8_0000 window hold clock, power and configuration words. The DMA and clock set-up writes most of them once; their encodings are largely unknown, so the firmware writes the vendor’s values in the vendor’s order.
Registers
| Offset | Address | Register | Type | Description |
|---|---|---|---|---|
+0x58 |
0x0ac8_0058 |
SHARED_POINTER |
u32 WO | DMA and clock set-up writes 0x0004_0090. Not a CPU-form DTCM address; the encoding is unknown. |
+0x64 |
0x0ac8_0064 |
POWER_CONTROL |
u32 RW | PHY controller run and halt inferred. DMA and clock set-up writes 0x10; RF start-up writes 0x11 and then 1 if bit 0 reads clear; stopping the radio, or dozing the receiver, writes 0x10 again. |
+0x80 |
0x0ac8_0080 |
READY_STATUS |
u32 RO | Clock/PLL settle flag. |
+0x84 |
0x0ac8_0084 |
CLOCK_FLAGS |
u32 WO | 0x0c02 or 0x0042, chosen by CLOCK_STATUS bit 3. |
+0x94 |
0x0ac8_0094 |
CLOCK_STATUS |
u32 RO | Read once to choose the CLOCK_FLAGS value. |
+0x9c |
0x0ac8_009c |
PARAMETER_9C |
u32 WO | Written 6. |
+0xa0 |
0x0ac8_00a0 |
PARAMETER_A0 |
u32 WO | Written 31. |
+0xbc |
0x0ac8_00bc |
CONFIGURATION |
u32 RW | Clear bit 0 and set bit 23 before platform preparation; later OR in 0x0012_0000 if no remap window is present. |
Source: PlatformControl · 192 bytes
READY_STATUS
| Bits | Field | Description |
|---|---|---|
| 0 | READY |
Set once the clock/PLL block has settled. Polled at most 0x200 times. |
Source: PlatformReady · 4 bytes
CLOCK_STATUS
| Bits | Field | Description |
|---|---|---|
| 3 | SELECT |
Selects the CLOCK_FLAGS value: 0x0c02 when clear, 0x0042 when set. |
Source: PlatformClockStatus · 4 bytes
CONFIGURATION
Updated twice during bring-up. The first update must come before platform preparation.
| Bits | Field | Description |
|---|---|---|
| 23 | BIT23 |
Set by the first update. |
| 20 | BIT20 |
Set with bit 17. |
| 17 | BIT17 |
Set by DMA and clock set-up when no remap window is present. |
| 0 | BIT0 |
Cleared by the first update. |
Source: PlatformConfiguration · 4 bytes
Other platform words
Two words the typed layout does not declare, written during RF start-up: one inside its range and one beyond it.
| Address | Register | Access | Description |
|---|---|---|---|
0x0ac8_005c | PLATFORM_5C | W | 0x6a25_5800 during RF start-up when no remap window is present; function unknown |
0x0ac8_00e8 | PLATFORM_E8 | W | 0x10c with the word above; function unknown |
Ordering
Update CONFIGURATION first. Clearing bit 0 and setting bit 23 must happen before platform preparation samples the remap windows.
The other registers are written during DMA and clock set-up, in the order given there.