openwrt/flashrom
1
0
Fork 0
mirror of https://review.coreboot.org/flashrom.git synced 2025-04-27 15:12:36 +02:00
Code Issues Releases Wiki Activity
flashrom/Documentation/building.md
Thomas Heijligen 75d327c550 Documentation: Add build instructions for meson 
Change-Id: I3476f17fa274cd71e3e0e84f791d547d08165ecb
Signed-off-by: Thomas Heijligen <thomas.heijligen@secunet.com>
Reviewed-on: https://review.coreboot.org/c/flashrom/+/66862
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Anastasia Klimchuk <aklm@chromium.org>
2022-09-12 07:15:19 +00:00

3.2 KiB
Raw Blame History

Compiling from Source with meson (recommended)

Dependencies:

  • C compiler (GCC | Clang) *
  • meson >=0.53.0 *
  • ninja *
  • pkg-config *
  • cmocka **
  • system-headers ***
  • libpci ***
  • libusb1 >=1.0.9 ***
  • libftdi1 ***
  • libjaylink ***

* Compile time dependency ** For unit-testing only *** Runtime / Programmer specific

Build Options:

  • classic_cli=auto/enabled/disabled
  • classic_cli_default_programmer=<programmer_name>:<programmer_params>
  • classic_cli_print_wiki=auto/enabled/disabled
  • tests=auto/enabled/disabled
  • ich_descriptors_tool=auto/enabled/disabled
  • use_internal_dmi=true/false
  • programmer=...

Configure

meson builddir -D<your_options>
  • builddir is the directory in which flashrom will be build
  • for all available options see meson_options.txt

Compile

ninja -C builddir

Install

ninja -C builddir install

Run unit tests

ninja -C builddir test

System specific information

Ubuntu / Debian (Linux)

  • linux-headers are version specific
apt-get install -y gcc meson ninja-build pkg-config libcmocka-dev \
	linux-headers-generic libpci-dev libusb-1.0-0-dev libftdi1-dev \
	libjaylink-dev

ArchLinux / Manjaro

  • libjaylink is not available through the package manager
pacman -S --noconfirm gcc meson ninja pkg-config cmocka \
	pciutils libusb libftdi

NixOS / Nixpkgs

nix-shell <flashrom_source>/util/shell.nix

or

nix-shell -p meson ninja pkg-config cmocka pciutils libusb1 libftdi1 libjaylink

OpenSUSE

zypper install -y gcc meson ninja pkg-config libcmocka-devel \
	pciutils-devel libusb-1_0-devel libftdi1-devel \
	libjaylink-devel

Alpine

apk add build-base meson ninja pkgconf cmocka-dev pciutils-dev libusb-dev libftdi1-dev libjaylink-dev linux-headers

Freebsd / DragonFly BSD

  • Tests are not working yet and must be disabled with -Dtests=disabled
  • libjaylink is not available through the package manager
  • libusb1 is part of the base system
pkg install pkgconf meson ninja cmocka libpci libftdi1

OpenBSD

  • Tests are not working yet and must be disabled with -Dtests=disabled
  • libjaylink is not available through the package manager
pkg_add install meson ninja pkg-config cmocka pciutils libusb1 libftdi1

NetBSD

pkgin install meson ninja pkg-config cmocka pciutils libusb1 libftdi1

OpenIndiana (Illumos, Solaris, SunOS)

  • Tests are not working yet and must be disabled with -Dtests=disabled
  • libpci missing, pciutils is build without it
  • libftdi1, libjaylink is not available through the package manager
  • TODO: replace build-essential with the default compiler
pkg install build-essential meson ninja cmocka libusb-1

MacOS (Homebrew)

  • Tests are not working yet and must be disabled with -Dtests=disabled
  • Internal, PCI programmer not supported
  • libjaylink is not available through the package manager
brew install meson ninja pkg-config cmocka libusb libftdi