blob: aabb45b18054728d169e16be4e31ce4d072ef572 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
# 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
* Tests are not working yet and must be disabled with `-Dtests=disabled`
* __libjaylink__ is not available through the package manager
* note: https://www.cambus.net/installing-ca-certificates-on-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
```
|
