feat(bootcfg): set usb identification with a kwargs-dict

Author: xs5871

docs/en/boot.md

@@ -33,7 +33,7 @@ bootcfg(
     nkro: bool = False,
     pan: bool = False,
     storage: bool = True,
-    usb_id: Optional[tuple[str, str]] = None,
+    usb_id: Optional[dict] = {},
     **kwargs,
 ) -> bool
 ```
@@ -128,6 +128,9 @@ I have to mount!" every time you plug in your keyboard.
 #### `usb_id`
 A recent addition to CircuitPython 8 is the ability to give your keyboard an
 identity other than "MCU board manufacturer" - "CircuitPython device".
+The argument is expected to be a kwargs-dictionary that is passed to
+`supervisor.set_usb_identification`.
+See the example 1 and the [CircuitPython documentation](https://docs.circuitpython.org/en/latest/shared-bindings/supervisor/index.html#supervisor.set_usb_identification) for reference.
 
 
 #### return value
@@ -156,7 +159,7 @@ bootcfg(
     midi=False,
     mouse=False,
     storage=False,
-    usb_id=('KMK Keyboards', 'Custom 60% Ergo'),
+    usb_id={'manufacturer': 'KMK Keyboards', 'product': 'Custom 60% Ergo'},
 )
 
 ```

kmk/bootcfg.py

@@ -22,7 +22,7 @@ def bootcfg(
     nkro: bool = False,
     pan: bool = False,
     storage: bool = True,
-    usb_id: Optional[tuple[str, str]] = None,
+    usb_id: Optional[dict, tuple[str, str]] = {},
     **kwargs,
 ) -> bool:
 
@@ -44,6 +44,14 @@ def bootcfg(
 
         supervisor.runtime.autoreload = False
 
+<<<<<<< HEAD
+=======
+    # Parse `usb_id` tuple for backwards compatibility. This can be removed at
+    # some point in the future(TM).
+    if type(usb_id) is tuple:
+        usb_id = {'manufacturer': usb_id[0], 'product': usb_id[1]}
+
+>>>>>>> 28dcc3e (feat(bootcfg): set usb identification with a kwargs-dict)
     # configure HID devices
     devices = []
     if keyboard:
@@ -74,11 +82,13 @@ def bootcfg(
         usb_midi.disable()
 
     # configure usb vendor and product id
-    if usb_id is not None:
+    if usb_id:
         import supervisor
 
-        if hasattr(supervisor, 'set_usb_identification'):
-            supervisor.set_usb_identification(*usb_id)
+        try:
+            supervisor.set_usb_identification(**usb_id)
+        except Exception as e:
+            print('supervisor.set_usb_identification: ', e, type(e))
 
     # configure data serial
     if cdc_data: