' ********************************************************************** ' * File: uk_BAS51_033.BAS * ' * Version: 1.1 * ' * Date: 29.11.10 * ' * 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 033 of BASCOM 8051 course. ' The program modulates the light intensity of the 16 LEDs available on the ' TIO 16 board that is connected to I/O connectors of GMM TST3. The modulation ' is the same for all the LEDs, it starts from completely off and increase to ' completely on and then it restarts continuosly. ' The program describe its functionalities 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!! ' Inside the program the terms that identify the used signals refers to electric ' diagram and technical manual of GMM TST3!! ' ' Added instructions: Config Timer0, On Timer0, Load Timer0, Enable Timer0, ' Start Timer0, Stop Timer0, Priority Set Timer0, ' Enable Interrupts, Return. ' ' 29/11/10: uk_BAS51_033.BAS - Ver 1.1 - By G.A. ' First version. ' ' '**************************** IDE Configurations ******************************* ' NOTE: in order to coorectly 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 following jumpers must be properly configured: ' 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!!! ' ' TIO 16 GMM TST3 pin Z2 pin Signal Used uP ' LED resource GMM TST3 GMM 5115 GMM 5115 signal ' LD1 CN4.2 33 27 P1.0 DSW1.1 T2 DL1 P1.0 ' LD2 CN4.1 32 26 P1.1 ADC1 T2EX P1.1 ' LD3 CN4.4 31 25 P1.2 ADC2 ECI P1.2 ' LD4 CN4.3 30 24 P1.3 ADC3 CEX0 P1.3 ' LD5 CN4.6 29 23 P1.4 ADC4 CEX1 P1.4 ' LD6 CN4.5 28 22 P1.5 ADC5 P1.5 ' LD7 CN4.8 27 21 P1.6 ADC6 P1.6 ' LD8 CN4.7 26 20 P1.7 ADC7 P1.7 ' LD9 CN4.15 25 19 P3.2 INT0 P3.2 ' LD10 CN4.16 24 18 P3.3 INT1 P3.3 ' LD11 CN4.13 23 17 P3.4 T0 P3.4 ' LD12 CN4.14 22 16 P3.5 T1 P3.5 ' LD13 CN4.11 21 15 P3.6 P3.6 ' LD14 CN4.12 19 13 P3.7 P3.7 ' LD15 CN4.9 14 8 P4.0 P4.0 ' LD16 CN4.10 15 9 P4.1 P4.1 ' ' 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 - ' 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. 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 Dirio As Byte ' Variable with digital I/O direction Dim Iod As Byte ' Variable with digital I/O status Dim Hlpb As Byte ' General purpose help variable Dim Modled As Byte ' Variable for current LEDs modulation Dim Modcnt As Byte ' Variable for LEDs modulation counter Dim Del As Byte ' Variable for delay on modulation change '************************ Subroutines declaration ****************************** Declare Sub Ini_pa(dirio As Byte) ' Initialize GMM TST3 port A Declare Sub Ini_pc(dirio As Byte) ' Initialize GMM TST3 port C Declare Sub Low_pac() ' Set low the 15 lines of GMM TST3 port A and C Declare Sub High_pac() ' Set high the 15 lines of GMM TST3 port A and C Declare Sub Ini_modled() ' Inizialize timer for periodic interrupt generation Declare Sub Set_modled() ' Define LEDs modulation '****************************** Main program *********************************** Main: Pinrx = 1 ' Initialize signals for serial communication Pintx = 1 ' as digital inputs Call Ini_pa(&H00) ' Initialize lines connected to port A as outputs Call Ini_pc(&H00) ' Initialize lines connected to port C as outputs Call Ini_modled() ' Inizialize timer for LEDs modulation Print ' Separate from previous visualization by showing an empty new line Print Print " Modulates light intensity on the 16 LEDs of TIO 16" Print "Mount Mini Module on Z2 of GMM TST3 and connect TIO 16 to CN4." Do ' Begin endless loop Print "Modulation in execution.."; Modled = &H00 ' Initialize for minimum modulation: LEDs completely off Do ' Loop that modulates LEDs from completely off to completely on Call Set_modled() ' Set current modulation=light intensity Incr Modled ' Increase modulation=intensity ' Perform a delay of about 20 msec in order to obtain a total time (from ' LEDs off to LEDs on) of about 5 sec in 256 steps: 256*20=5120 msec. The ' delay is realized with a calibrated loop, in fact the specific BASCOM ' instructions don't generate the right delays when there are interrupts ' enabled Del = 0 ' Reset loop counter for delay Do ' Start loop for delay Del = Del + 1 ' Increase loop counter for delay Loop Until Del > 16 ' Delay loop of about 20 msec completed Loop Until Modled = &H00 ' Repeat up to maximum modulation Print ' Signalize end of modulation Print "Modulation completed: LEDs completely on." Print Loop ' End endless loop Stop Timer0 ' Stop TIMER0 and associated functions '*************************** End of main program ******************************* '*********************** Subroutines used by program *************************** ' Initializes the 8 pins of uP connected to port A on CN4 of GMM TST3: ' PA.0 -> P1.0 PA.1 -> P1.1 PA.2 -> P1.2 PA.3 -> P1.3 ' PA.4 -> P1.4 PA.5 -> P1.5 PA.6 -> P1.6 PA.7 -> P1.7 ' with the I/O modality passed in dirio parameter (bit at 0=output at low ' level; bit at 1=input), by leaving unchanged the status of all the other ' lines. ' Note: On GMM 5115 the digital I/O are quasi-bidirectional and they don't have ' direction settable. Thus the subroutine doesn't set direction on these lines ' and it has been developed for compatibility and code exchange with other ' Mini Modules. Sub Ini_pa(dirio As Byte) P1 = &HFF ' Set lines direction Iod = P1 End Sub ' Initializes the 8 pins of uP connected to port C on CN4 of GMM TST3: ' PC.0 -> P3.2 PC.1 -> P3.3 PC.2 -> P3.4 PC.3 -> P3.5 ' PC.4 -> P3.6 PC.5 -> P3.7 PC.6 -> P4.0 PC.7 -> P4.1 ' with the I/O modality passed in dirio parameter (bit at 0=output at low ' level; bit at 1=input), by leaving unchanged the status of all the other ' lines. ' Note: On GMM 5115 the digital I/O are quasi-bidirectional and they don't have ' direction settable. Thus the subroutine doesn't set direction on these lines ' and it has been developed for compatibility and code exchange with other ' Mini Modules. Sub Ini_pc(dirio As Byte) P3 = P3 Or &HFC ' Set direction of lines P3.2-P3.7 Iod = P3 P4 = P4 Or &H03 ' Set direction of lines P4.0-P4.1 Iod = P4 End Sub ' Set low the 15 lines of GMM TST3 port A and C on CN4 of the GMM TST3, by ' leaving unchanged the status of all the other lines. Sub Low_pac() P1 = &H00 ' Set low the lines of Port A,C on P1 P3 = P3 And &H03 ' Set low the lines of Port A,C on P3 P4 = P4 And &HFC ' Set low the lines of Port A,C on P4 End Sub ' Set high the 15 lines of GMM TST3 port A and C on CN4 of the GMM TST3, by ' leaving unchanged the status of all the other lines. Sub High_pac() P1 = &HFF ' Set high the lines of Port A,C on P1 P3 = P3 Or &HFC ' Set high the lines of Port A,C on P3 P4 = P4 Or &H03 ' Set high the lines of Port A,C on P4 End Sub ' Initialize periodic interrupt generation by TIMER0 of microcontroller, used ' for LEDs modulation on TIO 16. The remarks of this subroutine briefly specify ' the executed operations but detailed informations are available in data sheet ' of microcontroller and inside on line help of BASCOM. ' The 80 usec time has been selected by taking into account of the execution ' time of the interrupt service routine (equal to 75 usec) and leaving a small ' additional time (5 usec) for main program execution. Sub Ini_modled() Call High_pac() ' Set initial LEDs state for modulation=disabled=off Modled = 0 ' Set duty cycle = 0 for LEDs disabled Modcnt = 0 ' Clear LEDs modulation counter Config Timer0 = Timer , Gate = Internal , Mode = 2 ' TIMER0 as 8 bit timer with auto reload and internal activation On Timer0 Timer0_irq ' Define TIMER0 overflow interrupt service routine Load Timer0 , 98 ' Load time constant for 80 usec Priority Set Timer0 ' Set higher priority for TIMER0 interrupt Enable Interrupts ' General interrupts enable Start Timer0 ' Enable TIMER0 End Sub ' Define LEDs modulation, by cheking if it nust be performed and, when so it is, ' by enabling the TIMER0 periodic interrupt that manages the modulation. The ' modulation time is equal to duty cycle of interrupt generated signal and it ' is passed in global variable Modled (0..255) Sub Set_modled() Select Case Modled ' Check current modulation Case 0: ' Minimum modulation -> LEDs off Disable Timer0 ' Disable TIMER0 interrupt Call High_pac() ' Set high the 15 lines of port A and C on GMM TST3 Case 255: ' Maximum modulation -> LEDs on Disable Timer0 ' Disable TIMER0 interrupt Call Low_pac() ' Set low the 15 lines of port A and C on GMM TST3 Case Else: ' Modulation must be performed da effettuare Enable Timer0 ' Enable TIMER0 interrupt End Select End Sub ' Interrupt service routine associated to periodic TIMER0 overflow. ' It modulates the light intensity of LEDs on TIO 16 with a period of ' (80 usec*256)=20480 usec (equal to a frequency of about 50 Hz) and a ' variableed duty cycle variabile from 1 (0,4%) to 254 (99,6%), passed in ' global variable Modled Timer0_irq: Incr Modcnt ' Increase LEDs modulation counter If Modcnt = 0 Then ' If it is the beginning of modulated signal half-period Call Low_pac() ' Set low 15 lines of port A and C on GMM TST3 End If If Modcnt = Modled Then ' If it is the end of modulated signal half-period Call High_pac() ' Set high the 15 lines of port A and C on GMM TST3 End If Return '******************* End of subroutines used by program ************************