Difference between revisions of "Component: Serial Flash (W25) (W25) (Storage)"
From Flowcode Help
Jump to navigationJump to search| (4 intermediate revisions by the same user not shown) | |||
| Line 14: | Line 14: | ||
==Serial Flash (W25) component== | ==Serial Flash (W25) component== | ||
Component to allow support for the Winbond W25 range of SPI Flash devices. Compatible with various sizes of Flash including: 2Mb, 4Mb, 8Mb, 32Mb, 64Mb, 128Mb. | Component to allow support for the Winbond W25 range of SPI Flash devices. Compatible with various sizes of Flash including: 2Mb, 4Mb, 8Mb, 32Mb, 64Mb, 128Mb. | ||
| + | |||
| + | ==Component Pack== | ||
| + | |||
| + | STORAGE | ||
==Detailed description== | ==Detailed description== | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
''No detailed description exists yet for this component'' | ''No detailed description exists yet for this component'' | ||
==Examples== | ==Examples== | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| Line 35: | Line 59: | ||
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:]] - | + | | width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL |
| width="90%" | Status | | width="90%" | Status | ||
|- | |- | ||
| Line 145: | Line 169: | ||
|- | |- | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:]] - | + | | width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL |
| width="90%" | Blocking | | width="90%" | Blocking | ||
|- | |- | ||
| Line 201: | Line 225: | ||
| colspan="2" | Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | | colspan="2" | Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | ||
|- | |- | ||
| − | | width="10%" align="center" | [[File:]] - | + | | width="10%" align="center" | [[File:Fc9-bool-icon.png]] - BOOL |
| width="90%" | Blocking | | width="90%" | Blocking | ||
|- | |- | ||
| Line 250: | Line 274: | ||
|- | |- | ||
| colspan="2" | Initialises the SPI bus ready for communications. | | colspan="2" | Initialises the SPI bus ready for communications. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
|- | |- | ||
| Line 278: | Line 289: | ||
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]] | | width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]] | ||
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties''' | | width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties''' | ||
| + | |- | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Flash Properties | ||
|- | |- | ||
|- | |- | ||
| Line 294: | Line 309: | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | SPI Properties | ||
| + | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-16-icon.png]] | ||
| Line 324: | Line 343: | ||
|- | |- | ||
| colspan="2" | Chip Select / Slave Select Pin Master Mode: General purpose output pin used to select the remote SPI device. Slave Mode: Hardware chip select pin input used to select the SPI device. | | colspan="2" | Chip Select / Slave Select Pin Master Mode: General purpose output pin used to select the remote SPI device. Slave Mode: Hardware chip select pin input used to select the SPI device. | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Simulation | ||
| + | |- | ||
| + | |- | ||
| + | | width="10%" align="center" | [[File:Fc9-type-7-icon.png]] | ||
| + | | width="90%" | Simulate Comms | ||
| + | |- | ||
| + | | colspan="2" | Decides how the simulation handles the data. No - Do no SPI simulation and allow all simulation data to come from a local text file. Yes - Use SPI simulation for use with Injector components etc. | ||
| + | |- | ||
| + | | width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]] | ||
| + | | width="90%" style="background-color:#EAE1EA; color:#4B008D;" | File Simulation | ||
| + | |- | ||
|- | |- | ||
| width="10%" align="center" | [[File:Fc9-type-10-icon.png]] | | width="10%" align="center" | [[File:Fc9-type-10-icon.png]] | ||
| Line 339: | Line 371: | ||
|- | |- | ||
| colspan="2" | | | colspan="2" | | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|} | |} | ||
Latest revision as of 17:24, 9 November 2022
| Author | Matrix TSL |
| Version | 1.0 |
| Category | Storage |
Contents
Serial Flash (W25) component
Component to allow support for the Winbond W25 range of SPI Flash devices. Compatible with various sizes of Flash including: 2Mb, 4Mb, 8Mb, 32Mb, 64Mb, 128Mb.
Component Pack
STORAGE
Detailed description
No detailed description exists yet for this component
Examples
No additional examples
Downloadable macro reference
|
WriteControl |
| Enables or disables writing for things like erasing and programming. Writes must be enabled after a power on reset and again after an erase command. | |
 - BOOL
|
Status |
| 1 = Write Enabled, 0 = Write Protected | |
 - VOID
|
Return |
|
|
ReadStatus |
| Reads one of the internal status registers on the device | |
 - BYTE
|
Reg |
| Selects which status register to read, 0 = Status or 1 = Status 2. | |
| - BYTE
|
Return |
|
|
ReadDataByte |
| Reads a single data byte from the specified address. | |
 - UINT
|
PageAddress |
| Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | |
| - BYTE
|
ByteAddress |
| A7-A0 : 8-bit Address within the page - Range 0x00 - 0xFF | |
| - BYTE
|
Return |
|
|
ReadUniqueID |
| Reads the 8-byte unique identifier from the IC. Useful if you need each board to have it's own guarenteed unique address or identifier. | |
| - BYTE
|
ID |
| 8-Byte data array to store the unique ID read back from the IC. | |
| - VOID
|
Return |
|
|
WriteDataArray |
| Writes an array of data bytes atarting at the specified address. Writes must be enabled and memory locations must be erased for data writes to function correctly. Note that all bytes will be written to the same page. | |
| - UINT
|
PageAddress |
| Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | |
| - BYTE
|
ByteAddress |
| A7-A0 : 8-bit Address within the page - Range 0x00 - 0xFF | |
| - BYTE
|
Count |
| Number of bytes to write. | |
| - BYTE
|
Data |
| - VOID
|
Return |
|
|
EraseChip |
| Erases all data stored on the chip. Chip erase takes between 20 seconds and 100 seconds to complete. Blocking mode is recommended to ensure write cycle is complete. | |
| - BOOL
|
Blocking |
| Controls if the macro blocks until the erase cycle is complete. 0 = Don't Wait, 1 = Wait | |
| - VOID
|
Return |
|
|
WriteDataByte |
| Writes a single data byte to the specified address. Writes must be enabled and memory locations must be erased for data writes to function correctly. | |
| - UINT
|
PageAddress |
| Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | |
| - BYTE
|
ByteAddress |
| A7-A0 : 8-bit Address within the page - Range 0x00 - 0xFF | |
| - BYTE
|
Data |
| Data byte to write | |
| - VOID
|
Return |
|
|
EraseBlock |
| Erases a block of data stored on the chip. Erase takes between 45 milliseconds and 2000 milliseconds to complete. Blocking mode is recommended to ensure write cycle is complete. | |
| - BYTE
|
EraseMode |
| 0=4KB / 1=32KB / 2=64KB | |
| - UINT
|
PageAddress |
| Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | |
| - BOOL
|
Blocking |
| Controls if the macro blocks until the erase cycle is complete. 0 = Don't Wait, 1 = Wait | |
| - VOID
|
Return |
|
|
ReadDataArray |
| Reads up to 256 data bytes starting from the specified address. Note that all bytes will be read from the same page. | |
| - UINT
|
PageAddress |
| Address bits A23-A8 : 16-bit Address - Range 0x0000 - 0xFFFF | |
| - BYTE
|
ByteAddress |
| A7-A0 : 8-bit Address within the page - Range 0x00 - 0xFF | |
| - BYTE
|
Count |
| Number of bytes to read. | |
| - BYTE
|
Data |
| Byta array to store the incoming read data. | |
| - VOID
|
Return |
|
|
Initialise |
| Initialises the SPI bus ready for communications. | |
| - VOID
|
Return |
Property reference
|
Properties |
|
Flash Properties |
|
Memory Size |
| Sets the size of the flash memory available on the chip. | |
|
Number Bytes |
|
|
Number Pages |
|
|
SPI Properties |
|
|
Channel |
| SPI Channel selector | |
|
|
Prescale |
| Prescale option selector | |
|
MOSI |
| SPI Data Out Pin SDO - Also Known as Master Out Slave In (MOSI) when used in Master mode. | |
|
|
MISO |
| SPI Data In Pin SDI - Also Known as Master In Slave Out (MISO) when used in Master mode. | |
|
|
CLK |
| SPI Clock Pin CLK - The Clock signal is driven by the SPI master. | |
|
|
CS / SS |
| Chip Select / Slave Select Pin Master Mode: General purpose output pin used to select the remote SPI device. Slave Mode: Hardware chip select pin input used to select the SPI device. | |
|
|
Simulation |
|
Simulate Comms |
| Decides how the simulation handles the data. No - Do no SPI simulation and allow all simulation data to come from a local text file. Yes - Use SPI simulation for use with Injector components etc. | |
|
|
File Simulation |
|
Simulation File |
| Name of file to use to hold the contents of the simulated flash memory. $(srcdir) assigns the file to the same folder as the Flowcode project file. | |
|
|
Unique ID Lower 32-bit |
|
|
Unique ID Upper 32-bit |
