' ****************************************************************
' * File:  k51term.pbas  -  Ver. 1.1                             *
' * Compilatore:  mikroBasic for PIC by mikroElektronica         *
' * IDE: mikroBasic for PIC by mikroElektronica                  *
' * Versione Compilatore: 1.1.6.0                                *
' * Schede: GMM 4620 + GMB HR168 + K51-AVR                       *
' *   GRIFO(R)   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  *
' * by Graziano Gaiba                              25.02.05      *
' ****************************************************************
'
' Questo demo permette di pilotare una periferica I2C BUS a bordo della K51-AVR,
' DS1621, attraverso il modulo mini-BLOCK GMB HR168 ed un mini modulo grifo(r).
' Il Ds1621 e' un termometro digitale programmabile, con risoluzione di mezzo
' grado Celsius, tutte le operazioni di programmazione e acquisizione della
' temperatura avvengono tramite l'interfaccia seriale sincrona I2C BUS.
' Il demo mostra sui display a 7 segmenti della K51-AVR la temperatura misurata.
'
'
' Rel 1.1 - by Graziano Gaiba
' Demo per l'utilizzo del DS1621 a bordo della K51-AVR usando una GMB HR168
' pilotata da un Mini Modulo GMM 4620
'
'
' ******************** Compiler definitions **********************
'
program k51term
'
' *************** Dichiarazione delle contanti *******************
'
const Saa1064 = $38                 ' Slave address SAA1064
const Wsaa1064 = $70                ' Slave address SAA1064 in Write
const Rsaa1064 = $71                ' Slave address SAA1064 in Read
'****************** Indirizzi registri Saa1064 ********************
const Ctb = 0                       ' Registro di controllo
const Dig1 = 1                      ' Cifra 1
const Dig2 = 2                      ' Cifra 2
const Dig3 = 3                      ' Cifra 3
const Dig4 = 4                      ' Cifra 4
'
' **********************************************************************
'
const Ds1621 = $4C                  ' Slave address DS1621
const Wds1621 = $98                 ' Slave address DS1621 in Write
const Rds1621 = $99                 ' Slave address DS1621 in Read
' ***************** Commands list of DS1621 ****************************
const Cfg = $AC                     ' Registro di configurazione DS1621
const Rtemp = $AA                   ' Lettura temperatura in 2 bytes
const Strct = $EE                   ' Inizia conversione temperatura
const Stpct = $22                   ' Ferma conversione temperatura
'
'
' ******************* Dichiarazione delle Variabili ********************
'
' Variabili di uso generico
dim Tmp as byte
'
' Cifre della temperatura
dim Units as byte
dim Hundreds as byte
dim Tenth as byte
'
' Usate per la gestione dell'I2C BUS hardware
dim i2c_buffer as byte[10]
'
' Conversione letta da DS1621
dim Temp_h as byte
dim Temp_l as byte
'
'
' ******************* Definizione delle procedure *********************
'
'
' Inizializzazione direzione segnali della CPU
sub procedure Init_cpu
    '
    ADCON1=$0f        ' Imposta come I/O digitale i pin AN0..12
    CMCON=$07         ' Imposta come I/O digitale RA0..4
' Gli ingressi optoisolati di CN1 sono:
' IN1-1 <-> RA0
' IN2-1 <-> RA1
' IN3-1 <-> RB0
' IN4-1 <-> RB1
' IN5-1 <-> RA4
' IN6-1 <-> RC0
' IN7-1 <-> RC1
' IN8-1 <-> RC5
    trisa.0=1
    trisa.1=1
    trisa.4=1
    trisb.0=1
    trisb.1=1
    trisc.0=1
    trisc.1=1
    trisc.5=1
' Gli ingressi optoisolati di CN2 sono:
' IN1-2 <-> RD0
' IN2-2 <-> RD1
' IN3-2 <-> RD2
' IN4-2 <-> RD3
' IN5-2 <-> RD4
' IN6-2 <-> RD5
' IN7-2 <-> RD6
' IN8-2 <-> RD7
    trisd=$ff
' Le uscite relays di CN3 sono:
' OUT A1 <-> RB4
' OUT A2 <-> RB5
' OUT B1 <-> RB6
' OUT B2 <-> RB7
' OUT C1 <-> RB3
' OUT C2 <-> RB2
    trisb=trisb and $03
' Le uscite relays di CN4 sono:
' OUT D1 <-> RA3
' OUT D2 <-> RC2 (J10 in posizione 3-4)
    trisa.3=0
    trisc.2=0
    ' Inizialzza modulo USART (8 bit, 19200 baud rate,
    ' no parity)
    Usart_init(19200)
end sub
'
'
' Invia una stringa di caratteri alla porta seriale
sub procedure print_USART(dim byref txt as char[255])
    dim i as byte
    dim l as byte

    l = txt[0]
    for i = 1 to l
        USART_Write(txt[i])
    next i
end sub
'
'
' Invia CR + LF
sub procedure print_CRLF
    USART_Write(10)
    USART_Write(13)
end sub
'
'
' Pulisce lo schermo, inviando 25 volte CR + LF.
sub procedure clrscr

    dim i as byte
    
    for i = 0 to 24
        print_CRLF
    next i
end sub
'
'
' Chiede la pressione di un tasto
sub procedure wait_key
    dim c as byte

    print_usart("Premere un tasto...")
    do
        nop
    loop until USART_Data_Ready = 1
    c = USART_Read
end sub
'
'
' Procedura per impostare lo stato dei relays sui connettori CN3 e CN4.
' A seconda del valore dei bits di port_val, ogni relay viene attivato
' (contatto chiuso) o disattivato (contatto aperto).
' I bit di port_val hanno il seguente significato:
' -- CN3
' port_val.0 pilota il relay OUT A1
' port_val.1 pilota il relay OUT A2
' port_val.2 pilota il relay OUT B1
' port_val.3 pilota il relay OUT B2
' port_val.4 pilota il relay OUT C1
' port_val.5 pilota il relay OUT C2
' -- CN4
' port_val.6 pilota il relay OUT D1
' port_val.7 pilota il relay OUT D2
'
' Ogni bit ha il seguente significato:
'   bit              Significato
'    0    Relay disattivato (contatto aperto)
'    1    Relay attivato (contatto chiuso)
sub procedure set_relays(dim port_val as byte)
' I relays sono pilotati in logica complementata , quindi anche port_val
' deve essere complementato
    port_val=port_val xor $ff
    portb.4=port_val.0
    portb.5=port_val.1
    portb.6=port_val.2
    portb.7=port_val.3
    portb.3=port_val.4
    portb.2=port_val.5

    porta.3=port_val.6

    portc.2=port_val.7
end sub
'
'
' Inizializza I2C BUS hardware
sub procedure I2CBUSInit
'
' Inizializza  I2C BUS
' Configura RC3 e RC4 come inputs
    trisc.3=1
    trisc.4=1
' Abilita modula SSP in master I2C BUS mode, clock 50 kHz
    sspstat.6=0
    sspadd=$32
    sspcon1=$28
end sub
'
'
' Genera I2C BUS start
sub procedure I2CBUSStart
    sspcon2.0=1
    while sspcon2.0=1
    wend
    pir1.3=0
end sub
'
'
' Genera I2C BUS start ripetuta
sub procedure I2CBUSRepStart
    sspcon2.1=1
    while sspcon2.1=1
    wend
    pir1.3=0
end sub
'
'
' Genera I2C BUS stop
sub procedure I2CBUSStop
    sspcon2.2=1
    while sspcon2.2=1
    wend
    pir1.3=0
end sub
'
'
' Invia il contenuto della variabile i2c_data all'I2C BUS
sub procedure I2CBUSSend(dim i2c_data as byte)
    sspbuf=i2c_data
' Attende completamento dell'ultima operaziane dell'interfaccia hardware I2C
    while pir1.3=0
    wend
    pir1.3=0
end sub
'
'
' Legge un dato da I2C BUS e lo restituisce
sub function I2CBUSGet as byte
    sspcon2.3=1
    while sspcon2.3=1
    wend
    result=sspbuf
' Attende completamento dell'ultima operaziane dell'interfaccia hardware I2C
    while pir1.3=0
    wend
    pir1.3=0
end sub
'
'
' Invia NOT acknowledge
sub procedure I2CBUSNACK
' Invia NOT acknowledge...
    sspcon2.5=1
    sspcon2.4=1
' Attende completamento dell'ultima operaziane dell'interfaccia hardware I2C
    while pir1.3=0
    wend
    pir1.3=0
end sub
'
'
' Invia acknowledge
sub procedure I2CBUSACK
' Invia acknowledge...
    sspcon2.5=0
    sspcon2.4=1
' Attende completamento dell'ultima operaziane dell'interfaccia hardware I2C
    while pir1.3=0
    wend
    pir1.3=0
end sub
'
'
' Indica che un acknowledge atteso non e' stato ricevuto.
sub procedure I2CBUSNotAck
    print_USART("Acknowledge not received.")
    print_crlf
' Disabilita I2CBUS
    sspcon1.5=0
end sub

'
'
' Legge un byte dal dispositivo il cui slave address e' contenuto nella
' variable i2c_slave e il cui indirizzo e' contenuto nella variabile i2c_addr.
' Il dato letto viene messo nella variabile i2c_val.
sub function I2CBUSReadByte(dim i2c_slave as byte, dim i2c_addr as byte) as byte
'
' Genera I2CBUS Start
    i2cbusstart
' Invia Slave Address
    i2cbussend(i2c_slave)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Invia indirizzo
    i2cbussend(i2c_addr)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Genera I2CBUS Start ripetuto
    i2cbusrepstart
' Invia Slave Address per la lettura
    i2cbussend(i2c_slave or $01)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Riceve il dato
    result = i2cbusget
' Invia NOT acknowledge.
    I2CBUSNACK
' Genera stop
    i2cbusstop
end sub
'
'
' Scrive un byte al dispositivo il cui slave address e' contenuto nella
' variablie i2c_slave e il cui indirizzo e' contenuto nella variabile i2c_addr.
' Il dato da scrivere viene messo nella variabile i2c_val.
sub procedure I2CBUSWriteByte(dim i2c_slave as byte, dim i2c_addr as byte,
                              dim i2c_data as byte)
'
' Genera I2CBUS Start
    i2cbusstart
' Invia Slave Address
    i2cbussend(i2c_slave)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Invia indirizzo
    i2cbussend(i2c_addr)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Invia il dato
    i2cbussend(i2c_data)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
' Genera stop
    i2cbusstop
end sub
'
'
' Invia una sequenza di bytes ad un dispositivo I2C BUS.
' Lo slave address deve essere contentuo nella variabile i2c_slave.
' L'utente puo' cambiare la dimensione dell'array nella lista parametri.
' Il numero di bytes da inviare va nella variabile i2c_to_send.
' L'utente deve verifcare che non avvengano eventuali overflow.
sub procedure I2CBUSWrite(dim i2c_slave as byte,
                          dim byref i2c_buffer as byte[10],
                          dim i2c_to_send as byte)

    dim i2c_cnt as byte
'
' Genera I2CBUS Start
    i2cbusstart
' Invia Slave Address
    i2cbussend(i2c_slave)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
    for i2c_cnt=0 to i2c_to_send - 1
' Invia il dato
        i2cbussend(i2c_buffer[i2c_cnt])
' Se acknowledge non ricevuto, segnala un errore
        if sspcon2.6=1 then I2CBUSNotAck
        end if
    next i2c_cnt
' Genera stop
    i2cbusstop
end sub
'
'
' Legge una sequenza di bytes da un dispositivo I2C BUS.
' Lo slave address va nella variabile i2c_slave.
' L'utente puo' cambiare la dimensione dell'array nella lista parametri.
' I dati ricevuti vengono memorizzati nello stesso array.
' Il numero di bytes da inviare va nella variabile i2c_to_send.
' Il numero di bytes da ricevere va nella variabile i2c_to_receive.
' L'utente deve verificare che non avvengano eventuali overflow.
sub procedure I2CBUSRead(dim i2c_slave as byte,
                         dim byref i2c_buffer as byte[10],
                         dim i2c_to_send as byte,
                         dim i2c_to_receive as byte)
    dim i2c_cnt as byte
'
' Genera I2CBUS Start.
    i2cbusstart
' Invia Slave Address
    i2cbussend(i2c_slave)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
    for i2c_cnt=0 to i2c_to_send - 1
' Invia il dato
        i2cbussend(i2c_buffer[i2c_cnt])
' Se acknowledge non ricevuto, segnala un errore
        if sspcon2.6=1 then I2CBUSNotAck
        end if
    next i2c_cnt
' Genera I2CBUS Start ripetuto
    i2cbusrepstart
' Invia Slave Address per la lettura
    i2cbussend(i2c_slave or $01)
' Se acknowledge non ricevuto, segnala un errore
    if sspcon2.6=1 then I2CBUSNotAck
    end if
    for i2c_cnt=0 to i2c_to_receive - 1
' Legge il dato
        i2c_buffer[i2c_cnt] = i2cbusget
        if i2c_cnt = i2c_to_receive - 1 then
' Invia NOT acknowledge.
            I2CBUSNACK
        else
' Invia acknowledge.
            I2CBUSaCK
        end if
    next i2c_cnt
' Invia lo stop
    i2cbusstop
end sub
'
' 
' Inizializzazione delle periferiche a bordo della K51-AVR
sub procedure K51_init

    dim dummy as byte
    '
    ' Configurazione del controller dei display a 7 segmenti SAA 1064
    '
    do
        I2CBUSstart
        I2CBUSSend(rsaa1064)
        dummy = I2CBUSGet
        I2CBUSNACK
        I2CBUSStop
    loop until dummy = 0
    '
    i2c_buffer[0] = ctb               ' Punta al registro di controllo
    i2c_buffer[1] =  %00100111        ' bit0 =1 dynamic mode
                                      ' bit1 =1 cifre 1+3 non spente
                                      ' bit2 =1 cifre 2+4 non spente
                                      ' bit3 =0 no test segmenti
                                      ' bit4 =0 no corrente segmenti 3mA
                                      ' bit5 =1 corrente segmenti 6mA
                                      ' bit6 =0 no corrente segmenti 12mA
                                      ' bit7 =0 indifferente
    i2c_buffer[2] = 0
    i2c_buffer[3] = 0
    i2c_buffer[4] = 0
    i2c_buffer[5] = 0
    i2cbuswrite(wsaa1064, i2c_buffer, 6)
    '
    ' Configurazione del termometro DS 1621
    '
    ' Inizializza termometro
    I2CBUSStart
    I2CBUSSend(Wds1621)
    I2CBUSSend(cfg)
    I2CBUSStop
    '
    ' Legge registro di configurazione del DS 1621
    '
    dummy = i2cbusreadbyte(wds1621,cfg)
    ' Se la conversione e' abilitata, falla partire
    if dummy.0 = 0 then
        goto begin_conversion
    end if
    ' Se la conversione non e' abilitata, abilitarla
    ' Scrive registro configurazione
    ' bit1= 1 polarita' "1"
    ' bit0= 0 conversione continua
    i2cbuswritebyte(wds1621,cfg,%00001010)
Begin_conversion:
    i2c_buffer[0] = strct
    i2cbuswrite(wds1621,i2c_buffer,1)
end sub
'
'
' Converte una cifra decimalenella rappresentazione a 7-segmenti
sub function DecTo7Seg(dim value as byte) as byte

    dim temp as byte
    
    select case value
        case 0
            temp = $3F
        case 1
            temp = $06
        case 2
            temp = $5B
        case 3
            temp = $4F
        case 4
            temp = $66
        case 5
            temp = $6D
        case 6
            temp = $7D
        case 7
            temp = $07
        case 8
            temp = $7F
        case 9
            temp = $6F
        case 10
            temp = $40
        case 11
            temp = 00
    end select
    
    Result = temp

end sub
'
'********************** Programma principale ***************************
'
main:
    Init_cpu
    ' Turn OFF relays
    set_relays(0)
    ' Initialize hardware I2C BUS peripheral
    I2Cbusinit
    ' Initialize K51-AVR on board I2C BUS peripheral
    k51_init
    ' Clear screen
    clrscr
    print_USART("Read temperature on a 7 segments display...")
for_ever:

    gosub Read_temperature
    gosub Vis_temp
'
    goto for_ever
'
' ********************* Fine programma ***********************
'
'
' ************* Definizione delle subroutines ****************
'
'
'
' Questa procedura converte 1 byte da 0 a 255 in temperatura dove da
' 0 a 125 sono gradi centigradi positivi (+0..+125), mentre da 255 a 201 sono
' gradi centigradi negativi (-0...-55), in pratica il bit7 indica il segno,
' i gradi negativi si ottengono con il complemento. Es: Not 255=0, Not 201=54
Cifre:
    if Temp_h <= 127 then
        goto TempPositive
    end if
    ' Se la temperatura e' negativa, aggiustare il valore facendone
    ' il complemento a 1
    Temp_h = Temp_h xor $FF
    ' Attivo il segno meno
    Hundreds = 10
    goto Temp_if1
TempPositive:
    if Temp_h <= 99 then
        goto Temp1
    end if
    ' Se e' uguale o superiore a 100, attivo le centinaia
    Hundreds = 1
    ' Sottraggo  100
    Temp_h = Temp_h - 100
    goto temp_if1
Temp1:
    ' Non supera 99, spengo la cifra delle centinaia
    Hundreds = 11
Temp_if1:
    if Temp_h <= 9 then
        goto Temp2
    end if
    ' Supera 9, ricavo la cifra delle decine
    Tenth = Temp_h div 10
    ' Ricavo le unita'
    Tmp = Tenth * 10
    Units = Temp_h - Tmp
    goto Cifre_esci
Temp2:
    if Hundreds <> 11 then
        goto Temp3
    end if
    ' Less than 9 and Centinaia off, also Decine off
    Tenth = 11
    goto Cifre_Units_vale_0
Temp3:
    if Hundreds <> 10 then
        goto temp4
    end if
    ' Minore di 9 e centinaia spente, cifra delle decine spenta
    Tenth = 11
    goto Cifre_Units_vale_0
Temp4:
    ' Minore di 9 e negativa, cifra delle decine spenta
    Tenth = 0
Cifre_Units_vale_0:
    ' Unita'
    Units = Temp_h
Cifre_esci:
return
'
'
' Visualizzazione della temperatura sui display a 7 segmenti
Vis_temp:
    ' Separa il valore di temperatura in W0 in tre cifre:
    ' Centinaia, Decine e Unita
    gosub Cifre
    ' Converte il valore decimale in codifica a 7 segmenti
    Hundreds = DecTo7Seg(Hundreds)
    ' Converte il valore decimale in codifica a 7 segmenti
    Tenth = DecTo7Seg(Tenth)
    ' Converte il valore decimale in codifica a 7 segmenti
    Units = DecTo7Seg(Units)
    '
    ' Invia il valore di temperatura converitito in codifica a 7
    ' segmenti al driver dei display a 7 segmenti
    i2c_buffer[0] = dig1
    i2c_buffer[1] = Hundreds
    i2c_buffer[2] = Tenth
    i2c_buffer[3] = Units or $80
    if Temp_l = $80 then
        ' Scrive  5
        i2c_buffer[4] = $6D
    else
        ' Scrive  0
        i2c_buffer[4] = $3F
    end if
    i2cbuswrite(Wsaa1064, i2c_buffer, 5)
return
'
'
' Lettura della temperatura misurata dal DS1621 in Th e Tl
Read_temperature:
    i2c_buffer[0] = rtemp
    i2cbusread(wds1621,i2c_buffer,1,2)
    Temp_h = i2c_buffer[0]
    Temp_l = i2c_buffer[1]
return

end.