Skip to content

Commit c05112f

Browse files
committed
general change to mac adress perserving flashing
Signed-off-by: nestire <hannes@nitrokey.com>
1 parent 1316285 commit c05112f

2 files changed

Lines changed: 20 additions & 3 deletions

File tree

About/Historical-Legacy-Migration.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,10 +99,18 @@ mount-usb
9999
flashprog -p internal -w /media/PathToMaximizedRom.rom
100100
```
101101

102+
on board with Intel based Ethernet you might want to use:
103+
104+
```
105+
sudo flashrom -p internal --ifd -i bios -i me -i fd -w /media/PathToMaximizedRom.rom
106+
```
107+
108+
to perserve the orignal mac adresse
109+
102110
**Note**: Use `flashprog` on newer Heads firmware (2025+) or `flashrom` on older firmware versions, depending on what is available in your Heads system.
103111

104112
On next reboot, Heads would guide you into factory resetting your USB Security dongle or import your previously generated public key matching your USB Security dongle's private key.
105113

106114
It would then regenerate a TOTP/HOTP secret and sign /boot content. You would then have to define a new default boot and optionally renew/change your Disk Unlock Key to be released to to OS to unlock your encrypted OS installation to move forward.
107115

108-
In the case nothing was found installed on your disk, Heads would propose you to boot from USB to install a new Operating System, prior of being able to do the above steps prior of booting into your system.
116+
In the case nothing was found installed on your disk, Heads would propose you to boot from USB to install a new Operating System, prior of being able to do the above steps prior of booting into your system.

Installing-and-Configuring/Upgrading.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,16 @@ If you are installing Heads for the first time, you will need to perform an exte
6464
- Verifying file integrity.
6565
- Preparing for external flashing.
6666

67+
You can use this command
68+
```shell
69+
sudo flashrom -p ch341a_spi -c YYY -w [HEADS_ROM]
70+
```
71+
On boards with Intel-based Ethernet, this will also overwrite the GbE region in the BIOS, which stores the MAC address of the chip, with a forged one (MAC: 00:DE:AD:C0:FF:EE). This has the privacy benefit that the chip uses this shared MAC so it can't be used as a personal identifier for this exact board. The downside is that this can create connectivity problems on local networks if other heads boards with the same MAC address are present. To preserve the original MAC address of the board, use:
72+
73+
```shell
74+
sudo flashrom -p ch341a_spi -c YYY --ifd -i bios -i me -i fd -w [HEADS_ROM]
75+
```
76+
6777
**Note**: This process is only required for the initial installation of Heads.
6878

6979
---
@@ -121,8 +131,7 @@ If you need to validate the current firmware integrity against the last flashed
121131
**Note on `CONFIG_FLASH_OPTIONS`**:
122132
- The `CONFIG_FLASH_OPTIONS` variable specifies the board-specific flash options to ensure proper handling of SPI regions during flashing. These options are defined in the board's configuration file.
123133
- Boards may specify different SPI regions to flash. For example:
124-
- The `novacustom-v540tu` board preserves the `GBE` (Gigabit Ethernet) region, ensuring the manufacturing MAC address remains intact.
125-
- The `x230-hotp-maximized` board overwrites the entire SPI flash, including the `GBE` region, replacing it with a generic configuration.
134+
- All boards with intel based ethernet chips preserves the `GBE` (Gigabit Ethernet) region, ensuring the MAC address remains intact.
126135
- To inspect the flash options for your board, use the `env` command in the recovery shell:
127136
```shell
128137
env

0 commit comments

Comments
 (0)