Action

Configures the hardware USI.

 

 

Syntax

CONFIG USI=usimode , Address=adr , ALTPIN=port

CONFIG USI=usimode , Mode=mode , ALTPIN=port

 

Remarks

The USI(universal serial Interface) is found in most atTiny processors. It can be used for various tasks. At the moment only the TWI slave and TWI master modes are supported. The other modes you need to configure/code yourself.

The CONFIG USI = TWISLAVE mode requires a library that is part of the i2c slave add on which is a commercial add on.

The CONFIG USI = TWIMASTER also requires a library which is included in the commercial distribution.

 

 

 

TWI SLAVE MODE

When USI is used in TWI/I2C mode, it does require that SCL and SDA have pull up resistors. You can not freely choose the SCL and SDA pins : you must use the fixed SCL en SDA pins.

 

The variables  TWI_USI_OVS , TWI_slaveAddress, Twi , Twi_btr and Twi_btw are created by the compiler. These are all bytes.

The USI interrupts are enabled but you need to enabled the global interrupt using ENABLE INTERRUPTS

 

The USI Slave code is running as an interrupt process. Each time there is an USI interrupt some slave code is executed. Your BASIC code is called from the low level slave code at a number of events.

You must include all these labels in your Slave application. You do not need to write code in all these sub routines.

 

 

 

 

TWI MASTER MODE

When USI is used in TWI/I2C mode, it does require that SCL and SDA have pull up resistors. You can not freely choose the SCL and SDA pins : you must use the fixed SCL en SDA pins.

 

The master mode does NOT require or use any variables. It also does not use any interrupts.

 

 

 

See also

Using USI , CONFIG TWISLAVE, CONFIG TWIXSLAVE

 

 

Example, USI SLAVE

'-------------------------------------------------------------------------------
'                            (c) 2004-2016 MCS Electronics
'          This demo demonstrates the USI I2C slave
'          Not all AVR chips have an USI !!!!
'-------------------------------------------------------------------------------
 
$regfile = "attiny2313.dat"
 
$crystal = 8000000
$hwstack = 40
$swstack = 16
$framesize = 24
 
const cPrint = 0                                           'make 0 for chips that have NO UART, make 1 when the micro has a UART and you want to show data on the terminal
 
#if cPrint
  $baud = 19200                                           'only when the processor has a UART
#endif
 
config usi = twislave , address = &H40                     'bascom uses 8 bit i2c address (7 bit shifted to the left with one bit)
 
#if cPrint
  print "USI DEMO"
#endif
 
'do not forget to enable global interrupts since USI is used in interrupt mode
enable interrupts                                           'it is important you enable interrupts
 
do
  ! nop                                                   ; nothing to do here
loop
 
 
 
'The following labels are called from the library. You need to insert code in these subroutines
'Notice that the PRINT commands are remarked.
'You can unmark them and see what happens, but it will increase code size
'The idea is that you write your code in the called labels. And this code must execute in as little time
'as possible. So when you slave must read the A/D converter, you can best do it in the main program
'then the data is available when the master requires it, and you do not need to do the conversion which cost time.
 
 
'A master can send or receive bytes.
'A master protocol can also send some bytes, then receive some bytes
'The master and slave address must match.
 
'the following labels are called from the library  when master send stop or start
Twi_stop_rstart_received:
  '  Print "Master sent stop or repeated start"
Return
 
'master sent our slave address and will not send data
Twi_addressed_goread:
  ' Print "We were addressed and master will send data"
Return
 
 
Twi_addressed_gowrite:
  '  Print "We were addressed and master will read data"
Return
 
'this label is called when the master sends data and the slave has received the byte
'the variable TWI holds the received value
Twi_gotdata:
  '   Print "received : " ; Twi ; " byte no : " ; Twi_btw
  Select Case Twi_btw
    Case 1 :                                               'Portd = Twi                                   ' first byte
    Case 2:                                               'you can set another port here for example
  End Select
Return
 
'this label is called when the master receives data and needs a byte
'the variable twi_btr is a byte variable that holds the index of the needed byte
'so when sending multiple bytes from an array, twi_btr can be used for the index
Twi_master_needs_byte:
  '  Print "Master needs byte : " ; Twi_btr
  Select Case Twi_btr
    Case 1 : twi = 68                                       ' first byte
    Case 2 : twi = 69                                       ' send second byte
  End Select                                               'you could also return the state of a port pin or A/D converter
Return

 

 

Example, USI Master

'------------------------------------------------------------------------------
'                   (c) 1995-2021 MCS Electronics
'                     USI-MASTER.bas
' USI used as TWI master demo
'------------------------------------------------------------------------------
 
$regfile = "attiny2313.dat"
$crystal = 8000000
$hwstack = 40
$swstack = 16
$framesize = 24
$baud = 19200
 
config usi = twimaster , mode = fast
 
dim b as byte
 
i2cinit
 
do
i2cstart
i2cwbyte &H40                                             'send slave WRITE address for PCF8574
i2cwbyte &B10101010                                       'send a pattern
i2crepstart                                               'repeated start
 
i2cwbyte &H41                                             'send slave READ address
i2crbyte b , ack                                         'read a byte
i2crbyte b , nack                                         'and again
i2cstop                                                   'end transaction and free bus
 
waitms 100                                               'some delay not required only when you print
loop