90cf37a179
The help prompt usage output for sd_bench was inconsistent with that of the actual application. Amend this error.
52 lines
2.3 KiB
ReStructuredText
52 lines
2.3 KiB
ReStructuredText
================================================
|
|
``sd_bench`` SD card or mount point bench test
|
|
================================================
|
|
|
|
Performs bench mark testing on SD card or other mount points using the file system layer.
|
|
|
|
A single test run.
|
|
|
|
- Sequentially writes blocks of bytes to a test file on the device until the test duration elapses.
|
|
- Optionally, the number of bytes written are read back and verified.
|
|
|
|
The following runtime options are available::
|
|
|
|
sdbench: [-b] [-r] [-d] [-k] [-s] [-a] [-v]
|
|
-b Block size per write (1-65536), default 512
|
|
-r Number of runs (1-10000), default 5
|
|
-d Max duration of a test (ms) (1-60000), default 2000
|
|
-k Keep test file when finished, default false
|
|
-s Call fsync after each block, false calls fsync
|
|
only at the end of each run, default false
|
|
-a Test performance on aligned data, default false
|
|
-v Verify data and block number, default true
|
|
|
|
An example of a completed test::
|
|
|
|
nsh> sdbench
|
|
Using block size = 512 bytes, sync = false
|
|
|
|
Testing Sequential Write Speed...
|
|
Run 1: 345.9 KB/s, max write time: 156.907 ms (3.2 KB/s), fsync: 259.687 ms
|
|
Run 2: 378.8 KB/s, max write time: 30.273 ms (16.5 KB/s), fsync: 240.832 ms
|
|
Run 3: 372.1 KB/s, max write time: 37.630 ms (13.3 KB/s), fsync: 261.005 ms
|
|
Run 4: 341.7 KB/s, max write time: 186.352 ms (2.7 KB/s), fsync: 240.875 ms
|
|
Run 5: 375.6 KB/s, max write time: 37.785 ms (13.2 KB/s), fsync: 250.928 ms
|
|
Avg : 362.8 KB/s, 3.999 MB written.
|
|
|
|
Testing Sequential Read Speed...
|
|
Run 1: 636.5 KB/s, max read/verify time: 54.1180 ms (9.2 KB/s)
|
|
Run 2: 648.9 KB/s, max read/verify time: 54.0520 ms (9.3 KB/s)
|
|
Run 3: 663.2 KB/s, max read/verify time: 43.5360 ms (11.5 KB/s)
|
|
Run 4: 721.8 KB/s, max read/verify time: 11.7640 ms (42.5 KB/s)
|
|
Avg : 652.6 KB/s, 3.999 MB and verified
|
|
|
|
|
|
The following Kconfig options can be used to configure the application at compile time.
|
|
|
|
- ``CONFIG_TESTING_SD_BENCH`` - Enable the SD benchmark testing utility.
|
|
- ``CONFIG_TESTING_SD_BENCH_PROGNAME`` - The name of the program registered with nsh.
|
|
- ``CONFIG_TESTING_SD_BENCH_PRIORITY`` - The priority of the task.
|
|
- ``CONFIG_TESTING_SD_BENCH_STACKSIZE`` - The stacksize of the task.
|
|
- ``CONFIG_TESTING_SD_BENCH_DEVICE`` - The mountpoint to run sdbench on.
|