fix: updates to latest schema

Author: Bucknalla

notecard/card.py

@@ -33,38 +33,38 @@ def get(card, length=None, offset=None):
 
 
 @validate_card_object
-def status(card, name=None, stop=None, status=None, version=None, vvalue=None, on=None, off=None, err=None):
+def status(card, err=None, name=None, off=None, on=None, status=None, stop=None, version=None, vvalue=None):
     """Get and sets the background download status of MCU host or Notecard firmware updates.
 
     Args:
         card (Notecard): The current Notecard object.
+        err (str): If `err` text is provided along with `"stop":true`, this sets the host DFU to an error state with the specified string.
         name (str): Determines which type of firmware update status to view. The value can be `"user"` (default), which gets the status of MCU host firmware updates, or `"card"`, which gets the status of Notecard firmware updates.
-        stop (bool): `true` to clear DFU state and delete the local firmware image from the Notecard.
+        off (bool): `true` to disable firmware downloads from Notehub.
+        on (bool): `true` to allow firmware downloads from Notehub.
         status (str): When setting `stop` to `true`, an optional string synchronized to Notehub, which can be used for informational or diagnostic purposes.
+        stop (bool): `true` to clear DFU state and delete the local firmware image from the Notecard.
         version (str): Version information on the host firmware to pass to Notehub. You may pass a simple version number string (e.g. `"1.0.0.0"`), or an object with detailed information about the firmware image (recommended). If you provide an object it must take the following form. `{"org":"my-organization","product":"My Product","description":"A description of the image","version":"1.2.4","built":"Jan 01 2025 01:02:03","vermajor":1,"verminor":2,"verpatch":4,"verbuild": 5,"builder":"The Builder"}` Code to help you generate a version with the correct formatting is available in Enabling Notecard Outboard Firmware Update.
         vvalue (str): A voltage-variable string that controls, by Notecard voltage, whether or not DFU is enabled. Use a boolean `1` (on) or `0` (off) for each source/voltage level: `usb:<1/0>;high:<1/0>;normal:<1/0>;low:<1/0>;dead:0`.
-        on (bool): `true` to allow firmware downloads from Notehub.
-        off (bool): `true` to disable firmware downloads from Notehub.
-        err (str): If `err` text is provided along with `"stop":true`, this sets the host DFU to an error state with the specified string.
 
     Returns:
         dict: The result of the Notecard request.
     """
     req = {"req": "dfu.status"}
+    if err:
+        req["err"] = err
     if name:
         req["name"] = name
-    if stop is not None:
-        req["stop"] = stop
+    if off is not None:
+        req["off"] = off
+    if on is not None:
+        req["on"] = on
     if status:
         req["status"] = status
+    if stop is not None:
+        req["stop"] = stop
     if version:
         req["version"] = version
     if vvalue:
         req["vvalue"] = vvalue
-    if on is not None:
-        req["on"] = on
-    if off is not None:
-        req["off"] = off
-    if err:
-        req["err"] = err
     return card.Transaction(req)

notecard/dfu.py

@@ -122,7 +122,7 @@ def set(card, align=None, details=None, duration=None, host=None, inbound=None,
 
 @validate_card_object
 def signal(card, seconds=None):
-    """Receive a Signal (a near-real-time note) from Notehub. This request checks for an inbound signal from Notehub. If it finds a signal, this request returns the signal's body and deletes the signal. If there are multiple signals to receive, this request reads and deletes signals in FIFO (first in first out) order.
+    """Receive a Signal (a near-real-time Note) from Notehub. This request checks for an inbound signal from Notehub. If it finds a signal, this request returns the signal's body and deletes the signal. If there are multiple signals to receive, this request reads and deletes signals in FIFO (first in first out) order.
 
     Args:
         card (Notecard): The current Notecard object.