Tests: USB: Remove outdated docs from basic test

Author: Filip Jagodzinski

TESTS/host_tests/pyusb_basic.py

@@ -1639,154 +1639,3 @@ def get_descriptor(dev, type_index, lang_id, length):
     ret = dev.ctrl_transfer(request_type, request, value, index, length)
 
     return ret
-
-
-"""
-For documentation purpose until test writing finished
-TODO: remove this if not needed anymore
-
-
-def test_device(serial_number, log=print):
-        dev = usb.core.find(custom_match=TestMatch(serial_number))
-        if dev is None:
-            log("Device not found")
-            return
-
-        ## --Control Tests-- ##
-        #control_basic_test(dev, log)
-            # Test control IN/OUT/NODATA
-        control_stall_test(dev, log)
-            # Invalid control in/out/nodata requests are stalled
-            # Stall during different points in the control transfer
-        #control_sizes_test(dev, log)
-            # Test control requests of various data stage sizes (1,8,16,32,64,255,256,...)
-        control_stress_test(dev, log)
-            # normal and delay mode
-
-        ## --Endpoint test-- ##
-        #for each endpoint
-            #-test all allowed wMaxPacketSize sizes and transfer types
-            #-stall tests
-                #-set/clear stall control request
-                #-stall at random points of sending/receiveing data
-            #-test aborting an in progress transfer
-        #test as many endpoints at once as possible
-        #test biggest configuration possible
-
-        ## --physical test-- ##
-        #-reset notification/handling
-        #-connect/disconnect tests - have device disconnect and then reconnect
-            #-disconnect during various phases of control transfers and endpoint transfers
-        #-suspend/resume tests (may not be possible to test with current framework)
-            #-suspend/resume notifications
-
-        ## -- Stress tests-- ##
-        #-concurrent tests (all endpoints at once including control)
-        #-concurrent tests + reset + delay
-
-        ## -- other tests-- ##
-        #-report throughput for in/out of control, bulk, interrupt and iso transfers
-        #-verify that construction/destruction repeatedly works gracefully
-
-        intf = get_interface(dev, 0, 0)
-
-        # Find endpoints
-        bulk_in = None
-        bulk_out = None
-        int_in = None
-        int_out = None
-
-        for endpoint in intf:
-            log("Processing endpoint %s" % endpoint)
-            ep_type = endpoint.bmAttributes & 0x3
-            if  ep_type == 2:
-                if endpoint.bEndpointAddress & 0x80:
-                    assert bulk_in is None
-                    bulk_in = endpoint
-                else:
-                    assert bulk_out is None
-                    bulk_out = endpoint
-            elif ep_type == 3:
-                if endpoint.bEndpointAddress & 0x80:
-                    assert int_in is None
-                    int_in = endpoint
-                else:
-                    assert int_out is None
-                    int_out = endpoint
-        assert bulk_in is not None
-        assert bulk_out is not None
-        assert int_in is not None
-        assert int_out is not None
-        bulk_out.write("hello" + "x" *256);
-        int_out.write("world" + "x" *256);
-
-        dev.set_interface_altsetting(0, 1)
-
-        intf = get_interface(dev, 0, 0)
-
-        # Find endpoints
-        bulk_in = None
-        bulk_out = None
-        int_in = None
-        int_out = None
-
-        for endpoint in intf:
-            log("Processing endpoint %s" % endpoint)
-            ep_type = endpoint.bmAttributes & 0x3
-            if  ep_type == 2:
-                if endpoint.bEndpointAddress & 0x80:
-                    assert bulk_in is None
-                    bulk_in = endpoint
-                else:
-                    assert bulk_out is None
-                    bulk_out = endpoint
-            elif ep_type == 3:
-                if endpoint.bEndpointAddress & 0x80:
-                    assert int_in is None
-                    int_in = endpoint
-                else:
-                    assert int_out is None
-                    int_out = endpoint
-        assert bulk_in is not None
-        assert bulk_out is not None
-        assert int_in is not None
-        assert int_out is not None
-        bulk_out.write("hello2" + "x" *256);
-        int_out.write("world2" + "x" *256);
-
-
-        t = Thread(target=write_data, args=(bulk_out,))
-        t.start()
-
-        for _ in range(10):
-            request_type = build_request_type(CTRL_OUT, CTRL_TYPE_VENDOR,
-                                              CTRL_RECIPIENT_DEVICE)
-            request = VENDOR_TEST_CTRL_NONE_DELAY
-            value = 0               # Always 0 for this request
-            index = 0               # Communication interface
-            length = 0              # No data
-            dev.ctrl_transfer(request_type, request, value, index, length, 5000)
-
-        t.join()
-
-
-def write_data(pipe):
-    print("Write data running")
-    count = 0
-    for _ in range(40):
-        pipe.write("Value is %s" % count)
-        count += 1
-        print("Count %s" % count)
-        time.sleep(0.5)
-
-
-def main():
-    parser = ArgumentParser(description="USB basic test")
-    parser.add_argument('serial', help='USB serial number of DUT')
-    args = parser.parse_args()
-    ret = test_device(args.serial)
-    print("Test %s" % "passed" if ret else "failed")
-
-if __name__ == "__main__":
-    main()
-"""