Hardware reference

Platform control

On this page

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.

AddressRegisterAccessDescription
0x0ac8_005cPLATFORM_5CW0x6a25_5800 during RF start-up when no remap window is present; function unknown
0x0ac8_00e8PLATFORM_E8W0x10c 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.