cab2a371fd2a7c05adeba87de8f53fbe3912c27f
[goodfet] / client / GoodFETSPI.py
1 #!/usr/bin/env python
2 # GoodFET SPI and SPIFlash Client Library
3
4 # (C) 2009 Travis Goodspeed <travis at radiantmachines.com>
5 #
6 # This code is being rewritten and refactored.  You've been warned!
7
8 import sys, time, string, cStringIO, struct, glob, serial, os;
9
10 from GoodFET import GoodFET;
11
12 class GoodFETSPI(GoodFET):
13     def SPIsetup(self):
14         """Move the FET into the SPI application."""
15         self.writecmd(0x01,0x10,0,self.data); #SPI/SETUP
16         
17     def SPItrans8(self,byte):
18         """Read and write 8 bits by SPI."""
19         data=self.SPItrans([byte]);
20         return ord(data[0]);
21     
22     def SPItrans(self,data):
23         """Exchange data by SPI."""
24         self.data=data;
25         self.writecmd(0x01,0x00,len(data),data);
26         return self.data;
27
28 class GoodFETSPI25C(GoodFETSPI):
29     #opcodes
30     WREN=0x06;
31     WRDI=0x04;
32     RDSR=0x05;
33     WRSR=0x01;
34     READ=0x03;
35     WRITE=0x02;
36     
37     def peek8(self,adr):
38         """Read a byte from the given address."""
39         data=self.SPItrans([self.READ,(adr>>8)&0xFF,adr&0xFF,0x00]);
40         return ord(data[3]);
41
42
43 class GoodFETSPIFlash(GoodFETSPI):
44     JEDECmanufacturers={0xFF: "MISSING",
45                         0xEF: "Winbond",
46                         0xC2: "MXIC",
47                         0x20: "Numonyx/ST",
48                         0x1F: "Atmel",
49                         0x01: "AMD/Spansion"
50                         };
51
52     JEDECdevices={0xFFFFFF: "MISSING",
53                   0xEF3015: "W25X16L",
54                   0xEF3014: "W25X80L",
55                   0xEF3013: "W25X40L",
56                   0xEF3012: "W25X20L",
57                   0xEF3011: "W25X10L",
58                   0xC22017: "MX25L6405D",
59                   0xC22016: "MX25L3205D",
60                   0xC22015: "MX25L1605D",
61                   0xC22014: "MX25L8005",
62                   0xC22013: "MX25L4005",
63                   0x204011: "M45PE10"
64                   };
65     
66     JEDECsizes={0x17: 0x800000,
67                 0x16: 0x400000,
68                 0x15: 0x200000,
69                 0x14: 0x100000,
70                 0x13: 0x080000,
71                 0x12: 0x040000,
72                 0x11: 0x020000
73                 };
74     
75     JEDECsize=0;
76
77     def SPIjedec(self):
78         """Grab an SPI Flash ROM's JEDEC bytes."""
79         data=[0x9f, 0, 0, 0];
80         data=self.SPItrans(data);
81         
82         self.JEDECmanufacturer=ord(data[1]);
83         self.JEDECtype=ord(data[2]);
84         self.JEDECcapacity=ord(data[3]);
85         self.JEDECsize=self.JEDECsizes.get(self.JEDECcapacity);
86         if self.JEDECsize==None:
87             self.JEDECsize=0;
88         self.JEDECdevice=(ord(data[1])<<16)+(ord(data[2])<<8)+ord(data[3]);
89         return data;
90     def SPIpeek(self,adr):
91         """Grab a byte from an SPI Flash ROM."""
92         data=[0x03,
93               (adr&0xFF0000)>>16,
94               (adr&0xFF00)>>8,
95               adr&0xFF,
96               0];
97         self.SPItrans(data);
98         return ord(self.data[4]);
99     def SPIpeekblock(self,adr):
100         """Grab a few block from an SPI Flash ROM.  Block size is unknown"""
101         data=[(adr&0xFF0000)>>16,
102               (adr&0xFF00)>>8,
103               adr&0xFF];
104         
105         self.writecmd(0x01,0x02,3,data);
106         return self.data;
107     
108     def SPIpokebyte(self,adr,val):
109         self.SPIpokebytes(adr,[val]);
110     def SPIpokebytes(self,adr,data):
111         #Used to be 24 bits, BE, not 32 bits, LE.
112         adranddata=[adr&0xFF,
113                     (adr&0xFF00)>>8,
114                     (adr&0xFF0000)>>16,
115                     0, #MSB
116                     ]+data;
117         #print "%06x: poking %i bytes" % (adr,len(data));
118         self.writecmd(0x01,0x03,
119                       len(adranddata),adranddata);
120         
121     def SPIchiperase(self):
122         """Mass erase an SPI Flash ROM."""
123         self.writecmd(0x01,0x81);
124     def SPIwriteenable(self):
125         """SPI Flash Write Enable"""
126         data=[0x06];
127         self.SPItrans(data);
128         
129     def SPIjedecmanstr(self):
130         """Grab the JEDEC manufacturer string.  Call after SPIjedec()."""
131         man=self.JEDECmanufacturers.get(self.JEDECmanufacturer)
132         if man==0:
133             man="UNKNOWN";
134         return man;
135     
136     def SPIjedecstr(self):
137         """Grab the JEDEC manufacturer string.  Call after SPIjedec()."""
138         man=self.JEDECmanufacturers.get(self.JEDECmanufacturer);
139         if man==0:
140             man="UNKNOWN";
141         device=self.JEDECdevices.get(self.JEDECdevice);
142         if device==0:
143             device="???"
144         return "%s %s" % (man,device);
145