- Name:
- i2cslave
- Syntax:
-
I2CSLAVE slaveaddress, mode, addresslen
SLAVEI2C slaveaddress, mode, addresslen
SlaveAddress - is the i2c slave address.
Mode - is the keyword i2cfast (400kHz) or i2cslow (100kHz) at 4Mhz.
Addresslen - is the keyword i2cbyte or i2cword.
- Description:
-
This command is deprecated, please consider using the hi2csetup command instead.
The i2cslave command (slavei2c also accepted by the compiler) is used to configure the PICAXE pins for i2c use (in MASTER mode) and to define the type of i2c device to be addressed.
Use of i2c parts is covered in more detail in the separate 'i2c Tutorial' datasheet.
If you are using a single i2c device you generally only need one i2cslave command within a program. With the PICAXE-18X device you should issue the command at the start of the program to configure the SDA and SCL pins as inputs to conserve power.
After the i2cslave has been issued, readi2c and writei2c can be used to access the i2c device.
Slave Address
The slave address varies for different i2c devices (see table below). For the popular 24LCxx series serial EEPROMs the address is commonly %1010xxxx.
Note that some devices, e.g. 24LC16B, incorporate the block address (ie the memory page) into bits 1-3 of the slave address. Other devices include the external device select pins into these bits. In this case care must be made to ensure the hardware is configured correctly for the slave address used.
Bit 0 of the slave address is always the read/write bit. However the value entered using the i2cslave command is ignored by the PICAXE, as it is overwritten as appropriate when the slave address is used within the readi2c and writei2c commands.
Mode
Speed mode of the i2c bus can be selected by using one of the two keywords i2cfast or i2cslow (400kHz or 100kHz). The internal slew rate control of the microcontroller is automatically enabled at the 400kHz speed (28X/40X). Note that the 18X internal architecture means that the slower speed is always used with the 18X, as it is not capable of processing at the faster speed.
Address Length
i2c devices commonly have a single byte (i2cbyte) or double byte (i2cword) address. This must be correctly defined for the type of i2c device being used. If you use the wrong definition erratic behaviour will be experienced. When using the i2cword address length you must also ensure the 'address' used in the readi2c and writei2c commands is a word variable. Note this is the EEPROM address length only, not the data bytes themselves. It is not possible to transmit a word value directly over i2c (e.g. word w0 must be transmitted as the two separate bytes b0 and b1).
Settings for some common parts
Device Type Slave Speed Address 24LC01B EE 128 %1010xxxx i2cfast i2cbyte 24LC02B EE 256 %1010xxxx i2cfast i2cbyte 24LC04B EE 512 %1010xxbx i2cfast i2cbyte 24LC08B EE 1kb %1010xbbx i2cfast i2cbyte 24LC16B EE 2kb %1010bbbx i2cfast i2cbyte 24LC64 EE 8kb %1010dddx i2cfast i2cword 24LC128 EE 16kb %1010dddx i2cfast i2cword 24LC256 EE32kb %1010dddx i2cfast i2cword 24LC512 EE64kb %1010dddx i2cfast i2cword DS1307 RTC %1101000x i2cslow i2cbyte MAX6953 5x7 LED %101ddddx i2cfast i2cbyte AD5245 Digital Pot %010110dx i2cfast i2cbyte SRF08 Sonar %1110000x i2cfast i2cbyte AXE033 I2C LCD %1100011x i2cslow i2cbyte CMPS03 Compass %1100000x i2cfast i2cbyte SPE030 Speech %1100010x i2cfast i2cbyte x = don't care (ignored).
b = block select (selects internal memory page within device).
d = device select (selects device via external address pin polarity).
Effect of Increased Clock Speed
Ensure you modify the speed keyword (i2cfast_8, i2cslow_8) at 8MHz or (i2cfast_16, i2cslow_16) at 16MHz for correct operation.
See readi2c or writei2c for example program for DS1307 real time clock.
Example of how to use a DS1307 Real Time Clock
This program configures I2C operations to access a DS1307 Real Time Clock and then sets the current time and date of the DS1307. Note the data is sent/received in BCD format. Note that seconds, mins etc are variables that need defining e.g. symbol seconds = b0 etc.
- Code Example:
-
i2cslave %11010000, i2cslow, i2cbyte ; set PICAXE as master and DS1307 slave address ; write time and date e.g. to 11:59:00 on Thurs 25/12/03 start_clock: let seconds = $00 ; 00 Note all BCD format let mins = $59 ; 59 Note all BCD format let hour = $11 ; 11 Note all BCD format let day = $03 ; 03 Note all BCD format let date = $25 ; 25 Note all BCD format let month = $12 ; 12 Note all BCD format let year = $03 ; 03 Note all BCD format let control = %00010000 ; Enable output at 1Hz writei2c 0,(seconds,mins,hour,day,date,month,year,control) end
Copy Code Submit an Example
Submit Your Own Code!
You must be logged in to submit code examples. Login now.