dap_link.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: Copyright The Zephyr Project Contributors
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_DAP_DAP_LINK_H
#define ZEPHYR_INCLUDE_DAP_DAP_LINK_H
 
#include <stdint.h>
#include <zephyr/device.h>
#include <zephyr/drivers/swdp.h>
 
#ifdef __cplusplus
extern "C" {
#endif


struct dap_link_context {
        /* Pointer to SWD or JTAG device. Only SWD is supported yet. */
        const struct device *dev;
        atomic_t state;
        /* Runtime debug port type */
        uint8_t debug_port;
        /* Debug port capabilities */
        uint8_t capabilities;
        /* Packet size used by a backend */
        uint16_t pkt_size;
        struct {
                /* Idle cycles after transfer */
                uint8_t idle_cycles;
                /* Number of retries after WAIT response */
                uint16_t retry_count;
                /* Number of retries if read value does not match */
                uint16_t match_retry;
                /* Match Mask */
                uint32_t match_mask;
        } transfer;
};


#define DAP_LINK_CONTEXT_DEFINE(ctx_name, ctx_dev)                              \
        static struct dap_link_context ctx_name = {                             \
                .dev = ctx_dev,                                                 \
        }

int dap_link_init(struct dap_link_context *const dap_link_ctx);

void dap_link_set_pkt_size(struct dap_link_context *const dap_link_ctx,
                           const uint16_t pkt_size);

int dap_link_backend_usb_init(struct dap_link_context *const dap_link_ctx);
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_DAP_DAP_LINK_H */