py/tests/test_dfu.py

3 # SPDX-License-Identifier: GPL-2.0
5 # Test U-Boot's "dfu" command. The test starts DFU in U-Boot, waits for USB
6 # device enumeration on the host, executes dfu-util multiple times to test
8 # finally aborts the "dfu" command in U-Boot.
26         "host_usb_dev_node": "/dev/usbdev-p2371-2180",
29         "host_usb_port_path": "3-13",
58         # One example is the Odroid XU3,  which automatically generates
78 ACTION=="add", SUBSYSTEM=="block", SUBSYSTEMS=="usb", KERNELS=="3-13", MODE:="666"
88 ENV{ID_PATH}=="?*", ENV{.ID_PORT}=="", SYMLINK+="bus/usb/by-path/$env{ID_PATH}"
89 ENV{ID_PATH}=="?*", ENV{.ID_PORT}=="?*", SYMLINK+="bus/usb/by-path/$env{ID_PATH}-port$env{.ID_PORT}"
92 # The set of file sizes to test. These values trigger various edge-cases such
96     64 - 1,
99     128 - 1,
102     960 - 1,
105     4096 - 1,
108     1024 * 1024 - 1,
122         u_boot_console: A U-Boot console connection.
123         env__usb_dev_port: The single USB device-mode port specification on
124             which to run the test. See the file-level comment above for
127             to run the test. See the file-level comment above for details
135         """Start U-Boot's dfu shell command.
137         This also waits for the host-side USB enumeration process to complete.
155             'Starting long-running U-Boot dfu shell command')
172         """Stop U-Boot's dfu shell command from executing.
174         This also waits for the host-side USB de-enumeration process to
179                 already been detected, and the code is performing best-effort
189                 'Stopping long-running U-Boot dfu shell command')
200         """Invoke dfu-util on the host.
205             fn: The host-side file name to transfer.
206             up_dn_load_arg: '-U' or '-D' depending on whether a DFU upload or
213         cmd = ['dfu-util', '-a', alt_setting, up_dn_load_arg, fn]
215             cmd += ['-p', env__usb_dev_port['host_usb_port_path']]
225             fn: The host-side file name to transfer.
231         run_dfu_util(alt_setting, fn, '-D')
239             fn: The host-side file name to transfer.
245         # dfu-util fails reads/uploads if the host file already exists
248         run_dfu_util(alt_setting, fn, '-U')
289     # host PC can enumerate the U-Boot USB device.
315                 # Make the status of each sub-test obvious. If the test didn't