flash7  2.0.0.0
flash7.h
Go to the documentation of this file.
1 /****************************************************************************
2 ** Copyright (C) 2020 MikroElektronika d.o.o.
3 ** Contact: https://www.mikroe.com/contact
4 **
5 ** Permission is hereby granted, free of charge, to any person obtaining a copy
6 ** of this software and associated documentation files (the "Software"), to deal
7 ** in the Software without restriction, including without limitation the rights
8 ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 ** copies of the Software, and to permit persons to whom the Software is
10 ** furnished to do so, subject to the following conditions:
11 ** The above copyright notice and this permission notice shall be
12 ** included in all copies or substantial portions of the Software.
13 **
14 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
16 ** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
19 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 ** USE OR OTHER DEALINGS IN THE SOFTWARE.
21 ****************************************************************************/
22 
28 #ifndef FLASH7_H
29 #define FLASH7_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
39 #ifdef PREINIT_SUPPORTED
40 #include "preinit.h"
41 #endif
42 
43 #ifdef MikroCCoreVersion
44  #if MikroCCoreVersion >= 1
45  #include "delays.h"
46  #endif
47 #endif
48 
49 #include "drv_digital_out.h"
50 #include "drv_digital_in.h"
51 #include "drv_spi_master.h"
52 
78 #define FLASH7_STAT_REG_LSB_SRP0 0x80
79 #define FLASH7_STAT_REG_LSB_BP4 0x40
80 #define FLASH7_STAT_REG_LSB_BP3 0x20
81 #define FLASH7_STAT_REG_LSB_BP2 0x10
82 #define FLASH7_STAT_REG_LSB_BP1 0x08
83 #define FLASH7_STAT_REG_LSB_BP0 0x04
84 #define FLASH7_STAT_REG_LSB_WEL 0x02
85 #define FLASH7_STAT_REG_LSB_WIP 0x01
86 
91 #define FLASH7_STAT_REG_MSB_SUS1 0x80
92 #define FLASH7_STAT_REG_MSB_CMP 0x40
93 #define FLASH7_STAT_REG_MSB_LB3 0x20
94 #define FLASH7_STAT_REG_MSB_LB2 0x10
95 #define FLASH7_STAT_REG_MSB_LB1 0x08
96 #define FLASH7_STAT_REG_MSB_SUS2 0x04
97 #define FLASH7_STAT_REG_MSB_QE 0x02
98 #define FLASH7_STAT_REG_MSB_SRP1 0x01
99 
104 #define FLASH7_MEMORY_ADDR_START 0x00000000
105 #define FLASH7_MEMORY_ADDR_END 0x00FFFFFF
106 #define FLASH7_MEM_SECTOR_LEN 0x00001000
107 #define FLASH7_MEMORY_BLOCK_SIZE 0x00008000
108  // flash7_reg
110 
130 #define FLASH7_CMD_WRSR 0x01
131 #define FLASH7_CMD_WRITE 0x02
132 #define FLASH7_CMD_READ 0x03
133 #define FLASH7_CMD_WRDI 0x04
134 #define FLASH7_CMD_RDSR_LSB 0x05
135 #define FLASH7_CMD_RDSR_MSB 0x35
136 #define FLASH7_CMD_WREN 0x06
137 #define FLASH7_CMD_FREAD 0x0B
138 #define FLASH7_CMD_WEVSR 0x50
139 #define FLASH7_CMD_SE 0x20
140 #define FLASH7_CMD_BE_32KB 0x52
141 #define FLASH7_CMD_BE_64KB 0xD8
142 #define FLASH7_CMD_CE 0x60
143 #define FLASH7_CMD_SLEEP 0xB9
144 #define FLASH7_CMD_WAKE 0xAB
145 #define FLASH7_CMD_REMS 0x90
146 #define FLASH7_CMD_RDID 0x9F
147 #define FLASH7_CMD_ID 0x4B
148 #define FLASH7_CMD_ENRES 0x66
149 #define FLASH7_CMD_RES 0x99
150 
155 #define FLASH7_WRITE_PROTECT_DISABLE 0x00
156 #define FLASH7_WRITE_PROTECT_ENABLE 0x01
157 
162 #define FLASH7_HOLD_DISABLE 0x00
163 #define FLASH7_HOLD_ENABLE 0x01
164 
169 #define FLASH7_DUMMY 0x00
170  // flash7_set
172 
187 #define FLASH7_MAP_MIKROBUS( cfg, mikrobus ) \
188  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
189  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
190  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
191  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
192  cfg.io2 = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
193  cfg.io3 = MIKROBUS( mikrobus, MIKROBUS_INT )
194  // flash7_map // flash7
197 
202 typedef struct
203 {
204  // Output pins
205  digital_out_t io2;
206  digital_out_t io3;
208  // Modules
209  spi_master_t spi;
211  pin_name_t chip_select;
213 } flash7_t;
214 
219 typedef struct
220 {
221  // Communication gpio pins
222  pin_name_t miso;
223  pin_name_t mosi;
224  pin_name_t sck;
225  pin_name_t cs;
227  // Additional gpio pins
228 
229  pin_name_t io2;
230  pin_name_t io3;
232  // static variable
233  uint32_t spi_speed;
234  spi_master_mode_t spi_mode;
235  spi_master_chip_select_polarity_t cs_polarity;
237 } flash7_cfg_t;
238 
243 typedef enum
244 {
246  FLASH7_ERROR = -1
247 
249 
266 
281 err_t flash7_init ( flash7_t *ctx, flash7_cfg_t *cfg );
282 
297 
313 err_t flash7_generic_write ( flash7_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
314 
329 err_t flash7_generic_read ( flash7_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
330 
342 void flash7_write_protect ( flash7_t *ctx, uint8_t en_write_protect );
343 
354 void flash7_hold ( flash7_t *ctx, uint8_t en_hold );
355 
366 void flash7_send_command ( flash7_t *ctx, uint8_t cmd );
367 
378 
389 
400 
411 uint8_t flash7_read_status_register ( flash7_t *ctx, uint8_t status_byte );
412 
423 void flash7_write_status_register ( flash7_t *ctx, uint16_t status_data );
424 
438 uint8_t flash7_page_program ( flash7_t *ctx, uint32_t mem_addr, uint8_t *p_tx_data, uint16_t n_bytes );
439 
453 void flash7_read_memory ( flash7_t *ctx, uint32_t mem_addr, uint8_t *p_rx_data, uint16_t n_bytes );
454 
468 void flash7_fast_read_memory ( flash7_t *ctx, uint32_t mem_addr, uint8_t *p_rx_data, uint16_t n_bytes );
469 
485 uint8_t flash7_sector_erase ( flash7_t *ctx, uint16_t mem_sector );
486 
503 uint8_t flash7_block_erase ( flash7_t *ctx, uint8_t mem_block, uint8_t mem_block_len );
504 
517 
528 uint8_t flash7_wake_up ( flash7_t *ctx );
529 
541 void flash7_read_id ( flash7_t *ctx, uint8_t *manufacturer_id, uint8_t *device_id );
542 
555 void flash7_get_identification ( flash7_t *ctx, uint8_t *manufacturer_id, uint8_t *memory_type_id, uint8_t *capacity_id );
556 
566 void flash7_sw_reset ( flash7_t *ctx );
567 
568 #ifdef __cplusplus
569 }
570 #endif
571 #endif // FLASH7_H
572  // flash7
574 
575 // ------------------------------------------------------------------------ END
flash7_write_status_register
void flash7_write_status_register(flash7_t *ctx, uint16_t status_data)
Write status register function.
flash7_chip_erase
void flash7_chip_erase(flash7_t *ctx)
Chip erase function.
flash7_cfg_setup
void flash7_cfg_setup(flash7_cfg_t *cfg)
Flash 7 configuration object setup function.
flash7_cfg_t::cs
pin_name_t cs
Definition: flash7.h:225
flash7_hold
void flash7_hold(flash7_t *ctx, uint8_t en_hold)
Enable hold operation function.
flash7_t::io3
digital_out_t io3
Definition: flash7.h:206
flash7_fast_read_memory
void flash7_fast_read_memory(flash7_t *ctx, uint32_t mem_addr, uint8_t *p_rx_data, uint16_t n_bytes)
Fast read memory function.
flash7_write_enable
void flash7_write_enable(flash7_t *ctx)
Write enable function.
flash7_read_status_register
uint8_t flash7_read_status_register(flash7_t *ctx, uint8_t status_byte)
Read status register function.
flash7_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: flash7.h:235
flash7_get_identification
void flash7_get_identification(flash7_t *ctx, uint8_t *manufacturer_id, uint8_t *memory_type_id, uint8_t *capacity_id)
Get identification function.
flash7_sw_reset
void flash7_sw_reset(flash7_t *ctx)
Soft reset function.
flash7_cfg_t::io2
pin_name_t io2
Definition: flash7.h:229
flash7_cfg_t
Flash 7 Click configuration object.
Definition: flash7.h:220
flash7_cfg_t::io3
pin_name_t io3
Definition: flash7.h:230
flash7_read_memory
void flash7_read_memory(flash7_t *ctx, uint32_t mem_addr, uint8_t *p_rx_data, uint16_t n_bytes)
Read memory function.
flash7_init
err_t flash7_init(flash7_t *ctx, flash7_cfg_t *cfg)
Flash 7 initialization function.
flash7_t
Flash 7 Click context object.
Definition: flash7.h:203
flash7_write_protect
void flash7_write_protect(flash7_t *ctx, uint8_t en_write_protect)
Enable write protect function.
flash7_default_cfg
err_t flash7_default_cfg(flash7_t *ctx)
Flash 7 default configuration function.
flash7_t::chip_select
pin_name_t chip_select
Definition: flash7.h:211
FLASH7_OK
@ FLASH7_OK
Definition: flash7.h:245
flash7_block_erase
uint8_t flash7_block_erase(flash7_t *ctx, uint8_t mem_block, uint8_t mem_block_len)
Block erase function.
flash7_go_to_sleep
void flash7_go_to_sleep(flash7_t *ctx)
Go to sleep mode function.
flash7_page_program
uint8_t flash7_page_program(flash7_t *ctx, uint32_t mem_addr, uint8_t *p_tx_data, uint16_t n_bytes)
Page program function.
flash7_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: flash7.h:234
flash7_cfg_t::spi_speed
uint32_t spi_speed
Definition: flash7.h:233
flash7_generic_read
err_t flash7_generic_read(flash7_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Flash 7 data reading function.
FLASH7_ERROR
@ FLASH7_ERROR
Definition: flash7.h:246
flash7_send_command
void flash7_send_command(flash7_t *ctx, uint8_t cmd)
Send command function.
flash7_cfg_t::sck
pin_name_t sck
Definition: flash7.h:224
flash7_cfg_t::miso
pin_name_t miso
Definition: flash7.h:222
flash7_sector_erase
uint8_t flash7_sector_erase(flash7_t *ctx, uint16_t mem_sector)
Sector erase function.
flash7_wake_up
uint8_t flash7_wake_up(flash7_t *ctx)
Wake up function.
flash7_return_value_t
flash7_return_value_t
Flash 7 Click return value data.
Definition: flash7.h:244
flash7_generic_write
err_t flash7_generic_write(flash7_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Flash 7 data writing function.
flash7_t::spi
spi_master_t spi
Definition: flash7.h:209
flash7_t::io2
digital_out_t io2
Definition: flash7.h:205
flash7_cfg_t::mosi
pin_name_t mosi
Definition: flash7.h:223
flash7_write_disable
void flash7_write_disable(flash7_t *ctx)
Write disable function.
flash7_read_id
void flash7_read_id(flash7_t *ctx, uint8_t *manufacturer_id, uint8_t *device_id)
Read ID function.