blob: ab4c64790798a6557ce82c1be462b435a51c9d26 (
plain) (
blame)
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
|
/*
* Copyright (c) 2015, Freescale Semiconductor, Inc.
* Copyright 2016-2022 NXP
* All rights reserved.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
#ifndef __FSL_LPSPI_FREERTOS_H__
#define __FSL_LPSPI_FREERTOS_H__
#include "FreeRTOS.h"
#include "portable.h"
#include "semphr.h"
#include "fsl_lpspi.h"
/*!
* @addtogroup lpspi_freertos_driver LPSPI FreeRTOS Driver
* @{
*/
/**********************************************************************************************************************
* Definitions
*********************************************************************************************************************/
/*! @name Driver version */
/*@{*/
/*! @brief LPSPI FreeRTOS driver version 2.3.1. */
#define FSL_LPSPI_FREERTOS_DRIVER_VERSION (MAKE_VERSION(2, 3, 1))
/*@}*/
/*!
* @cond RTOS_PRIVATE
* @brief LPSPI FreeRTOS handle
*/
typedef struct _lpspi_rtos_handle
{
LPSPI_Type *base; /*!< LPSPI base address */
lpspi_master_handle_t drv_handle; /*!< Handle of the underlying driver, treated as opaque by the RTOS layer */
status_t async_status;
SemaphoreHandle_t mutex; /*!< Mutex to lock the handle during a trasfer */
SemaphoreHandle_t event; /*!< Semaphore to notify and unblock task when transfer ends */
} lpspi_rtos_handle_t;
/*! \endcond */
/**********************************************************************************************************************
* API
*********************************************************************************************************************/
#if defined(__cplusplus)
extern "C" {
#endif
/*!
* @name LPSPI RTOS Operation
* @{
*/
/*!
* @brief Initializes LPSPI.
*
* This function initializes the LPSPI module and related RTOS context.
*
* @param handle The RTOS LPSPI handle, the pointer to an allocated space for RTOS context.
* @param base The pointer base address of the LPSPI instance to initialize.
* @param masterConfig Configuration structure to set-up LPSPI in master mode.
* @param srcClock_Hz Frequency of input clock of the LPSPI module.
* @return status of the operation.
*/
status_t LPSPI_RTOS_Init(lpspi_rtos_handle_t *handle,
LPSPI_Type *base,
const lpspi_master_config_t *masterConfig,
uint32_t srcClock_Hz);
/*!
* @brief Deinitializes the LPSPI.
*
* This function deinitializes the LPSPI module and related RTOS context.
*
* @param handle The RTOS LPSPI handle.
*/
status_t LPSPI_RTOS_Deinit(lpspi_rtos_handle_t *handle);
/*!
* @brief Performs SPI transfer.
*
* This function performs an SPI transfer according to data given in the transfer structure.
*
* @param handle The RTOS LPSPI handle.
* @param transfer Structure specifying the transfer parameters.
* @return status of the operation.
*/
status_t LPSPI_RTOS_Transfer(lpspi_rtos_handle_t *handle, lpspi_transfer_t *transfer);
/*!
* @}
*/
#if defined(__cplusplus)
}
#endif
/*!
* @}
*/
#endif /* __FSL_LPSPI_FREERTOS_H__ */
|
