- Name:
-
hi2cin
- Syntax:
-
HI2CIN (variable,...)
HI2CIN location,(variable,...)
HI2CIN [newslave],(variable,...) (X2 parts only)
HI2CIN [newslave],location,(variable,...) (X2 parts only)
Location - is a optional variable/constant specifying a byte or word address.
Variable(s) - receives the data byte(s) read.
Newslave - is an optional new slave address for this (and all future) commands (X2 parts only).
- Description:
-
Read i2c location contents into variable(s).
Use of i2c parts is covered in more detail in the separate 'i2c Tutorial' datasheet.
This command is used to read byte data from an i2c device. Location defines the start address of the data read, although it is also possible to read more than one byte sequentially (if the i2c device supports sequential reads). Location must be a byte or word as defined within the hi2csetup command. An hi2csetup command must have been issued before this command is used. The hi2csetup commands sets the default slave address for this command.
However when addressing multiple parts it may be necessary to repeatedly change the default slave address. This can be achieved via the optional [newslave] variable. If the i2c hardware is incorrectly configured, or the wrong i2cslave data has been used, the value 255 ($FF) will be loaded into each variable.