From 813f2171b7014e89122abcccf79b66925e0989f9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 19 May 2026 20:30:43 +0000 Subject: [PATCH] Update Notecard API from upstream schema changes (49fbe4948b3df7a59c752d92708ce885427480ca) --- notecard/card.py | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/notecard/card.py b/notecard/card.py index 32dfb22..88c6c81 100644 --- a/notecard/card.py +++ b/notecard/card.py @@ -115,9 +115,9 @@ def auxSerial(card, duration=None, limit=None, max=None, minutes=None, mode=None Args: card (Notecard): The current Notecard object. - duration (int): If using `"mode": "accel"`, specify a sampling duration for the Notecard accelerometer. + duration (int): If using `"mode": "notify,accel"`, specify a sampling duration (in milliseconds) for the Notecard accelerometer. limit (bool): If `true`, along with `"mode":"gps"` the Notecard will disable concurrent modem use during GPS tracking. - max (int): The maximum amount of data, in bytes, that can be sent in a single transmission before the Notecard pauses to allow the host to process incoming data. This value should be set to the size of the host's serial receive buffer minus `1`, which represents the number of bytes the host can absorb before the sender must delay due to the absence of flow control. For example, `note-arduino`` uses a buffer size of `(SERIALRXBUFFER_SIZE - 1)`. + max (int): The maximum amount of data, in bytes, that can be sent in a single transmission before the Notecard pauses to allow the host to process incoming data. This value should be set to the size of the host's serial receive buffer minus `1`, which represents the number of bytes the host can absorb before the sender must delay due to the absence of flow control. For example, `note-arduino` uses a buffer size of `(SERIALRXBUFFER_SIZE - 1)`. minutes (int): When using `"mode": "notify,dfu"`, specify an interval for notifying the host. mode (str): The AUX mode. Must be one of the following: ms (int): The delay in milliseconds before sending a buffer of `max` size. @@ -404,8 +404,8 @@ def locationTrack(card, file=None, heartbeat=None, hours=None, payload=None, sta Args: card (Notecard): The current Notecard object. file (str): The Notefile in which to store tracked location data. See the `_track.qo` Notefile's documentation for details on the format of the data captured. - heartbeat (bool): When `start` is `true`, set to `true` to enable tracking even when motion is not detected. If using `heartbeat`, also set the `hours` below. - hours (int): If `heartbeat` is true, add a heartbeat entry at this hourly interval. Use a negative integer to specify a heartbeat in minutes instead of hours. + heartbeat (bool): When `start` is `true`, set to `true` to capture a tracking Note on a fixed interval even when no motion has been detected. The interval is configured with the `hours` field below. + hours (int): When `heartbeat` is `true`, the interval at which to capture a heartbeat tracking Note. A positive value sets the interval in hours (e.g. `2` captures a Note every two hours). To configure an interval shorter than one hour, pass a negative integer whose absolute value is the number of minutes (e.g. `-30` captures a Note every 30 minutes). payload (str): A base64-encoded binary payload to be included in the next `_track.qo` Note. See the guide on Sampling at Predefined Intervals for more details. start (bool): Set to `true` to start Notefile tracking. stop (bool): Set to `true` to stop Notefile tracking. @@ -744,7 +744,7 @@ def transport(card, allow=None, method=None, seconds=None, umin=None): card (Notecard): The current Notecard object. allow (bool): Set to `true` to allow adding Notes to non-compact Notefiles while connected over a non-terrestrial network. See Define NTN vs non-NTN Templates. method (str): The connectivity method to enable on the Notecard. - seconds (int): The amount of time a Notecard will spend on any fallback transport before retrying the first transport specified in the `method`. The default is `3600` or 60 minutes. + seconds (int): The amount of time (in seconds) a Notecard will spend on any fallback transport before retrying the first transport specified in the `method`. The default is `3600` or 60 minutes. umin (bool): Set to `true` to force a longer network transport timeout when using Wideband Notecards. Returns: