mbed - The official Mbed 2 C/C++ SDK provides the softwa…

Users » mbed_official » Code » mbed

mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_L486RG/TARGET_STM/TARGET_STM32L4/device/stm32l4xx_hal_qspi.h@140:97feb9bacc10, 2017-04-12 (annotated)

Committer:: <>
Date:: Wed Apr 12 16:07:08 2017 +0100
Revision:: 140:97feb9bacc10
Parent:: 128:9bcdf88f62b0
Child:: 145:64910690c574

Release 140 of the mbed library

Ports for Upcoming Targets

3841: Add nRf52840 target https://github.com/ARMmbed/mbed-os/pull/3841

3992: Introducing UBLOX_C030 platform. https://github.com/ARMmbed/mbed-os/pull/3992

Fixes and Changes

3951: [NUCLEO_F303ZE] Correct ARDUINO pin https://github.com/ARMmbed/mbed-os/pull/3951

4021: Fixing a macro to detect when RTOS was in use for the NRF52840_DK https://github.com/ARMmbed/mbed-os/pull/4021

3979: KW24D: Add missing SPI defines and Arduino connector definitions https://github.com/ARMmbed/mbed-os/pull/3979

3990: UBLOX_C027: construct a ticker-based wait, rather than calling wait_ms(), in the https://github.com/ARMmbed/mbed-os/pull/3990

4003: Fixed OBOE in async serial tx for NRF52 target, fixes #4002 https://github.com/ARMmbed/mbed-os/pull/4003

4012: STM32: Correct I2C master error handling https://github.com/ARMmbed/mbed-os/pull/4012

4020: NUCLEO_L011K4 remove unsupported tool chain files https://github.com/ARMmbed/mbed-os/pull/4020

4065: K66F: Move bss section to m_data_2 Section https://github.com/ARMmbed/mbed-os/pull/4065

4014: Issue 3763: Reduce heap allocation in the GCC linker file https://github.com/ARMmbed/mbed-os/pull/4014

4030: [STM32L0] reduce IAR heap and stack size for small targets https://github.com/ARMmbed/mbed-os/pull/4030

4109: NUCLEO_L476RG : minor serial pin update https://github.com/ARMmbed/mbed-os/pull/4109

3982: Ticker - kl25z bugfix for handling events in the past https://github.com/ARMmbed/mbed-os/pull/3982

Who changed what in which revision?

User	Revision	Line number	New contents of line
Kojto	122:f9eeca106725	1	/**
Kojto	122:f9eeca106725	2	******************************************************************************
Kojto	122:f9eeca106725	3	* @file stm32l4xx_hal_qspi.h
Kojto	122:f9eeca106725	4	* @author MCD Application Team
Kojto	122:f9eeca106725	5	* @version V1.5.1
Kojto	122:f9eeca106725	6	* @date 31-May-2016
Kojto	122:f9eeca106725	7	* @brief Header file of QSPI HAL module.
Kojto	122:f9eeca106725	8	******************************************************************************
Kojto	122:f9eeca106725	9	* @attention
Kojto	122:f9eeca106725	10	*
Kojto	122:f9eeca106725	11	* <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
Kojto	122:f9eeca106725	12	*
Kojto	122:f9eeca106725	13	* Redistribution and use in source and binary forms, with or without modification,
Kojto	122:f9eeca106725	14	* are permitted provided that the following conditions are met:
Kojto	122:f9eeca106725	15	* 1. Redistributions of source code must retain the above copyright notice,
Kojto	122:f9eeca106725	16	* this list of conditions and the following disclaimer.
Kojto	122:f9eeca106725	17	* 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto	122:f9eeca106725	18	* this list of conditions and the following disclaimer in the documentation
Kojto	122:f9eeca106725	19	* and/or other materials provided with the distribution.
Kojto	122:f9eeca106725	20	* 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto	122:f9eeca106725	21	* may be used to endorse or promote products derived from this software
Kojto	122:f9eeca106725	22	* without specific prior written permission.
Kojto	122:f9eeca106725	23	*
Kojto	122:f9eeca106725	24	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto	122:f9eeca106725	25	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto	122:f9eeca106725	26	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto	122:f9eeca106725	27	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto	122:f9eeca106725	28	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto	122:f9eeca106725	29	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto	122:f9eeca106725	30	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto	122:f9eeca106725	31	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto	122:f9eeca106725	32	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto	122:f9eeca106725	33	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto	122:f9eeca106725	34	*
Kojto	122:f9eeca106725	35	******************************************************************************
Kojto	122:f9eeca106725	36	*/
Kojto	122:f9eeca106725	37
Kojto	122:f9eeca106725	38	/* Define to prevent recursive inclusion -------------------------------------*/
Kojto	122:f9eeca106725	39	#ifndef __STM32L4xx_HAL_QSPI_H
Kojto	122:f9eeca106725	40	#define __STM32L4xx_HAL_QSPI_H
Kojto	122:f9eeca106725	41
Kojto	122:f9eeca106725	42	#ifdef __cplusplus
Kojto	122:f9eeca106725	43	extern "C" {
Kojto	122:f9eeca106725	44	#endif
Kojto	122:f9eeca106725	45
Kojto	122:f9eeca106725	46	/* Includes ------------------------------------------------------------------*/
Kojto	122:f9eeca106725	47	#include "stm32l4xx_hal_def.h"
Kojto	122:f9eeca106725	48
Kojto	122:f9eeca106725	49	/** @addtogroup STM32L4xx_HAL_Driver
Kojto	122:f9eeca106725	50	* @{
Kojto	122:f9eeca106725	51	*/
Kojto	122:f9eeca106725	52
Kojto	122:f9eeca106725	53	/** @addtogroup QSPI
Kojto	122:f9eeca106725	54	* @{
Kojto	122:f9eeca106725	55	*/
Kojto	122:f9eeca106725	56
Kojto	122:f9eeca106725	57	/* Exported types ------------------------------------------------------------*/
Kojto	122:f9eeca106725	58	/** @defgroup QSPI_Exported_Types QSPI Exported Types
Kojto	122:f9eeca106725	59	* @{
Kojto	122:f9eeca106725	60	*/
Kojto	122:f9eeca106725	61
Kojto	122:f9eeca106725	62	/**
Kojto	122:f9eeca106725	63	* @brief QSPI Init structure definition
Kojto	122:f9eeca106725	64	*/
Kojto	122:f9eeca106725	65	typedef struct
Kojto	122:f9eeca106725	66	{
Kojto	122:f9eeca106725	67	uint32_t ClockPrescaler; /* Specifies the prescaler factor for generating clock based on the AHB clock.
Kojto	122:f9eeca106725	68	This parameter can be a number between 0 and 255 */
Kojto	122:f9eeca106725	69	uint32_t FifoThreshold; /* Specifies the threshold number of bytes in the FIFO (used only in indirect mode)
Kojto	122:f9eeca106725	70	This parameter can be a value between 1 and 16 */
Kojto	122:f9eeca106725	71	uint32_t SampleShifting; /* Specifies the Sample Shift. The data is sampled 1/2 clock cycle delay later to
Kojto	122:f9eeca106725	72	take in account external signal delays. (It should be QSPI_SAMPLE_SHIFTING_NONE in DDR mode)
Kojto	122:f9eeca106725	73	This parameter can be a value of @ref QSPI_SampleShifting */
Kojto	122:f9eeca106725	74	uint32_t FlashSize; /* Specifies the Flash Size. FlashSize+1 is effectively the number of address bits
Kojto	122:f9eeca106725	75	required to address the flash memory. The flash capacity can be up to 4GB
Kojto	122:f9eeca106725	76	(addressed using 32 bits) in indirect mode, but the addressable space in
Kojto	122:f9eeca106725	77	memory-mapped mode is limited to 256MB
Kojto	122:f9eeca106725	78	This parameter can be a number between 0 and 31 */
Kojto	122:f9eeca106725	79	uint32_t ChipSelectHighTime; /* Specifies the Chip Select High Time. ChipSelectHighTime+1 defines the minimum number
Kojto	122:f9eeca106725	80	of clock cycles which the chip select must remain high between commands.
Kojto	122:f9eeca106725	81	This parameter can be a value of @ref QSPI_ChipSelectHighTime */
Kojto	122:f9eeca106725	82	uint32_t ClockMode; /* Specifies the Clock Mode. It indicates the level that clock takes between commands.
Kojto	122:f9eeca106725	83	This parameter can be a value of @ref QSPI_ClockMode */
Kojto	122:f9eeca106725	84	#if defined(STM32L431xx) \|\| defined(STM32L432xx) \|\| defined(STM32L433xx) \|\| defined(STM32L442xx) \|\| defined(STM32L443xx)
Kojto	122:f9eeca106725	85	uint32_t FlashID; /* Specifies the Flash which will be used,
Kojto	122:f9eeca106725	86	This parameter can be a value of @ref QSPI_Flash_Select */
Kojto	122:f9eeca106725	87	uint32_t DualFlash; /* Specifies the Dual Flash Mode State
Kojto	122:f9eeca106725	88	This parameter can be a value of @ref QSPI_DualFlash_Mode */
Kojto	122:f9eeca106725	89	#endif
Kojto	122:f9eeca106725	90	}QSPI_InitTypeDef;
Kojto	122:f9eeca106725	91
Kojto	122:f9eeca106725	92	/**
Kojto	122:f9eeca106725	93	* @brief HAL QSPI State structures definition
Kojto	122:f9eeca106725	94	*/
Kojto	122:f9eeca106725	95	typedef enum
Kojto	122:f9eeca106725	96	{
Kojto	122:f9eeca106725	97	HAL_QSPI_STATE_RESET = 0x00, /!< Peripheral not initialized /
Kojto	122:f9eeca106725	98	HAL_QSPI_STATE_READY = 0x01, /!< Peripheral initialized and ready for use /
Kojto	122:f9eeca106725	99	HAL_QSPI_STATE_BUSY = 0x02, /!< Peripheral in indirect mode and busy /
Kojto	122:f9eeca106725	100	HAL_QSPI_STATE_BUSY_INDIRECT_TX = 0x12, /!< Peripheral in indirect mode with transmission ongoing /
Kojto	122:f9eeca106725	101	HAL_QSPI_STATE_BUSY_INDIRECT_RX = 0x22, /!< Peripheral in indirect mode with reception ongoing /
Kojto	122:f9eeca106725	102	HAL_QSPI_STATE_BUSY_AUTO_POLLING = 0x42, /!< Peripheral in auto polling mode ongoing /
Kojto	122:f9eeca106725	103	HAL_QSPI_STATE_BUSY_MEM_MAPPED = 0x82, /!< Peripheral in memory mapped mode ongoing /
Kojto	122:f9eeca106725	104	HAL_QSPI_STATE_ABORT = 0x08, /!< Peripheral with abort request ongoing /
Kojto	122:f9eeca106725	105	HAL_QSPI_STATE_ERROR = 0x04 /!< Peripheral in error /
Kojto	122:f9eeca106725	106	}HAL_QSPI_StateTypeDef;
Kojto	122:f9eeca106725	107
Kojto	122:f9eeca106725	108	/**
Kojto	122:f9eeca106725	109	* @brief QSPI Handle Structure definition
Kojto	122:f9eeca106725	110	*/
Kojto	122:f9eeca106725	111	typedef struct
Kojto	122:f9eeca106725	112	{
Kojto	122:f9eeca106725	113	QUADSPI_TypeDef Instance; / QSPI registers base address */
Kojto	122:f9eeca106725	114	QSPI_InitTypeDef Init; /* QSPI communication parameters */
Kojto	122:f9eeca106725	115	uint8_t pTxBuffPtr; / Pointer to QSPI Tx transfer Buffer */
Kojto	122:f9eeca106725	116	__IO uint16_t TxXferSize; /* QSPI Tx Transfer size */
Kojto	122:f9eeca106725	117	__IO uint16_t TxXferCount; /* QSPI Tx Transfer Counter */
Kojto	122:f9eeca106725	118	uint8_t pRxBuffPtr; / Pointer to QSPI Rx transfer Buffer */
Kojto	122:f9eeca106725	119	__IO uint16_t RxXferSize; /* QSPI Rx Transfer size */
Kojto	122:f9eeca106725	120	__IO uint16_t RxXferCount; /* QSPI Rx Transfer Counter */
Kojto	122:f9eeca106725	121	DMA_HandleTypeDef hdma; / QSPI Rx/Tx DMA Handle parameters */
Kojto	122:f9eeca106725	122	__IO HAL_LockTypeDef Lock; /* Locking object */
Kojto	122:f9eeca106725	123	__IO HAL_QSPI_StateTypeDef State; /* QSPI communication state */
Kojto	122:f9eeca106725	124	__IO uint32_t ErrorCode; /* QSPI Error code */
Kojto	122:f9eeca106725	125	uint32_t Timeout; /* Timeout for the QSPI memory access */
Kojto	122:f9eeca106725	126	}QSPI_HandleTypeDef;
Kojto	122:f9eeca106725	127
Kojto	122:f9eeca106725	128	/**
Kojto	122:f9eeca106725	129	* @brief QSPI Command structure definition
Kojto	122:f9eeca106725	130	*/
Kojto	122:f9eeca106725	131	typedef struct
Kojto	122:f9eeca106725	132	{
Kojto	122:f9eeca106725	133	uint32_t Instruction; /* Specifies the Instruction to be sent
Kojto	122:f9eeca106725	134	This parameter can be a value (8-bit) between 0x00 and 0xFF */
Kojto	122:f9eeca106725	135	uint32_t Address; /* Specifies the Address to be sent (Size from 1 to 4 bytes according AddressSize)
Kojto	122:f9eeca106725	136	This parameter can be a value (32-bits) between 0x0 and 0xFFFFFFFF */
Kojto	122:f9eeca106725	137	uint32_t AlternateBytes; /* Specifies the Alternate Bytes to be sent (Size from 1 to 4 bytes according AlternateBytesSize)
Kojto	122:f9eeca106725	138	This parameter can be a value (32-bits) between 0x0 and 0xFFFFFFFF */
Kojto	122:f9eeca106725	139	uint32_t AddressSize; /* Specifies the Address Size
Kojto	122:f9eeca106725	140	This parameter can be a value of @ref QSPI_AddressSize */
Kojto	122:f9eeca106725	141	uint32_t AlternateBytesSize; /* Specifies the Alternate Bytes Size
Kojto	122:f9eeca106725	142	This parameter can be a value of @ref QSPI_AlternateBytesSize */
Kojto	122:f9eeca106725	143	uint32_t DummyCycles; /* Specifies the Number of Dummy Cycles.
Kojto	122:f9eeca106725	144	This parameter can be a number between 0 and 31 */
Kojto	122:f9eeca106725	145	uint32_t InstructionMode; /* Specifies the Instruction Mode
Kojto	122:f9eeca106725	146	This parameter can be a value of @ref QSPI_InstructionMode */
Kojto	122:f9eeca106725	147	uint32_t AddressMode; /* Specifies the Address Mode
Kojto	122:f9eeca106725	148	This parameter can be a value of @ref QSPI_AddressMode */
Kojto	122:f9eeca106725	149	uint32_t AlternateByteMode; /* Specifies the Alternate Bytes Mode
Kojto	122:f9eeca106725	150	This parameter can be a value of @ref QSPI_AlternateBytesMode */
Kojto	122:f9eeca106725	151	uint32_t DataMode; /* Specifies the Data Mode (used for dummy cycles and data phases)
Kojto	122:f9eeca106725	152	This parameter can be a value of @ref QSPI_DataMode */
Kojto	122:f9eeca106725	153	uint32_t NbData; /* Specifies the number of data to transfer. (This is the number of bytes)
Kojto	122:f9eeca106725	154	This parameter can be any value between 0 and 0xFFFFFFFF (0 means undefined length
Kojto	122:f9eeca106725	155	until end of memory)*/
Kojto	122:f9eeca106725	156	uint32_t DdrMode; /* Specifies the double data rate mode for address, alternate byte and data phase
Kojto	122:f9eeca106725	157	This parameter can be a value of @ref QSPI_DdrMode */
Kojto	122:f9eeca106725	158	uint32_t DdrHoldHalfCycle; /* Specifies the DDR hold half cycle. It delays the data output by one half of
Kojto	122:f9eeca106725	159	system clock in DDR mode. Not available on STM32L4x6 devices but in future devices.
Kojto	122:f9eeca106725	160	This parameter can be a value of @ref QSPI_DdrHoldHalfCycle */
Kojto	122:f9eeca106725	161	uint32_t SIOOMode; /* Specifies the send instruction only once mode
Kojto	122:f9eeca106725	162	This parameter can be a value of @ref QSPI_SIOOMode */
Kojto	122:f9eeca106725	163	}QSPI_CommandTypeDef;
Kojto	122:f9eeca106725	164
Kojto	122:f9eeca106725	165	/**
Kojto	122:f9eeca106725	166	* @brief QSPI Auto Polling mode configuration structure definition
Kojto	122:f9eeca106725	167	*/
Kojto	122:f9eeca106725	168	typedef struct
Kojto	122:f9eeca106725	169	{
Kojto	122:f9eeca106725	170	uint32_t Match; /* Specifies the value to be compared with the masked status register to get a match.
Kojto	122:f9eeca106725	171	This parameter can be any value between 0 and 0xFFFFFFFF */
Kojto	122:f9eeca106725	172	uint32_t Mask; /* Specifies the mask to be applied to the status bytes received.
Kojto	122:f9eeca106725	173	This parameter can be any value between 0 and 0xFFFFFFFF */
Kojto	122:f9eeca106725	174	uint32_t Interval; /* Specifies the number of clock cycles between two read during automatic polling phases.
Kojto	122:f9eeca106725	175	This parameter can be any value between 0 and 0xFFFF */
Kojto	122:f9eeca106725	176	uint32_t StatusBytesSize; /* Specifies the size of the status bytes received.
Kojto	122:f9eeca106725	177	This parameter can be any value between 1 and 4 */
Kojto	122:f9eeca106725	178	uint32_t MatchMode; /* Specifies the method used for determining a match.
Kojto	122:f9eeca106725	179	This parameter can be a value of @ref QSPI_MatchMode */
Kojto	122:f9eeca106725	180	uint32_t AutomaticStop; /* Specifies if automatic polling is stopped after a match.
Kojto	122:f9eeca106725	181	This parameter can be a value of @ref QSPI_AutomaticStop */
Kojto	122:f9eeca106725	182	}QSPI_AutoPollingTypeDef;
Kojto	122:f9eeca106725	183
Kojto	122:f9eeca106725	184	/**
Kojto	122:f9eeca106725	185	* @brief QSPI Memory Mapped mode configuration structure definition
Kojto	122:f9eeca106725	186	*/
Kojto	122:f9eeca106725	187	typedef struct
Kojto	122:f9eeca106725	188	{
Kojto	122:f9eeca106725	189	uint32_t TimeOutPeriod; /* Specifies the number of clock to wait when the FIFO is full before to release the chip select.
Kojto	122:f9eeca106725	190	This parameter can be any value between 0 and 0xFFFF */
Kojto	122:f9eeca106725	191	uint32_t TimeOutActivation; /* Specifies if the timeout counter is enabled to release the chip select.
Kojto	122:f9eeca106725	192	This parameter can be a value of @ref QSPI_TimeOutActivation */
Kojto	122:f9eeca106725	193	}QSPI_MemoryMappedTypeDef;
Kojto	122:f9eeca106725	194
Kojto	122:f9eeca106725	195	/**
Kojto	122:f9eeca106725	196	* @}
Kojto	122:f9eeca106725	197	*/
Kojto	122:f9eeca106725	198
Kojto	122:f9eeca106725	199	/* Exported constants --------------------------------------------------------*/
Kojto	122:f9eeca106725	200	/** @defgroup QSPI_Exported_Constants QSPI Exported Constants
Kojto	122:f9eeca106725	201	* @{
Kojto	122:f9eeca106725	202	*/
Kojto	122:f9eeca106725	203
Kojto	122:f9eeca106725	204	/** @defgroup QSPI_ErrorCode QSPI Error Code
Kojto	122:f9eeca106725	205	* @{
Kojto	122:f9eeca106725	206	*/
Kojto	122:f9eeca106725	207	#define HAL_QSPI_ERROR_NONE ((uint32_t)0x00000000) /!< No error /
Kojto	122:f9eeca106725	208	#define HAL_QSPI_ERROR_TIMEOUT ((uint32_t)0x00000001) /!< Timeout error /
Kojto	122:f9eeca106725	209	#define HAL_QSPI_ERROR_TRANSFER ((uint32_t)0x00000002) /!< Transfer error /
Kojto	122:f9eeca106725	210	#define HAL_QSPI_ERROR_DMA ((uint32_t)0x00000004) /!< DMA transfer error /
Kojto	122:f9eeca106725	211	#define HAL_QSPI_ERROR_INVALID_PARAM ((uint32_t)0x00000008) /!< Invalid parameters error /
Kojto	122:f9eeca106725	212	/**
Kojto	122:f9eeca106725	213	* @}
Kojto	122:f9eeca106725	214	*/
Kojto	122:f9eeca106725	215
Kojto	122:f9eeca106725	216	/** @defgroup QSPI_SampleShifting QSPI Sample Shifting
Kojto	122:f9eeca106725	217	* @{
Kojto	122:f9eeca106725	218	*/
Kojto	122:f9eeca106725	219	#define QSPI_SAMPLE_SHIFTING_NONE ((uint32_t)0x00000000) /!<No clock cycle shift to sample data/
Kojto	122:f9eeca106725	220	#define QSPI_SAMPLE_SHIFTING_HALFCYCLE ((uint32_t)QUADSPI_CR_SSHIFT) /!<1/2 clock cycle shift to sample data/
Kojto	122:f9eeca106725	221	/**
Kojto	122:f9eeca106725	222	* @}
Kojto	122:f9eeca106725	223	*/
Kojto	122:f9eeca106725	224
Kojto	122:f9eeca106725	225	/** @defgroup QSPI_ChipSelectHighTime QSPI ChipSelect High Time
Kojto	122:f9eeca106725	226	* @{
Kojto	122:f9eeca106725	227	*/
Kojto	122:f9eeca106725	228	#define QSPI_CS_HIGH_TIME_1_CYCLE ((uint32_t)0x00000000) /!<nCS stay high for at least 1 clock cycle between commands/
Kojto	122:f9eeca106725	229	#define QSPI_CS_HIGH_TIME_2_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_0) /!<nCS stay high for at least 2 clock cycles between commands/
Kojto	122:f9eeca106725	230	#define QSPI_CS_HIGH_TIME_3_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_1) /!<nCS stay high for at least 3 clock cycles between commands/
Kojto	122:f9eeca106725	231	#define QSPI_CS_HIGH_TIME_4_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_0 \| QUADSPI_DCR_CSHT_1) /!<nCS stay high for at least 4 clock cycles between commands/
Kojto	122:f9eeca106725	232	#define QSPI_CS_HIGH_TIME_5_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_2) /!<nCS stay high for at least 5 clock cycles between commands/
Kojto	122:f9eeca106725	233	#define QSPI_CS_HIGH_TIME_6_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_2 \| QUADSPI_DCR_CSHT_0) /!<nCS stay high for at least 6 clock cycles between commands/
Kojto	122:f9eeca106725	234	#define QSPI_CS_HIGH_TIME_7_CYCLE ((uint32_t)QUADSPI_DCR_CSHT_2 \| QUADSPI_DCR_CSHT_1) /!<nCS stay high for at least 7 clock cycles between commands/
Kojto	122:f9eeca106725	235	#define QSPI_CS_HIGH_TIME_8_CYCLE ((uint32_t)QUADSPI_DCR_CSHT) /!<nCS stay high for at least 8 clock cycles between commands/
Kojto	122:f9eeca106725	236	/**
Kojto	122:f9eeca106725	237	* @}
Kojto	122:f9eeca106725	238	*/
Kojto	122:f9eeca106725	239
Kojto	122:f9eeca106725	240	/** @defgroup QSPI_ClockMode QSPI Clock Mode
Kojto	122:f9eeca106725	241	* @{
Kojto	122:f9eeca106725	242	*/
Kojto	122:f9eeca106725	243	#define QSPI_CLOCK_MODE_0 ((uint32_t)0x00000000) /!<Clk stays low while nCS is released/
Kojto	122:f9eeca106725	244	#define QSPI_CLOCK_MODE_3 ((uint32_t)QUADSPI_DCR_CKMODE) /!<Clk goes high while nCS is released/
Kojto	122:f9eeca106725	245	/**
Kojto	122:f9eeca106725	246	* @}
Kojto	122:f9eeca106725	247	*/
Kojto	122:f9eeca106725	248
Kojto	122:f9eeca106725	249	#if defined(STM32L431xx) \|\| defined(STM32L432xx) \|\| defined(STM32L433xx) \|\| defined(STM32L442xx) \|\| defined(STM32L443xx)
Kojto	122:f9eeca106725	250	/** @defgroup QSPI_Flash_Select QSPI Flash Select
Kojto	122:f9eeca106725	251	* @{
Kojto	122:f9eeca106725	252	*/
Kojto	122:f9eeca106725	253	#define QSPI_FLASH_ID_1 ((uint32_t)0x00000000) /!<FLASH 1 selected/
Kojto	122:f9eeca106725	254	#define QSPI_FLASH_ID_2 ((uint32_t)QUADSPI_CR_FSEL) /!<FLASH 2 selected/
Kojto	122:f9eeca106725	255	/**
Kojto	122:f9eeca106725	256	* @}
Kojto	122:f9eeca106725	257	*/
Kojto	122:f9eeca106725	258
Kojto	122:f9eeca106725	259	/** @defgroup QSPI_DualFlash_Mode QSPI Dual Flash Mode
Kojto	122:f9eeca106725	260	* @{
Kojto	122:f9eeca106725	261	*/
Kojto	122:f9eeca106725	262	#define QSPI_DUALFLASH_ENABLE ((uint32_t)QUADSPI_CR_DFM) /!<Dual-flash mode enabled/
Kojto	122:f9eeca106725	263	#define QSPI_DUALFLASH_DISABLE ((uint32_t)0x00000000) /!<Dual-flash mode disabled/
Kojto	122:f9eeca106725	264	/**
Kojto	122:f9eeca106725	265	* @}
Kojto	122:f9eeca106725	266	*/
Kojto	122:f9eeca106725	267	#endif
Kojto	122:f9eeca106725	268
Kojto	122:f9eeca106725	269	/** @defgroup QSPI_AddressSize QSPI Address Size
Kojto	122:f9eeca106725	270	* @{
Kojto	122:f9eeca106725	271	*/
Kojto	122:f9eeca106725	272	#define QSPI_ADDRESS_8_BITS ((uint32_t)0x00000000) /!<8-bit address/
Kojto	122:f9eeca106725	273	#define QSPI_ADDRESS_16_BITS ((uint32_t)QUADSPI_CCR_ADSIZE_0) /!<16-bit address/
Kojto	122:f9eeca106725	274	#define QSPI_ADDRESS_24_BITS ((uint32_t)QUADSPI_CCR_ADSIZE_1) /!<24-bit address/
Kojto	122:f9eeca106725	275	#define QSPI_ADDRESS_32_BITS ((uint32_t)QUADSPI_CCR_ADSIZE) /!<32-bit address/
Kojto	122:f9eeca106725	276	/**
Kojto	122:f9eeca106725	277	* @}
Kojto	122:f9eeca106725	278	*/
Kojto	122:f9eeca106725	279
Kojto	122:f9eeca106725	280	/** @defgroup QSPI_AlternateBytesSize QSPI Alternate Bytes Size
Kojto	122:f9eeca106725	281	* @{
Kojto	122:f9eeca106725	282	*/
Kojto	122:f9eeca106725	283	#define QSPI_ALTERNATE_BYTES_8_BITS ((uint32_t)0x00000000) /!<8-bit alternate bytes/
Kojto	122:f9eeca106725	284	#define QSPI_ALTERNATE_BYTES_16_BITS ((uint32_t)QUADSPI_CCR_ABSIZE_0) /!<16-bit alternate bytes/
Kojto	122:f9eeca106725	285	#define QSPI_ALTERNATE_BYTES_24_BITS ((uint32_t)QUADSPI_CCR_ABSIZE_1) /!<24-bit alternate bytes/
Kojto	122:f9eeca106725	286	#define QSPI_ALTERNATE_BYTES_32_BITS ((uint32_t)QUADSPI_CCR_ABSIZE) /!<32-bit alternate bytes/
Kojto	122:f9eeca106725	287	/**
Kojto	122:f9eeca106725	288	* @}
Kojto	122:f9eeca106725	289	*/
Kojto	122:f9eeca106725	290
Kojto	122:f9eeca106725	291	/** @defgroup QSPI_InstructionMode QSPI Instruction Mode
Kojto	122:f9eeca106725	292	* @{
Kojto	122:f9eeca106725	293	*/
Kojto	122:f9eeca106725	294	#define QSPI_INSTRUCTION_NONE ((uint32_t)0x00000000) /!<No instruction/
Kojto	122:f9eeca106725	295	#define QSPI_INSTRUCTION_1_LINE ((uint32_t)QUADSPI_CCR_IMODE_0) /!<Instruction on a single line/
Kojto	122:f9eeca106725	296	#define QSPI_INSTRUCTION_2_LINES ((uint32_t)QUADSPI_CCR_IMODE_1) /!<Instruction on two lines/
Kojto	122:f9eeca106725	297	#define QSPI_INSTRUCTION_4_LINES ((uint32_t)QUADSPI_CCR_IMODE) /!<Instruction on four lines/
Kojto	122:f9eeca106725	298	/**
Kojto	122:f9eeca106725	299	* @}
Kojto	122:f9eeca106725	300	*/
Kojto	122:f9eeca106725	301
Kojto	122:f9eeca106725	302	/** @defgroup QSPI_AddressMode QSPI Address Mode
Kojto	122:f9eeca106725	303	* @{
Kojto	122:f9eeca106725	304	*/
Kojto	122:f9eeca106725	305	#define QSPI_ADDRESS_NONE ((uint32_t)0x00000000) /!<No address/
Kojto	122:f9eeca106725	306	#define QSPI_ADDRESS_1_LINE ((uint32_t)QUADSPI_CCR_ADMODE_0) /!<Address on a single line/
Kojto	122:f9eeca106725	307	#define QSPI_ADDRESS_2_LINES ((uint32_t)QUADSPI_CCR_ADMODE_1) /!<Address on two lines/
Kojto	122:f9eeca106725	308	#define QSPI_ADDRESS_4_LINES ((uint32_t)QUADSPI_CCR_ADMODE) /!<Address on four lines/
Kojto	122:f9eeca106725	309	/**
Kojto	122:f9eeca106725	310	* @}
Kojto	122:f9eeca106725	311	*/
Kojto	122:f9eeca106725	312
Kojto	122:f9eeca106725	313	/** @defgroup QSPI_AlternateBytesMode QSPI Alternate Bytes Mode
Kojto	122:f9eeca106725	314	* @{
Kojto	122:f9eeca106725	315	*/
Kojto	122:f9eeca106725	316	#define QSPI_ALTERNATE_BYTES_NONE ((uint32_t)0x00000000) /!<No alternate bytes/
Kojto	122:f9eeca106725	317	#define QSPI_ALTERNATE_BYTES_1_LINE ((uint32_t)QUADSPI_CCR_ABMODE_0) /!<Alternate bytes on a single line/
Kojto	122:f9eeca106725	318	#define QSPI_ALTERNATE_BYTES_2_LINES ((uint32_t)QUADSPI_CCR_ABMODE_1) /!<Alternate bytes on two lines/
Kojto	122:f9eeca106725	319	#define QSPI_ALTERNATE_BYTES_4_LINES ((uint32_t)QUADSPI_CCR_ABMODE) /!<Alternate bytes on four lines/
Kojto	122:f9eeca106725	320	/**
Kojto	122:f9eeca106725	321	* @}
Kojto	122:f9eeca106725	322	*/
Kojto	122:f9eeca106725	323
Kojto	122:f9eeca106725	324	/** @defgroup QSPI_DataMode QSPI Data Mode
Kojto	122:f9eeca106725	325	* @{
Kojto	122:f9eeca106725	326	*/
Kojto	122:f9eeca106725	327	#define QSPI_DATA_NONE ((uint32_t)0X00000000) /!<No data/
Kojto	122:f9eeca106725	328	#define QSPI_DATA_1_LINE ((uint32_t)QUADSPI_CCR_DMODE_0) /!<Data on a single line/
Kojto	122:f9eeca106725	329	#define QSPI_DATA_2_LINES ((uint32_t)QUADSPI_CCR_DMODE_1) /!<Data on two lines/
Kojto	122:f9eeca106725	330	#define QSPI_DATA_4_LINES ((uint32_t)QUADSPI_CCR_DMODE) /!<Data on four lines/
Kojto	122:f9eeca106725	331	/**
Kojto	122:f9eeca106725	332	* @}
Kojto	122:f9eeca106725	333	*/
Kojto	122:f9eeca106725	334
Kojto	122:f9eeca106725	335	/** @defgroup QSPI_DdrMode QSPI DDR Mode
Kojto	122:f9eeca106725	336	* @{
Kojto	122:f9eeca106725	337	*/
Kojto	122:f9eeca106725	338	#define QSPI_DDR_MODE_DISABLE ((uint32_t)0x00000000) /!<Double data rate mode disabled/
Kojto	122:f9eeca106725	339	#define QSPI_DDR_MODE_ENABLE ((uint32_t)QUADSPI_CCR_DDRM) /!<Double data rate mode enabled/
Kojto	122:f9eeca106725	340	/**
Kojto	122:f9eeca106725	341	* @}
Kojto	122:f9eeca106725	342	*/
Kojto	122:f9eeca106725	343
Kojto	122:f9eeca106725	344	/** @defgroup QSPI_DdrHoldHalfCycle QSPI DDR Data Output Delay
Kojto	122:f9eeca106725	345	* @{
Kojto	122:f9eeca106725	346	*/
Kojto	122:f9eeca106725	347	#define QSPI_DDR_HHC_ANALOG_DELAY ((uint32_t)0x00000000) /!<Delay the data output using analog delay in DDR mode/
Kojto	122:f9eeca106725	348	#if defined(STM32L431xx) \|\| defined(STM32L432xx) \|\| defined(STM32L433xx) \|\| defined(STM32L442xx) \|\| defined(STM32L443xx)
Kojto	122:f9eeca106725	349	#define QSPI_DDR_HHC_HALF_CLK_DELAY ((uint32_t)QUADSPI_CCR_DHHC) /!<Delay the data output by 1/2 clock cycle in DDR mode/
Kojto	122:f9eeca106725	350	#endif
Kojto	122:f9eeca106725	351	/**
Kojto	122:f9eeca106725	352	* @}
Kojto	122:f9eeca106725	353	*/
Kojto	122:f9eeca106725	354
Kojto	122:f9eeca106725	355	/** @defgroup QSPI_SIOOMode QSPI Send Instruction Mode
Kojto	122:f9eeca106725	356	* @{
Kojto	122:f9eeca106725	357	*/
Kojto	122:f9eeca106725	358	#define QSPI_SIOO_INST_EVERY_CMD ((uint32_t)0x00000000) /!<Send instruction on every transaction/
Kojto	122:f9eeca106725	359	#define QSPI_SIOO_INST_ONLY_FIRST_CMD ((uint32_t)QUADSPI_CCR_SIOO) /!<Send instruction only for the first command/
Kojto	122:f9eeca106725	360	/**
Kojto	122:f9eeca106725	361	* @}
Kojto	122:f9eeca106725	362	*/
Kojto	122:f9eeca106725	363
Kojto	122:f9eeca106725	364	/** @defgroup QSPI_MatchMode QSPI Match Mode
Kojto	122:f9eeca106725	365	* @{
Kojto	122:f9eeca106725	366	*/
Kojto	122:f9eeca106725	367	#define QSPI_MATCH_MODE_AND ((uint32_t)0x00000000) /!<AND match mode between unmasked bits/
Kojto	122:f9eeca106725	368	#define QSPI_MATCH_MODE_OR ((uint32_t)QUADSPI_CR_PMM) /!<OR match mode between unmasked bits/
Kojto	122:f9eeca106725	369	/**
Kojto	122:f9eeca106725	370	* @}
Kojto	122:f9eeca106725	371	*/
Kojto	122:f9eeca106725	372
Kojto	122:f9eeca106725	373	/** @defgroup QSPI_AutomaticStop QSPI Automatic Stop
Kojto	122:f9eeca106725	374	* @{
Kojto	122:f9eeca106725	375	*/
Kojto	122:f9eeca106725	376	#define QSPI_AUTOMATIC_STOP_DISABLE ((uint32_t)0x00000000) /!<AutoPolling stops only with abort or QSPI disabling/
Kojto	122:f9eeca106725	377	#define QSPI_AUTOMATIC_STOP_ENABLE ((uint32_t)QUADSPI_CR_APMS) /!<AutoPolling stops as soon as there is a match/
Kojto	122:f9eeca106725	378	/**
Kojto	122:f9eeca106725	379	* @}
Kojto	122:f9eeca106725	380	*/
Kojto	122:f9eeca106725	381
Kojto	122:f9eeca106725	382	/** @defgroup QSPI_TimeOutActivation QSPI Timeout Activation
Kojto	122:f9eeca106725	383	* @{
Kojto	122:f9eeca106725	384	*/
Kojto	122:f9eeca106725	385	#define QSPI_TIMEOUT_COUNTER_DISABLE ((uint32_t)0x00000000) /!<Timeout counter disabled, nCS remains active/
Kojto	122:f9eeca106725	386	#define QSPI_TIMEOUT_COUNTER_ENABLE ((uint32_t)QUADSPI_CR_TCEN) /!<Timeout counter enabled, nCS released when timeout expires/
Kojto	122:f9eeca106725	387	/**
Kojto	122:f9eeca106725	388	* @}
Kojto	122:f9eeca106725	389	*/
Kojto	122:f9eeca106725	390
Kojto	122:f9eeca106725	391	/** @defgroup QSPI_Flags QSPI Flags
Kojto	122:f9eeca106725	392	* @{
Kojto	122:f9eeca106725	393	*/
Kojto	122:f9eeca106725	394	#define QSPI_FLAG_BUSY QUADSPI_SR_BUSY /!<Busy flag: operation is ongoing/
Kojto	122:f9eeca106725	395	#define QSPI_FLAG_TO QUADSPI_SR_TOF /!<Timeout flag: timeout occurs in memory-mapped mode/
Kojto	122:f9eeca106725	396	#define QSPI_FLAG_SM QUADSPI_SR_SMF /!<Status match flag: received data matches in autopolling mode/
Kojto	122:f9eeca106725	397	#define QSPI_FLAG_FT QUADSPI_SR_FTF /!<Fifo threshold flag: Fifo threshold reached or data left after read from memory is complete/
Kojto	122:f9eeca106725	398	#define QSPI_FLAG_TC QUADSPI_SR_TCF /!<Transfer complete flag: programmed number of data have been transferred or the transfer has been aborted/
Kojto	122:f9eeca106725	399	#define QSPI_FLAG_TE QUADSPI_SR_TEF /!<Transfer error flag: invalid address is being accessed/
Kojto	122:f9eeca106725	400	/**
Kojto	122:f9eeca106725	401	* @}
Kojto	122:f9eeca106725	402	*/
Kojto	122:f9eeca106725	403
Kojto	122:f9eeca106725	404	/** @defgroup QSPI_Interrupts QSPI Interrupts
Kojto	122:f9eeca106725	405	* @{
Kojto	122:f9eeca106725	406	*/
Kojto	122:f9eeca106725	407	#define QSPI_IT_TO QUADSPI_CR_TOIE /!<Interrupt on the timeout flag/
Kojto	122:f9eeca106725	408	#define QSPI_IT_SM QUADSPI_CR_SMIE /!<Interrupt on the status match flag/
Kojto	122:f9eeca106725	409	#define QSPI_IT_FT QUADSPI_CR_FTIE /!<Interrupt on the fifo threshold flag/
Kojto	122:f9eeca106725	410	#define QSPI_IT_TC QUADSPI_CR_TCIE /!<Interrupt on the transfer complete flag/
Kojto	122:f9eeca106725	411	#define QSPI_IT_TE QUADSPI_CR_TEIE /!<Interrupt on the transfer error flag/
Kojto	122:f9eeca106725	412	/**
Kojto	122:f9eeca106725	413	* @}
Kojto	122:f9eeca106725	414	*/
Kojto	122:f9eeca106725	415
Kojto	122:f9eeca106725	416	/** @defgroup QSPI_Timeout_definition QSPI Timeout definition
Kojto	122:f9eeca106725	417	* @brief QSPI Timeout definition
Kojto	122:f9eeca106725	418	* @{
Kojto	122:f9eeca106725	419	*/
Kojto	122:f9eeca106725	420	#define HAL_QPSI_TIMEOUT_DEFAULT_VALUE ((uint32_t)5000)/* 5 s */
Kojto	122:f9eeca106725	421	/**
Kojto	122:f9eeca106725	422	* @}
Kojto	122:f9eeca106725	423	*/
Kojto	122:f9eeca106725	424
Kojto	122:f9eeca106725	425	/**
Kojto	122:f9eeca106725	426	* @}
Kojto	122:f9eeca106725	427	*/
Kojto	122:f9eeca106725	428
Kojto	122:f9eeca106725	429	/* Exported macros -----------------------------------------------------------*/
Kojto	122:f9eeca106725	430	/** @defgroup QSPI_Exported_Macros QSPI Exported Macros
Kojto	122:f9eeca106725	431	* @{
Kojto	122:f9eeca106725	432	*/
Kojto	122:f9eeca106725	433	/** @brief Reset QSPI handle state.
Kojto	122:f9eeca106725	434	* @param __HANDLE__: QSPI handle.
Kojto	122:f9eeca106725	435	* @retval None
Kojto	122:f9eeca106725	436	*/
Kojto	122:f9eeca106725	437	#define __HAL_QSPI_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_QSPI_STATE_RESET)
Kojto	122:f9eeca106725	438
Kojto	122:f9eeca106725	439	/** @brief Enable the QSPI peripheral.
Kojto	122:f9eeca106725	440	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	441	* @retval None
Kojto	122:f9eeca106725	442	*/
Kojto	122:f9eeca106725	443	#define __HAL_QSPI_ENABLE(__HANDLE__) SET_BIT((__HANDLE__)->Instance->CR, QUADSPI_CR_EN)
Kojto	122:f9eeca106725	444
Kojto	122:f9eeca106725	445	/** @brief Disable the QSPI peripheral.
Kojto	122:f9eeca106725	446	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	447	* @retval None
Kojto	122:f9eeca106725	448	*/
Kojto	122:f9eeca106725	449	#define __HAL_QSPI_DISABLE(__HANDLE__) CLEAR_BIT((__HANDLE__)->Instance->CR, QUADSPI_CR_EN)
Kojto	122:f9eeca106725	450
Kojto	122:f9eeca106725	451	/** @brief Enable the specified QSPI interrupt.
Kojto	122:f9eeca106725	452	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	453	* @param __INTERRUPT__: specifies the QSPI interrupt source to enable.
Kojto	122:f9eeca106725	454	* This parameter can be one of the following values:
Kojto	122:f9eeca106725	455	* @arg QSPI_IT_TO: QSPI Timeout interrupt
Kojto	122:f9eeca106725	456	* @arg QSPI_IT_SM: QSPI Status match interrupt
Kojto	122:f9eeca106725	457	* @arg QSPI_IT_FT: QSPI FIFO threshold interrupt
Kojto	122:f9eeca106725	458	* @arg QSPI_IT_TC: QSPI Transfer complete interrupt
Kojto	122:f9eeca106725	459	* @arg QSPI_IT_TE: QSPI Transfer error interrupt
Kojto	122:f9eeca106725	460	* @retval None
Kojto	122:f9eeca106725	461	*/
Kojto	122:f9eeca106725	462	#define __HAL_QSPI_ENABLE_IT(__HANDLE__, __INTERRUPT__) SET_BIT((__HANDLE__)->Instance->CR, (__INTERRUPT__))
Kojto	122:f9eeca106725	463
Kojto	122:f9eeca106725	464
Kojto	122:f9eeca106725	465	/** @brief Disable the specified QSPI interrupt.
Kojto	122:f9eeca106725	466	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	467	* @param __INTERRUPT__: specifies the QSPI interrupt source to disable.
Kojto	122:f9eeca106725	468	* This parameter can be one of the following values:
Kojto	122:f9eeca106725	469	* @arg QSPI_IT_TO: QSPI Timeout interrupt
Kojto	122:f9eeca106725	470	* @arg QSPI_IT_SM: QSPI Status match interrupt
Kojto	122:f9eeca106725	471	* @arg QSPI_IT_FT: QSPI FIFO threshold interrupt
Kojto	122:f9eeca106725	472	* @arg QSPI_IT_TC: QSPI Transfer complete interrupt
Kojto	122:f9eeca106725	473	* @arg QSPI_IT_TE: QSPI Transfer error interrupt
Kojto	122:f9eeca106725	474	* @retval None
Kojto	122:f9eeca106725	475	*/
Kojto	122:f9eeca106725	476	#define __HAL_QSPI_DISABLE_IT(__HANDLE__, __INTERRUPT__) CLEAR_BIT((__HANDLE__)->Instance->CR, (__INTERRUPT__))
Kojto	122:f9eeca106725	477
Kojto	122:f9eeca106725	478	/** @brief Check whether the specified QSPI interrupt source is enabled or not.
Kojto	122:f9eeca106725	479	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	480	* @param __INTERRUPT__: specifies the QSPI interrupt source to check.
Kojto	122:f9eeca106725	481	* This parameter can be one of the following values:
Kojto	122:f9eeca106725	482	* @arg QSPI_IT_TO: QSPI Timeout interrupt
Kojto	122:f9eeca106725	483	* @arg QSPI_IT_SM: QSPI Status match interrupt
Kojto	122:f9eeca106725	484	* @arg QSPI_IT_FT: QSPI FIFO threshold interrupt
Kojto	122:f9eeca106725	485	* @arg QSPI_IT_TC: QSPI Transfer complete interrupt
Kojto	122:f9eeca106725	486	* @arg QSPI_IT_TE: QSPI Transfer error interrupt
Kojto	122:f9eeca106725	487	* @retval The new state of __INTERRUPT__ (TRUE or FALSE).
Kojto	122:f9eeca106725	488	*/
Kojto	122:f9eeca106725	489	#define __HAL_QSPI_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (READ_BIT((__HANDLE__)->Instance->CR, (__INTERRUPT__)) == (__INTERRUPT__))
Kojto	122:f9eeca106725	490
Kojto	122:f9eeca106725	491	/**
Kojto	122:f9eeca106725	492	* @brief Check whether the selected QSPI flag is set or not.
Kojto	122:f9eeca106725	493	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	494	* @param __FLAG__: specifies the QSPI flag to check.
Kojto	122:f9eeca106725	495	* This parameter can be one of the following values:
Kojto	122:f9eeca106725	496	* @arg QSPI_FLAG_BUSY: QSPI Busy flag
Kojto	122:f9eeca106725	497	* @arg QSPI_FLAG_TO: QSPI Timeout flag
Kojto	122:f9eeca106725	498	* @arg QSPI_FLAG_SM: QSPI Status match flag
Kojto	122:f9eeca106725	499	* @arg QSPI_FLAG_FT: QSPI FIFO threshold flag
Kojto	122:f9eeca106725	500	* @arg QSPI_FLAG_TC: QSPI Transfer complete flag
Kojto	122:f9eeca106725	501	* @arg QSPI_FLAG_TE: QSPI Transfer error flag
Kojto	122:f9eeca106725	502	* @retval None
Kojto	122:f9eeca106725	503	*/
Kojto	122:f9eeca106725	504	#define __HAL_QSPI_GET_FLAG(__HANDLE__, __FLAG__) (READ_BIT((__HANDLE__)->Instance->SR, (__FLAG__)) != 0)
Kojto	122:f9eeca106725	505
Kojto	122:f9eeca106725	506	/** @brief Clears the specified QSPI's flag status.
Kojto	122:f9eeca106725	507	* @param __HANDLE__: specifies the QSPI Handle.
Kojto	122:f9eeca106725	508	* @param __FLAG__: specifies the QSPI clear register flag that needs to be set
Kojto	122:f9eeca106725	509	* This parameter can be one of the following values:
Kojto	122:f9eeca106725	510	* @arg QSPI_FLAG_TO: QSPI Timeout flag
Kojto	122:f9eeca106725	511	* @arg QSPI_FLAG_SM: QSPI Status match flag
Kojto	122:f9eeca106725	512	* @arg QSPI_FLAG_TC: QSPI Transfer complete flag
Kojto	122:f9eeca106725	513	* @arg QSPI_FLAG_TE: QSPI Transfer error flag
Kojto	122:f9eeca106725	514	* @retval None
Kojto	122:f9eeca106725	515	*/
Kojto	122:f9eeca106725	516	#define __HAL_QSPI_CLEAR_FLAG(__HANDLE__, __FLAG__) WRITE_REG((__HANDLE__)->Instance->FCR, (__FLAG__))
Kojto	122:f9eeca106725	517	/**
Kojto	122:f9eeca106725	518	* @}
Kojto	122:f9eeca106725	519	*/
Kojto	122:f9eeca106725	520
Kojto	122:f9eeca106725	521	/* Exported functions --------------------------------------------------------*/
Kojto	122:f9eeca106725	522	/** @addtogroup QSPI_Exported_Functions
Kojto	122:f9eeca106725	523	* @{
Kojto	122:f9eeca106725	524	*/
Kojto	122:f9eeca106725	525	/* Initialization/de-initialization functions ********************************/
Kojto	122:f9eeca106725	526	HAL_StatusTypeDef HAL_QSPI_Init (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	527	HAL_StatusTypeDef HAL_QSPI_DeInit (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	528	void HAL_QSPI_MspInit (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	529	void HAL_QSPI_MspDeInit(QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	530
Kojto	122:f9eeca106725	531	/* IO operation functions *****************************************************/
Kojto	122:f9eeca106725	532	/* QSPI IRQ handler method */
Kojto	122:f9eeca106725	533	void HAL_QSPI_IRQHandler(QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	534
Kojto	122:f9eeca106725	535	/* QSPI indirect mode */
Kojto	122:f9eeca106725	536	HAL_StatusTypeDef HAL_QSPI_Command (QSPI_HandleTypeDef hqspi, QSPI_CommandTypeDef cmd, uint32_t Timeout);
Kojto	122:f9eeca106725	537	HAL_StatusTypeDef HAL_QSPI_Transmit (QSPI_HandleTypeDef hqspi, uint8_t pData, uint32_t Timeout);
Kojto	122:f9eeca106725	538	HAL_StatusTypeDef HAL_QSPI_Receive (QSPI_HandleTypeDef hqspi, uint8_t pData, uint32_t Timeout);
Kojto	122:f9eeca106725	539	HAL_StatusTypeDef HAL_QSPI_Command_IT (QSPI_HandleTypeDef hqspi, QSPI_CommandTypeDef cmd);
Kojto	122:f9eeca106725	540	HAL_StatusTypeDef HAL_QSPI_Transmit_IT (QSPI_HandleTypeDef hqspi, uint8_t pData);
Kojto	122:f9eeca106725	541	HAL_StatusTypeDef HAL_QSPI_Receive_IT (QSPI_HandleTypeDef hqspi, uint8_t pData);
Kojto	122:f9eeca106725	542	HAL_StatusTypeDef HAL_QSPI_Transmit_DMA (QSPI_HandleTypeDef hqspi, uint8_t pData);
Kojto	122:f9eeca106725	543	HAL_StatusTypeDef HAL_QSPI_Receive_DMA (QSPI_HandleTypeDef hqspi, uint8_t pData);
Kojto	122:f9eeca106725	544
Kojto	122:f9eeca106725	545	/* QSPI status flag polling mode */
Kojto	122:f9eeca106725	546	HAL_StatusTypeDef HAL_QSPI_AutoPolling (QSPI_HandleTypeDef hqspi, QSPI_CommandTypeDef cmd, QSPI_AutoPollingTypeDef *cfg, uint32_t Timeout);
Kojto	122:f9eeca106725	547	HAL_StatusTypeDef HAL_QSPI_AutoPolling_IT(QSPI_HandleTypeDef hqspi, QSPI_CommandTypeDef cmd, QSPI_AutoPollingTypeDef *cfg);
Kojto	122:f9eeca106725	548
Kojto	122:f9eeca106725	549	/* QSPI memory-mapped mode */
Kojto	122:f9eeca106725	550	HAL_StatusTypeDef HAL_QSPI_MemoryMapped(QSPI_HandleTypeDef hqspi, QSPI_CommandTypeDef cmd, QSPI_MemoryMappedTypeDef *cfg);
Kojto	122:f9eeca106725	551
Kojto	122:f9eeca106725	552	/* Callback functions in non-blocking modes ***********************************/
Kojto	122:f9eeca106725	553	void HAL_QSPI_ErrorCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	554	void HAL_QSPI_AbortCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	555	void HAL_QSPI_FifoThresholdCallback(QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	556
Kojto	122:f9eeca106725	557	/* QSPI indirect mode */
Kojto	122:f9eeca106725	558	void HAL_QSPI_CmdCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	559	void HAL_QSPI_RxCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	560	void HAL_QSPI_TxCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	561	void HAL_QSPI_RxHalfCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	562	void HAL_QSPI_TxHalfCpltCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	563
Kojto	122:f9eeca106725	564	/* QSPI status flag polling mode */
Kojto	122:f9eeca106725	565	void HAL_QSPI_StatusMatchCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	566
Kojto	122:f9eeca106725	567	/* QSPI memory-mapped mode */
Kojto	122:f9eeca106725	568	void HAL_QSPI_TimeOutCallback (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	569
Kojto	122:f9eeca106725	570	/* Peripheral Control and State functions ************************************/
Kojto	122:f9eeca106725	571	HAL_QSPI_StateTypeDef HAL_QSPI_GetState (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	572	uint32_t HAL_QSPI_GetError (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	573	HAL_StatusTypeDef HAL_QSPI_Abort (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	574	HAL_StatusTypeDef HAL_QSPI_Abort_IT (QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	575	void HAL_QSPI_SetTimeout (QSPI_HandleTypeDef *hqspi, uint32_t Timeout);
Kojto	122:f9eeca106725	576	HAL_StatusTypeDef HAL_QSPI_SetFifoThreshold(QSPI_HandleTypeDef *hqspi, uint32_t Threshold);
Kojto	122:f9eeca106725	577	uint32_t HAL_QSPI_GetFifoThreshold(QSPI_HandleTypeDef *hqspi);
Kojto	122:f9eeca106725	578	/**
Kojto	122:f9eeca106725	579	* @}
Kojto	122:f9eeca106725	580	*/
Kojto	122:f9eeca106725	581	/* End of exported functions -------------------------------------------------*/
Kojto	122:f9eeca106725	582
Kojto	122:f9eeca106725	583	/* Private macros ------------------------------------------------------------*/
Kojto	122:f9eeca106725	584	/** @defgroup QSPI_Private_Macros QSPI Private Macros
Kojto	122:f9eeca106725	585	* @{
Kojto	122:f9eeca106725	586	*/
Kojto	122:f9eeca106725	587	#define IS_QSPI_CLOCK_PRESCALER(PRESCALER) ((PRESCALER) <= 0xFF)
Kojto	122:f9eeca106725	588
Kojto	122:f9eeca106725	589	#define IS_QSPI_FIFO_THRESHOLD(THR) (((THR) > 0) && ((THR) <= 16))
Kojto	122:f9eeca106725	590
Kojto	122:f9eeca106725	591	#define IS_QSPI_SSHIFT(SSHIFT) (((SSHIFT) == QSPI_SAMPLE_SHIFTING_NONE) \|\| \
Kojto	122:f9eeca106725	592	((SSHIFT) == QSPI_SAMPLE_SHIFTING_HALFCYCLE))
Kojto	122:f9eeca106725	593
Kojto	122:f9eeca106725	594	#define IS_QSPI_FLASH_SIZE(FSIZE) (((FSIZE) <= 31))
Kojto	122:f9eeca106725	595
Kojto	122:f9eeca106725	596	#define IS_QSPI_CS_HIGH_TIME(CSHTIME) (((CSHTIME) == QSPI_CS_HIGH_TIME_1_CYCLE) \|\| \
Kojto	122:f9eeca106725	597	((CSHTIME) == QSPI_CS_HIGH_TIME_2_CYCLE) \|\| \
Kojto	122:f9eeca106725	598	((CSHTIME) == QSPI_CS_HIGH_TIME_3_CYCLE) \|\| \
Kojto	122:f9eeca106725	599	((CSHTIME) == QSPI_CS_HIGH_TIME_4_CYCLE) \|\| \
Kojto	122:f9eeca106725	600	((CSHTIME) == QSPI_CS_HIGH_TIME_5_CYCLE) \|\| \
Kojto	122:f9eeca106725	601	((CSHTIME) == QSPI_CS_HIGH_TIME_6_CYCLE) \|\| \
Kojto	122:f9eeca106725	602	((CSHTIME) == QSPI_CS_HIGH_TIME_7_CYCLE) \|\| \
Kojto	122:f9eeca106725	603	((CSHTIME) == QSPI_CS_HIGH_TIME_8_CYCLE))
Kojto	122:f9eeca106725	604
Kojto	122:f9eeca106725	605	#define IS_QSPI_CLOCK_MODE(CLKMODE) (((CLKMODE) == QSPI_CLOCK_MODE_0) \|\| \
Kojto	122:f9eeca106725	606	((CLKMODE) == QSPI_CLOCK_MODE_3))
Kojto	122:f9eeca106725	607
Kojto	122:f9eeca106725	608	#if defined(STM32L431xx) \|\| defined(STM32L432xx) \|\| defined(STM32L433xx) \|\| defined(STM32L442xx) \|\| defined(STM32L443xx)
Kojto	122:f9eeca106725	609	#define IS_QSPI_FLASH_ID(FLASH) (((FLASH) == QSPI_FLASH_ID_1) \|\| \
Kojto	122:f9eeca106725	610	((FLASH) == QSPI_FLASH_ID_2))
Kojto	122:f9eeca106725	611
Kojto	122:f9eeca106725	612	#define IS_QSPI_DUAL_FLASH_MODE(MODE) (((MODE) == QSPI_DUALFLASH_ENABLE) \|\| \
Kojto	122:f9eeca106725	613	((MODE) == QSPI_DUALFLASH_DISABLE))
Kojto	122:f9eeca106725	614	#endif
Kojto	122:f9eeca106725	615
Kojto	122:f9eeca106725	616	#define IS_QSPI_INSTRUCTION(INSTRUCTION) ((INSTRUCTION) <= 0xFF)
Kojto	122:f9eeca106725	617
Kojto	122:f9eeca106725	618	#define IS_QSPI_ADDRESS_SIZE(ADDR_SIZE) (((ADDR_SIZE) == QSPI_ADDRESS_8_BITS) \|\| \
Kojto	122:f9eeca106725	619	((ADDR_SIZE) == QSPI_ADDRESS_16_BITS) \|\| \
Kojto	122:f9eeca106725	620	((ADDR_SIZE) == QSPI_ADDRESS_24_BITS) \|\| \
Kojto	122:f9eeca106725	621	((ADDR_SIZE) == QSPI_ADDRESS_32_BITS))
Kojto	122:f9eeca106725	622
Kojto	122:f9eeca106725	623	#define IS_QSPI_ALTERNATE_BYTES_SIZE(SIZE) (((SIZE) == QSPI_ALTERNATE_BYTES_8_BITS) \|\| \
Kojto	122:f9eeca106725	624	((SIZE) == QSPI_ALTERNATE_BYTES_16_BITS) \|\| \
Kojto	122:f9eeca106725	625	((SIZE) == QSPI_ALTERNATE_BYTES_24_BITS) \|\| \
Kojto	122:f9eeca106725	626	((SIZE) == QSPI_ALTERNATE_BYTES_32_BITS))
Kojto	122:f9eeca106725	627
Kojto	122:f9eeca106725	628	#define IS_QSPI_DUMMY_CYCLES(DCY) ((DCY) <= 31)
Kojto	122:f9eeca106725	629
Kojto	122:f9eeca106725	630	#define IS_QSPI_INSTRUCTION_MODE(MODE) (((MODE) == QSPI_INSTRUCTION_NONE) \|\| \
Kojto	122:f9eeca106725	631	((MODE) == QSPI_INSTRUCTION_1_LINE) \|\| \
Kojto	122:f9eeca106725	632	((MODE) == QSPI_INSTRUCTION_2_LINES) \|\| \
Kojto	122:f9eeca106725	633	((MODE) == QSPI_INSTRUCTION_4_LINES))
Kojto	122:f9eeca106725	634
Kojto	122:f9eeca106725	635	#define IS_QSPI_ADDRESS_MODE(MODE) (((MODE) == QSPI_ADDRESS_NONE) \|\| \
Kojto	122:f9eeca106725	636	((MODE) == QSPI_ADDRESS_1_LINE) \|\| \
Kojto	122:f9eeca106725	637	((MODE) == QSPI_ADDRESS_2_LINES) \|\| \
Kojto	122:f9eeca106725	638	((MODE) == QSPI_ADDRESS_4_LINES))
Kojto	122:f9eeca106725	639
Kojto	122:f9eeca106725	640	#define IS_QSPI_ALTERNATE_BYTES_MODE(MODE) (((MODE) == QSPI_ALTERNATE_BYTES_NONE) \|\| \
Kojto	122:f9eeca106725	641	((MODE) == QSPI_ALTERNATE_BYTES_1_LINE) \|\| \
Kojto	122:f9eeca106725	642	((MODE) == QSPI_ALTERNATE_BYTES_2_LINES) \|\| \
Kojto	122:f9eeca106725	643	((MODE) == QSPI_ALTERNATE_BYTES_4_LINES))
Kojto	122:f9eeca106725	644
Kojto	122:f9eeca106725	645	#define IS_QSPI_DATA_MODE(MODE) (((MODE) == QSPI_DATA_NONE) \|\| \
Kojto	122:f9eeca106725	646	((MODE) == QSPI_DATA_1_LINE) \|\| \
Kojto	122:f9eeca106725	647	((MODE) == QSPI_DATA_2_LINES) \|\| \
Kojto	122:f9eeca106725	648	((MODE) == QSPI_DATA_4_LINES))
Kojto	122:f9eeca106725	649
Kojto	122:f9eeca106725	650	#define IS_QSPI_DDR_MODE(DDR_MODE) (((DDR_MODE) == QSPI_DDR_MODE_DISABLE) \|\| \
Kojto	122:f9eeca106725	651	((DDR_MODE) == QSPI_DDR_MODE_ENABLE))
Kojto	122:f9eeca106725	652
Kojto	122:f9eeca106725	653	#if defined(STM32L431xx) \|\| defined(STM32L432xx) \|\| defined(STM32L433xx) \|\| defined(STM32L442xx) \|\| defined(STM32L443xx)
Kojto	122:f9eeca106725	654	#define IS_QSPI_DDR_HHC(DDR_HHC) (((DDR_HHC) == QSPI_DDR_HHC_ANALOG_DELAY) \|\| \
Kojto	122:f9eeca106725	655	((DDR_HHC) == QSPI_DDR_HHC_HALF_CLK_DELAY))
Kojto	122:f9eeca106725	656	#else
Kojto	122:f9eeca106725	657	#define IS_QSPI_DDR_HHC(DDR_HHC) (((DDR_HHC) == QSPI_DDR_HHC_ANALOG_DELAY))
Kojto	122:f9eeca106725	658	#endif
Kojto	122:f9eeca106725	659
Kojto	122:f9eeca106725	660	#define IS_QSPI_SIOO_MODE(SIOO_MODE) (((SIOO_MODE) == QSPI_SIOO_INST_EVERY_CMD) \|\| \
Kojto	122:f9eeca106725	661	((SIOO_MODE) == QSPI_SIOO_INST_ONLY_FIRST_CMD))
Kojto	122:f9eeca106725	662
Kojto	122:f9eeca106725	663	#define IS_QSPI_INTERVAL(INTERVAL) ((INTERVAL) <= QUADSPI_PIR_INTERVAL)
Kojto	122:f9eeca106725	664
Kojto	122:f9eeca106725	665	#define IS_QSPI_STATUS_BYTES_SIZE(SIZE) (((SIZE) >= 1) && ((SIZE) <= 4))
Kojto	122:f9eeca106725	666
Kojto	122:f9eeca106725	667	#define IS_QSPI_MATCH_MODE(MODE) (((MODE) == QSPI_MATCH_MODE_AND) \|\| \
Kojto	122:f9eeca106725	668	((MODE) == QSPI_MATCH_MODE_OR))
Kojto	122:f9eeca106725	669
Kojto	122:f9eeca106725	670	#define IS_QSPI_AUTOMATIC_STOP(APMS) (((APMS) == QSPI_AUTOMATIC_STOP_DISABLE) \|\| \
Kojto	122:f9eeca106725	671	((APMS) == QSPI_AUTOMATIC_STOP_ENABLE))
Kojto	122:f9eeca106725	672
Kojto	122:f9eeca106725	673	#define IS_QSPI_TIMEOUT_ACTIVATION(TCEN) (((TCEN) == QSPI_TIMEOUT_COUNTER_DISABLE) \|\| \
Kojto	122:f9eeca106725	674	((TCEN) == QSPI_TIMEOUT_COUNTER_ENABLE))
Kojto	122:f9eeca106725	675
Kojto	122:f9eeca106725	676	#define IS_QSPI_TIMEOUT_PERIOD(PERIOD) ((PERIOD) <= 0xFFFF)
Kojto	122:f9eeca106725	677	/**
Kojto	122:f9eeca106725	678	* @}
Kojto	122:f9eeca106725	679	*/
Kojto	122:f9eeca106725	680	/* End of private macros -----------------------------------------------------*/
Kojto	122:f9eeca106725	681
Kojto	122:f9eeca106725	682	/**
Kojto	122:f9eeca106725	683	* @}
Kojto	122:f9eeca106725	684	*/
Kojto	122:f9eeca106725	685
Kojto	122:f9eeca106725	686	/**
Kojto	122:f9eeca106725	687	* @}
Kojto	122:f9eeca106725	688	*/
Kojto	122:f9eeca106725	689
Kojto	122:f9eeca106725	690	#ifdef __cplusplus
Kojto	122:f9eeca106725	691	}
Kojto	122:f9eeca106725	692	#endif
Kojto	122:f9eeca106725	693
Kojto	122:f9eeca106725	694	#endif /* __STM32L4xx_HAL_QSPI_H */
Kojto	122:f9eeca106725	695
Kojto	122:f9eeca106725	696	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/