Zephyr API Documentation 3.7.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
swdp.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2019 PHYTEC Messtechnik GmbH
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
12#ifndef ZEPHYR_INCLUDE_SWDP_H_
13#define ZEPHYR_INCLUDE_SWDP_H_
14
15#include <zephyr/device.h>
16
17#ifdef __cplusplus
18extern "C" {
19#endif
20
21/* SWDP packet request bits */
22#define SWDP_REQUEST_APnDP BIT(0)
23#define SWDP_REQUEST_RnW BIT(1)
24#define SWDP_REQUEST_A2 BIT(2)
25#define SWDP_REQUEST_A3 BIT(3)
26
27/* SWDP acknowledge response bits */
28#define SWDP_ACK_OK BIT(0)
29#define SWDP_ACK_WAIT BIT(1)
30#define SWDP_ACK_FAULT BIT(2)
31
32/* SWDP transfer or parity error */
33#define SWDP_TRANSFER_ERROR BIT(3)
34
35/* SWDP Interface pins */
36#define SWDP_SWCLK_PIN 0U
37#define SWDP_SWDIO_PIN 1U
38#define SWDP_nRESET_PIN 7U
39
40/*
41 * Serial Wire Interface (SWDP) driver API.
42 * This is the mandatory API any Serial Wire driver needs to expose.
43 */
44struct swdp_api {
53 int (*swdp_output_sequence)(const struct device *dev,
54 uint32_t count,
55 const uint8_t *data);
56
65 int (*swdp_input_sequence)(const struct device *dev,
66 uint32_t count,
67 uint8_t *data);
68
79 int (*swdp_transfer)(const struct device *dev,
80 uint8_t request,
81 uint32_t *data,
82 uint8_t idle_cycles,
83 uint8_t *response);
84
94 int (*swdp_set_pins)(const struct device *dev,
95 uint8_t pins, uint8_t value);
96
105 int (*swdp_get_pins)(const struct device *dev, uint8_t *state);
106
114 int (*swdp_set_clock)(const struct device *dev, uint32_t clock);
115
124 int (*swdp_configure)(const struct device *dev,
125 uint8_t turnaround,
126 bool data_phase);
127
136 int (*swdp_port_on)(const struct device *dev);
137
144 int (*swdp_port_off)(const struct device *dev);
145};
146
147#ifdef __cplusplus
148}
149#endif
150
151#endif /* ZEPHYR_INCLUDE_SWDP_H_ */
state
Definition parser_state.h:29
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
Runtime device structure (in ROM) per driver instance.
Definition device.h:412
Definition swdp.h:44
int(* swdp_input_sequence)(const struct device *dev, uint32_t count, uint8_t *data)
Read count bits from SWDIO into data LSB first.
Definition swdp.h:65
int(* swdp_transfer)(const struct device *dev, uint8_t request, uint32_t *data, uint8_t idle_cycles, uint8_t *response)
Perform SWDP transfer and store response.
Definition swdp.h:79
int(* swdp_output_sequence)(const struct device *dev, uint32_t count, const uint8_t *data)
Write count bits to SWDIO from data LSB first.
Definition swdp.h:53
int(* swdp_configure)(const struct device *dev, uint8_t turnaround, bool data_phase)
Configure SWDP interface.
Definition swdp.h:124
int(* swdp_port_on)(const struct device *dev)
Enable interface, set pins to default state.
Definition swdp.h:136
int(* swdp_port_off)(const struct device *dev)
Disable interface, set pins to High-Z mode.
Definition swdp.h:144
int(* swdp_set_clock)(const struct device *dev, uint32_t clock)
Set SWDP clock frequency.
Definition swdp.h:114
int(* swdp_get_pins)(const struct device *dev, uint8_t *state)
Get SWCLK, SWDPIO, and nRESET pins state.
Definition swdp.h:105
int(* swdp_set_pins)(const struct device *dev, uint8_t pins, uint8_t value)
Set SWCLK, SWDPIO, and nRESET pins state.
Definition swdp.h:94