' ********************************************************************** ' * File: uk_BAS51_049.BAS * ' * Version: 1.1 * ' * Date: 07.09.11 * ' * Development Tools: Bascom 8051 COMP.,IDE 2.0.14.0 + FLIP 2.4.6 * ' * Cards: GMM 5115 + GMM TST3 * ' * Developed by: GRIFO(r) Italian Technology * ' * via Dell'Artigiano 8/6 * ' * 40016 S. Giorgio di Piano (BO) * ' * Tel. +39 051 892052 Fax. +39 051 893661 * ' * http://www.grifo.com http://www.grifo.it * ' * Author: Gianluca Angelini * ' ********************************************************************** ' Example program 049 of BASCOM 8051 course. ' Test and management program for SPI EEPROM Microchip 25LC040, at byte level, ' low level, without BASCOM instructions. ' It performs the foundamental operations on the component by using a software ' SPI interface and by interacting with user on a serial console provided ' of monitor and keyboard with a fixed physical protocol at 19200 Baud, 8 Bit ' x chr, 1 Stop bit, No parity. ' This console can be another system capable to support a serial RS 232 ' communication. In order to simplify the use it can be used a PC provided of ' one COMx line, that execute a terminal emulation program as HYPERTERMINAL or ' the homonym modality provided by BASCOM 8051 (see IDE Configuration). ' The program works only when the GMM 5115 is mounted on Z2 socket of GMM TST3!! ' ' Added instructions: None. ' ' 07/09/11: uk_BAS51_049.BAS - Ver 1.1 - By G.A. ' First version. ' ' '**************************** IDE Configurations ******************************* ' NOTE: in order to correctly use this demo program, please execute the following ' steps: ' 1) Check the availability of 89C5115.DAT file into the directory where the ' BASCOM 8051 is installed and copy it if not present. ' 2) Into the window "Options | Compiler | Misc" set: ' Register File = 89C5115.DAT ' Byte End(Hex) = A0 ' Size warning = selected at 16384 (=4000H) ' 3) Into the window "Options | Communication" set: ' COM port = the PC line connected to GMM 5115, through GMM TST3 ' Baudrate = 19200 ' Parity = None ' Databits = 8 ' Stopbit = 1 ' Handshake = None ' Emulation = TTY ' Font = Terminal, Normal, 12 points, white colour ' Backcolor = Navy ' Run emulator modal = not selected ' 4) At the end of compilation, after the code is programmed on GMM 5115, select ' RUN mode and open the terminal emulation window of BASCOM 8051 with the ' option: Tools | Terminal emulator (Ctrl+T) and then reset or powen on the ' Mini Module. '************************* Compiler directives ********************************* $regfile "89C5115.DAT" ' Definitions file for used microcontroller $romstart = &H0 ' Code start address on FLASH $iramstart = &H0 ' Data start address on internal RAM $ramstart = &H0 ' Data start address on external RAM $ramsize = &H100 ' External RAM size $crystal = 14745600 ' Microcontroller crystal frequency $large ' Code size > 2K $map ' Generate debug information $baud = 19200 ' Serial communication speed: 19200 Baud ' Other parameters fixed to: 8 bit x chr ' 1 Stop bit ' No parity '******************************* Definitions *********************************** ' The resources used by program are connected as described in following table. ' !!! Note: On GMM TST3 the jumpers must be set in following positions: ' J1 in 2-3 ; J2 in 1-2 ; J3 in 1-2 ; J5 in 2-3 ; J7 in 2-3 ; J8 in 2-3 ' J9 in 2-3!!! ' ' 25LC040 GMM TST3 pin Z2 pin Signal Signal ' signal resource GMM TST3 GMM 5115 GMM 5115 uP ' /CS CN4.1 32 26 P1.1 ADC1 T2EX P1.1 ' SCK CN4.4 31 25 P1.2 ADC2 ECI P1.2 ' SI CN4.3 30 24 P1.3 ADC3 CEX0 P1.3 ' SO CN4.6 29 23 P1.4 ADC4 CEX1 P1.4 ' Vcc CN4.18 34 28 +5 Vdc Vcc ' VSS CN4.17 20 14 GND GND ' ' Signal pin COMx pin CN5 pin Z1 pin Signal Used up ' PC DB9 GMM TST3 GMM TST3 GMM 5115 GMM 5115 signal ' TX 3 3 9 3 RxD RS232 P3.0 ' RX 2 2 10 4 TxD RS232 P3.1 ' GND 5 5 20 14 GND GND ' This table shows that the connection cable between PC COM line and CN5 of ' GMM TST3 is a normal pin to pin cable or direct. Grifo(r) can supply it by ' requesting the CCR 9+9E code. Pincs Alias P1.1 ' Bit with output signal connected to /CS of EEPROM Pinsck Alias P1.2 ' Bit with output signal connected to SCK of EEPROM Pinsi Alias P1.3 ' Bit with output signal connected to SI of EEPROM Pinso Alias P1.4 ' Bit with input signal connected to SO of EEPROM Pinrx Alias P3.0 ' Signal connected to GMM 5115 RxD Pintx Alias P3.1 ' Signal connected to GMM 5115 TxD '************************* Constants declaration ******************************* '************************* Variables declaration ******************************* Dim Hlpb As Byte ' General purpose help byte variable Dim Choice As Byte ' Selected operation Dim Spibyte As Byte ' Byte to communicate with SPI interface Dim Addspi As Word ' Address to send with SPI interface Dim Datspi As Byte ' Data to communicate on SPI interface '************************ Subroutines declaration ****************************** Declare Sub Ask_key() ' Ask and wait a key pressure Declare Sub Ini_spi() ' Initialize lines used for the software SPI interface Declare Sub Comin_spi() ' Acquire a byte from software SPI interface Declare Sub Comout_spi(spibyte As Byte) ' Send a byte on software SPI interface Declare Sub Read_spiee() ' Read a byte from SPI EE Declare Sub Write_spiee() ' Write a byte on SPI EE Declare Sub Enawr_spiee() ' Enable write on SPI EE Declare Sub Diswr_spiee() ' Disable write on SPI EE '****************************** Main program *********************************** Main: Pinrx = 1 ' Initialize signals for serial communication Pintx = 1 ' as digital inputs Call Ini_spi() ' Initialize lines used for software SPI interface Print ' Separate from previous visualization by showing 2 empty new line on console Print Print " 25LC040 SPI EEPROM management with GMM 5115 + GMM TST3" Print "Mount Mini Module on Z2 of GMM TST3, connect EEPROM to CN4 as described in" Print " electric diagram." Do ' Begin endless loop Print ' Shows menu with available operations Print "R -> Read location" Print "W -> Write location" Print "E -> Enable write" Print "D -> Disable write" Print "Perform the choice by pushing the associated key: "; Choice = Waitkey() ' Wait selection of operation to execute Printbin Choice ' Shows performed choice Print If Choice >= "a" Then ' If choice is lower case Choice = Choice And &HDF ' Convert it in upper case End If Print ' Separate menu from following visualizations Select Case Choice ' Check converted choice Case "R": ' Selected operation is read EE location Input "Addrress of location to read (0..511): " , Addspi Call Read_spiee() ' Read byte from SPI EEPROM Print "Read data= " ; Datspi Call Ask_key() ' Ask and wait a key pressure on console to allow results reading Case "W": ' Selected operation is write EE location Input "Addrress of location to write (0..511): " , Addspi Input "Data to write (0..255): " , Datspi Call Write_spiee() ' Write byte on SPI EEPROM Print "Write performed." Call Ask_key() ' Ask and wait a key pressure on console to allow results reading Case "E": ' Selected operation is enable erase and write operations Call Enawr_spiee() ' Enable erase and write operations on SPI EEPROM Print "Write operations enabled." Call Ask_key() ' Ask and wait a key pressure on console to allow results reading Case "D": ' Selected operation is disable erase and write operations Call Diswr_spiee() ' Enable erase and write operations on SPI EEPROM Print "Write operations disabled." Call Ask_key() ' Ask and wait a key pressure on console to allow results reading Case Else: ' Selected operation is not valid Printbin &H07 ' Generate an advise BEL on console End Select Loop ' End endless loop End '*************************** End of main program ******************************* '*********************** Subroutines used by program *************************** ' Require and wait a key pressure on console ' Input: None ' Output: None Sub Ask_key() Print "Press a key to continue..."; Hlpb = Waitkey() Print End Sub ' Initialize signals and variables used for the SPI interface managed by ' software ' Input: None ' Output: None Sub Ini_spi() ' Connection of software SPI interface signals (see on line help and previous ' table for further information) Pinso = 1 ' Initialize P1.4=SO as digital input Pinsck = 0 ' Initialize P1.2=SCK as digital output at low level Pinsi = 0 ' Initialize P1.3=SI as digital output at low level Pincs = 1 ' Initialize P1.1=/CS as digital output at high level End Sub ' Communicate on SPI interface managed by software by receiving a byte from ' connected device. The 8 bits of byte are acquired on high level of SCK ' signal, with MSB first. ' Input: None ' Output: Spibyte = Acquired byte Sub Comin_spi() For Hlpb = 1 To 8 ' Loop repeated for all the bits to communicate Shift Spibyte , Left , 1 ' Update current bit of received data Pinsck = 1 ' SCK signal at high level Spibyte.0 = Pinso ' Get current bit from SO signal and save it on received data Pinsck = 0 ' SCK signal at low level Next Hlpb End Sub ' Communicate on SPI interface managed by software by sending a byte to ' connected device. The 8 bits of byte are set on low level of SCK ' signal, with MSB first. ' Input: Spibyte = Byte to send ' Output: None Sub Comout_spi(spibyte As Byte) For Hlpb = 1 To 8 ' Loop repeated for all the bits to communicate Pinsi = Spibyte.7 ' Set current bit status to send on SI signal Pinsck = 1 ' SCK signal at high level Shift Spibyte , Left , 1 ' Update current bit of data to send Pinsck = 0 ' SCK signal at low level Next Hlpb End Sub ' Read a byte from 25LC040 SPI EEPROM. ' Input: Addspi = EEPROM location address to read ' Output: Datspi = data read from EEPROM Sub Read_spiee() Pincs = 0 ' /CS signal at low level Spibyte = High(addspi) ' Obtain high byte of EEPROM address to read Shift Spibyte , Left , 3 Spibyte = Spibyte Or &H03 ' Add READ command code Call Comout_spi(spibyte) ' Send to EEPROM the byte with high part of address and command Spibyte = Low(addspi) ' Obtain low byte of EEPROM address to read Call Comout_spi(spibyte) ' Send to EEPROM the byte with low part of address Call Comin_spi() ' Read byte from EEPROM Datspi = Spibyte ' Return read data Pincs = 1 ' /CS signal at high level End Sub ' Write a byte to 25LC040 SPI EEPROM. ' Input: Addspi = EEPROM location address to write ' Datspi = data to write on EEPROM ' Output: None Sub Write_spiee() Pincs = 0 ' /CS signal at low level Spibyte = High(addspi) ' Obtain high byte of EEPROM address to read Shift Spibyte , Left , 3 Spibyte = Spibyte Or &H02 ' Add READ command code Call Comout_spi(spibyte) ' Send to EEPROM the byte with high part of address and command Spibyte = Low(addspi) ' Obtain low byte of EEPROM address to read Call Comout_spi(spibyte) ' Send to EEPROM the byte with low part of address Spibyte = Datspi ' Save data to write in byte to send Call Comout_spi(spibyte) ' Send to EEPROM byte to write Pincs = 1 ' /CS signal at high level Waitms 10 ' Wait end of write time for SPI EEPROM (5 msec on data sheet) End Sub ' Enable write operations on 25LC040 SPI EEPROM ' Input: None ' Output: None Sub Enawr_spiee() Pincs = 0 ' /CS signal at low level Spibyte = &H06 ' WREN command code (enable write operation) Call Comout_spi(spibyte) ' Send to EEPROM the byte with command Pincs = 1 ' /CS signal at high level End Sub ' Disable write operations on 25LC040 SPI EEPROM ' Input: None ' Output: None Sub Diswr_spiee() Pincs = 0 ' /CS signal at low level Spibyte = &H04 ' WRDI command code (disable write operation) Call Comout_spi(spibyte) ' Send to EEPROM the byte with command Pincs = 1 ' /CS signal at high level End Sub '******************* End of subroutines used by program ************************