SPI DataFlash Library - Versionsgeschichte

Mat: /* Donate */

2017-08-31T03:18:46Z

‎Donate

Mat am 21. April 2015 um 14:59 Uhr

2015-04-21T14:59:26Z

Mat am 20. April 2015 um 19:53 Uhr

2015-04-20T19:53:56Z

Mat am 20. April 2015 um 19:53 Uhr

2015-04-20T19:53:18Z

Mat: /* Overview */

2015-04-20T16:07:01Z

‎Overview

Mat: /* Overview */

2015-04-20T16:06:09Z

‎Overview

Mat am 20. April 2015 um 16:03 Uhr

2015-04-20T16:03:29Z

Mat am 13. April 2015 um 21:19 Uhr

2015-04-13T21:19:53Z

Mat am 13. April 2015 um 02:52 Uhr

2015-04-13T02:52:12Z

Mat: Created page with "== Overview == This library reads/writes Atmel AT25DF-compatible SPI DataFlash ICs (ex. Spansion S25FL) through either a SW or HW SPI interface. The sample serves also as Firmwar..."

2015-04-12T05:01:20Z

Created page with "== Overview == This library reads/writes Atmel AT25DF-compatible SPI DataFlash ICs (ex. Spansion S25FL) through either a SW or HW SPI interface. The sample serves also as Firmwar..."

Neue Seite

== Overview ==
This library reads/writes Atmel AT25DF-compatible SPI DataFlash ICs (ex. Spansion S25FL) through either a SW or HW SPI interface.
The sample serves also as Firmware for the DataFlash Programmer application to initially write data into the memory.
It uploads a list of any type of files, image files are converted on the fly to the uncompressed 16-Bit color BIN format. To access the stored information, an include file with all the neccessary constants (memory position, size, image width & height) is generated.

The library has been developed and tested using an XMega-A1 Xplain board with a Spansion S25FL032P (32Mbit) dataflash mounted on it (U502!).

== How to use ==

Include the library. Set the options above the $include statement, needs the new Submode.
<pre>Config Submode = New

Const Flash_port_spi = PORTC
$include "SpiFlash.inc"</pre>

Init the DataFlash SPI interface
<pre>Sub Flash_init()</pre>

Read the 81 Bytes JEDEC RDID information
<pre>Sub Flash_get_info(byref Spiflashbuffer() As Byte)</pre>

Disable the SPI interface
<pre>Sub Flash_stop()</pre>

Erase a sector (64Kb block, upper 8 Bit of 24 Bit byte adress). The memory has to be erased (set to &HFF) before writing data.
<pre>Sub Flash_sector_erase(byval Sector As Byte)</pre>

Erase the whole memory
<pre>Sub Flash_bulk_erase()</pre>

Writes a page to the memory (256 Bytes) to a specified page adress (upper 16 Bit of 24 Bit byte adress).
<pre>Sub Flash_write_page(byval Address As Word , Byref Pagedata() As Byte)</pre>

Reads a block of data starting from the 24 Bit adress
<pre>Sub Flash_read(byval Address As Dword , Byref Spiflashbuffer() As Byte , Byval Length As Word)</pre>

Reads a block of data from the flash memory to an SRAM adress
<pre>Sub Flash_readto(byval Sourceaddress As Dword , Byval Destinationaddress As Dword , Byval Length As Dword)</pre>

Start an asynchronous read sequence. Data can be read byte-wise from the 24 Bit start adress until Flash_endread() is called.
<pre>Sub Flash_beginread(byval Address As Dword)</pre>

Reads a Byte (needs Flash_beginread() first)
<pre>Function Flash_readbyte() As Byte</pre>

Stop a read sequence
<pre>Sub Flash_endread()</pre>

=== Options ===

=== Electrical connection ===
[[File:FlashConnectionSchem.jpg|thumb|frameless|SPI DataFlash connection schematic]]

== Sample ==
<pre>$regfile = "xm128a1def.dat"
$crystal = 32000000
$hwstack = 64
$swstack = 64
$framesize = 64
Config Submode = New

Const False = 0
Const True = 1
$include "XMegaPll.inc"

Config Com1 = 115200 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
Open "COM1:" For Binary As #1

' use the watchdog for communication timeouts
Config Watchdog = 1000

Const Flash_port_ss = Portq ' Xplained DataFlash SS
Const Flash_pin_ss = 2
Const Flash_enable_statusled = True
$include "SPI-Flash.inc"

Dim Flashbuffer(256) As Byte
Dim Shakedhands As Boolean
Dim Tempbyte As Byte , Tempword As Word , Tempdword As Dword

Flash_init

Do
' wait for command
Inputbin #1 , Tempbyte
Select Case Tempbyte

' Handshake/Exit
Case &HAA:
Shakedhands = Not Shakedhands ' some kind of accidental write protection
Printbin #1 , &HF0 ' ack

' erase a sector (address bits 23..16)
Case &H01:
Reset Watchdog
Start Watchdog
Inputbin #1 , Tempbyte ' read sector address
Stop Watchdog
If Shakedhands = True Then Flash_sector_erase Tempbyte
Printbin #1 , &HF0

' erase whole memory
Case &H02:
If Shakedhands = True Then Flash_bulk_erase
Printbin #1 , &HF0

' write a page (256 Bytes, address bits 23..8)
Case &H03:
Reset Watchdog
Start Watchdog
Inputbin #1 , Tempword ' read page address
Inputbin #1 , Flashbuffer(1) ; 256 ' read 256 bytes page data
Stop Watchdog
Swap Tempword
If Shakedhands = True Then Flash_write_page Tempword , Flashbuffer(1)
Printbin #1 , &HF0

' read a page (256 Bytes, address bits 23..8)
Case &H04:
Reset Watchdog
Start Watchdog
Inputbin #1 , Tempword ' read page address
Stop Watchdog
Swap Tempword
Tempdword = Tempword
Shift Tempdword , Left , 8
If Shakedhands = True Then Flash_read Tempdword , Flashbuffer(1) , 256
Printbin #1 , Flashbuffer(1) ; 256 ' write page data

' read the device ID data (81 Bytes)
Case &H05:
If Shakedhands = True Then Flash_get_info Flashbuffer(1)
Printbin #1 , Flashbuffer(1) ; 81

End Select
Loop</pre>

== DataFlash Programmer ==
[[File:SpiDataFlashProgrammer.jpg|thumb|frameless|SPI DataFlash Programmer application]]

== Donate ==
This Software is [http://en.wikipedia.org/wiki/Donationware Donationware].
<paypal>1</paypal>
[[About|See here]] for more informations

== Download ==
* [http://www.braunecker.at/downloads/dataflash/SpiFlash.zip SPI DataFlash Library 1.0]

@@ Zeile 268: / Zeile 268: @@
 "Write to file..." writes the resulting data stream into a binary file instead of programming a memory.
 At least, a file list in .txt format (one file path per line), containing the files to write, can be saved or loaded.
 == Download ==
 * [http://www.braunecker.at/downloads/dataflash/SpiFlash.zip SPI DataFlash Library 1.0]

← Nächstältere Version		Version vom 21. April 2015, 14:59 Uhr
Zeile 5:		Zeile 5:

	The library has been developed and tested using an XMega-A1 Xplained board with a Spansion S25FL032P (32Mbit) dataflash mounted on it.		The library has been developed and tested using an XMega-A1 Xplained board with a Spansion S25FL032P (32Mbit) dataflash mounted on it.
		+
		+
		+	[http://www.mcselec.com/index2.php?option=com_forum&Itemid=59&page=viewtopic&t=12892 Forum thread]
		+

	== How to use ==		== How to use ==

@@ Zeile 81: / Zeile 81: @@
 <pre>Const Flash_pin_sdo = 5 (2)</pre>
 <pre>Const Flash_pin_sdi = 6 (3)</pre>
 (HW SPI) If the memory's SS signal is not connected to the HW SPI CS pin, the correct pin needs to be set:

@@ Zeile 10: / Zeile 10: @@
 Include the library. Set the options above the $include statement, needs the new Submode.
 <pre>Config Submode = New
 Const Flash_port_spi = PORTC
@@ Zeile 61: / Zeile 62: @@
 === Options ===
 Options and settings need to be set before the $include-statement, every setting has a default value that will be used if not specified otherwise. (in the list below the default values for the ATXMega are shown, values for ATMega are written in brackets () if applicable).
 Set to true to use software SPI instead of hardware modules, any GPIOs will work.
 <pre>Const Flash_use_soft_spi = False</pre>
 False only configures the SS pin, does not enable and configure the SPI interface, this needs to be done manually (useful if the memory shares the SPI interface with other hardware).
 <pre>Const Flash_init_spi = True</pre>
-Sets the port of the SPI interface. (AtMega:
 <pre>Const Flash_port_spi = Portc (Portb)</pre>
 Set the SPI pins (CS, CLK, SDO and SDI are set to the hardware SPI pins by default)
@@ Zeile 80: / Zeile 85: @@
 <pre>Const Flash_port_ss = Flash_port_spi</pre>
 <pre>Const Flash_pin_ss = Flash_pin_cs</pre>
 Enable the status LED. Active during ongoing transmissions.
 <pre>Const Flash_enable_statusled = False</pre>
 Invert the status LED (active low)
 <pre>Const Flash_invert_statusled = False</pre>
 Set the pin of the status LED

@@ Zeile 4: / Zeile 4: @@
 It uploads a list of any type of files, image files are converted on the fly to the uncompressed 16-Bit color BIN format. To access the stored information, an include file with all the neccessary constants (memory position, size, image width & height) is generated.
-The library has been developed and tested using an XMega-A1 Xplained board with a Spansion S25FL032P (32Mbit) dataflash mounted on it (U502!).
+The library has been developed and tested using an XMega-A1 Xplained board with a Spansion S25FL032P (32Mbit) dataflash mounted on it.
 == How to use ==

@@ Zeile 1: / Zeile 1: @@
 == Overview ==
 This library reads/writes Atmel AT25DF-compatible SPI DataFlash ICs (ex. Spansion S25FL) through either a SW or HW SPI interface.
-The sample serves also as Firmware for the DataFlash Programmer application to initially write data into the memory.
+The sample serves also as Firmware for the DataFlash Programmer application to write data to the memory.
 It uploads a list of any type of files, image files are converted on the fly to the uncompressed 16-Bit color BIN format. To access the stored information, an include file with all the neccessary constants (memory position, size, image width & height) is generated.

@@ Zeile 99: / Zeile 99: @@
 == Sample ==
 <pre>$regfile = "xm128a1def.dat"
 $crystal = 32000000
 $hwstack = 64
 $swstack = 64
 $framesize = 64
 Config Submode = New
 Const False = 0
 Const True = 1
-Config Com1 = 115200 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
+' XMega settings
-Open "COM1:" For Binary As #1
+#if _xmega = True
-' use the watchdog for communication timeouts
+   ' use the watchdog for communication timeouts
-Config Watchdog = 1000
+   Config Watchdog = 1024
-Const Flash_port_ss = Portq                                                     ' Xplained DataFlash SS
+Const Flash_enable_statusled = True                                             '
 $include "SPI-Flash.inc"
 Dim Flashbuffer(256) As Byte
 Dim Shakedhands As Boolean
-Dim Tempbyte As Byte , Tempword As Word , Tempdword As Dword
+Dim Sector As Byte , Page As Word , Address As Dword
 Flash_init
@@ Zeile 130: / Zeile 149: @@
 Do
     ' wait for command
-    Inputbin #1 , Tempbyte
+    Inputbin #1 , Sector
-    Select Case Tempbyte
+    Select Case Sector
     ' Handshake/Exit
@@ Zeile 142: / Zeile 161: @@
        Reset Watchdog
        Start Watchdog
-       Inputbin #1 , Tempbyte                                                    ' read sector address
+       Inputbin #1 , Sector                                                    ' read sector address
        Stop Watchdog
-       If Shakedhands = True Then Flash_sector_erase Tempbyte
+       If Shakedhands = True Then Flash_sector_erase Sector
-       Printbin #1 , &HF0
+       Printbin #1 , &HF0                                                        ' ack
     ' erase whole memory
     Case &H02:
        If Shakedhands = True Then Flash_bulk_erase
-       Printbin #1 , &HF0
+       Printbin #1 , &HF0                                                        ' ack
     ' write a page (256 Bytes, address bits 23..8)
@@ Zeile 156: / Zeile 175: @@
        Reset Watchdog
        Start Watchdog
-       Inputbin #1 , Tempword                                                    ' read page address
+       Inputbin #1 , Page                                                    ' read page address
        Inputbin #1 , Flashbuffer(1) ; 256                                        ' read 256 bytes page data
        Stop Watchdog
-       Swap Tempword
+       Swap Page
-       If Shakedhands = True Then Flash_write_page Tempword , Flashbuffer(1)
+       If Shakedhands = True Then Flash_write_page Page , Flashbuffer(1)
-       Printbin #1 , &HF0
+       Printbin #1 , &HF0                                                        ' ack
     ' read a page (256 Bytes, address bits 23..8)
@@ Zeile 167: / Zeile 186: @@
        Reset Watchdog
        Start Watchdog
-       Inputbin #1 , Tempword                                                    ' read page address
+       Inputbin #1 , Page                                                    ' read page address
        Stop Watchdog
-       Swap Tempword
+       Swap Page
-       Tempdword = Tempword
+       Address = Page
-       Shift Tempdword , Left , 8
+       Shift Address , Left , 8
-       If Shakedhands = True Then Flash_read Tempdword , Flashbuffer(1) , 256
+       If Shakedhands = True Then Flash_read Address , Flashbuffer(1) , 256
        Printbin #1 , Flashbuffer(1) ; 256                                        ' write page data

@@ Zeile 4: / Zeile 4: @@
 It uploads a list of any type of files, image files are converted on the fly to the uncompressed 16-Bit color BIN format. To access the stored information, an include file with all the neccessary constants (memory position, size, image width & height) is generated.
-The library has been developed and tested using an XMega-A1 Xplain board with a Spansion S25FL032P (32Mbit) dataflash mounted on it (U502!).
+The library has been developed and tested using an XMega-A1 Xplained board with a Spansion S25FL032P (32Mbit) dataflash mounted on it (U502!).
@@ Zeile 61: / Zeile 61: @@
 === Options ===
-Options and settings need to be set before the $include-statement, every setting has a default value that will be used if not specified otherwise. (in the list below the default values are shown).
+Options and settings need to be set before the $include-statement, every setting has a default value that will be used if not specified otherwise. (in the list below the default values for the ATXMega are shown, values for ATMega are written in brackets () if applicable).
 Set to true to use software SPI instead of hardware modules, any GPIOs will work.
@@ Zeile 69: / Zeile 69: @@
 <pre>Const Flash_init_spi = True</pre>
-Sets the port of the SPI interface.
+Sets the port of the SPI interface. (AtMega:
-<pre>Const Flash_port_spi = Portc</pre>
+<pre>Const Flash_port_spi = Portc (Portb)</pre>
 Set the SPI pins (CS, CLK, SDO and SDI are set to the hardware SPI pins by default)
-<pre>Const Flash_pin_cs = 4</pre>
+<pre>Const Flash_pin_cs = 4 (0)</pre>
-<pre>Const Flash_pin_clk = 7</pre>
+<pre>Const Flash_pin_clk = 7 (1)</pre>
-<pre>Const Flash_pin_sdo = 5</pre>
+<pre>Const Flash_pin_sdo = 5 (2)</pre>
-<pre>Const Flash_pin_sdi = 6</pre>
+<pre>Const Flash_pin_sdi = 6 (3)</pre>
 (HW SPI) If the memory's SS signal is not connected to the HW SPI CS pin, the correct pin needs to be set:
@@ Zeile 89: / Zeile 89: @@
 Set the pin of the status LED
-<pre>Flash_statusled Alias Porte.0</pre>
+<pre>Flash_statusled Alias Porte.0 (Porta.0)</pre>
@@ Zeile 228: / Zeile 227: @@
 == DataFlash Programmer ==
 The SPI DataFlash Programmer application allows in-circuit programming of the memory over a serial connection. It uploads any types of files, images files (BMP, JPG, PNG, TIFF) can be converted to the uncompressed 16 Bit color BIN format on the fly when writing the data (standard).
-[[File:SpiDataFlashProgrammer.jpg|frameless|SPI DataFlash Programmer application]]
+[[File:SpiDataFlashProgrammer.jpg|SPI DataFlash Programmer application]]
 To use this application, the sample from above has to be programmed in the microcontroller, set up the SPI and the USART interface correctly.
 On the left side, choose the files to upload, rearrange them as you need and choose whether to convert image files to BIN by checking the box (initially checked for images) or upload them as they are by unchecking (does not affect other file types).

@@ Zeile 61: / Zeile 61: @@
 === Options ===
 === Electrical connection ===
-[[File:FlashConnectionSchem.jpg|thumb|frameless|SPI DataFlash connection schematic]]
+[[File:FlashConnectionSchem.jpg|width|600px|SPI DataFlash connection schematic]]
 == Sample ==
@@ Zeile 150: / Zeile 183: @@
     End Select
 Loop</pre>
 == DataFlash Programmer ==
-[[File:SpiDataFlashProgrammer.jpg|thumb|frameless|SPI DataFlash Programmer application]]
+The SPI DataFlash Programmer application allows in-circuit programming of the memory over a serial connection. It uploads any types of files, images files (BMP, JPG, PNG, TIFF) can be converted to the uncompressed 16 Bit color BIN format on the fly when writing the data (standard).