what does the status codes mean, how do you read them ?

[MNapi]

here are the functions:

/**
* @brief Return the OSPI error code.
* @PAram hospi : OSPI handle
* @retval OSPI Error Code
*/
uint32_t HAL_OSPI_GetError(const OSPI_HandleTypeDef *hospi)
{
return hospi->ErrorCode;
}

/**
* @brief Return the OSPI handle state.
* @PAram hospi : OSPI handle
* @retval HAL state
*/
uint32_t HAL_OSPI_GetState(const OSPI_HandleTypeDef *hospi)
{
/* Return OSPI handle state */
return hospi->State;
}

 

I am reading

state = 2

error = 0

nowhere to find what those numbers mean.

[mƎALLEm]

Hello,

Defined in stm32h7xx_hal_ospi.h header file: 

ErrorCode:

 

#define HAL_OSPI_ERROR_NONE ((uint32_t)0x00000000U) /*!< No error */
#define HAL_OSPI_ERROR_TIMEOUT ((uint32_t)0x00000001U) /*!< Timeout error */
#define HAL_OSPI_ERROR_TRANSFER ((uint32_t)0x00000002U) /*!< Transfer error */
#define HAL_OSPI_ERROR_DMA ((uint32_t)0x00000004U) /*!< DMA transfer error */
#define HAL_OSPI_ERROR_INVALID_PARAM ((uint32_t)0x00000008U) /*!< Invalid parameters error */
#define HAL_OSPI_ERROR_INVALID_SEQUENCE ((uint32_t)0x00000010U) /*!< Sequence of the state machine is incorrect */

 

State:

 

#define HAL_OSPI_STATE_RESET ((uint32_t)0x00000000U) /*!< Initial state */
#define HAL_OSPI_STATE_HYPERBUS_INIT ((uint32_t)0x00000001U) /*!< Initialization done in hyperbus mode but timing configuration not done */
#define HAL_OSPI_STATE_READY ((uint32_t)0x00000002U) /*!< Driver ready to be used */
#define HAL_OSPI_STATE_CMD_CFG ((uint32_t)0x00000004U) /*!< Command (regular or hyperbus) configured, ready for an action */
#define HAL_OSPI_STATE_READ_CMD_CFG ((uint32_t)0x00000014U) /*!< Read command configuration done, not the write command configuration */
#define HAL_OSPI_STATE_WRITE_CMD_CFG ((uint32_t)0x00000024U) /*!< Write command configuration done, not the read command configuration */
#define HAL_OSPI_STATE_BUSY_CMD ((uint32_t)0x00000008U) /*!< Command without data on-going */
#define HAL_OSPI_STATE_BUSY_TX ((uint32_t)0x00000018U) /*!< Indirect Tx on-going */
#define HAL_OSPI_STATE_BUSY_RX ((uint32_t)0x00000028U) /*!< Indirect Rx on-going */
#define HAL_OSPI_STATE_BUSY_AUTO_POLLING ((uint32_t)0x00000048U) /*!< Auto-polling on-going */
#define HAL_OSPI_STATE_BUSY_MEM_MAPPED ((uint32_t)0x00000088U) /*!< Memory-mapped on-going */
#define HAL_OSPI_STATE_ABORT ((uint32_t)0x00000100U) /*!< Abort on-going */
#define HAL_OSPI_STATE_ERROR ((uint32_t)0x00000200U) /*!< Blocking error, driver should be re-initialized */

 

 

 

[Andrew Neil]

This really ought to be stated in the function header comment; eg,

/**
* @brief Return the OSPI error code.
* @PAram hospi : OSPI handle
* @retval OSPI Error Code - one of the HAL_OSPI_ERROR_... values 
*/

 

Similarly:

/**
* @brief Return the OSPI handle state.
* @PAram hospi : OSPI handle
* @retval HAL state - one of the HAL_OSPI_STATE_... values
*/

 

Or, why not make them enums ?