I2C

I2C

• I2C is a shared bus system that allows multiple devices to be hooked to a microprocessor using short wires.
• Devices can either be the I2C master or slave.
• Teensys might have multiple I2C buses, but a lot of the libraries out there assume there is only one I2C bus, because the early AVR 328p based Arduino systems only had one I2C bus.
• To access the main I2C bus, use the Wire external class. On systems with a second I2C bus, use Wire1 instead of Wire to access the second I2C, and Wire2 to access the third I2C bus.
• Each I2C slave has an address it listens to. On some devices there are solder pads or pins that allow you to configure which I2C address is used. Other devices have an I2C command that allows you to change the I2C address. Other I2C devices just have a single I2C address.
• There are I2C multiplexers out there that allow you to connect multiple I2C devices that have the same address. One such multiplexer is the Adafruit TCA9548A board (https://www.adafruit.com/product/2717) that allows you to split an I2C bus into 8 separate I2C buses.
• An older Arduino I2C tutorial is at: (http://www.gammon.com.au/i2c).
• I2C has 4 pins: Power, ground, SDA, and SCL.

I2C debugging

• There are various I2C drivers and oscilloscopes out there to allow debugging I2C connections
• Excamera Labs provides: https://i2cdriver.com/ and https://i2cdriver.com/mini.html

Libraries

• The main I2C library is in #include <Wire.h> (https://www.pjrc.com/teensy/td_libs_Wire.html)
• An alternative I2C library for Teensy LC & 3.2/3.5/3.6 is #include <i2c_t3.h> (https://github.com/nox771/i2c_t3)
• Unfortunately, i2c_t3.h has not yet been ported to the Teensy 4.0.
• Within a sketch, you can only use either Wire.h or i2c_t3.h. If you call any library that uses Wire.h, you can't use i2c_t3.h without cloning each of the libraries that used Wire.h, renaming the library, and changing Wire.h to i2c_t3.h.

Pull-up resistors

• On ARM based systems (Teensy LC, 3.0, 3.1, 3.2, 3.5, 3.6, and 4.0) you need to have 2 pull-up resistors on each I2C bus.
• One resistor goes between the SDA pin and 3.3v power in parallel to the data connection(s).
• One resistor goes between the SCL pin and 3.3v power in parallel to the data connection(s).
• On I2C buses that support 5 volts, a common value for the pull-up resistors is 4.7K ohms. On I2C buses that are 3.3 volts only, a common value for the pull-up resistors is 2.2K ohms. However, complex I2C buses can need different values for the resistors.
• Many I2C devices provide their own pull-up resistors.
• You can have multiple pull-up resistors on the I2C bus, and generally they will work together. However, having multiple pull-up resistors can mean the devices might not be able to handle faster I2C bus speeds.
• If you have multiple pull-up resistors on an I2C bus, it is similar to having a single resistor of the sum of each of the resistors on the bus.
• If no devices have pull-up resistors, I2C requests may hang.
• Most newer Adafruit and Sparkfun I2C devices provide their own pull-up resistors.
• For the main I2C bus, there is an example program (Wire -> Scanner) that probes the main I2C bus to see what devices are present. If this example hangs, you need to add pull-up resistors.
• The Teensy Audio shields and the Teensy Prop shields, each provide 2.2K pull-up resistors on the main I2C bus.
• The Adafruit Teensy -> feather adapter does not provide pull-up resistors.

Multiple I2C ports

• Most Teensys can have more than one I2C bus.
• Some Teensys can use alternate pins for some of the I2C pins. See the Wire.h or i2c_t3.h documentation for more details.
• All ARM Teensys have the first I2C bus on pins 18/A4 (SDA0) and 19/A5 (SCL0)
• Teensy 4.0 has 2 additional I2C buses (17/A3 and 16/A2 are SDA1/SCL1; 25/A11 and 24/A10 are SDA2/SCL2);
• Teensy 3.6 has 3 additional I2C buses (38/A19 and 37/A18 are SDA1/SCL1; 4 and 3 are SDA2/SCL2; 56 and 57 are SDA3/SCL3);
• Teensy 3.5 has 2 additional I2C buses (38/A19 and 37/A18 are SDA1/SCL1; 4 and 3 are SDA2/SCL2);
• Teensy 3.1 and 3.2 have 1 additional I2C bus (30/A19 and 29/18 are SDA1/SCL1);
• Teensy LC has 1 additional I2C bus (23/A9 and 22/A8 are SDA1/SCL1).