.. image:: https://github.com/eblot/pyspiflash/workflows/Python%20package/badge.svg :alt: Python package build status
SPI data flash device drivers (pure Python)
SPI flash devices, also known as DataFlash are commonly found in embedded products, to store firmware, microcode or configuration parameters.
PySpiFlash comes with several pure Python drivers for those flash devices, that demonstrate use of SPI devices with PyFtdi. It could also be useful to dump flash contents or recover from a bricked devices.
.. _PySpiFlash : https://github.com/eblot/pyspiflash .. _Python: http://python.org/ .. _PyFtdi : https://github.com/eblot/pyftdi
============= ======= ========== ======== ====== ======= ========== ========== Vendor Atmel Atmel Macronix SST Winbond Micron Adesto
DataFlash AT45 AT25 MX25L SST25 W25Q N25Q AT25XE041B ============= ======= ========== ======== ====== ======= ========== ========== Status Tested Tested Tested Tested Tested Tested Tested
Sizes (MiB) 2,4 2,4,8 2,4,8,16 2,4 2,4 8 0.5
Read (KiB/s) 1278 1279 1329 642 1252 1315 1695
Write (KiB/s) 56 64 71 2 63 107 32
Erase (KiB/s) 60 63 31 500 60 84 28 ============= ======= ========== ======== ====== ======= ========== ==========
Notes about performances ........................
Supporting new flash devices of series '25' ........................................... Many flash devices support a common subset to for read/write/erase operations. Critical differences appear with lock and protection features, and with security features. An NDA is often required to obtain details about the advanced security features of these devices.
It should be nevertheless quite easy to add support for new flash device variants:
match
method in the PyFtdi flash device API should be the first to look
at to detect more compatible flash devices.Identification The SPI device driver is automatically selected based on the detected SPI flash device
Read Read byte sequences of any size, starting at any location from the SPI flash device
Write Write arbitrary byte sequences of any size, starting at any location to the SPI flash device
Erase Erase SPI flash device blocks, whose size depend on the capabilities of the flash device, typically 4KiB and/or 64KiB.
Unlock Unlock any protected flash device sectors
Note about previous releases ............................
If you have no choice but using previous releases of Python (including Python 2.x) or PyFTDI , please checkout the latest PySpiFlash 0.4.1 which provides support for these deprecated environmement, but is no longer actively maintained.
PySpiFlash heavily relies on PyFtdi module to access the SPI flash device. The PyFtdi_ API has been changed several times, see the compatibility matrix below.
The setup.py
script should take care of those dependencies.
==================== =============== PySpiFlash version PyFtdi version
0.2. 0.9 .. 0.10 0.3. 0.11+ 0.4. 0.13.2+ 0.5. 0.20.0+ 0.6.* 0.42.0+ ==================== ===============