Ir al archivo
SMFSW d31cca271e Updated to travis-ci.com status 2018-12-12 20:54:31 +01:00
examples v1.2: No internal address transmission when reading/writing to next internal address (auto-increment feature of most I2C devices) 2017-11-30 22:40:42 +01:00
src v1.3: Delay between retries set to 1ms 2018-05-27 15:57:06 +02:00
.gitignore Updated Doxyfile & .travis.yml 2018-05-04 02:23:19 +02:00
.travis.yml Removed deprecated sudo from .travis.yml 2018-12-11 19:53:01 +01:00
Doxyfile v1.3: Delay between retries set to 1ms 2018-05-27 15:57:06 +02:00
Doxyfile.auto Added dedicated Doxyfile for Travis CI and updated .travis.yml to use graphviz 2018-05-04 17:43:37 +02:00
LICENSE v0.3: bugfixes and refactoring 2017-01-22 18:32:00 +01:00
README.md Updated to travis-ci.com status 2018-12-12 20:54:31 +01:00
ReleaseNotes.md typo in ReleaseNotes.md 2018-06-17 18:23:58 +02:00
keywords.txt v0.5: speed enum names change 2017-02-02 00:03:07 +01:00
library.properties v1.3: Added Travis CI support and removed doxygen version anchors in sources 2018-05-03 18:42:08 +02:00

README.md

cI2C Build Status

Arduino Hardware I2C for AVR (plain c)

Hardware I2C library for AVR MCUs (lib intended for I2C protocols development in c, for easier ports to other MCUs)

Library choice

  • cI2C library implements I2C bus for AVR targets (Uno, Nano, Mega...)
    • you may prefer this one when:
      • working on AVR targets
      • interrupts are not needed
  • WireWrapper implements I2C bus for every platform that includes Wire library
    • you would have to use this one when:
      • working on non-AVR targets
      • portability is needed (using Wire library)

No refactoring is required when switching between cI2C & WireWrapper libs; Both libs share same Typedefs, Functions & Parameters.

Notes

  • cI2C is written in plain c (intentionally)
  • cI2C does not use any interrupt (yet, but soon will have to)
  • cI2C is designed to act as bus Master (Slave mode will be considered in future releases)
  • cI2C is set to work on AVR targets only
    • for other targets, you may use WireWrapper instead (will be using Wire)

Usage

This library is intended to be able to work with multiple slaves connected on the same I2C bus. Thus, the I2C bus and Slaves are defined separately.

  • On one hand, I2C bus has to be initialized with appropriate speed:
    • use I2C_init(speed): speed can be chosen from I2C_SPEED enum for convenience, or passing an integer as parameter
  • On the other hand, Slave(s) have to be defined and initialized too:
    • use I2C_SLAVE typedef to declare slaves structs
    • use I2C_slave_init(pSlave, addr, regsize)
      • pSlave: pointer to the slave struct to initialize
      • addr: slave I2C address (don't shift addr, lib takes care of that)
      • regsize: width of internal slave registers (to be chosen from I2C_INT_SIZE)
    • in case you need to use custom R/W procedures for a particular slave:
      • use I2C_slave_set_rw_func(pSlave, pFunc, rw)
        • pSlave: pointer to the slave declaration to initialize
        • pFunc: pointer to the Read or Write bypass function
        • rw: can be chosen from I2C_RW enum (wr=0, rd=1)

After all inits are done, the lib can basically be used this way:

  • I2C_read(pSlave, regaddr, pData, bytes)
    • pSlave: pointer to the slave struct to read from
    • regaddr: start address to read from
    • pData: pointer to the place where datas read will be stored
    • bytes: number of bytes to read from slave
    • returns true if read is ok, false otherwise
  • I2C_write(pSlave, regaddr, pData, bytes)
    • pSlave: pointer to the slave struct to write to
    • regaddr: start address to write to
    • pData: pointer to the block of datas to write to slave
    • bytes: number of bytes to write to slave
    • returns true if write is ok, false otherwise

Examples included

following examples should work with any I2C EEPROM/FRAM with address 0x50 (yet function to get Chip ID are device dependent (and will probably only work on FUJITSU devices))

Documentation

Doxygen doc can be generated using "Doxyfile".

See generated documentation

Release Notes

See release notes

See also

cI2C

WireWrapper