View source

= <span class="f_Header">Action</span> =

Receives data from an I2C serial slave device.

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Syntax</span> =

<span class="f_Syntax">I2CRECEIVE</span>&nbsp;slave, var

<span class="f_Syntax">I2CRECEIVE</span>&nbsp;slave, var , b2W, b2R

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Syntax Xmega</span> =

<span class="f_Syntax">I2CRECEIVE</span>&nbsp;slave, var ,&nbsp;<span class="f_Syntax">#</span>const

<span class="f_Syntax">I2CRECEIVE</span>&nbsp;slave, var , b2W, b2R ,&nbsp;<span class="f_Syntax">#</span>const

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Remarks</span> =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="547" 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: 79px; border: 1px solid rgb(0, 0, 0);" | 
Slave

| valign="top" width="90%" style="width: 459px; border: 1px solid rgb(0, 0, 0);" | 
A byte, Word/Integer variable or constant with the slave address from the I2C-device.

&nbsp;

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: 79px; border: 1px solid rgb(0, 0, 0);" | 
Var

| valign="top" width="90%" style="width: 459px; border: 1px solid rgb(0, 0, 0);" | 
A byte or integer/word variable that will receive the information from the I2C-device.

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

| valign="top" width="90%" style="width: 459px; border: 1px solid rgb(0, 0, 0);" | 
The number of bytes to write.

<span style="font-family: Arial;">&nbsp;</span>

Be cautious not to specify too many bytes!

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

| valign="top" width="90%" style="width: 459px; border: 1px solid rgb(0, 0, 0);" | 
The number of bytes to receive.

<span style="font-family: Arial;">&nbsp;</span>

Be cautious not to specify too many bytes!

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 79px; border: 1px solid rgb(0, 0, 0);" | 
<span class="f_Syntax">#</span>const

| valign="top" width="90%" style="width: 459px; border: 1px solid rgb(0, 0, 0);" | 
For the Xmega, a channel constant that was specified with OPEN.

|}
</div>
<span style="font-family: Arial;">&nbsp;</span>

You must specify the base address of the slave chip because the read/write bit is set/reset by the software.

When an error occurs, the internal ERR variable will return 1. Otherwise it will be set to 0.

&nbsp;

The I2CRECEIVE statement combines the i2cstart,i2cwbyte, i2crbyte and i2cstop statements.

For the xmega you can optional specify the channel. Without it, SPIC will be used.

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">ASM</span> =

The I2C routines are located in the i2c.lib/i2c.lbx files.

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">See also</span> =

[[I2CSEND]],&nbsp;[[I2CSTART]]&nbsp;,&nbsp;[[I2CSTOP]],&nbsp;[[I2CRBYTE]]&nbsp;,&nbsp;[[I2CWBYTE]]

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Example</span> =

<br/><source lang="bascomavr">
Config Sda = Portb.5
Config Scl = Portb.7
Dim X As Byte , Slave As Byte
X = 0 'reset variable
Slave = &H40 'slave address of a PCF 8574 I/O IC
I2creceive Slave , X 'get the value
Print X 'print it
 
 
Dim Buf(10)as Byte
Buf(1) = 1 : Buf(2) = 2
I2creceive Slave , Buf(1) , 2 , 1 'send two bytes and receive one byte
Print Buf(1) 'print the received byte
End
</source><br/>{{Languages}}

[[Category:BASCOM Language Reference]]