18#ifndef __VSF_TEMPLATE_FLASH_H__
19#define __VSF_TEMPLATE_FLASH_H__
40#ifndef VSF_FLASH_CFG_MULTI_CLASS
41# define VSF_FLASH_CFG_MULTI_CLASS ENABLED
51#if defined(VSF_HW_FLASH_COUNT) && !defined(VSF_HW_FLASH_MASK)
52# define VSF_HW_FLASH_MASK VSF_HAL_COUNT_TO_MASK(VSF_HW_FLASH_COUNT)
62#if defined(VSF_HW_FLASH_MASK) && !defined(VSF_HW_FLASH_COUNT)
63# define VSF_HW_FLASH_COUNT VSF_HAL_MASK_TO_COUNT(VSF_HW_FLASH_MASK)
75#ifndef VSF_FLASH_CFG_PREFIX
76# if VSF_FLASH_CFG_MULTI_CLASS == ENABLED
77# define VSF_FLASH_CFG_PREFIX vsf
78# elif defined(VSF_HW_FLASH_COUNT) && (VSF_HW_FLASH_COUNT != 0)
79# define VSF_FLASH_CFG_PREFIX vsf_hw
81# define VSF_FLASH_CFG_PREFIX vsf
94#ifndef VSF_FLASH_CFG_FUNCTION_RENAME
95# define VSF_FLASH_CFG_FUNCTION_RENAME ENABLED
105#ifndef VSF_FLASH_CFG_REIMPLEMENT_TYPE_IRQ_MASK
106# define VSF_FLASH_CFG_REIMPLEMENT_TYPE_IRQ_MASK DISABLED
116#ifndef VSF_FLASH_CFG_REIMPLEMENT_TYPE_FLASH_SIZE
117# define VSF_FLASH_CFG_REIMPLEMENT_TYPE_FLASH_SIZE DISABLED
127#ifndef VSF_FLASH_CFG_REIMPLEMENT_TYPE_STATUS
128# define VSF_FLASH_CFG_REIMPLEMENT_TYPE_STATUS DISABLED
140#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_CFG == DISABLED
141# define VSF_FLASH_CFG_REIMPLEMENT_TYPE_CFG DISABLED
153#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_CAPABILITY == DISABLED
154# define VSF_FLASH_CFG_REIMPLEMENT_TYPE_CAPABILITY DISABLED
164#ifndef VSF_FLASH_CFG_INHERIT_HAL_CAPABILITY
165# define VSF_FLASH_CFG_INHERIT_HAL_CAPABILITY ENABLED
170#define VSF_FLASH_APIS(__prefix_name) \
171 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, init, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_cfg_t *cfg_ptr) \
172 __VSF_HAL_TEMPLATE_API(__prefix_name, void, flash, fini, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptrr) \
173 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, flash, enable, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr) \
174 __VSF_HAL_TEMPLATE_API(__prefix_name, fsm_rt_t, flash, disable, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr) \
175 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_flash_status_t, flash, status, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr) \
176 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_flash_capability_t, flash, capability, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr) \
177 __VSF_HAL_TEMPLATE_API(__prefix_name, void, flash, irq_enable, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_irq_mask_t irq_mask) \
178 __VSF_HAL_TEMPLATE_API(__prefix_name, void, flash, irq_disable, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_irq_mask_t irq_mask) \
179 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, erase_one_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes) \
180 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, erase_multi_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes, vsf_flash_size_t size_of_bytes) \
181 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, erase_all, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr) \
182 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, write_one_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t* buffer, vsf_flash_size_t size_of_bytes) \
183 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, write_multi_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t* buffer, vsf_flash_size_t size_of_bytes) \
184 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, read_one_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t* buffer, vsf_flash_size_t size_of_bytes) \
185 __VSF_HAL_TEMPLATE_API(__prefix_name, vsf_err_t, flash, read_multi_sector, VSF_MCONNECT(__prefix_name, _flash_t) *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t* buffer, vsf_flash_size_t size_of_bytes)
189#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_IRQ_MASK == DISABLED
218#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_FLASH_SIZE == DISABLED
222#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_CFG == DISABLED
243#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_STATUS == DISABLED
261#if VSF_FLASH_CFG_REIMPLEMENT_TYPE_CAPABILITY == DISABLED
263#if VSF_FLASH_CFG_INHERIT_HAL_CAPABILITY == ENABLED
282#undef __VSF_HAL_TEMPLATE_API
283#define __VSF_HAL_TEMPLATE_API VSF_HAL_TEMPLATE_API_FP
289#if VSF_FLASH_CFG_MULTI_CLASS == ENABLED
564#if VSF_FLASH_CFG_FUNCTION_RENAME == ENABLED
565# define __vsf_flash_t VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_t)
566# define vsf_flash_init(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_init) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
567# define vsf_flash_fini(__FLASH) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_fini) ((__vsf_flash_t *)(__FLASH))
568# define vsf_flash_enable(__FLASH) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_enable) ((__vsf_flash_t *)(__FLASH))
569# define vsf_flash_disable(__FLASH) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_disable) ((__vsf_flash_t *)(__FLASH))
570# define vsf_flash_capability(__FLASH) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_capability) ((__vsf_flash_t *)(__FLASH))
571# define vsf_flash_status(__FLASH) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_status) ((__vsf_flash_t *)(__FLASH))
572# define vsf_flash_irq_enable(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_irq_enable) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
573# define vsf_flash_irq_disable(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_irq_disable) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
574# define vsf_flash_erase_one_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_erase_one_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
575# define vsf_flash_erase_multi_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_erase_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
576# define vsf_flash_erase(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_erase_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
577# define vsf_flash_erase_all(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_erase_all) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
578# define vsf_flash_write_one_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_write_one_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
579# define vsf_flash_write_multi_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_write_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
580# define vsf_flash_write(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_write_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
581# define vsf_flash_read_one_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_read_one_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
582# define vsf_flash_read_multi_sector(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_read_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
583# define vsf_flash_read(__FLASH, ...) VSF_MCONNECT(VSF_FLASH_CFG_PREFIX, _flash_read_multi_sector) ((__vsf_flash_t *)(__FLASH), ##__VA_ARGS__)
vsf_err_t
Definition __type.h:42
vsf_arch_prio_t
Definition cortex_a_generic.h:88
const i_spi_t vsf_spi_irq_mask_t irq_mask
Definition spi_interface.h:38
unsigned uint32_t
Definition stdint.h:9
unsigned int uint_fast32_t
Definition stdint.h:27
unsigned char uint8_t
Definition stdint.h:5
Definition vsf_template_flash.h:262
vsf_flash_size_t max_size
Definition vsf_template_flash.h:269
uint8_t none_sector_aligned_read
Definition vsf_template_flash.h:275
vsf_flash_size_t write_sector_size
Definition vsf_template_flash.h:271
inherit(vsf_peripheral_capability_t) vsf_flash_irq_mask_t irq_mask
vsf_flash_size_t base_address
Definition vsf_template_flash.h:268
vsf_flash_size_t erase_sector_size
Definition vsf_template_flash.h:270
uint8_t none_sector_aligned_write
Definition vsf_template_flash.h:274
Definition vsf_template_flash.h:238
vsf_flash_isr_t isr
Interrupt configuration.
Definition vsf_template_flash.h:239
Definition vsf_template_flash.h:233
vsf_flash_isr_handler_t * handler_fn
Interrupt handler function.
Definition vsf_template_flash.h:234
vsf_arch_prio_t prio
Interrupt priority.
Definition vsf_template_flash.h:236
void * target_ptr
User target pointer.
Definition vsf_template_flash.h:235
Definition vsf_template_flash.h:280
Flash status structure that can be reimplemented in specific HAL drivers.
Definition vsf_template_flash.h:251
Definition vsf_template_flash.h:290
const vsf_flash_op_t * op
Definition vsf_template_flash.h:291
Definition vsf_template_hal_driver.h:203
Definition vsf_template_hal_driver.h:196
vsf_flash_irq_mask_t
Definition flash.h:116
void vsf_flash_isr_handler_t(void *target_ptr, vsf_flash_t *flash_ptr, vsf_flash_irq_mask_t mask)
Definition flash.h:132
uint_fast32_t vsf_flash_size_t
Definition flash.h:127
fsm_rt_t
Definition vsf_fsm.h:315
vsf_err_t vsf_flash_init(vsf_flash_t *flash_ptr, vsf_flash_cfg_t *cfg_ptr)
Initialize a FLASH instance.
Definition flash_common.c:38
#define VSF_FLASH_APIS(__prefix_name)
Definition vsf_template_flash.h:170
vsf_err_t vsf_flash_read_one_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t *buffer, vsf_flash_size_t size_of_bytes)
flash read one sector
Definition flash_common.c:155
vsf_err_t vsf_flash_write_multi_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t *buffer, vsf_flash_size_t size_of_bytes)
Flash write multi sector.
Definition flash_common.c:146
vsf_flash_irq_mask_t
Predefined VSF Flash interrupts that can be reimplemented in specific HAL drivers.
Definition vsf_template_flash.h:197
@ VSF_FLASH_IRQ_ERASE_MASK
Erase operation complete.
Definition vsf_template_flash.h:198
@ VSF_FLASH_IRQ_READ_MASK
Read operation complete.
Definition vsf_template_flash.h:200
@ VSF_FLASH_IRQ_WRITE_ERROR_MASK
Write operation error.
Definition vsf_template_flash.h:203
@ VSF_FLASH_IRQ_WRITE_MASK
Write operation complete.
Definition vsf_template_flash.h:199
@ VSF_FLASH_IRQ_ERASE_ERROR_MASK
Erase operation error.
Definition vsf_template_flash.h:202
@ VSF_FLASH_IRQ_READ_ERROR_MASK
Read operation error.
Definition vsf_template_flash.h:204
void vsf_flash_isr_handler_t(void *target_ptr, vsf_flash_t *flash_ptr, vsf_flash_irq_mask_t mask)
Definition vsf_template_flash.h:231
vsf_err_t vsf_flash_read_multi_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t *buffer, vsf_flash_size_t size_of_bytes)
flash read multi sector
Definition flash_common.c:164
vsf_err_t vsf_flash_erase_all(vsf_flash_t *flash_ptr)
Flash chip erase.
Definition flash_common.c:128
vsf_err_t vsf_flash_erase_multi_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes, vsf_flash_size_t size_of_bytes)
Flash erase a continuous range.
Definition flash_common.c:119
vsf_flash_status_t vsf_flash_status(vsf_flash_t *flash_ptr)
Get the status of FLASH instance.
Definition flash_common.c:92
fsm_rt_t vsf_flash_disable(vsf_flash_t *flash_ptr)
Disable a FLASH instance.
Definition flash_common.c:65
vsf_err_t vsf_flash_erase_one_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes)
FLASH erase one sector.
Definition flash_common.c:110
@ VSF_FLASH_IRQ_COUNT
Definition vsf_template_flash.h:209
@ VSF_FLASH_IRQ_ALL_BITS_MASK
Definition vsf_template_flash.h:210
vsf_flash_capability_t vsf_flash_capability(vsf_flash_t *flash_ptr)
Get the capabilities of FLASH instance.
Definition flash_common.c:101
struct vsf_flash_capability_t vsf_flash_capability_t
struct vsf_flash_cfg_t vsf_flash_cfg_t
struct vsf_flash_isr_t vsf_flash_isr_t
fsm_rt_t vsf_flash_enable(vsf_flash_t *flash_ptr)
Enable a FLASH instance.
Definition flash_common.c:56
struct vsf_flash_status_t vsf_flash_status_t
Flash status structure that can be reimplemented in specific HAL drivers.
uint_fast32_t vsf_flash_size_t
Definition vsf_template_flash.h:219
void vsf_flash_fini(vsf_flash_t *flash_ptr)
Finalize a FLASH instance.
Definition flash_common.c:47
void vsf_flash_irq_disable(vsf_flash_t *flash_ptr, vsf_flash_irq_mask_t irq_mask)
Disable interrupt masks of FLASH instance.
Definition flash_common.c:83
void vsf_flash_irq_enable(vsf_flash_t *flash_ptr, vsf_flash_irq_mask_t irq_mask)
Enable interrupt masks of FLASH instance.
Definition flash_common.c:74
vsf_err_t vsf_flash_write_one_sector(vsf_flash_t *flash_ptr, vsf_flash_size_t offset_of_bytes, uint8_t *buffer, vsf_flash_size_t size_of_bytes)
Flash write one sector.
Definition flash_common.c:137