hal_xsnor_micron_n25q.h

Go to the documentation of this file.

/*
    ChibiOS - Copyright (C) 2006..2025 Giovanni Di Sirio
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
*/
 
/**
 * @file        hal_xsnor_micron_n25q.h
 * @brief       Generated SNOR Micron N25Q header.
 * @note        This is a generated file, do not edit directly.
 *
 * @addtogroup  HAL_XSNOR_MICRON_N25Q
 * @brief       SNOR Micron N25Q driver.
 * @details     Module for SNOR Micron N25Q flash devices.
 * @{
 */
 
#ifndef HAL_XSNOR_MICRON_N25Q_H
#define HAL_XSNOR_MICRON_N25Q_H
 
#include "oop_base_object.h"
#include "hal_xsnor_base.h"
 
/*===========================================================================*/
/* Module constants.                                                         */
/*===========================================================================*/
 
/*===========================================================================*/
/* Module pre-compile time settings.                                         */
/*===========================================================================*/
 
/*===========================================================================*/
/* Derived constants and error checks.                                       */
/*===========================================================================*/
 
/**
 * @name    Device options
 * @{
 */
/**
 * @brief       Mask of the dummy cycles field.
 */
#define N25Q_OPT_DUMMY_CYCLES_MASK          (15U << 0)
 
/**
 * @brief       Number of dummy cycles.
 *
 * @param         n             Number of dummy cycles (2..15)
 */
#define N25Q_OPT_DUMMY_CYCLES(n)            ((n) << 0)
 
/**
 * @brief       Switch bus width on initialization.
 * @details     If @p N25Q_OPT_NO_WIDTH_SWITCH is specified then this is the
 *              bus mode that the device is expected to be using else this is
 *              the bus mode that the device will be switched in.
 * @note        This option is only valid in WSPI bus mode.
 */
#define N25Q_OPT_NO_WIDTH_SWITCH            (1U << 4)
 
/**
 * @brief       Use 4kB sub-sectors rather than 64kB sectors.
 */
#define N25Q_OPT_USE_SUBSECTORS             (1U << 5)
 
/**
 * @brief       Delays insertion.
 * @details     If enabled this options inserts delays into the flash waiting
 *              routines releasing some extra CPU time for threads with lower
 *              priority, this may slow down the driver a bit however.
 */
#define N25Q_OPT_NICE_WAITING               (1U << 6)
/** @} */
 
/*===========================================================================*/
/* Module macros.                                                            */
/*===========================================================================*/
 
/*===========================================================================*/
/* Module data structures and types.                                         */
/*===========================================================================*/
 
/**
 * @class       hal_xsnor_micron_n25q_c
 * @extends     hal_xsnor_base_c
 *
 *
 * @name        Class @p hal_xsnor_micron_n25q_c structures
 * @{
 */
 
/**
 * @brief       Type of a SNOR Micron N25Q driver class.
 */
typedef struct hal_xsnor_micron_n25q hal_xsnor_micron_n25q_c;
 
/**
 * @brief       Class @p hal_xsnor_micron_n25q_c virtual methods table.
 */
struct hal_xsnor_micron_n25q_vmt {
  /* From base_object_c.*/
  void (*dispose)(void *ip);
  /* From hal_xsnor_base_c.*/
  flash_error_t (*init)(void *ip);
  flash_error_t (*read)(void *ip, flash_offset_t offset, size_t n, uint8_t *rp);
  flash_error_t (*program)(void *ip, flash_offset_t offset, size_t n, const uint8_t *pp);
  flash_error_t (*start_erase_all)(void *ip);
  flash_error_t (*start_erase_sector)(void *ip, flash_sector_t sector);
  flash_error_t (*query_erase)(void *ip, unsigned *msec);
  flash_error_t (*verify_erase)(void *ip, flash_sector_t sector);
  flash_error_t (*mmap_on)(void *ip, uint8_t **addrp);
  void (*mmap_off)(void *ip);
  /* From hal_xsnor_micron_n25q_c.*/
};
 
/**
 * @brief       Structure representing a SNOR Micron N25Q driver class.
 */
struct hal_xsnor_micron_n25q {
  /**
   * @brief       Virtual Methods Table.
   */
  const struct hal_xsnor_micron_n25q_vmt *vmt;
  /**
   * @brief       Implemented interface @p flash_interface_i.
   */
  flash_interface_i         fls;
  /**
   * @brief       Driver state.
   */
  flash_state_t             state;
  /**
   * @brief       Driver configuration.
   */
  const xsnor_config_t      *config;
#if (XSNOR_USE_WSPI == TRUE) || defined (__DOXYGEN__)
  /**
   * @brief       Current commands configuration.
   * @note        This field is meant to be initialized by subclasses on object
   *              creation.
   */
  const xsnor_commands_t    *commands;
#endif /* XSNOR_USE_WSPI == TRUE */
  /**
   * @brief       Flash access mutex.
   */
  mutex_t                   mutex;
  /**
   * @brief       Flash descriptor.
   * @note        This field is meant to be initialized by subclasses on memory
   *              initialization.
   */
  flash_descriptor_t        descriptor;
};
/** @} */
 
/*===========================================================================*/
/* External declarations.                                                    */
/*===========================================================================*/
 
#ifdef __cplusplus
extern "C" {
#endif
  /* Methods of hal_xsnor_micron_n25q_c.*/
  void *__n25q_objinit_impl(void *ip, const void *vmt);
  void __n25q_dispose_impl(void *ip);
  flash_error_t __n25q_init_impl(void *ip);
  flash_error_t __n25q_read_impl(void *ip, flash_offset_t offset, size_t n,
                                 uint8_t *rp);
  flash_error_t __n25q_program_impl(void *ip, flash_offset_t offset, size_t n,
                                    const uint8_t *pp);
  flash_error_t __n25q_start_erase_all_impl(void *ip);
  flash_error_t __n25q_start_erase_sector_impl(void *ip, flash_sector_t sector);
  flash_error_t __n25q_query_erase_impl(void *ip, unsigned *msec);
  flash_error_t __n25q_verify_erase_impl(void *ip, flash_sector_t sector);
  flash_error_t __n25q_mmap_on_impl(void *ip, uint8_t **addrp);
  void __n25q_mmap_off_impl(void *ip);
  /* Regular functions.*/
#ifdef __cplusplus
}
#endif
 
/*===========================================================================*/
/* Module inline functions.                                                  */
/*===========================================================================*/
 
/**
 * @name        Default constructor of hal_xsnor_micron_n25q_c
 * @{
 */
/**
 * @brief       Default initialization function of @p hal_xsnor_micron_n25q_c.
 *
 * @param[out]    self          Pointer to a @p hal_xsnor_micron_n25q_c
 *                              instance to be initialized.
 * @return                      Pointer to the initialized object.
 *
 * @objinit
 */
CC_FORCE_INLINE
static inline hal_xsnor_micron_n25q_c *n25qObjectInit(hal_xsnor_micron_n25q_c *self) {
  extern const struct hal_xsnor_micron_n25q_vmt __hal_xsnor_micron_n25q_vmt;
 
  return __n25q_objinit_impl(self, &__hal_xsnor_micron_n25q_vmt);
}
/** @} */
 
#endif /* HAL_XSNOR_MICRON_N25Q_H */
 
/** @} */