2020-12-21 05:11:23 +00:00
# fm10k-dump & fm10k-flash
2020-12-19 20:49:53 +00:00
2020-12-21 05:11:23 +00:00
Utility that allows dumping/flashing the SPI Flash Non-Volatile Memory of the FM10000 family of cards.
2020-12-19 20:49:53 +00:00
## Requirements
2021-01-06 07:01:01 +00:00
* GCC >= 4.4.0, TCC, or clang
2020-12-19 20:49:53 +00:00
* make
2020-12-23 00:38:45 +00:00
* Only one FM10K device installed on hardware.
* A management resource (BAR4) must be exposed, check bifurcation settings if needed.
* Usually FM10K cards use two 8x PCIe groups per 16x slot.
2020-12-19 20:49:53 +00:00
## Compilation
2020-12-19 21:11:03 +00:00
* `$ make clean && make`
2021-01-06 07:01:01 +00:00
* You can specify whether to use gcc/clang/tcc this way: `$ make CC=gcc` / `$ make CC=clang` / `$ make CC=tcc`
2020-12-21 05:11:23 +00:00
* Two executables named `./fm10k-dump` and `./fm10k-flash` should now exist.
2020-12-19 20:49:53 +00:00
2020-12-21 05:11:23 +00:00
## fm10k-dump usage example
2020-12-19 20:49:53 +00:00
* If the chip on the card is known to the tool, it'll set the image size to match. Alternatively it will use the platform minimum of 8Mbit.
2020-12-23 00:38:45 +00:00
* `# ./fm10k-dump outputImage.bin`
* You can also force the image/chip size: `# ./fm10k-dump outputImage.bin 32`
2020-12-19 20:49:53 +00:00
2020-12-21 05:11:23 +00:00
## fm10k-flash usage example
* _fm10k-flash_ requires a backup of the existing image before flashing a new one, for safety measures. Use _fm10k-dump_ to take a backup copy of the current state before flashing.
2020-12-23 00:38:45 +00:00
* `# ./fm10k-dump backupImage.bin`
* `# ./fm10k-flash inputImage.bin backupImage.bin`
2020-12-21 05:11:23 +00:00
2020-12-19 20:49:53 +00:00
## License
* BSD-3-Clause
2020-12-21 05:11:23 +00:00
* See [COPYING ](COPYING ) for the full license.