1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016-2019 NXP
* All rights reserved.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef _FSL_XBARA_H_
#define _FSL_XBARA_H_
#include "fsl_common.h"
/*!
* @addtogroup xbara
* @{
*/
/*******************************************************************************
* Definitions
******************************************************************************/
#define FSL_XBARA_DRIVER_VERSION (MAKE_VERSION(2, 0, 5))
/* Macros for entire XBARA_SELx register. */
#define XBARA_SELx(base, output) (((volatile uint16_t *)(&((base)->SEL0)))[(uint32_t)(output) / 2UL])
/* Set the XBARA_SELx_SELx field to a new value. */
#define XBARA_WR_SELx_SELx(base, input, output) XBARA_SetSignalsConnection((base), (input), (output))
/*!
* @brief XBARA active edge for detection
*/
typedef enum _xbara_active_edge
{
kXBARA_EdgeNone = 0U, /*!< Edge detection status bit never asserts. */
kXBARA_EdgeRising = 1U, /*!< Edge detection status bit asserts on rising edges. */
kXBARA_EdgeFalling = 2U, /*!< Edge detection status bit asserts on falling edges. */
kXBARA_EdgeRisingAndFalling = 3U /*!< Edge detection status bit asserts on rising and falling edges. */
} xbara_active_edge_t;
/*!
* @brief Defines the XBARA DMA and interrupt configurations.
*/
typedef enum _xbar_request
{
kXBARA_RequestDisable = 0U, /*!< Interrupt and DMA are disabled. */
kXBARA_RequestDMAEnable = 1U, /*!< DMA enabled, interrupt disabled. */
kXBARA_RequestInterruptEnalbe = 2U /*!< Interrupt enabled, DMA disabled. */
} xbara_request_t;
/*!
* @brief XBARA status flags.
*
* This provides constants for the XBARA status flags for use in the XBARA functions.
*/
typedef enum _xbara_status_flag_t
{
kXBARA_EdgeDetectionOut0 =
(XBARA_CTRL0_STS0_MASK), /*!< XBAR_OUT0 active edge interrupt flag, sets when active edge detected. */
kXBARA_EdgeDetectionOut1 =
(XBARA_CTRL0_STS1_MASK), /*!< XBAR_OUT1 active edge interrupt flag, sets when active edge detected. */
kXBARA_EdgeDetectionOut2 =
(XBARA_CTRL1_STS2_MASK << 16U), /*!< XBAR_OUT2 active edge interrupt flag, sets when active edge detected. */
kXBARA_EdgeDetectionOut3 =
(XBARA_CTRL1_STS3_MASK << 16U), /*!< XBAR_OUT3 active edge interrupt flag, sets when active edge detected. */
} xbara_status_flag_t;
/*!
* @brief Defines the configuration structure of the XBARA control register.
*
* This structure keeps the configuration of XBARA control register for one output.
* Control registers are available only for a few outputs. Not every XBARA module has
* control registers.
*/
typedef struct XBARAControlConfig
{
xbara_active_edge_t activeEdge; /*!< Active edge to be detected. */
xbara_request_t requestType; /*!< Selects DMA/Interrupt request. */
} xbara_control_config_t;
/*******************************************************************************
* API
******************************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif /* __cplusplus */
/*!
* @name XBARA functional Operation.
* @{
*/
/*!
* @brief Initializes the XBARA module.
*
* This function un-gates the XBARA clock.
*
* @param base XBARA peripheral address.
*/
void XBARA_Init(XBARA_Type *base);
/*!
* @brief Shuts down the XBARA module.
*
* This function disables XBARA clock.
*
* @param base XBARA peripheral address.
*/
void XBARA_Deinit(XBARA_Type *base);
/*!
* @brief Sets a connection between the selected XBARA_IN[*] input and the XBARA_OUT[*] output signal.
*
* This function connects the XBARA input to the selected XBARA output.
* If more than one XBARA module is available, only the inputs and outputs from the same module
* can be connected.
*
* Example:
@code
XBARA_SetSignalsConnection(XBARA, kXBARA_InputPIT_TRG0, kXBARA_OutputDMAMUX18);
@endcode
*
* @param base XBARA peripheral address.
* @param input XBARA input signal.
* @param output XBARA output signal.
*/
void XBARA_SetSignalsConnection(XBARA_Type *base, xbar_input_signal_t input, xbar_output_signal_t output);
/*!
* @brief Gets the active edge detection status.
*
* This function gets the active edge detect status of all XBARA_OUTs. If the
* active edge occurs, the return value is asserted. When the interrupt or the DMA
* functionality is enabled for the XBARA_OUTx, this field is 1 when the interrupt
* or DMA request is asserted and 0 when the interrupt or DMA request has been
* cleared.
*
* @param base XBARA peripheral address.
* @return the mask of these status flag bits.
*/
uint32_t XBARA_GetStatusFlags(XBARA_Type *base);
/*!
* @brief Clears the edge detection status flags of relative mask.
*
* @param base XBARA peripheral address.
* @param mask the status flags to clear.
*/
void XBARA_ClearStatusFlags(XBARA_Type *base, uint32_t mask);
/*!
* @brief Configures the XBARA control register.
*
* This function configures an XBARA control register. The active edge detection
* and the DMA/IRQ function on the corresponding XBARA output can be set.
*
* Example:
@code
xbara_control_config_t userConfig;
userConfig.activeEdge = kXBARA_EdgeRising;
userConfig.requestType = kXBARA_RequestInterruptEnalbe;
XBARA_SetOutputSignalConfig(XBARA, kXBARA_OutputDMAMUX18, &userConfig);
@endcode
*
* @param base XBARA peripheral address.
* @param output XBARA output number.
* @param controlConfig Pointer to structure that keeps configuration of control register.
*/
void XBARA_SetOutputSignalConfig(XBARA_Type *base,
xbar_output_signal_t output,
const xbara_control_config_t *controlConfig);
#if defined(__cplusplus)
}
#endif /* __cplusplus */
/*! @}*/
/*!* @} */
#endif /* _FSL_XBARA_H_ */
|
