Lint more python scripts

hw/production_test/Makefile

@@ -3,7 +3,9 @@ SHELL := /bin/bash
 PYTHON_FILES = \
     usb_test.py \
     icenvcm.py \
-    icebin2nvcm.py
+    icebin2nvcm.py \
+    encode_usb_strings.py \
+    reset.py
 
 lint:
 	autopep8 --in-place --max-line-length 70 --aggressive --aggressive  ${PYTHON_FILES}

hw/production_test/encode_usb_strings.py

@@ -4,25 +4,34 @@ manufacturer = 'Mullvad'
 product = 'MTA1-USB-V1'
 serial = "68de5d27-e223-4874-bc76-a54d6e84068f"
 
-def descriptor_to_string(descriptor):
-    """ Convert a bytes object containing a USB string descriptor into a python string"""
+
+def descriptor_to_string(descriptor: bytes) -> str:
+    """ Convert a USB string descriptor into a python string
+
+    Keyword arguments:
+    descriptor -- UTF-16 formatted USB descriptor string
+    """
     bLength = descriptor[0]
     if bLength != len(descriptor):
-        raise Exception('Descriptor length mismatch, length_field:{} actual_length:{}'.format(
-                bLength,
-                len(descriptor)
-                ))
+        raise Exception(
+            'Length mismatch, length_field:{:} actual_length:{:}'
+            .format(bLength, len(descriptor)))
 
     bDescriptorType = descriptor[1]
     if bDescriptorType != 0x03:
-        raise Exception('Descriptor type mismatch, bDescriptorType:{02x} expected:0x03'.format(
-            bDescriptorType
-            ))
+        raise Exception(
+            'Type mismatch, bDescriptorType:{:02x} expected:0x03'
+            .format(bDescriptorType))
 
     return descriptor[2:].decode('utf-16', errors='strict')
 
-def string_to_descriptor(string):
-    """ Convert a python string into a bytes object containing a USB string descriptor"""
+
+def string_to_descriptor(string: str) -> bytes:
+    """ Convert a python string into a USB string descriptor
+
+    Keyword arguments:
+    string: String to convert
+    """
     descriptor = bytearray()
     descriptor.append(0x00)  # placeholder for length
     descriptor.append(0x03)
@@ -53,7 +62,6 @@ if __name__ == "__main__":
     # print(['{:02x} '.format(i) for i in sample_product])
     # print(['{:02x} '.format(i) for i in rt])
 
-    
     # sample_mfr = bytes([
     #    0x0A,0x03,
     #    0x5F,0x6c,0xCF,0x82,0x81,0x6c,0x52,0x60,
@@ -65,26 +73,32 @@ if __name__ == "__main__":
     # print(['{:02x} '.format(i) for i in sample_mfr])
     # print(['{:02x} '.format(i) for i in rt])
 
-    
-    
     with open('usb_strings.h', 'w') as f:
         f.write('#ifndef USB_STRINGS\n')
         f.write('#define USB_STRINGS\n')
 
-        f.write('unsigned char __code Prod_Des[]={{  // "{}"\n'.format(product))
+        f.write(
+            'unsigned char __code Prod_Des[]={{  // "{}"\n'
+            .format(product))
         f.write('    ')
-        f.write(', '.join(['0x{:02x}'.format(i) for i in string_to_descriptor(product)]))
+        f.write(', '.join(['0x{:02x}'.format(i)
+                for i in string_to_descriptor(product)]))
         f.write('\n};\n')
 
-        f.write('unsigned char __code Manuf_Des[]={{  // "{}"\n'.format(manufacturer))
+        f.write(
+            'unsigned char __code Manuf_Des[]={{  // "{}"\n'
+            .format(manufacturer))
         f.write('    ')
-        f.write(', '.join(['0x{:02x}'.format(i) for i in string_to_descriptor(manufacturer)]))
+        f.write(', '.join(['0x{:02x}'.format(i)
+                for i in string_to_descriptor(manufacturer)]))
         f.write('\n};\n')
 
-        f.write('unsigned char __code SerDes[]={{  // "{}"\n'.format(serial))
+        f.write(
+            'unsigned char __code SerDes[]={{  // "{}"\n'
+            .format(serial))
         f.write('    ')
-        f.write(', '.join(['0x{:02x}'.format(i) for i in string_to_descriptor(serial)]))
+        f.write(', '.join(['0x{:02x}'.format(i)
+                for i in string_to_descriptor(serial)]))
         f.write('\n};\n')
 
-    
         f.write('#endif\n')

hw/production_test/reset.py

@@ -1,16 +1,20 @@
 #!/usr/bin/env python
-import hid_test
+import hid_test  # type: ignore
 import time
 
 
-def reset_tk1():
-    """Manipulate the GPIO lines on the MTA1-USB-CH552 Programmer to issue a
-    hardware reset to the TK1. The result is that TK1 again will be in firmware
-    mode, so a new app can be loaded."""
+def reset_tk1() -> None:
+    """ Reset a TK1 contained in a TP1 programmer
+
+    Manipulate the GPIO lines on the TP1 to issue a hardware reset
+    to the TK1. The result is that TK1 again will be in firmware
+    mode, so a new app can be loaded.
+    """
     d = hid_test.ice40_flasher()
     d.gpio_set_direction(14, True)
     d.gpio_put(14, False)
     d.gpio_set_direction(14, False)
     d.close()
 
+
 reset_tk1()