Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/resources/hcl/cpu/pro-b850-p-wifi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# PRO B850-P WIFI
<!--start-->
| CPU Model | Dasharo version | Source |
|:---------:|:----------------------:|:---------:|
| AMD Ryzen 5 8600G w/ Radeon 760M Graphics| v0.9.0 | lab setup |
<!--end-->
6 changes: 6 additions & 0 deletions docs/resources/hcl/memory/pro-b850-p-wifi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# PRO Z790-P (WIFI)
<!--start-->
| DIMM vendor | Part Number | Size | SPD profile | Configuration 1/2/4 | Dasharo version | Source |
|:-----------:|:-----------:|:----:|:-----------:|:-------------------:|:---------------:|:------:|
| Crucial | CT8G48C40U5 | 32 GB | 4800 MT/s | -/-/&#10004 | v0.9.0 | lab setup |
<!--end-->
Original file line number Diff line number Diff line change
Expand Up @@ -148,24 +148,23 @@ To prepare the motherboard the following operations should be performed:
## Device validation

1. Connect the device to the mains.
1. Power on the device with the button located on the front panel.
1. If all connections have been made correctly, the device should start and
2. Power on the device with the button located on the front panel.
3. If all connections have been made correctly, the device should start and
the boot logo should be shown.
1. Install Dasharo firmware in accordance with
[Initial Deployment](../../unified/msi/initial-deployment.md) -
the `Migrating SMBIOS unique data` chapter can be skipped.
1. Power on the device.
1. Boot to Linux system (Ubuntu is recommended).
1. Open a terminal window and run the following command:
4. Install Dasharo firmware in accordance with
[Initial Deployment](../../unified/msi/initial-deployment.md).
5. Power on the device.
6. Boot to Linux system (Ubuntu is recommended).
7. Open a terminal window and run the following command:

```bash
sudo dmidecode -t 0 | grep Version
```

1. The output of the command above should be similar to:
8. The output of the command above should be similar to:
`Version: Dasharo (coreboot+UEFI) <version>` where the version should
correspond to the version of the flashing binary used eg. v1.0.0.
1. Check in the system that everything is working properly.
9. Check in the system that everything is working properly.

## Useful content

Expand Down
36 changes: 36 additions & 0 deletions docs/unified/msi/building-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,14 @@
> most recent release version
> - `msi_ms7d25/release` branch for the release versions up to v0.9.0

=== "PRO B850-P WIFI"
> Replace the `REVISION` with one of the:
>
> - `msi_ms7e56_vVERSION` tag for the given release `VERSION`
> (e.g. `msi_ms7e56_v0.9.0`), **RECOMMENDED**
> - `dasharo-25.12` branch for a development version with unreleased changes past
> most recent release version

```bash
git clone https://github.com/Dasharo/coreboot.git -b REVISION
cd coreboot
Expand Down Expand Up @@ -122,6 +130,34 @@

The resulting Dasharo firmware image will be placed at `$PWD/msi_ms7e06_VERSION_ddr4.rom`.

=== "PRO B850-P WIFI"
Download the AMD Phoenix AM5 blobs.

{{ tos_gated_downloads("msi-ms7e56-v090-blobs",
[{"label": "PhoenixAM5.zip", "url": "https://dl.3mdeb.com/open-source-firmware/Dasharo/msi_ms7e56/uefi/v0.9.0/PhoenixAM5.zip"}],
prose_section_id="msi-ms7e56-v090-blobs-prose") }}

<div data-prose-group="msi-ms7e56-v090-blobs-prose"
class="tos-gate-content" markdown="1"
style="display: none">

Unzip the package to the following directory:

```bash
unzip PhoenixAM5.zip -d 3rdparty/blobs/soc/amd/
```

</div>

And then execute:


```bash
./build.sh b850p
```

The resulting Dasharo firmware image will be placed at `$PWD/msi_ms7e56_VERSION.rom`.

=== "Dasharo (coreboot + Heads)"

# Intro
Expand Down
27 changes: 22 additions & 5 deletions docs/unified/msi/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,19 @@ Dasharo compatible with the MSI PRO Z690-A and PRO Z790-P platform.
- peripherals listed in the:
+ [PRO Z690-A Hardware Configuration Matrix](../../variants/msi_z690/hardware-matrix.md)
+ [PRO Z790-P Hardware Configuration Matrix](../../variants/msi_z790/hardware-matrix.md)
+ [PRO B850-P Hardware Configuration Matrix](../../variants/msi_b850/hardware-matrix.md)
- [RTE](https://3mdeb.com/open-source-hardware/#rte)
- [Sonoff S20 Smart Plug](https://wiki.iteadstudio.com/S20_Smart_Socket)
with [custom firmware](http://web.archive.org/web/20240221030444/https://esphome.io/devices/sonoff_s20.html)
- DB9 null modem cable (MSI PRO B850-P only)
- DB9 serial port to 10 pin header adapter (MSI PRO B850-P only)

### Serial debug

!!! Note

MSI PRO Z690-A/Z790-P only!

- Attach the jumpers in `J16` header to enable header `J18` according to the
table below:

Expand All @@ -27,7 +34,7 @@ Dasharo compatible with the MSI PRO Z690-A and PRO Z790-P platform.

- Connect signals from the `J18` header to serial receiver:

| RTE | Msi Z690 |
| RTE | Msi Z690/Z790 |
|:---------------:|:-----------------------------------------:|
| J18 pin 1 (GND) | JBD1 pin 1 (pin closer to JBAT1) |
| J18 pin 2 (RX) | JBD1 pin 2 (pin further from JBAT1) |
Expand All @@ -40,12 +47,22 @@ from booting, but we cannot provide input to the platform at the same time.

![JBD1](images/msi_z690_serial_panel.jpg)

### Serial console

!!! Note

MSI PRO B850-P only!

1. Connect IDC 10-pin to DB9 adapter to `JCOM1` on the board
2. Connect DB9 adapter end with DB9 null model cable
3. Connect one end of DB9 null modem cable to RTE RS232 DB9 connector.

### SPI

- For external flashing, connect `RTE` with motherboard according to the table
below:

| RTE SPI header | MSI Z690-A/Z790-P |
| RTE SPI header | MSI Z690-A/Z790-P/B850-P |
|:-------------------:|:----------------------------------------------------:|
| J7 pin 1 (Vcc) | JTPM1 pin 1 (SPI Power) |
| J7 pin 2 (GND) | JTPM1 pin 7 (GND) |
Expand Down Expand Up @@ -78,13 +95,13 @@ manual).

> JFP1 is located in the corner of the mainbaord, near SATA interface ports

| RTE | MSI Z690-A/Z790-P |
| RTE | MSI Z690-A/Z790-P/B850-P |
|:--------------:|:---------------------------:|
| J11 pin 9 | JFP1 pin 6 (PWR_ON) |
| J11 pin 8 | JFP1 pin 7 (RST) |
| J15 pin 1 (GND)| JFP1 pin 5 (GND) |

#### Power supply control

Connect `SeaSonic FOCUS Plus Platinum` power supply unit to the mains via
`Sonoff S20 Smart Plug`. To power control via RTE, `Sonoff` smart plug
Connect the power supply unit to the mains via `Sonoff S20 Smart Plug`. To
power control via RTE, `Sonoff` smart plug
2 changes: 1 addition & 1 deletion docs/unified/msi/firmware-transition.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## Introduction

This document describes the process of transitioning from Dasharo UEFI to Heads
and the other way around.
and the other way around for MSI Z690-A and Z790-P boards.

## Transition from Dasharo UEFI to Heads variant

Expand Down
16 changes: 10 additions & 6 deletions docs/unified/msi/firmware-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,12 +140,6 @@ Alternatively, it can be checked in the `BIOS Setup Menu`.

That means you are good to go.

#### Migrating SMBIOS unique data (optional)

Before flashing you may migrate your serial number and UUID as
described in [Initial deployment](./initial-deployment.md#migrating-smbios-unique-data).
Applicable to Dasharo v1.1.0 (PRO Z690-A) / v0.9.0 (PRO Z790-P) and later.

#### Flashing using flashrom

=== "PRO Z690-A boards"
Expand Down Expand Up @@ -190,6 +184,16 @@ Alternatively, it can be checked in the `BIOS Setup Menu`.
flashrom -p internal -w [path] --fmap -i RW_SECTION_A -i RW_SECTION_B
```

=== "PRO B850-P boards"

If updating firmware using custom builds without changing the flashmap,
only the `COREBOOT` partition of the flash needs to be updated. Flash it
using the following command:

```bash
flashrom -p internal -w [path] --fmap -i COREBOOT
```

#### Troubleshooting

Possible errors are described in the
Expand Down
41 changes: 41 additions & 0 deletions docs/unified/msi/hcl.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,13 @@ hardware.
end="<!--end-->"
%}

=== "PRO B850-P WIFI"
{%
include-markdown "../../resources/hcl/cpu/pro-b850-p-wifi.md"
start="<!--start-->"
end="<!--end-->"
%}

</center>

=== "Memory HCL (11 Dec 2025)"
Expand Down Expand Up @@ -119,6 +126,13 @@ hardware.
end="<!--end-->"
%}

=== "PRO B850-P WIFI"
{%
include-markdown "../../resources/hcl/memory/pro-b850-p-wifi.md"
start="<!--start-->"
end="<!--end-->"
%}

</center>

=== "GPU HCL (manual)"
Expand Down Expand Up @@ -302,5 +316,32 @@ Maintainer documentation](../../dev-proc/hcl-maintainer.md).
Dasharo version:
```

=== "PRO B850-P (WIFI)"
- Use [Dasharo Tools Suite HCL report](../../dasharo-tools-suite/documentation/features.md#hcl-report)
to upload report automatically.
- Create new issue in [Dasharo issues repository](https://github.com/Dasharo/dasharo-issues/issues/new?assignees=&labels=P%3A+default%2C+T%3A+hcl&template=hcl-report.md&title=CPU+HCL+report+for+msi_b850).
- Create PR directly to [Dasharo documentation repository](https://github.com/Dasharo/docs).

- [CPU HCL email](mailto:contact@dasharo.com?subject=CPU HCL report for msi_b850)
your `/proc/cpuinfo` or relevant information using following template:

```text
CPU model:
Dasharo version:
```

- [Memory HCL email](mailto:contact@dasharo.com?subject=Memory HCL report for msi_b850)
as attachments outputs of following command:

```bash
decode-dimms > decode-dimms.log 2> decode-dimms.err.log
```

In email please include Dasharo version.

```text
Dasharo version:
```

If you already have reported your results and you change some hardware
configuration we would appreciate an update.
Loading
Loading