CONFIG TWIXSLAVE - Revision history

Admin at 15:04, 4 February 2014

2014-02-04T15:04:40Z

Admin at 15:03, 4 February 2014

2014-02-04T15:03:48Z

Admin: Created page with "= Action = Configure the Xmega TWIC,TWID,TWIE or TWIF hardware to be used a a slave.
2014-02-04T15:02:42Z

Created page with "= Action = Configure the Xmega TWIC,TWID,TWIE or TWIF hardware to be used a a slave. Action =

Configure the Xmega TWIC,TWID,TWIE or TWIF hardware to be used a a slave.

 

 

= Syntax =

CONFIG TWICSLAVE = address , BTR = value ,GENCALL=value

CONFIG TWIDSLAVE = address , BTR = value ,GENCALL=value

CONFIG TWIESLAVE = address , BTR = value ,GENCALL=value

CONFIG TWIFSLAVE = address , BTR = value ,GENCALL=value

 

(I2C TWI Slave is part of the I2C-Slave library. This is an add-on library which is not included with Bascom-AVR by default. It is a commercial add on library. It is available from [http://www.mcselec.com/index.php?page=shop.product_details&flypage=shop.flypage&product_id=34&category_id=6&option=com_phpshop&Itemid=1 MCS Electronics] )

 

See also: [[I2C_TWI_Slave|I2C TWI Slave]], [[Using_the_I2C_protocol|USING I2C Protocol]], [[Using_USI_(Universal_Serial_Interface)|Using USI]], [[CONFIG_I2CSLAVE|CONFIG I2CSLAVE]] , [[CONFIG_USI|CONFIG USI]]

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
Address

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
The slave address which is assigned to the slave chip. This must be an Even number. Bit 0 of the address is used to activate the general call address.

The GENCAL option will set this bit automatic.

 

I2C uses a 7 bit address from bit 1 to bit 7. Bit 0 is used to specify a read/write operation. In BASCOM the byte transmission address is used for I2C.

This means that an I2C 7-bit address of 1 becomes &B10 = 2. And we say the address is 2. This is done so you can copy the address from the data sheets which are in the same format in most cases.

So if you work with 7 bit address, you need to multiply the address by 2.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
BTR

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
Bytes to receive. With this constant you specify how many bytes will be expected when the master reads data from the slave. And thus how many bytes will be sent to the master. This value can be changed dynamically.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 87px; border: 1px solid rgb(0, 0, 0);" |
GENCALL

| valign="top" width="100%" style="width: 508px; border: 1px solid rgb(0, 0, 0);" |
General call address activated or not. When you specify 1, the General call address will be activated which mean that the slave will respond not only to it's own address, but also to the general call address 0.

When you omit the option or specify 0, the general call address will not be honored.

|}
</div>
 

The variables  TwiX , TwiX_btr, TwiX_CBTR and TwiX_btw are created by the compiler. These are all byte variables.

The X represents the TWI interface letter which can be C, D, E or F.

 

The TWIx interrupt is enabled as well but you need to enabled the global interrupt

 

The TWI Slave code is running as an interrupt process. Each time there is a TWI interrupt some slave code is executed. Your BASIC code is called from the low level slave code by 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.

 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="189" bgcolor="#ffff99" style="width: 189px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Label

| valign="top" width="400" bgcolor="#ffff99" style="width: 400px; background-color: rgb(255, 255, 153); border: 1px solid rgb(0, 0, 0);" |
Event

|- style="vertical-align: top;"
| valign="top" width="189" style="width: 189px; border: 1px solid rgb(0, 0, 0);" |
Twi_stop_rstart_received

TwiD_stop_rstart_received

TwiE_stop_rstart_received

TwiF_stop_rstart_received

| valign="top" width="400" style="width: 400px; border: 1px solid rgb(0, 0, 0);" |
The Master sent a stop(i2CSTOP) or repeated start.

Typical you do not need to do anything here.

|- style="vertical-align: top;"
| valign="top" width="189" style="width: 189px; border: 1px solid rgb(0, 0, 0);" |
Twi_addressed_goread

TwiD_addressed_goread

TwiE_addressed_goread

TwiF_addressed_goread

| valign="top" width="400" style="width: 400px; border: 1px solid rgb(0, 0, 0);" |
The master has addressed the slave and will now continue to send data to the slave. You do not need to take action here.

|- style="vertical-align: top;"
| valign="top" width="189" style="width: 189px; border: 1px solid rgb(0, 0, 0);" |
Twi_addressed_gowrite

TwiD_addressed_gowrite

TwiE_addressed_gowrite

TwiF_addressed_gowrite

| valign="top" width="400" style="width: 400px; border: 1px solid rgb(0, 0, 0);" |
The master has addressed the slave and will now continue to receive data from the slave. You do not need to take action here.

|- style="vertical-align: top;"
| valign="top" width="189" style="width: 189px; border: 1px solid rgb(0, 0, 0);" |
Twi_gotdata

TwiD_gotdata

TwiE_gotdata

TwiF_gotdata

| valign="top" width="400" style="width: 400px; border: 1px solid rgb(0, 0, 0);" |
The master has sent data. The variable TWIx holds the received value. The byte TWIx_BTW is an index that holds the value of the number of received bytes. The first received byte will have an index value of 1.

|- style="vertical-align: top;"
| valign="top" width="189" style="width: 189px; border: 1px solid rgb(0, 0, 0);" |
Twi_master_needs_byte

TwiD_master_needs_byte

TwiE_master_needs_byte

TwiF_master_needs_byte

| valign="top" width="400" style="width: 400px; border: 1px solid rgb(0, 0, 0);" |
The master reads from the slave and needs a value. The variable TWIx_BTR can be inspected to see which index byte was requested. With the CONFIG parameter BTR, you specify how many bytes the master will read. This value is stored in the variable TWIx_CBTR. You can alter this value but you should not do that in the middle of a transaction.

|}
</div>
 

The name of the label called depends on the used TWI interface. TWIC is the default TWI interface. All I2C commands work with TWIC by default.

In order to make the normal slave code compatible with the Xmega, the TWIC interface uses the same label names as used for normal AVR TWI interface.

This means that your BASCOM slave code for the M32 should work for the TWIC interface without much changes.

 

[[File:Notice.jpg]]It is important that you do not use the MASTER TWI routines when using the TWI as a slave. Just supply or read data at the provided routines.

 

In most cases your main application is just an empty DO LOOP. But when you write a slave that performs other tasks on the background these other tasks are interrupted by the TWI traffic.

Do NOT write blocking code inside an interrupt. While servicing another interrupt, the TWI interrupt can not be serviced.

Also, do not block execution by putting delays in the called routines such as TWI_GOTDATA. All these labels are called from the TWIX SLAVE library which is an interrupt routine that will halt the main application and other interrupts.

 

The TWI Slave code will save all used registers.

 

In order to get a working slave it is important that the slave matches the protocol used by the master. Thus if the slave reads data from the master and only expects 2 bytes, the master should not send less or more. We advise to make a simple slave first like a PCF8574 clone.

 

 

= See also =

[[File:file:///D:/TRANSFER/AVRHELPHTML/new29012014/config_twi.htm|CONFIG TWIX]]

 

 

= Example =

The following example uses two TWI interfaces. TWID is used in master mode while TWIC is used as the slave.

← Older revision		Revision as of 15:04, 4 February 2014
Line 197:		Line 197:

	The following example uses two TWI interfaces. TWID is used in master mode while TWIC is used as the slave.		The following example uses two TWI interfaces. TWID is used in master mode while TWIC is used as the slave.
		+
		+	<source lang="bascomavr">
		+	'------------------------------------------------------------------------------
		+	'name : xmega-twi-slave.bas
		+	'copyright : (c) 1995-2013, MCS Electronics
		+	'purpose : demonstrates Xmega TWI slave add on
		+	'micro : Xmega128A1
		+	'suited for demo : yes
		+	'commercial addon needed : yes
		+	'------------------------------------------------------------------------------
		+
		+	$regfile = "xm128a1def.dat"
		+	$crystal = 32000000
		+	$hwstack = 64
		+	$swstack = 40
		+	$framesize = 40
		+
		+
		+	'first enable the osc of your choice
		+	Config Osc = Enabled , 32mhzosc = Enabled
		+
		+	'configure the systemclock
		+	Config Sysclock = 32mhz , Prescalea = 1 , Prescalebc = 1_1
		+
		+	Config Com1 = 19200 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
		+	'Config Serialin = Buffered , Size = 50
		+
		+	'Enable Interrupts
		+	Open "COM1:" For Binary As #1
		+
		+	Open "twid" For Binary As #4 ' or use TWIC,TWIE oR TWIF
		+	Config Twid = 100000 'CONFIG TWI will ENABLE the TWI master interface
		+	'you can also use TWIC, TWID, TWIE of TWIF
		+	'!!!!!!!!!!! WITHOUT a channel identifier, TWIC will be used !!!!!!!!!!!!!!
		+	'SCL is on pin 1
		+	'SDA is on pin 0
		+	'This demo uses TWID as master and TWIC as SLAVE
		+	'Thus portc.0 connects with portD.0 and
		+	' portc.1 connects with portD.1
		+
		+	'The TWIC when used as a slave has megaAVR compatible labels
		+	'The TWID,TWIE and TWIF have unique new labelnames
		+	'These labels are the labels in your code which are called from the slave ISR.
		+	'For example : Twi_addressed_gowrite is named TwiD_addressed_gowrite for TWID
		+
		+
		+	Dim Twi_start As Byte , j as byte , b as byte
		+	I2cinit #4 'init the master
		+	config TWIcslave = &H70 , btr = 2 'use address &H70 which is &H38 in 7-bit i2c notation
		+
		+	Enable INTERRUPTS 'for the slave to work we must enable global interrupts
		+
		+	do
		+	Print #1 , "test xmega"
		+
		+	For J = 0 To 120 Step 1 'notice that we scan odd and even addresses
		+	I2cstart #4 'send start
		+	I2cwbyte J , #4 'send value of J
		+	If Err = 0 Then ' no errors
		+	Print #1 , "FOUND : " ; Hex(j)
		+	if j.0 = 0 then 'ONLY if R/W bit is not set we may write data !!!
		+	I2cwbyte 100 , #4 'just write to values to the slave
		+	I2cwbyte 101 , #4
		+	else 'read
		+	I2crbyte b , Ack , #4 : print #1 , "GOT : " ; b 'read 2 bytes
		+	I2crbyte b , nAck , #4 : print #1 , "GOT : " ; b
		+	end if
		+	End If
		+	I2cstop #4 'done
		+	Next
		+	waitms 2000 'wait some time
		+	loop
		+
		+
		+	'the following labels are called from the library when master send stop or start
		+	'notice that these label names are valid for TWIC.
		+	'for TWID the name would be TWID_stop_rstart_received:
		+	Twi_stop_rstart_received:
		+	Print #1 , "Master sent stop or repeated start"
		+	Return
		+
		+	'master sent our slave address and will not send data
		+	Twi_addressed_goread:
		+	Print #1 , "We were addressed and master will send data"
		+	Return
		+
		+
		+	Twi_addressed_gowrite:
		+	Print #1 , "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 TWIx holds the received value
		+	'The x is the TWI interface letter
		+	Twi_gotdata:
		+	Print #1 , "received : " ; Twic ; " byte no : " ; Twic_btw
		+	'here you would do something with the received data
		+	' Select Case Twic_btw
		+	' Case 1 : Portb = 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 twix_btr is a byte variable that holds the index of the needed byte
		+	'so when sending multiple bytes from an array, twix_btr can be used for the index
		+	'again the variable name depends on the twi interface
		+	Twi_master_needs_byte:
		+	Print #1 , "Master needs byte : " ; Twic_btr
		+	Select Case Twic_btr
		+	Case 1: ' first byte
		+	twic = 66 'we assign a value but this could be any value you want
		+	Case 2 ' send second byte
		+	twic = 67
		+	End Select
		+	Return
		+
		+
		+	'when the mast has all bytes received this label will be called
		+	Twi_master_need_nomore_byte:
		+	Print #1 , "Master does not need anymore bytes"
		+	Return
		+
		+	End
		+	</source><br/>{{Languages}}
		+
		+	[[Category:BASCOM Language Reference]]

@@ Line 192: / Line 192: @@
 = <span class="f_Header">See also</span> =
-<span style="font-family: Arial;">[[File:file:///D:/TRANSFER/AVRHELPHTML/new29012014/config_twi.htm|CONFIG TWIX]]</span>
+[[CONFIG TWI|CONFIG TWI]]
-−
-<span style="font-family: Arial;">&nbsp;</span>
-−
-<span style="font-family: Arial;">&nbsp;</span>
 = <span class="f_Header">Example</span> =
 The following example uses two TWI interfaces. TWID is used in master mode while TWIC is used as the slave.