/* mbed Microcontroller Library * Copyright (c) 2017, ARM Limited * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * 3. Neither the name of STMicroelectronics nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #if DEVICE_QSPI #include "qspi_api.h" #include "mbed_error.h" #include "cmsis.h" #include "pinmap.h" #include "PeripheralPins.h" #define QSPI_FLASH_SIZE_DEFAULT 32 void qspi_prepare_command(const qspi_command_t *command, QSPI_CommandTypeDef *st_command) { // TODO: shift these around to get more dynamic mapping switch (command->instruction.bus_width) { case QSPI_CFG_BUS_SINGLE: st_command->InstructionMode = QSPI_INSTRUCTION_1_LINE; break; case QSPI_CFG_BUS_DUAL: st_command->InstructionMode = QSPI_INSTRUCTION_2_LINES; break; case QSPI_CFG_BUS_QUAD: st_command->InstructionMode = QSPI_INSTRUCTION_4_LINES; break; default: st_command->InstructionMode = QSPI_INSTRUCTION_NONE; break; } st_command->Instruction = command->instruction.value; st_command->DummyCycles = command->dummy_count, // these are target specific settings, use default values st_command->SIOOMode = QSPI_SIOO_INST_EVERY_CMD; st_command->DdrMode = QSPI_DDR_MODE_DISABLE; st_command->DdrHoldHalfCycle = QSPI_DDR_HHC_ANALOG_DELAY; switch (command->address.bus_width) { case QSPI_CFG_BUS_SINGLE: st_command->AddressMode = QSPI_ADDRESS_1_LINE; break; case QSPI_CFG_BUS_DUAL: st_command->AddressMode = QSPI_ADDRESS_2_LINES; break; case QSPI_CFG_BUS_QUAD: st_command->AddressMode = QSPI_ADDRESS_4_LINES; break; default: st_command->AddressMode = QSPI_ADDRESS_NONE; break; } if (command->address.disabled == true) { st_command->AddressMode = QSPI_ADDRESS_NONE; } switch (command->alt.bus_width) { case QSPI_CFG_BUS_SINGLE: st_command->AlternateByteMode = QSPI_ALTERNATE_BYTES_1_LINE; break; case QSPI_CFG_BUS_DUAL: st_command->AlternateByteMode = QSPI_ALTERNATE_BYTES_2_LINES; break; case QSPI_CFG_BUS_QUAD: st_command->AlternateByteMode = QSPI_ALTERNATE_BYTES_4_LINES; break; default: st_command->AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; break; } if (command->alt.disabled == true) { st_command->AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; } switch (command->data.bus_width) { case QSPI_CFG_BUS_SINGLE: st_command->DataMode = QSPI_DATA_1_LINE; break; case QSPI_CFG_BUS_DUAL: st_command->DataMode = QSPI_DATA_2_LINES; break; case QSPI_CFG_BUS_QUAD: st_command->DataMode = QSPI_DATA_4_LINES; break; default: st_command->DataMode = QSPI_DATA_NONE; break; } } qspi_status_t qspi_init(qspi_t *obj, PinName io0, PinName io1, PinName io2, PinName io3, PinName sclk, PinName ssel, uint32_t hz, uint8_t mode) { // Enable interface clock for QSPI __HAL_RCC_QSPI_CLK_ENABLE(); // Reset QSPI __HAL_RCC_QSPI_FORCE_RESET(); __HAL_RCC_QSPI_RELEASE_RESET(); // Set default QSPI handle values obj->handle.Init.ClockPrescaler = 1; obj->handle.Init.FifoThreshold = 4; obj->handle.Init.SampleShifting = QSPI_SAMPLE_SHIFTING_HALFCYCLE; obj->handle.Init.FlashSize = POSITION_VAL(QSPI_FLASH_SIZE_DEFAULT) - 1; obj->handle.Init.ChipSelectHighTime = QSPI_CS_HIGH_TIME_2_CYCLE; obj->handle.Init.ClockMode = QSPI_CLOCK_MODE_0; obj->handle.Init.FlashID = QSPI_FLASH_ID_1; obj->handle.Init.DualFlash = QSPI_DUALFLASH_DISABLE; obj->handle.Init.ClockMode = mode == 0 ? QSPI_CLOCK_MODE_0 : QSPI_CLOCK_MODE_3; QSPIName qspiio0name = (QSPIName)pinmap_peripheral(io0, PinMap_QSPI_DATA); QSPIName qspiio1name = (QSPIName)pinmap_peripheral(io1, PinMap_QSPI_DATA); QSPIName qspiio2name = (QSPIName)pinmap_peripheral(io2, PinMap_QSPI_DATA); QSPIName qspiio3name = (QSPIName)pinmap_peripheral(io3, PinMap_QSPI_DATA); QSPIName qspiclkname = (QSPIName)pinmap_peripheral(sclk, PinMap_QSPI_SCLK); QSPIName qspisselname = (QSPIName)pinmap_peripheral(ssel, PinMap_QSPI_SSEL); QSPIName qspi_data_first = (QSPIName)pinmap_merge(qspiio0name, qspiio1name); QSPIName qspi_data_second = (QSPIName)pinmap_merge(qspiio2name, qspiio3name); QSPIName qspi_data_third = (QSPIName)pinmap_merge(qspiclkname, qspisselname); if (qspi_data_first != qspi_data_second || qspi_data_second != qspi_data_third || qspi_data_first != qspi_data_third) { return QSPI_STATUS_INVALID_PARAMETER; } // tested all combinations, take first obj->handle.Instance = (QUADSPI_TypeDef *)qspi_data_first; // TODO pinmap here for pins (enable clock) pinmap_pinout(io0, PinMap_QSPI_DATA); pinmap_pinout(io1, PinMap_QSPI_DATA); pinmap_pinout(io2, PinMap_QSPI_DATA); pinmap_pinout(io3, PinMap_QSPI_DATA); pinmap_pinout(sclk, PinMap_QSPI_SCLK); pinmap_pinout(ssel, PinMap_QSPI_SSEL); if (HAL_QSPI_Init(&obj->handle) != HAL_OK) { return QSPI_STATUS_ERROR; } qspi_frequency(obj, hz); return QSPI_STATUS_OK; } qspi_status_t qspi_free(qspi_t *obj) { // TODO return QSPI_STATUS_ERROR; } qspi_status_t qspi_frequency(qspi_t *obj, int hz) { qspi_status_t status = QSPI_STATUS_OK; // HCLK drives QSPI int div = HAL_RCC_GetHCLKFreq() / hz; if (div > 256 || div < 1) { status = QSPI_STATUS_INVALID_PARAMETER; return status; } obj->handle.Init.ClockPrescaler = div - 1; if (HAL_QSPI_Init(&obj->handle) != HAL_OK) { status = QSPI_STATUS_ERROR; } return status; } qspi_status_t qspi_write(qspi_t *obj, const qspi_command_t *command, const void *data, size_t *length) { QSPI_CommandTypeDef st_command; qspi_prepare_command(command, &st_command); st_command.NbData = *length; qspi_status_t status = QSPI_STATUS_OK; if (HAL_QSPI_Command(&obj->handle, &st_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { status = QSPI_STATUS_ERROR; return status; } if (HAL_QSPI_Transmit(&obj->handle, (uint8_t *)data, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { status = QSPI_STATUS_ERROR; } return status; } qspi_status_t qspi_read(qspi_t *obj, const qspi_command_t *command, void *data, size_t *length) { QSPI_CommandTypeDef st_command; qspi_prepare_command(command, &st_command); st_command.NbData = *length; qspi_status_t status = QSPI_STATUS_OK; if (HAL_QSPI_Command(&obj->handle, &st_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { status = QSPI_STATUS_ERROR; return status; } if (HAL_QSPI_Receive(&obj->handle, data, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { status = QSPI_STATUS_ERROR; } return status; } qspi_status_t qspi_command_transfer(qspi_t *obj, const qspi_command_t *command, const void *tx_data, size_t tx_size, void *rx_data, size_t rx_size) { qspi_status_t status = QSPI_STATUS_OK; if (rx_size > 4) { return QSPI_STATUS_INVALID_PARAMETER; } QSPI_CommandTypeDef st_command; qspi_prepare_command(command, &st_command); QSPI_AutoPollingTypeDef s_config; s_config.Match = 0; s_config.Mask = 0; s_config.MatchMode = QSPI_MATCH_MODE_OR; s_config.StatusBytesSize = rx_size; s_config.Interval = 0x10; s_config.AutomaticStop = QSPI_AUTOMATIC_STOP_ENABLE; // or QSPI_AUTOMATIC_STOP_DISABLE ? if (HAL_QSPI_AutoPolling(&obj->handle, &st_command, &s_config, HAL_QPSI_TIMEOUT_DEFAULT_VALUE) != HAL_OK) { status = QSPI_STATUS_ERROR; } return status; } #endif /** @}*/