blob: 408d5594219a4f3ccd062f70f5c3e3b09bd4b193 [file] [log] [blame]
Lukasz Majewski98ffe742014-06-18 11:38:56 +02001DFU TEST CASE DESCRIPTION:
2
Stephen Warrenb1c384c2014-06-10 16:28:10 -06003The prerequisites for running this script are assured by
4dfu_gadget_test_init.sh, which is automatically invoked by dfu_gadget_test.sh.
Lukasz Majewski98ffe742014-06-18 11:38:56 +02005In this file user is able to generate their own set of test files by altering
6the default set of TEST_FILES_SIZES variable.
7The dfu_gadget_test_init.sh would generate test images only if they are not
8already generated.
9
Stephen Warrenb1c384c2014-06-10 16:28:10 -060010On the target device, environment variable "dfu_alt_info" must contain at
11least:
Lukasz Majewski98ffe742014-06-18 11:38:56 +020012
Stephen Warrenb1c384c2014-06-10 16:28:10 -060013 dfu_test.bin fat 0 6;dfudummy.bin fat 0 6
14
15Depending on your device, you may need to replace "fat" with
16"ext4", and "6" with the relevant partition number. For reference please
17consult the config file for TRATS/TRATS2 devices
18(../../include/configs/trats{2}.h)
19
20One can use fat, ext4 or any other supported file system supported by U-Boot.
21These can be created by exporting storage devices via UMS (ums 0 mmc 0) and
22using standard tools on host (like mkfs.ext4).
Lukasz Majewski98ffe742014-06-18 11:38:56 +020023
24Example usage:
251. On the target:
Stephen Warrenb1c384c2014-06-10 16:28:10 -060026 setenv dfu_alt_info dfu_test.bin fat 0 6\;dfudummy.bin fat 0 6
Lukasz Majewski98ffe742014-06-18 11:38:56 +020027 dfu 0 mmc 0
282. On the host:
Lukasz Majewski56d62ca2015-08-15 11:23:45 +020029 test/dfu/dfu_gadget_test.sh X Y [test file name] [usb device vendor:product]
Lukasz Majewskidcb11862014-06-20 17:53:44 +020030 e.g. test/dfu/dfu_gadget_test.sh 0 1
31 or
32 e.g. test/dfu/dfu_gadget_test.sh 0 1 ./dat_960.img
Lukasz Majewski56d62ca2015-08-15 11:23:45 +020033 or
34 e.g. test/dfu/dfu_gadget_test.sh 0 1 0451:d022
35 or
36 e.g. test/dfu/dfu_gadget_test.sh 0 1 ./dat_960.img 0451:d022
Lukasz Majewski98ffe742014-06-18 11:38:56 +020037
Lukasz Majewskidcb11862014-06-20 17:53:44 +020038... where X and Y are dfu_test.bin's and dfudummy.bin's alt setting numbers.
39They can be obtained from dfu-util -l or $dfu_alt_info.
40It is also possible to pass optional [test file name] to force the script to
41test one particular file.
Lukasz Majewski56d62ca2015-08-15 11:23:45 +020042If many DFU devices are connected, it may be useful to filter on USB
43vendor/product ID (0451:d022).
44One can get them by running "lsusb" command on a host PC.