108 lines
2.8 KiB
C
108 lines
2.8 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2015, Freescale Semiconductor, Inc.
|
||
|
|
* Copyright 2016-2020 NXP
|
||
|
|
* All rights reserved.
|
||
|
|
*
|
||
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
||
|
|
*/
|
||
|
|
#ifndef __FSL_LPI2C_FREERTOS_H__
|
||
|
|
#define __FSL_LPI2C_FREERTOS_H__
|
||
|
|
|
||
|
|
#include "FreeRTOS.h"
|
||
|
|
#include "portable.h"
|
||
|
|
#include "semphr.h"
|
||
|
|
|
||
|
|
#include "fsl_lpi2c.h"
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @addtogroup lpi2c_freertos_driver LPI2C FreeRTOS Driver
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* Definitions
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
/*! @name Driver version */
|
||
|
|
/*@{*/
|
||
|
|
/*! @brief LPI2C FreeRTOS driver version. */
|
||
|
|
#define FSL_LPI2C_FREERTOS_DRIVER_VERSION (MAKE_VERSION(2, 3, 0))
|
||
|
|
/*@}*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @cond RTOS_PRIVATE
|
||
|
|
* @brief LPI2C FreeRTOS handle
|
||
|
|
*/
|
||
|
|
typedef struct _lpi2c_rtos_handle
|
||
|
|
{
|
||
|
|
LPI2C_Type *base; /*!< LPI2C base address */
|
||
|
|
lpi2c_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 semaphore; /*!< Semaphore to notify and unblock task when transfer ends */
|
||
|
|
} lpi2c_rtos_handle_t;
|
||
|
|
/*! \endcond */
|
||
|
|
|
||
|
|
/*******************************************************************************
|
||
|
|
* API
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @name LPI2C RTOS Operation
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @brief Initializes LPI2C.
|
||
|
|
*
|
||
|
|
* This function initializes the LPI2C module and related RTOS context.
|
||
|
|
*
|
||
|
|
* @param handle The RTOS LPI2C handle, the pointer to an allocated space for RTOS context.
|
||
|
|
* @param base The pointer base address of the LPI2C instance to initialize.
|
||
|
|
* @param masterConfig Configuration structure to set-up LPI2C in master mode.
|
||
|
|
* @param srcClock_Hz Frequency of input clock of the LPI2C module.
|
||
|
|
* @return status of the operation.
|
||
|
|
*/
|
||
|
|
status_t LPI2C_RTOS_Init(lpi2c_rtos_handle_t *handle,
|
||
|
|
LPI2C_Type *base,
|
||
|
|
const lpi2c_master_config_t *masterConfig,
|
||
|
|
uint32_t srcClock_Hz);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @brief Deinitializes the LPI2C.
|
||
|
|
*
|
||
|
|
* This function deinitializes the LPI2C module and related RTOS context.
|
||
|
|
*
|
||
|
|
* @param handle The RTOS LPI2C handle.
|
||
|
|
*/
|
||
|
|
status_t LPI2C_RTOS_Deinit(lpi2c_rtos_handle_t *handle);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @brief Performs I2C transfer.
|
||
|
|
*
|
||
|
|
* This function performs an I2C transfer using LPI2C module according to data given in the transfer structure.
|
||
|
|
*
|
||
|
|
* @param handle The RTOS LPI2C handle.
|
||
|
|
* @param transfer Structure specifying the transfer parameters.
|
||
|
|
* @return status of the operation.
|
||
|
|
*/
|
||
|
|
status_t LPI2C_RTOS_Transfer(lpi2c_rtos_handle_t *handle, lpi2c_master_transfer_t *transfer);
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/*!
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
#endif /* __FSL_LPI2C_FREERTOS_H__ */
|