libosdp 3.0.8__tar.gz → 3.1.2__tar.gz

{libosdp-3.0.8 → libosdp-3.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: libosdp
-Version: 3.0.8
+Version: 3.1.2
 Summary: Library implementation of IEC 60839-11-5 OSDP (Open Supervised Device Protocol)
 Home-page: https://github.com/goToMain/libosdp
 Author: Siddharth Chandrasekaran
@@ -10,6 +10,14 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
 
 # LibOSDP for Python
 

{libosdp-3.0.8 → libosdp-3.1.2}/libosdp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: libosdp
-Version: 3.0.8
+Version: 3.1.2
 Summary: Library implementation of IEC 60839-11-5 OSDP (Open Supervised Device Protocol)
 Home-page: https://github.com/goToMain/libosdp
 Author: Siddharth Chandrasekaran
@@ -10,6 +10,14 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
 
 # LibOSDP for Python
 

{libosdp-3.0.8 → libosdp-3.1.2}/libosdp.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ osdp/helpers.py
 osdp/key_store.py
 osdp/peripheral_device.py
 vendor/include/osdp.h
+vendor/include/osdp_export.h
 vendor/python/osdp_sys/base.c
 vendor/python/osdp_sys/cp.c
 vendor/python/osdp_sys/data.c
@@ -27,7 +28,6 @@ vendor/src/osdp_config.h
 vendor/src/osdp_cp.c
 vendor/src/osdp_diag.c
 vendor/src/osdp_diag.h
-vendor/src/osdp_export.h
 vendor/src/osdp_file.c
 vendor/src/osdp_file.h
 vendor/src/osdp_pd.c
@@ -37,6 +37,7 @@ vendor/src/crypto/tinyaes.c
 vendor/src/crypto/tinyaes_src.c
 vendor/src/crypto/tinyaes_src.h
 vendor/utils/include/utils/assert.h
+vendor/utils/include/utils/crc16.h
 vendor/utils/include/utils/disjoint_set.h
 vendor/utils/include/utils/list.h
 vendor/utils/include/utils/logger.h
@@ -44,6 +45,7 @@ vendor/utils/include/utils/pcap_gen.h
 vendor/utils/include/utils/queue.h
 vendor/utils/include/utils/slab.h
 vendor/utils/include/utils/utils.h
+vendor/utils/src/crc16.c
 vendor/utils/src/disjoint_set.c
 vendor/utils/src/list.c
 vendor/utils/src/logger.c

{libosdp-3.0.8 → libosdp-3.1.2}/osdp/constants.py

@@ -35,6 +35,7 @@ class Command:
     Buzzer = osdp_sys.CMD_BUZZER
     LED = osdp_sys.CMD_LED
     Comset = osdp_sys.CMD_COMSET
+    ComsetDone = osdp_sys.CMD_COMSET_DONE
     Text = osdp_sys.CMD_TEXT
     Manufacturer = osdp_sys.CMD_MFG
     Keyset = osdp_sys.CMD_KEYSET

{libosdp-3.0.8 → libosdp-3.1.2}/osdp/control_panel.py

@@ -26,8 +26,11 @@ class ControlPanel():
             self.pd_addr.append(pd_info.address)
             info_list.append(pd_info.get())
         self.event_queue = [ queue.Queue() for i in self.pd_addr ]
+        self.user_event_handler = None
         osdp_sys.set_loglevel(log_level)
         self.ctx = osdp_sys.ControlPanel(info_list)
+        # Always use our internal handler to ensure queue functionality
+        self.ctx.set_event_callback(self._internal_event_handler)
         self.set_event_handler(event_handler)
         self.event = None
         self.lock = None
@@ -42,13 +45,22 @@ class ControlPanel():
             time.sleep(0.020) #sleep for 20ms
 
     def set_event_handler(self, handler: Callable[[int, dict], int]):
-        if handler:
-            self.ctx.set_event_callback(handler)
-        else:
-            self.ctx.set_event_callback(self.event_handler)
+        """Set user event handler while maintaining queue functionality"""
+        self.user_event_handler = handler
 
-    def event_handler(self, pd, event) -> int:
+    def _internal_event_handler(self, pd, event) -> int:
+        """Internal handler that manages both queue and user callback"""
+        # Always put event in queue for get_event() compatibility
         self.event_queue[pd].put(event)
+
+        # If user has set a custom handler, call it too
+        if self.user_event_handler:
+            try:
+                return self.user_event_handler(pd, event)
+            except Exception as e:
+                print(f"Error in user event handler: {e}")
+                return -1
+
         return 0
 
     def get_event(self, address, timeout: int=5):
@@ -119,13 +131,18 @@ class ControlPanel():
                 sc_active += 1
         return sc_active
 
-    def send_command(self, address, cmd):
+    def submit_command(self, address, cmd):
         pd = self.pd_addr.index(address)
         self.lock.acquire()
-        ret = self.ctx.send_command(pd, cmd)
+        ret = self.ctx.submit_command(pd, cmd)
         self.lock.release()
         return ret
 
+    def send_command(self, address, cmd):
+        from warnings import warn
+        warn("This method has been renamed to submit_command", DeprecationWarning, 2)
+        return self.submit_command(address, cmd)
+
     def set_flag(self, address, flag: LibFlag):
         pd = self.pd_addr.index(address)
         self.lock.acquire()
@@ -140,6 +157,27 @@ class ControlPanel():
         self.lock.release()
         return ret
 
+    def disable_pd(self, address: int) -> bool:
+        pd = self.pd_addr.index(address)
+        self.lock.acquire()
+        ret = self.ctx.disable_pd(pd)
+        self.lock.release()
+        return ret
+
+    def enable_pd(self, address: int) -> bool:
+        pd = self.pd_addr.index(address)
+        self.lock.acquire()
+        ret = self.ctx.enable_pd(pd)
+        self.lock.release()
+        return ret
+
+    def is_pd_enabled(self, address: int) -> bool:
+        pd = self.pd_addr.index(address)
+        self.lock.acquire()
+        ret = self.ctx.is_pd_enabled(pd)
+        self.lock.release()
+        return ret
+
     def register_file_ops(self, address, fops):
         pd = self.pd_addr.index(address)
         self.lock.acquire()
@@ -197,8 +235,14 @@ class ControlPanel():
 
     def offline_wait(self, address, timeout=8):
         count = 0
-        time.sleep(timeout)
-        return self.is_online(address) == False
+        res = False
+        while count < timeout * 2:
+            time.sleep(0.5)
+            if not self.is_online(address):
+                res = True
+                break
+            count += 1
+        return res
 
     def sc_wait(self, address, timeout=5):
         count = 0

{libosdp-3.0.8 → libosdp-3.1.2}/osdp/peripheral_device.py

@@ -19,12 +19,11 @@ class PeripheralDevice():
                  command_handler: Callable[[dict], Tuple[int, dict]]=None):
         self.command_queue = queue.Queue()
         self.address = pd_info.address
+        self.user_command_handler = None
         osdp_sys.set_loglevel(log_level)
         self.ctx = osdp_sys.PeripheralDevice(pd_info.get(), capabilities=pd_cap.get())
-        if command_handler:
-            self.ctx.set_command_callback(command_handler)
-        else:
-            self.ctx.set_command_callback(self.command_handler)
+        # Always use our internal handler to ensure queue functionality
+        self.ctx.set_command_callback(self._internal_command_handler)
         self.set_command_handler(command_handler)
         self.event = None
         self.lock = None
@@ -38,15 +37,24 @@ class PeripheralDevice():
             lock.release()
             time.sleep(0.020) #sleep for 20ms
 
-    def command_handler(self, command) -> Tuple[int, dict]:
+    def _internal_command_handler(self, command) -> Tuple[int, dict]:
+        """Internal handler that manages both queue and user callback"""
+        # Always put command in queue for get_command() compatibility
         self.command_queue.put(command)
+
+        # If user has set a custom handler, call it too
+        if self.user_command_handler:
+            try:
+                return self.user_command_handler(command)
+            except Exception as e:
+                print(f"Error in user command handler: {e}")
+                return -1, None
+
         return 0, None
 
     def set_command_handler(self, handler: Callable[[dict], Tuple[int, dict]]):
-        if handler:
-            self.ctx.set_command_callback(handler)
-        else:
-            self.ctx.set_command_callback(self.command_handler)
+        """Set user command handler while maintaining queue functionality"""
+        self.user_command_handler = handler
 
     def get_command(self, timeout: int=5):
         block = timeout >= 0
@@ -56,12 +64,17 @@ class PeripheralDevice():
             return None
         return cmd
 
-    def notify_event(self, event):
+    def submit_event(self, event):
         self.lock.acquire()
-        ret = self.ctx.notify_event(event)
+        ret = self.ctx.submit_event(event)
         self.lock.release()
         return ret
 
+    def notify_event(self, event):
+        from warnings import warn
+        warn("This method has been renamed to submit_event", DeprecationWarning, 2)
+        return self.submit_event(event)
+
     def register_file_ops(self, fops):
         self.lock.acquire()
         ret = self.ctx.register_file_ops(0, fops)

{libosdp-3.0.8 → libosdp-3.1.2}/setup.py

@@ -11,7 +11,7 @@ import shutil
 import subprocess
 
 project_name = "libosdp"
-project_version = "3.0.8"
+project_version = "3.1.2"
 current_dir = os.path.dirname(os.path.realpath(__file__))
 repo_root = os.path.realpath(os.path.join(current_dir, ".."))
 
@@ -63,9 +63,6 @@ def try_vendor_sources(src_dir, src_files, vendor_dir):
 
     ## generate build headers into ./vendor
 
-    with open("vendor/src/osdp_export.h", "w") as f:
-        f.write("#define OSDP_EXPORT\n")
-
     git = get_git_info()
     shutil.move("vendor/src/osdp_config.h.in", "vendor/src/osdp_config.h")
     configure_file("vendor/src/osdp_config.h", {
@@ -85,6 +82,7 @@ utils_sources = [
     "utils/src/utils.c",
     "utils/src/logger.c",
     "utils/src/disjoint_set.c",
+    "utils/src/crc16.c",
 ]
 
 utils_includes = [
@@ -95,6 +93,7 @@ utils_includes = [
     "utils/include/utils/utils.h",
     "utils/include/utils/logger.h",
     "utils/include/utils/disjoint_set.h",
+    "utils/include/utils/crc16.h",
 ]
 
 lib_sources = [
@@ -110,6 +109,7 @@ lib_sources = [
 
 lib_includes = [
     "include/osdp.h",
+    "include/osdp_export.h",
     "src/osdp_common.h",
     "src/osdp_file.h",
     "src/crypto/tinyaes_src.h",
@@ -147,13 +147,13 @@ try_vendor_sources(
 )
 
 definitions = [
-    "CONFIG_OSDP_PACKET_TRACE",
-    # "CONFIG_OSDP_DATA_TRACE",
-    # "CONFIG_OSDP_SKIP_MARK_BYTE",
+    "OPT_OSDP_PACKET_TRACE",
+    # "OPT_OSDP_DATA_TRACE",
+    # "OPT_OSDP_SKIP_MARK_BYTE",
 ]
 
-if ("CONFIG_OSDP_PACKET_TRACE" in definitions or
-    "CONFIG_OSDP_DATA_TRACE" in definitions):
+if ("OPT_OSDP_PACKET_TRACE" in definitions or
+    "OPT_OSDP_DATA_TRACE" in definitions):
     source_files += [
         "src/osdp_diag.c",
         "utils/src/pcap_gen.c",

{libosdp-3.0.8 → libosdp-3.1.2}/vendor/include/osdp.h

@@ -14,7 +14,7 @@
 
 #include <stdint.h>
 #include <stdbool.h>
-#include <osdp_export.h>
+#include "osdp_export.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -29,6 +29,7 @@ extern "C" {
  * possible. Fail where these assumptions don't hold.
  *   - Don't allow use of SCBK-D.
  *   - Assume that a KEYSET was successful at an earlier time.
+ *   - CP does not allow user requested broadcast commands (see OSDP_CMD_FLAG_BROADCAST)
  *
  * @note This flag is recommended in production use.
  */
@@ -64,7 +65,7 @@ extern "C" {
 
 /**
  * @brief Capture raw osdp packets as seen by this device to a pcap file.
- * LibOSDP must be built with CONFIG_OSDP_PACKET_TRACE or CONFIG_OSDP_DATA_TRACE
+ * LibOSDP must be built with OPT_OSDP_PACKET_TRACE or OPT_OSDP_DATA_TRACE
  * for this flag to be in effect.
  *
  * @note The app must call osdp_{cp,pd}_teardown() before existing for the
@@ -185,6 +186,22 @@ enum osdp_pd_cap_function_code_e {
 	 */
 	OSDP_PD_CAP_BIOMETRICS,
 
+	/**
+	 * This capability indicates if the reader is capable of supporting
+	 * Secure Pin Entry (SPE) for smart cards
+	 */
+	OSDP_PD_CAP_SECURE_PIN_ENTRY,
+
+	/**
+	 * This capability indicates the version of OSDP the PD supports
+	 *
+	 * Compliance Levels:
+	 *   0 - Unspecified
+	 *   1 - IEC 60839-11-5
+	 *   2 - SIA OSDP 2.2
+	 */
+	OSDP_PD_CAP_OSDP_VERSION,
+
 	/**
 	 * Capability Sentinel
 	 */
@@ -279,6 +296,14 @@ typedef int (*osdp_write_fn_t)(void *data, uint8_t *buf, int len);
  */
 typedef void (*osdp_flush_fn_t)(void *data);
 
+/**
+ * @brief pointer to function that closes the underlying channel. This call is
+ * made when LibOSDP is terminating, once per PD.
+ *
+ * @param data for use by underlying layers. osdp_channel::data is passed
+ */
+typedef void (*osdp_close_fn_t)(void *data);
+
 /**
  * @brief User defined communication channel abstraction for OSDP devices.
  * The methods for read/write/flush are expected to be non-blocking.
@@ -308,6 +333,10 @@ struct osdp_channel {
 	 * Pointer to function used to flush the channel (optional)
 	 */
 	osdp_flush_fn_t flush;
+	/**
+	 * Pointer to function used to close the channel (optional)
+	 */
+	osdp_close_fn_t close;
 };
 
 /**
@@ -393,6 +422,8 @@ enum osdp_status_report_type {
 	OSDP_STATUS_REPORT_REMOTE,
 };
 
+#define OSDP_STATUS_REPORT_MAX_LEN 64
+
 /**
  * @brief Status report structure. Used by OSDP_CMD_STATUS and
  * OSDP_EVENT_STATUS. In case of command, it is used to send a query to the PD
@@ -411,9 +442,9 @@ struct osdp_status_report {
 	 */
 	int nr_entries;
 	/**
-	 * Status bit mask
+	 * Status report
 	 */
-	uint32_t mask;
+	uint8_t report[OSDP_STATUS_REPORT_MAX_LEN];
 };
 
 /* ------------------------------- */
@@ -424,8 +455,6 @@ struct osdp_status_report {
 #define OSDP_CMD_KEYSET_KEY_MAX_LEN    32
 #define OSDP_CMD_MFG_MAX_DATALEN       64
 
-#define OSDP_CMD_FILE_TX_FLAG_CANCEL (1UL << 31)
-
 /**
  * @brief Command sent from CP to Control digital output of PD.
  */
@@ -641,19 +670,21 @@ struct osdp_cmd_mfg {
 	 */
 	uint32_t vendor_code;
 	/**
-	 * 1-byte manufacturer defined osdp command
+	 * Command data
 	 */
-	uint8_t command;
+	uint8_t data[OSDP_CMD_MFG_MAX_DATALEN];
 	/**
-	 * length Length of command data (optional)
+	 * Length of the data (internal use)
 	 */
 	uint8_t length;
-	/**
-	 * Command data (optional)
-	 */
-	uint8_t data[OSDP_CMD_MFG_MAX_DATALEN];
 };
 
+/**
+ * @brief A CP only flag that can be used by the application to cancel an
+ * in-flight file transfer.
+ */
+#define OSDP_CMD_FILE_TX_FLAG_CANCEL (1UL << 31)
+
 /**
  * @brief File transfer start command
  */
@@ -665,8 +696,10 @@ struct osdp_cmd_file_tx {
 	/**
 	 * Reserved and set to zero by OSDP spec.
 	 *
-	 * @note: The upper bits are used by libosdp as:
-	 *    bit-31 - OSDP_CMD_FILE_TX_FLAG_CANCEL: cancel an ongoing transfer
+	 * @note: The upper bits are used by libosdp internally (IOW, not sent
+	 * over the OSDP bus). Currently the following flags are defined:
+	 *
+	 * - @ref OSDP_CMD_FILE_TX_FLAG_CANCEL
 	 */
 	uint32_t flags;
 };
@@ -684,18 +717,27 @@ enum osdp_cmd_e {
 	OSDP_CMD_MFG,         /**< Manufacturer specific command */
 	OSDP_CMD_FILE_TX,     /**< File transfer command */
 	OSDP_CMD_STATUS,      /**< Status report command */
+	OSDP_CMD_COMSET_DONE, /**< Comset completed; Alias for OSDP_CMD_COMSET */
 	OSDP_CMD_SENTINEL     /**< Max command value */
 };
 
+/**
+ * @brief When set (`struct osdp_cmd::flags`), the command is sent out with the
+ * OSDP packet broadcast flag to the PD.
+ *
+ * According to the OSDP specification: "the use of the broadcast address should
+ * be limited to controlled (single PD) configurations". So this flag will be
+ * ignored in ENFORCE_SECURE mode.
+ */
+#define OSDP_CMD_FLAG_BROADCAST 0x000000001
+
 /**
  * @brief OSDP Command Structure. This is a wrapper for all individual OSDP
  * commands.
  */
 struct osdp_cmd {
-	/**
-	 * Command ID. Used to select specific commands in union.
-	 */
-	enum osdp_cmd_e id;
+	enum osdp_cmd_e id;    /**< Command ID. Used to select specific commands in union */
+	uint32_t flags;        /**< Flags; see OSDP_CMD_FLAG_* flags for possibilities */
 	/** Command */
 	union {
 		struct osdp_cmd_led led;          /**< LED command structure */
@@ -725,17 +767,12 @@ struct osdp_cmd {
 enum osdp_event_cardread_format_e {
 	OSDP_CARD_FMT_RAW_UNSPECIFIED, /**< Unspecified card format */
 	OSDP_CARD_FMT_RAW_WIEGAND,     /**< Wiegand card format */
-	OSDP_CARD_FMT_ASCII,           /**< ASCII card format */
+	OSDP_CARD_FMT_ASCII,           /**< ASCII card format (deprecated; don't use) */
 	OSDP_CARD_FMT_SENTINEL         /**< Max card format value */
 };
 
 /**
  * @brief OSDP event cardread
- *
- * @note When @a format is set to OSDP_CARD_FMT_RAW_UNSPECIFIED or
- * OSDP_CARD_FMT_RAW_WIEGAND, the length is expressed in bits. OTOH, when it is
- * set to OSDP_CARD_FMT_ASCII, the length is in bytes. The number of bytes to
- * read from the @a data field must be interpreted accordingly.
  */
 struct osdp_event_cardread {
 	/**
@@ -753,7 +790,7 @@ struct osdp_event_cardread {
 	 */
 	int direction;
 	/**
-	 * Length of card data in bytes or bits depending on @a format
+	 * Length of card data in bits
 	 */
 	int length;
 	/**
@@ -796,10 +833,6 @@ struct osdp_event_mfgrep {
 	 * 3-bytes IEEE assigned OUI of manufacturer
 	 */
 	uint32_t vendor_code;
-	/**
-	 * 1-byte reply code
-	 */
-	uint8_t command;
 	/**
 	 * Length of manufacturer data in bytes (optional)
 	 */
@@ -869,10 +902,8 @@ enum osdp_event_type {
  * @brief OSDP Event structure.
  */
 struct osdp_event {
-	/**
-	 * Event type. Used to select specific event in union.
-	 */
-	enum osdp_event_type type;
+	enum osdp_event_type type;  /**< Event type. Used to select specific event in union */
+	uint32_t flags;             /**< Flags; reserved, set to zero */
 	/** Event */
 	union {
 		struct osdp_event_keypress keypress; /**< Keypress event structure */
@@ -983,9 +1014,23 @@ void osdp_pd_set_command_callback(osdp_t *ctx, pd_command_callback_t cb,
  * @retval 0 on success
  * @retval -1 on failure
  */
-OSDP_EXPORT
+OSDP_DEPRECATED_EXPORT("Use osdp_pd_submit_event() instead!")
 int osdp_pd_notify_event(osdp_t *ctx, const struct osdp_event *event);
 
+/**
+ * @brief Submit PD events to CP. These events are delivered to the CP as a
+ * response to a future POLL command. A successful return does not mean CP
+ * received it, it only means LibOSDP accepted this submission.
+ *
+ * @param ctx OSDP context
+ * @param event pointer to event struct. Must be filled by application.
+ *
+ * @retval 0 on success
+ * @retval -1 on failure
+ */
+OSDP_EXPORT
+int osdp_pd_submit_event(osdp_t *ctx, const struct osdp_event *event);
+
 /**
  * @brief Deletes all events from the PD's event queue.
  *
@@ -1014,6 +1059,19 @@ int osdp_pd_flush_events(osdp_t *ctx);
 OSDP_EXPORT
 osdp_t *osdp_cp_setup(int num_pd, const osdp_pd_info_t *info);
 
+/**
+ * @brief Adds more PD devices in the CP control list.
+ *
+ * @param num_pd Number of PDs connected to this CP. The `osdp_pd_info_t *` is
+ * treated as an array of length num_pd.
+ * @param info Pointer to info struct populated by application.
+ *
+ * @retval 0 on success
+ * @retval -1 on failure
+ */
+OSDP_EXPORT
+int osdp_cp_add_pd(osdp_t *ctx, int num_pd, const osdp_pd_info_t *info);
+
 /**
  * @brief Periodic refresh method. Must be called by the application at least
  * once every 50ms to meet OSDP timing requirements.
@@ -1046,9 +1104,28 @@ void osdp_cp_teardown(osdp_t *ctx);
  * @note This method only adds the command on to a particular PD's command
  * queue. The command itself can fail due to various reasons.
  */
-OSDP_EXPORT
+OSDP_DEPRECATED_EXPORT("Use osdp_cp_submit_command() instead!")
 int osdp_cp_send_command(osdp_t *ctx, int pd, const struct osdp_cmd *cmd);
 
+/**
+ * @brief Submit CP commands to PD. These commands are queued to be sent to the
+ * PD at the next available opportunity. A successful return does not mean PD
+ * received it, it only means LibOSDP accepted this submission.
+ *
+ * @param ctx OSDP context
+ * @param pd PD offset (0-indexed) of this PD in `osdp_pd_info_t *` passed to
+ * osdp_cp_setup()
+ * @param cmd command pointer. Must be filled by application.
+ *
+ * @retval 0 on success
+ * @retval -1 on failure
+ *
+ * @note This method only adds the command on to a particular PD's command
+ * queue. The command itself can fail due to various reasons.
+ */
+OSDP_EXPORT
+int osdp_cp_submit_command(osdp_t *ctx, int pd, const struct osdp_cmd *cmd);
+
 /**
  * @brief Deletes all commands queued for a give PD
  *
@@ -1124,6 +1201,47 @@ void osdp_cp_set_event_callback(osdp_t *ctx, cp_event_callback_t cb, void *arg);
 OSDP_EXPORT
 int osdp_cp_modify_flag(osdp_t *ctx, int pd, uint32_t flags, bool do_set);
 
+/**
+ * @brief Disable a PD managed by the CP. Disabled PDs are brought to a safe
+ * state and will not process commands or generate events.
+ *
+ * @param ctx OSDP context
+ * @param pd PD offset (0-indexed) of this PD in `osdp_pd_info_t *` passed to
+ * osdp_cp_setup()
+ *
+ * @retval 0 on success
+ * @retval -1 on failure
+ */
+OSDP_EXPORT
+int osdp_cp_disable_pd(osdp_t *ctx, int pd);
+
+/**
+ * @brief Enable a previously disabled PD. The PD will start up as it would
+ * during initial setup.
+ *
+ * @param ctx OSDP context
+ * @param pd PD offset (0-indexed) of this PD in `osdp_pd_info_t *` passed to
+ * osdp_cp_setup()
+ *
+ * @retval 0 on success
+ * @retval -1 on failure
+ */
+OSDP_EXPORT
+int osdp_cp_enable_pd(osdp_t *ctx, int pd);
+
+/**
+ * @brief Check if a PD is currently enabled.
+ *
+ * @param ctx OSDP context
+ * @param pd PD offset (0-indexed) of this PD in `osdp_pd_info_t *` passed to
+ * osdp_cp_setup()
+ *
+ * @retval true if PD is enabled
+ * @retval false if PD is disabled or on error
+ */
+OSDP_EXPORT
+bool osdp_cp_is_pd_enabled(const osdp_t *ctx, int pd);
+
 /* ------------------------------- */
 /*          Common Methods         */
 /* ------------------------------- */