Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

emulator: Add event bus between Caliptra, MCU, BMC, etc. #1938

Open
wants to merge 13 commits into
base: main-2.x
Choose a base branch
from

Conversation

swenson
Copy link
Contributor

@swenson swenson commented Feb 3, 2025

And hook it up to the emulated AXI bus for DMA transfers.

The events are used to simulate some of the ways that Caliptra communicates with others in hardware, in particular, I3C, writing to MCU's memory aperture, and the recovery communications.

We wire these up in the emulated AXI DMA controller and recovery interface.

We also have to modify the emulated AXI DMA controller to support asynchronous reads and writes, which should more accurately emulates how the hardware works anyway.

This PR will be coordinated with a PR on the MCU repository, which will provide the emulated MCU and BMC cores, and will test the interactions.

I've run this with the MCU and BMC code through loading the recovery image from the recovery interface in the ROM's cold reset flow and gotten it to key verification.

Builds on some of the DMA changes in #1904.

@swenson swenson added the Caliptra v2.0 Items to be considered for v2.0 Release label Feb 3, 2025
swenson added a commit to chipsalliance/caliptra-mcu-sw that referenced this pull request Feb 3, 2025
We start implementing a simulated recovery flow engine in a fake BMC,
and having it work with Caliptra Core and MCU bootup.

This depends on an event bus being hooked up between Caliptra Core, the
MCU, and our fake BMC, which is processed on each end to translate
events. For example, recovery block reads and writes from the BMC are
translated to recovery registers available through AXI in Caliptra Core.

This flow is a bit complex, and is not 100% finished yet. Currently it
is working well enough that:

* Emulators start and enable active mode
* MCU ROM boots and sets up Caliptra Core's fuse registers
* MCU ROM starts the recovery flow
* Calipta Core ROM boots and requests the first recovery image
  (Caliptra's own firmware)
* Caliptra Core downloads the firmware successfully

The next step will be to get through validation and handle the SoC
manifest and MCU firmware in Caliptra's runtime code.

But, I wanted to do a check in so that these PRs don't become too
overwhelming.

Assuming you have `caliptra-sw` in `../caliptra-sw`, have built the ROM
(`cd rom/dev && make build-rom`) and the signed Caliptra firmware
(`cd rom/dev && make build-fw-image`), and have a file (doesn't yet
matter the contents) `soc-manifest.bin`, you can test this whole flow
with:

```shell-session
$ cargo xtask runtime --caliptra-rom ../caliptra-sw/target/riscv32imc-unknown-none-elf/firmware/caliptra-rom.bin --caliptra-firmware ../caliptra-sw/target/riscv32imc-unknown-none-elf/firmware/caliptra-rom-test-fw --soc-manifest soc-manifest.bin --active-mode

...
[ldev] Signing Cert with MLDSA AUTHORITY.KEYID = 8
[ldev] --
[fwproc] Wait for Commands...
[fwproc] Recv command 0x52494644
[emulator bmc recovery] Recovery state transition: ReadDeviceStatus -> WaitForRecoveryStatus
[emulator bmc recovery] Sending recovery image 0
[emulator bmc recovery] Recovery state transition: WaitForRecoveryStatus -> WaitForRecoveryPending
[fwproc] Waiting for payload available signal...
[fwproc] Recovery payload of 131072 bytes available
[fwproc] Received Image from Recovery Interface of size 131072 bytes
ROM Fatal Error: 0x000B0003
```

(The fatal error is signature validation failure, which is to be
expected.)

Depends on chipsalliance/caliptra-sw#1938
@swenson swenson force-pushed the communicate-with-mcu-bmc branch from e7927e4 to 9aacda2 Compare February 5, 2025 18:24
@swenson swenson requested a review from FerralCoder as a code owner February 6, 2025 00:41
@swenson swenson force-pushed the communicate-with-mcu-bmc branch from 0e91c77 to 479be86 Compare February 6, 2025 00:43
And hook it up to the emulated AXI bus for DMA transfers.

The events are used to simulate some of the ways that Caliptra
communicates with others in hardware, in particular, I3C, writing to
MCU's memory aperture, and the recovery communications.

We wire these up in the emulated AXI DMA controller and recovery
interface.

This PR will be coordinated with a PR on the MCU repository, which will
provide the emulated MCU and BMC cores, and will test the interactions.
downloaded

And fix the AXI to AXI transfer mechanism so that a fixed FIFO address
can output to a non-fixed MCU SRAM address.
@swenson swenson force-pushed the communicate-with-mcu-bmc branch from fd766d6 to 7b2835a Compare February 8, 2025 22:27
swenson added a commit to chipsalliance/caliptra-mcu-sw that referenced this pull request Feb 8, 2025
We start implementing a simulated recovery flow engine in a fake BMC,
and having it work with Caliptra Core and MCU bootup.

This depends on an event bus being hooked up between Caliptra Core, the
MCU, and our fake BMC, which is processed on each end to translate
events. For example, recovery block reads and writes from the BMC are
translated to recovery registers available through AXI in Caliptra Core.

This flow is a bit complex, and is not 100% finished yet. Currently it
is working well enough that:

* Emulators start and enable active mode
* MCU ROM boots and sets up Caliptra Core's fuse registers
* MCU ROM starts the recovery flow
* Calipta Core ROM boots and requests the first recovery image
  (Caliptra's own firmware)
* Caliptra Core downloads the firmware successfully

The next step will be to get through validation and handle the SoC
manifest and MCU firmware in Caliptra's runtime code.

But, I wanted to do a check in so that these PRs don't become too
overwhelming.

Assuming you have `caliptra-sw` in `../caliptra-sw`, have built the ROM
(`cd rom/dev && make build-rom`) and the signed Caliptra firmware
(`cd rom/dev && make build-fw-image`), and have a file (doesn't yet
matter the contents) `soc-manifest.bin`, you can test this whole flow
with:

```shell-session
$ cargo xtask runtime --caliptra-rom ../caliptra-sw/target/riscv32imc-unknown-none-elf/firmware/caliptra-rom.bin --caliptra-firmware ../caliptra-sw/target/riscv32imc-unknown-none-elf/firmware/caliptra-rom-test-fw --soc-manifest soc-manifest.bin --active-mode

...
[ldev] Signing Cert with MLDSA AUTHORITY.KEYID = 8
[ldev] --
[fwproc] Wait for Commands...
[fwproc] Recv command 0x52494644
[emulator bmc recovery] Recovery state transition: ReadDeviceStatus -> WaitForRecoveryStatus
[emulator bmc recovery] Sending recovery image 0
[emulator bmc recovery] Recovery state transition: WaitForRecoveryStatus -> WaitForRecoveryPending
[fwproc] Waiting for payload available signal...
[fwproc] Recovery payload of 131072 bytes available
[fwproc] Received Image from Recovery Interface of size 131072 bytes
ROM Fatal Error: 0x000B0003
```

(The fatal error is signature validation failure, which is to be
expected.)

Depends on chipsalliance/caliptra-sw#1938
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Caliptra v2.0 Items to be considered for v2.0 Release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant