sqiflash  2.0.0.0
sqiflash.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 SQIFLASH_H
29 #define SQIFLASH_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
35 #include "drv_digital_out.h"
36 #include "drv_digital_in.h"
37 #include "drv_spi_master.h"
38 #include "spi_specifics.h"
39 
60 #define SQIFLASH_STATUS_WEL 0x02
61 #define SQIFLASH_STATUS_WSE 0x04
62 #define SQIFLASH_STATUS_WSP 0x08
63 #define SQIFLASH_STATUS_WPLD 0x10
64 #define SQIFLASH_STATUS_SEC 0x20
65 #define SQIFLASH_STATUS_RES 0x40
66 #define SQIFLASH_STATUS_BUSY 0x80
67 
68 #define SQIFLASH_CFG_RES 0x01
69 #define SQIFLASH_CFG_IOC 0x02
70 #define SQIFLASH_CFG_BPNV 0x08
71 #define SQIFLASH_CFG_WPEN 0x80
72 
77 #define SQIFLASH_INSTR_NOP 0x00
78 #define SQIFLASH_INSTR_RSTEN 0x66
79 #define SQIFLASH_INSTR_RST 0x99
80 #define SQIFLASH_INSTR_EQIO 0x38
81 #define SQIFLASH_INSTR_RSTQIO 0xFF
82 #define SQIFLASH_INSTR_RDSR 0x05
83 #define SQIFLASH_INSTR_WRSR 0x01
84 #define SQIFLASH_INSTR_RDCR 0x35
85 #define SQIFLASH_INSTR_READ 0x03
86 #define SQIFLASH_INSTR_HS_READ 0x0B
87 #define SQIFLASH_INSTR_SQOR 0x6B
88 #define SQIFLASH_INSTR_SQIOR 0xEB
89 #define SQIFLASH_INSTR_SDOR 0x3B
90 #define SQIFLASH_INSTR_SDIOR 0xBB
91 #define SQIFLASH_INSTR_SB 0xC0
92 #define SQIFLASH_INSTR_RBSQI 0x0C
93 #define SQIFLASH_INSTR_RBSPI 0xEC
94 #define SQIFLASH_INSTR_JEDECID 0x9F
95 #define SQIFLASH_INSTR_QUAD_JID 0xAF
96 #define SQIFLASH_INSTR_SFDP 0x5A
97 #define SQIFLASH_INSTR_WREN 0x06
98 #define SQIFLASH_INSTR_WRDI 0x04
99 #define SQIFLASH_INSTR_SE 0x20
100 #define SQIFLASH_INSTR_BE 0xD8
101 #define SQIFLASH_INSTR_CE 0xC7
102 #define SQIFLASH_INSTR_PP 0x02
103 #define SQIFLASH_INSTR_SPI_QUAD 0x32
104 #define SQIFLASH_INSTR_WRSU 0xB0
105 #define SQIFLASH_INSTR_WRRE 0x30
106 #define SQIFLASH_INSTR_RBPR 0x72
107 #define SQIFLASH_INSTR_WBPR 0x42
108 #define SQIFLASH_INSTR_LBPR 0x8D
109 #define SQIFLASH_INSTR_NVWLDR 0xE8
110 #define SQIFLASH_INSTR_ULBPR 0x98
111 #define SQIFLASH_INSTR_RSID 0x88
112 #define SQIFLASH_INSTR_PSID 0xA5
113 #define SQIFLASH_INSTR_LSID 0x85
114 
115 
116 #define SQIFLASH_START_PAGE_ADDRESS 0x010000
117 #define SQIFLASH_END_PAGE_ADDRESS 0x7FFFFF
118 #define SQIFLASH_FLASH_PAGE_SIZE 256
119 
120 
129 #define SQIFLASH_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
130 #define SQIFLASH_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
131  // sqiflash_set
133 
148 #define SQIFLASH_MAP_MIKROBUS( cfg, mikrobus ) \
149  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
150  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
151  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
152  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
153  cfg.sq3 = MIKROBUS( mikrobus, MIKROBUS_RST ); \
154  cfg.sq2 = MIKROBUS( mikrobus, MIKROBUS_PWM )
155  // sqiflash_map // sqiflash
158 
163 typedef struct
164 {
165  // Output pins
166  digital_out_t sq3;
167  digital_out_t sq2;
169  // Modules
170  spi_master_t spi;
172  pin_name_t chip_select;
174 } sqiflash_t;
175 
180 typedef struct
181 {
182  // Communication gpio pins
183  pin_name_t miso;
184  pin_name_t mosi;
185  pin_name_t sck;
186  pin_name_t cs;
188  // Additional gpio pins
189  pin_name_t sq3;
190  pin_name_t sq2;
192  // static variable
193  uint32_t spi_speed;
194  spi_master_mode_t spi_mode;
195  spi_master_chip_select_polarity_t cs_polarity;
198 
203 typedef enum
204 {
206  SQIFLASH_ERROR = -1
207 
209 
226 
241 
256 err_t sqiflash_generic_write ( sqiflash_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
257 
272 err_t sqiflash_generic_read ( sqiflash_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
273 
285 void sqiflash_generic_transfer ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
286  uint32_t data_count );
287 
297 uint8_t sqiflash_busy ( sqiflash_t *ctx );
298 
308 
317 
327 
337 
347 
358 
368 
377 
386 
394 
403 
427 
428 
452 
462 void sqiflash_spi_get_security_id ( sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count);
463 
473 void sqiflash_sqi_get_security_id ( sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count);
474 
489 void sqiflash_set_security_id ( sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count );
490 
501 
513 void sqiflash_spi_get_bpr ( sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count );
514 
526 void sqiflash_sqi_get_bpr ( sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count );
527 
537 void sqiflash_set_bpr ( sqiflash_t *ctx, uint8_t *buffer );
538 
551 
562 void sqiflash_nonvolatile_write_lock ( sqiflash_t *ctx, uint8_t *buffer);
563 
575 
596 void sqiflash_read_generic ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count );
597 
612 void sqiflash_highspeed_r_read ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count );
613 
631 void sqiflash_quad_write ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count );
632 
648 void sqiflash_write_generic ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
649  uint32_t data_count );
650 
664 
679 void sqiflash_quad_out_read ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
680  uint32_t data_count);
681 
697 void sqiflash_quad_io_read ( sqiflash_t *ctx, uint32_t address, uint8_t mode, uint8_t *buffer,
698  uint32_t data_count);
699 
718 
735 void sqiflash_set_burst ( sqiflash_t *ctx, uint8_t length );
736 
762 void sqiflash_read_sqi_burst_wrap ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
763  uint32_t data_count );
764 
790 void sqiflash_read_spi_burst_wrap ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
791  uint32_t data_count );
792 
805 void sqiflash_read_dual_output ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
806  uint32_t data_count );
807 
843 void sqiflash_read_dual_io ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
844  uint32_t data_count );
845 
856 void sqiflash_sector_erase ( sqiflash_t *ctx, uint32_t address );
857 
870 void sqiflash_block_erase ( sqiflash_t *ctx, uint32_t address );
871 
882 
897 void sqiflash_get_sfdp_params ( sqiflash_t *ctx, uint32_t address, uint8_t *buffer,
898  uint32_t data_count );
899 
910 
921 
932 
943 
954 
965 
977 
987 void sqiflash_write_status_reg ( sqiflash_t *ctx, uint8_t s_reg );
988 
998 
1009 
1010 #ifdef __cplusplus
1011 }
1012 #endif
1013 #endif // SQIFLASH_H
1014  // sqiflash
1016 
1017 // ------------------------------------------------------------------------ END
sqiflash_quad_enable
void sqiflash_quad_enable(sqiflash_t *ctx)
SQI FLASH Quad Enable.
sqiflash_program_status
uint8_t sqiflash_program_status(sqiflash_t *ctx)
SQI FLASH Program Status.
sqiflash_read_dual_output
void sqiflash_read_dual_output(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Read Dual Output.
sqiflash_cfg_t::sck
pin_name_t sck
Definition: sqiflash.h:185
sqiflash_get_sfdp_params
void sqiflash_get_sfdp_params(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH get Serial Flash Discoverable.
sqiflash_erase_status
uint8_t sqiflash_erase_status(sqiflash_t *ctx)
SQI FLASH Erase Status.
sqiflash_security_status
uint8_t sqiflash_security_status(sqiflash_t *ctx)
SQI FLASH Security Status.
sqiflash_generic_transfer
void sqiflash_generic_transfer(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
Generic transfer function.
sqiflash_cfg_t::mosi
pin_name_t mosi
Definition: sqiflash.h:184
sqiflash_lock_security_id
void sqiflash_lock_security_id(sqiflash_t *ctx)
SQI FLASH Lock Security Status.
sqiflash_write_resume
void sqiflash_write_resume(sqiflash_t *ctx)
SQI FLASH Write Resume.
sqiflash_device_type
uint8_t sqiflash_device_type(sqiflash_t *ctx)
SQI FLASH Device Type.
sqiflash_write_status_reg
void sqiflash_write_status_reg(sqiflash_t *ctx, uint8_t s_reg)
SQI FLASH Write Status Register.
sqiflash_quad_out_read
void sqiflash_quad_out_read(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Quad Output Read.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
sqiflash_block_erase
void sqiflash_block_erase(sqiflash_t *ctx, uint32_t address)
SQI FLASH Block Erase.
sqiflash_quad_device_id
uint8_t sqiflash_quad_device_id(sqiflash_t *ctx)
SQI FLASH Quad Device ID.
sqiflash_cfg_t::miso
pin_name_t miso
Definition: sqiflash.h:183
sqiflash_set_burst
void sqiflash_set_burst(sqiflash_t *ctx, uint8_t length)
SQI FLASH Set Burst.
sqiflash_chip_erase
void sqiflash_chip_erase(sqiflash_t *ctx)
SQI FLASH Chip Erase.
sqiflash_write_enable
void sqiflash_write_enable(sqiflash_t *ctx)
SQI FLASH Write Enable.
sqiflash_write_status
uint8_t sqiflash_write_status(sqiflash_t *ctx)
SQI FLASH Write Status.
sqiflash_hold_disable
void sqiflash_hold_disable(sqiflash_t *ctx)
SQI FLASH Hold Disable.
sqiflash_t
SQI FLASH Click context object.
Definition: sqiflash.h:164
sqiflash_init
err_t sqiflash_init(sqiflash_t *ctx, sqiflash_cfg_t *cfg)
SQI FLASH initialization function.
sqiflash_read_spi_burst_wrap
void sqiflash_read_spi_burst_wrap(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Read Burst with Wrap through SPI.
sqiflash_t::sq3
digital_out_t sq3
Definition: sqiflash.h:166
sqiflash_set_security_id
void sqiflash_set_security_id(sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count)
SQI FLASH Set Security ID.
sqiflash_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: sqiflash.h:195
sqiflash_global_block_unlock
void sqiflash_global_block_unlock(sqiflash_t *ctx)
SQI FLASH Global Block Unlock.
sqiflash_cfg_t
SQI FLASH Click configuration object.
Definition: sqiflash.h:181
sqiflash_write_generic
void sqiflash_write_generic(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Write.
sqiflash_generic_read
err_t sqiflash_generic_read(sqiflash_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
SQI FLASH data reading function.
SQIFLASH_OK
@ SQIFLASH_OK
Definition: sqiflash.h:205
sqiflash_write_protect_enable
void sqiflash_write_protect_enable(sqiflash_t *ctx)
SQI FLASH Write Protect Enable .
sqiflash_cfg_setup
void sqiflash_cfg_setup(sqiflash_cfg_t *cfg)
SQI FLASH configuration object setup function.
sqiflash_device_manufac
uint8_t sqiflash_device_manufac(sqiflash_t *ctx)
SQI FLASH Device Manufacturer.
sqiflash_sqi_get_bpr
void sqiflash_sqi_get_bpr(sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count)
SQI FLASH Get Block Protection Register SQI.
sqiflash_sqi_get_security_id
void sqiflash_sqi_get_security_id(sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count)
SQI FLASH Get Security ID SQI.
sqiflash_read_sqi_burst_wrap
void sqiflash_read_sqi_burst_wrap(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Read Burst with Wrap through SQI.
sqiflash_hold_enable
void sqiflash_hold_enable(sqiflash_t *ctx)
SQI FLASH Hold Enable.
sqiflash_cfg_t::sq3
pin_name_t sq3
Definition: sqiflash.h:189
sqiflash_write_disable
void sqiflash_write_disable(sqiflash_t *ctx)
SQI FLASH Write Disable.
sqiflash_quad_reset
void sqiflash_quad_reset(sqiflash_t *ctx)
SQI FLASH Quad Reset.
sqiflash_read_generic
void sqiflash_read_generic(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Read.
sqiflash_quad_device_type
uint8_t sqiflash_quad_device_type(sqiflash_t *ctx)
SQI FLASH Quad Device Type.
sqiflash_sector_erase
void sqiflash_sector_erase(sqiflash_t *ctx, uint32_t address)
SQI FLASH Sector Erase.
sqiflash_t::sq2
digital_out_t sq2
Definition: sqiflash.h:167
sqiflash_device_id
uint8_t sqiflash_device_id(sqiflash_t *ctx)
SQI FLASH Device ID.
sqiflash_quad_io_read
void sqiflash_quad_io_read(sqiflash_t *ctx, uint32_t address, uint8_t mode, uint8_t *buffer, uint32_t data_count)
SQI FLASH Quad I/O Read.
sqiflash_get_config_reg
uint8_t sqiflash_get_config_reg(sqiflash_t *ctx)
SQI FLASH Get Config Register.
sqiflash_generic_write
err_t sqiflash_generic_write(sqiflash_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
SQI FLASH data writing function.
SQIFLASH_ERROR
@ SQIFLASH_ERROR
Definition: sqiflash.h:206
sqiflash_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: sqiflash.h:194
sqiflash_write_suspend
void sqiflash_write_suspend(sqiflash_t *ctx)
SQI FLASH Write Suspend.
sqiflash_t::chip_select
pin_name_t chip_select
Definition: sqiflash.h:172
sqiflash_get_status_reg
uint8_t sqiflash_get_status_reg(sqiflash_t *ctx)
SQI FLASH Get Status Register.
sqiflash_lock_bpr
void sqiflash_lock_bpr(sqiflash_t *ctx)
SQI FLASH Lock Block Protection Register.
sqiflash_cfg_t::sq2
pin_name_t sq2
Definition: sqiflash.h:190
sqiflash_cfg_t::cs
pin_name_t cs
Definition: sqiflash.h:186
sqiflash_spi_get_security_id
void sqiflash_spi_get_security_id(sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count)
SQI FLASH Get Security ID SPI.
sqiflash_protect_status
uint8_t sqiflash_protect_status(sqiflash_t *ctx)
SQI FLASH Protect Status.
sqiflash_quad_write
void sqiflash_quad_write(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Quad Write.
sqiflash_write_protect_disable
void sqiflash_write_protect_disable(sqiflash_t *ctx)
SQI FLASH Write Protect Disable.
sqiflash_cfg_t::spi_speed
uint32_t spi_speed
Definition: sqiflash.h:193
sqiflash_quad_device_manufac
uint8_t sqiflash_quad_device_manufac(sqiflash_t *ctx)
SQI FLASH Quad Device Manufacturer.
sqiflash_highspeed_r_read
void sqiflash_highspeed_r_read(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH High Speed Read.
sqiflash_t::spi
spi_master_t spi
Definition: sqiflash.h:170
sqiflash_busy
uint8_t sqiflash_busy(sqiflash_t *ctx)
SQI FLASH Busy.
sqiflash_return_value_t
sqiflash_return_value_t
SQI FLASH Click return value data.
Definition: sqiflash.h:204
sqiflash_set_bpr
void sqiflash_set_bpr(sqiflash_t *ctx, uint8_t *buffer)
SQI FLASH Set Block Protection Register.
sqiflash_spi_get_bpr
void sqiflash_spi_get_bpr(sqiflash_t *ctx, uint8_t *buffer, uint32_t data_count)
SQI FLASH Get Block Protection Register SPI.
sqiflash_read_dual_io
void sqiflash_read_dual_io(sqiflash_t *ctx, uint32_t address, uint8_t *buffer, uint32_t data_count)
SQI FLASH Read Dual I/O.
sqiflash_nonvolatile_write_lock
void sqiflash_nonvolatile_write_lock(sqiflash_t *ctx, uint8_t *buffer)
SQI FLASH Non-Volatile Write-Lock.
sqiflash_reset
void sqiflash_reset(sqiflash_t *ctx)
SQI FLASH Reset.