GNUBoot/coreboot-kgpe-d16
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Documentation: Use correct KiB/MiB units instead of KB/MB

Browse source 
Fix a common mistake of using KB/MB where KiB/MiB is what actually is meant.

1 MB = (10^3)^2 = 1000000
1 MiB = (2^10)^2 = 1048576

Change-Id: I78327652b6c6526318071a9d4bafd7ec279ea614
Signed-off-by: Evgeny Zinoviev <me@ch1p.io>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/39685
Reviewed-by: Angel Pons <th3fanbus@gmail.com>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
This commit is contained in:
Evgeny Zinoviev 2020-03-20 02:57:00 +03:00 committed by Patrick Georgi
parent 7ac6ae95ca
commit d2b3961fdc
8 changed files with 21 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
Documentation/ifdtool/layout.md
View file

@ -19,7 +19,7 @@ way to categorize anything required by the SoC but not provided by coreboot.
| IFD Region | IFD Region name | FMAP Name | Notes | | IFD Region | IFD Region name | FMAP Name | Notes |
| index | | | | | index | | | |
+============+==================+===========+===========================================+ +============+==================+===========+===========================================+
| 0 | Flash Descriptor | SI_DESC | Always the top 4KB of flash | | 0 | Flash Descriptor | SI_DESC | Always the top 4 KiB of flash |
+------------+------------------+-----------+-------------------------------------------+ +------------+------------------+-----------+-------------------------------------------+
| 1 | BIOS | SI_BIOS | This is the region that contains coreboot | | 1 | BIOS | SI_BIOS | This is the region that contains coreboot |
+------------+------------------+-----------+-------------------------------------------+ +------------+------------------+-----------+-------------------------------------------+
@ -40,9 +40,9 @@ way to categorize anything required by the SoC but not provided by coreboot.
The ifdtool can be used to manipulate a firmware image with a IFD. This tool The ifdtool can be used to manipulate a firmware image with a IFD. This tool
will not take into account the FMAP while modifying the image which can lead to will not take into account the FMAP while modifying the image which can lead to
unexpected and hard to debug issues with the firmware image. For example if the unexpected and hard to debug issues with the firmware image. For example if the
ME region is defined at 6 MB in the IFD but the FMAP only allocates 4 MB for the ME region is defined at 6 MiB in the IFD but the FMAP only allocates 4 MiB for
ME, then when the ME is added by the ifdtool 6 MB will be written which could the ME, then when the ME is added by the ifdtool 6 MiB will be written which
overwrite 2 MB of the BIOS. could overwrite 2 MiB of the BIOS.
In order to validate that the FMAP and the IFD are compatible the ifdtool In order to validate that the FMAP and the IFD are compatible the ifdtool
provides --validate (-t) option. `ifdtool -t` will read both the IFD and the provides --validate (-t) option. `ifdtool -t` will read both the IFD and the

4
Documentation/mainboard/facebook/monolith.md
View file

@ -41,8 +41,8 @@ These can be extracted from the original flash image as follows:
00003000:006FFFFF me 00003000:006FFFFF me
00001000:00002fff gbe 00001000:00002fff gbe
``` ```
3) Use `ifdtool -n <layout_file> <flash_image>` to resize the *bios* region from the default 6MB 3) Use `ifdtool -n <layout_file> <flash_image>` to resize the *bios* region from the default 6 MiB
to 9 MB, this is required to create sufficient space for LinuxBoot. to 9 MiB, this is required to create sufficient space for LinuxBoot.
NOTE: Please make sure only the firmware descriptor (*fd*) region is changed. Older versions NOTE: Please make sure only the firmware descriptor (*fd*) region is changed. Older versions
of the ifdtool corrupt the *me* region. of the ifdtool corrupt the *me* region.
4) Use `ifdtool -x <resized_flash_image>` to extract the components. 4) Use `ifdtool -x <resized_flash_image>` to extract the components.

2
Documentation/mainboard/hp/8760w.md
View file

@ -36,7 +36,7 @@ checkout the [code on gerrit] to build coreboot for the laptop.
## Flashing instructions ## Flashing instructions
HP EliteBook 8760w has an 8MB SOIC-8 flash chip on the bottom of the HP EliteBook 8760w has an 8 MiB SOIC-8 flash chip on the bottom of the
mainboard. You just need to remove the service cover, and use an SOIC-8 mainboard. You just need to remove the service cover, and use an SOIC-8
clip to read and flash the chip. clip to read and flash the chip.

2
Documentation/mainboard/intel/kblrvp11.md
View file

@ -60,7 +60,7 @@ $ flashrom -p internal --ifd -i bios -w coreboot.rom --noverify-all
2. Make sure power supply is disconnected from board. 2. Make sure power supply is disconnected from board.
3. Connect Dediprog SF600 to header at J7H1. 3. Connect Dediprog SF600 to header at J7H1.
4. Ensure that "currently working on" is in "application memory chip 1" 4. Ensure that "currently working on" is in "application memory chip 1"
5. Go to "file" and select the .rom file (16 MB) to program chip1. 5. Go to "file" and select the .rom file (16 MiB) to program chip1.
6. Execute the batch operation to erase and program the chip. 6. Execute the batch operation to erase and program the chip.
## Technology ## Technology

12
Documentation/mainboard/lenovo/montevina_series.md
View file

@ -53,7 +53,7 @@ the `new_layout.txt` file:
```eval_rst ```eval_rst
+---------------------------+---------------------------+---------------------------+ +---------------------------+---------------------------+---------------------------+
| 4 MB chip | 8 MB chip | 16 MB chip | | 4 MiB chip | 8 MiB chip | 16 MiB chip |
+===========================+===========================+===========================+ +===========================+===========================+===========================+
| .. code-block:: none | .. code-block:: none | .. code-block:: none | | .. code-block:: none | .. code-block:: none | .. code-block:: none |
| | | | | | | |
@ -97,12 +97,12 @@ $ cd util/bincfg
$ make $ make
``` ```
If your flash is not 8 MB, you need to change values of `flcomp_density1` and If your flash is not 8 MiB, you need to change values of `flcomp_density1` and
`flreg1_limit` in the `ifd-x200.set` file according to following table: `flreg1_limit` in the `ifd-x200.set` file according to following table:
```eval_rst ```eval_rst
+-----------------+-------+-------+--------+ +-----------------+-------+-------+--------+
| | 4 MB | 8 MB | 16 MB | | | 4 MiB | 8 MiB | 16 MiB |
+=================+=======+=======+========+ +=================+=======+=======+========+
| flcomp_density1 | 0x3 | 0x4 | 0x5 | | flcomp_density1 | 0x3 | 0x4 | 0x5 |
+-----------------+-------+-------+--------+ +-----------------+-------+-------+--------+
@ -123,7 +123,7 @@ to flash descriptor and gbe dump.
``` ```
Mainboard ---> Mainboard --->
ROM chip size (8192 KB (8 MB)) # According to your chip ROM chip size (8192 KB (8 MB)) # According to your chip
(0x7fd000) Size of CBFS filesystem in ROM # or 0x3fd000 for 4 MB chip / 0x1ffd000 for 16 MB chip (0x7fd000) Size of CBFS filesystem in ROM # or 0x3fd000 for 4 MiB chip / 0x1ffd000 for 16 MiB chip
Chipset ---> Chipset --->
[*] Add Intel descriptor.bin file [*] Add Intel descriptor.bin file
@ -142,7 +142,7 @@ The flash layouts of the OEM firmware are as follows:
```eval_rst ```eval_rst
+---------------------------------+---------------------------------+ +---------------------------------+---------------------------------+
| 4 MB chip | 8 MB chip | | 4 MiB chip | 8 MiB chip |
+=================================+=================================+ +=================================+=================================+
| .. code-block:: none | .. code-block:: none | | .. code-block:: none | .. code-block:: none |
| | | | | |
@ -159,6 +159,6 @@ The flash layouts of the OEM firmware are as follows:
On each boot of vendor BIOS `ec` area in flash is checked for having firmware On each boot of vendor BIOS `ec` area in flash is checked for having firmware
there, and if there is one, it proceedes to update firmware on H8S/2116 (when there, and if there is one, it proceedes to update firmware on H8S/2116 (when
both external power and main battery are attached). Once update is performed, both external power and main battery are attached). Once update is performed,
first 64 KB of `ec` area is erased. Visit first 64 KiB of `ec` area is erased. Visit
[thinkpad-ec repository](https://github.com/hamishcoleman/thinkpad-ec) to learn [thinkpad-ec repository](https://github.com/hamishcoleman/thinkpad-ec) to learn
more about how to extract EC firmware from vendor updates. more about how to extract EC firmware from vendor updates.

8
Documentation/mainboard/lenovo/t440p.md
View file

@ -8,15 +8,15 @@ Please see [mrc.bin](../../northbridge/intel/haswell/mrc.bin).
## Flashing instructions ## Flashing instructions
T440p has two flash chips, an 8MB W25Q64FV and a 4MB W25Q32FV. To flash T440p has two flash chips, an 8 MiB W25Q64FV and a 4 MiB W25Q32FV. To flash
coreboot, you just need to remove the big door according to the T440 coreboot, you just need to remove the big door according to the T440
[Hardware Maintenance Manual] and flash the 4MB chip. [Hardware Maintenance Manual] and flash the 4 MiB chip.
![T440p flash chip](t440p_flash_chip.jpg) ![T440p flash chip](t440p_flash_chip.jpg)
To access the 8MB chip, you need to remove the base cover. To access the 8 MiB chip, you need to remove the base cover.
![T440p 8MB flash chip](t440p_all_flash_chips.jpg) ![T440p 8 MiB flash chip](t440p_all_flash_chips.jpg)
The flash layout of the OEM firmware is as follows: The flash layout of the OEM firmware is as follows:

2
Documentation/mainboard/msi/ms7707/ms7707.md
View file

@ -2,7 +2,7 @@
* MSI MS-7707 V1.1 (Medion OEM Akoya P4385D MSN10014555) * MSI MS-7707 V1.1 (Medion OEM Akoya P4385D MSN10014555)
* SandyBridge Intel P67 (BD82x6x) * SandyBridge Intel P67 (BD82x6x)
* Winbond 25Q32BV (4MB) * Winbond 25Q32BV (4 MiB)
* Fintek F71808A SuperIO * Fintek F71808A SuperIO
* Intel 82579V Gigabit * Intel 82579V Gigabit
* NEC uPD720200 USB 3.0 Host Controller * NEC uPD720200 USB 3.0 Host Controller

2
Documentation/mainboard/supermicro/x11-lga1151-series/x11-lga1151-series.md
View file

@ -18,7 +18,7 @@ Controller etc.
## De-blobbing ## De-blobbing
- [Intel FSP2.0] can not be removed as long as there is no free replacement - [Intel FSP2.0] can not be removed as long as there is no free replacement
- Intel ME can be cleaned using me_cleaner (~4.5 MB more free space) - Intel ME can be cleaned using me_cleaner (~4.5 MiB more free space)
- Intel Ethernet Controller Firmware can be removed when it's extended functionality is not - Intel Ethernet Controller Firmware can be removed when it's extended functionality is not
needed. For more details refer to the respective datasheet (e.g 333016-008 for I210). needed. For more details refer to the respective datasheet (e.g 333016-008 for I210).
- Boards with [AST2400] BMC/IPMI: Firmware can be replaced by [OpenBMC] - Boards with [AST2400] BMC/IPMI: Firmware can be replaced by [OpenBMC]