{"id":386,"date":"2019-10-12T12:04:26","date_gmt":"2019-10-12T17:04:26","guid":{"rendered":"https:\/\/robotsbench.com\/?p=386"},"modified":"2022-03-14T09:25:00","modified_gmt":"2022-03-14T14:25:00","slug":"i2c-communication-arduino","status":"publish","type":"post","link":"https:\/\/robotsbench.com\/i2c-communication-arduino\/","title":{"rendered":"How to use i2C with Arduino"},"content":{"rendered":"<div class=\"affiliate-disclaimer\">I hope that the products recommended here will help you build great projects. Just so you know, if you buy through the links on this page on Amazon or Banggood (among others), RobotsBench may get a small share of the sale (as an Amazon affilate, I earn from qualifying purchases). This helps to keep the site alive and allow me to write more articles. Thank you!<\/div>\n<p>The i2C protocol is one of the most popular way to communicate with sensors and devices with an <a href=\"https:\/\/amzn.to\/2KWPXgK\">Arduino<\/a>. This protocol was built to limit the pins needed and to standardize the communication so you don&#8217;t have to figure out a proprietary format each time. But how to use i2C with an Arduino?<\/p>\n\n\n\n<p> A i2C devices uses two specific pins the Arduino to communicate: one pin is for data (SDA) and the other is for the clock (SCL). <\/p>\n\n\n\n<p>Each device has a specific address, so many devices can be added to the same bus without using up extra pins. The logic level of the communication (generally 3.3V or 5V) depends on the master, so each slave device must be able to work at that level. <\/p>\n\n\n\n<p>Everything is driven by the master node, which generates the clock and manages the communication with all the slave devices. There are theoretically 127 addresses available for slave devices, but you can realistically connect around 6-10 devices. BlueDot has an excellent explanation of what really limits the number of devices at <a href=\"https:\/\/www.bluedot.space\/tutorials\/how-many-devices-can-you-connect-on-i2c-bus\/\">https:\/\/www.bluedot.space\/tutorials\/how-many-devices-can-you-connect-on-i2c-bus\/<\/a>. <\/p>\n\n\n\n<aside class=\"wp-block-com-cindypotvin-cp-aside-gutenberg-block cp-aside-gutenberg-block-content\"><p>There are multi-master systems out there with an arbitration process so only one master communicates at a time, but it&#8217;s a lot more complex and won&#8217;t be covered here. <\/p><p>If you can&#8217;t manage to make your project work with a single master, you may wish to consider the CANBus protocol, which is better suited to having many nodes sending data over a bus. On the other hand, few devices have CANBus built-in and it requires more hardware to make it work while I2C is already implemented with the Arduino and many popular devices and chips.<\/p><\/aside>\n\n\n\n<p>If you purchase a sensor with i2c, it will already have a default slave address (the master doesn&#8217;t need one). Since each address must be unique, if you want to use more than one of the same sensor on a bus you must make sure that it can be changed by a jumper (or another similar option such as cutting a trace). You also need to be careful that the devices you want to use don&#8217;t communicate using the same address.<\/p>\n\n\n\n<p>Adafruit maintains a list of slave addresses for the most popular devices at <a href=\"https:\/\/learn.adafruit.com\/i2c-addresses\/the-list\">https:\/\/learn.adafruit.com\/i2c-addresses\/the-list<\/a>. You should also be able to find it in the documentation for the device, and they often already have an Arduino library that abstracts the messy communication part including the default address to use. <\/p>\n\n\n\n<h2>i2c Communication: The Hardware<\/h2>\n\n\n\n<p>I2c can also solve the problem of how to connect two Arduino together: the Arduino can act as a master or a slave on the i2c bus. So, for this tutorial, I&#8217;m going to make two <a href=\"https:\/\/amzn.to\/2KWPXgK\">Arduino<\/a> communicate, which is also helpful to show how to setup both sides of the communication. <\/p>\n\n\n\n<p>In more common use cases, the Arduino would act as a master, and your other devices, sensors and the like will be slave devices. Those devices will already have its logic and assigned addresses as mentioned previously, so you generally don&#8217;t need to setup the &#8220;slave&#8221; side, but it&#8217;s useful to know what it looks like.<\/p>\n\n\n\n<p>In this example, the slave is going to read the value of a potentiometer on the analog pin when the value is requested by the master. Please note that the reverse is possible: a master can push data to a specific slave so it reacts to this data.<\/p>\n\n\n\n<p>For the Arduinos, the wiring is pretty simple: just wire the SDA, SDL and GND pins of both microcontrollers together. The I2C bus requires pullup resistors (2k7 is usually fine), but they are included inside the Atmega chip of the Arduino and will be turned on automatically by the Wire Arduino library that we will use so you don&#8217;t need to add any.<\/p>\n\n\n\n<p>You also need to wire the potentiometer to the A0 analog pin of the slave Arduino so it can have a value to read. <\/p>\n\n\n\n<p>Here is the complete wiring diagram (the potentiometer I used has a maximum value of 1k ohms):<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"531\" src=\"https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-1024x531.png\" alt=\"\" class=\"wp-image-783\" srcset=\"https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-1024x531.png 1024w, https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-300x156.png 300w, https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-768x399.png 768w, https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png 1821w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2> i2c Communication: The Software<\/h2>\n\n\n\n<p>First, we&#8217;re going to focus on the slave (the Arduino to the right on the schematic). To get started, we need to initialize the i2c communication by specifying the slave address our slave Arduino will have (any value from 0 to 127).<\/p>\n\n\n\n<p>After this, we need to do the setup so the slave will answer when the master requests data. The <em>onRequest <\/em>call in the <em>setup()<\/em> method specifies which method will be called to do this, in that case the <em>respondToMasterEvent <\/em>method.<\/p>\n\n\n\n<p>So, when data is requested, the <em>respondToMasterEvent <\/em>reads the current value of the analog pin, which can be modified by the potentiometer, and writes it to the buffer so the master can retrieve it. Since the iC2 protocols uses bytes that are 8-bit long, but the analog pin of the Arduino returns a 10 bits value, this value is split in two so it can be sent as 2 bytes. <\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"cpp\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">#include &lt;Wire.h>\n\/\/ Slave address of this arduino on the bus.\nconst int SLAVE_ADDRESS = 0x10; \n\/\/ Analog pin A0 for the potentiometer that will act as an analog sensor in this example.\nconst int SENSOR_ANALOG_PIN = 14; \n\/\/ Variable for the current value of the analog pin (declared here to declare it only once).\nint analogPinValue;\nconst int BYTES_TO_SEND = 2;\nuint8_t sendBuffer[BYTES_TO_SEND];\n\nvoid setup() {\n  \/\/ Enable I2C on the Arduino, including pull-up resistors and join the bus as a slave.\n  Wire.begin(SLAVE_ADDRESS);\n  \n  \/\/ Register event to respond to request from the master.\n  Wire.onRequest(respondToMasterEvent); \n  \n  \/\/ Enable serial for debug information.\n  Serial.begin(115200);\n}\n\n\/\/ This function is called when the master requests data from the slave.\nvoid respondToMasterEvent() {\n  \/\/ The analog pin can return values from 0 to 1023 (10 bits).\n  analogPinValue = analogRead(SENSOR_ANALOG_PIN);\n  \/\/ Put the value in two uint8_t to send in 8bit format over I2C\n  sendBuffer[0] = analogPinValue >> 8;\n  sendBuffer[1] = analogPinValue &amp; 0xff; \n  Wire.write(sendBuffer, BYTES_TO_SEND); \n  Serial.println(analogPinValue);\n}\n\nvoid loop() {\n  \/\/ Receiving the I2C message has priority over the code in the loop (it works with \n  \/\/ interrupts), but nothing happens in the loop in this sketch. \n  delay(1000);\n}<\/pre>\n\n\n\n<p>On the master side, we only need to enable the i2c communication. After this, each 5 seconds the master will request the current value of the slave using the slave address according to our code. On receiving the value, it will reassemble it from the 2 bytes it received in a single integer and send it to the serial port so you can see it on the Serial Monitor of the Arduino IDE.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"cpp\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">#include &lt;Wire.h>\n\/\/ Address of the slave on the bus.\nconst int SLAVE_ADDRESS = 0x10; \n\/\/ Number of bytes to request from the slave\nconst int BYTES_TO_REQUEST = 2;\n\/\/ Last value received from the slave\nint slaveIncomingValue = 0;\n\nvoid setup() {\n  \/\/ Enable I2C on the Arduino, including pull-up resistors.\n  Wire.begin();\n  \/\/ Enable serial for debug information\n  Serial.begin(115200);\n}\n\nvoid loop() {\n  \/\/ Request 4 bytes from slave device (slave may send less)\n  Wire.requestFrom(SLAVE_ADDRESS, BYTES_TO_REQUEST);    \n  \/\/ Read the bytes on the bus, two at a time\n  while (Wire.available() >= BYTES_TO_REQUEST) { \n    slaveIncomingValue = Wire.read() &lt;&lt; 8 | Wire.read(); \n  }\n  \/\/ Print the complete value received.\n  Serial.println(slaveIncomingValue);   \n   \n  \/\/ Read again from the slave in 5 seconds.\n  delay(5000);\n}\n<\/pre>\n\n\n\n<p>That&#8217;s it: the master can now request data from the slave, and you can see for yourself that the value is updated by changing the value of the potentiometer.<\/p>\n\n\n\n<p>If you wish to download the code example and try to for yourself, it&#8217;s available on my GitHub at <a href=\"https:\/\/github.com\/CindyPotvin\/I2C-Tutorial-Arduino\">https:\/\/github.com\/CindyPotvin\/I2C-Tutorial-Arduino<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>I hope that the products recommended here will help you build great projects. Just so you know, if you buy through the links on this page on Amazon or Banggood (among others), RobotsBench may get a small share of the sale (as an Amazon affilate, I earn from qualifying purchases). This helps to keep the &#8230; <a title=\"How to use i2C with Arduino\" class=\"read-more\" href=\"https:\/\/robotsbench.com\/i2c-communication-arduino\/\">Read more<span class=\"screen-reader-text\">How to use i2C with Arduino<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":783,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"none","_seopress_titles_title":"","_seopress_titles_desc":"i2C is used to connect various sensors and devices to an Arduino. In this article, I will show you how to connect two Arduino together over i2c to showcase both sides of the communication.","_seopress_robots_index":"","inline_featured_image":false},"categories":[87,108],"tags":[89,101,102,100,92,99],"featured_image_urls":{"full":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1821,945,false],"thumbnail":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-150x150.png",150,150,true],"medium":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-300x156.png",300,156,true],"medium_large":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-768x399.png",768,399,true],"large":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-1024x531.png",1024,531,true],"1536x1536":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1536,797,false],"2048x2048":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1821,945,false]},"post_excerpt_stackable":"<p>I hope that the products recommended here will help you build great projects. Just so you know, if you buy through the links on this page on Amazon or Banggood (among others), RobotsBench may get a small share of the sale (as an Amazon affilate, I earn from qualifying purchases). This helps to keep the site alive and allow me to write more articles. Thank you! The i2C protocol is one of the most popular way to communicate with sensors and devices with an Arduino. This protocol was built to limit the pins needed and to standardize the communication so&hellip;<\/p>\n","category_list":"<a href=\"https:\/\/robotsbench.com\/category\/arduino\/\" rel=\"category tag\">Arduino<\/a>, <a href=\"https:\/\/robotsbench.com\/category\/products\/\" rel=\"category tag\">Products<\/a>","author_info":{"name":"Cindy","url":"https:\/\/robotsbench.com\/author\/cindyptn\/"},"comments_num":"0 comments","featured_image_urls_v2":{"full":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1821,945,false],"thumbnail":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-150x150.png",150,150,true],"medium":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-300x156.png",300,156,true],"medium_large":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-768x399.png",768,399,true],"large":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1-1024x531.png",1024,531,true],"1536x1536":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1536,797,false],"2048x2048":["https:\/\/robotsbench.com\/wp-content\/uploads\/2019\/10\/I2C_breadboard-1.png",1821,945,false]},"post_excerpt_stackable_v2":"<p>I hope that the products recommended here will help you build great projects. Just so you know, if you buy through the links on this page on Amazon or Banggood (among others), RobotsBench may get a small share of the sale (as an Amazon affilate, I earn from qualifying purchases). This helps to keep the site alive and allow me to write more articles. Thank you! The i2C protocol is one of the most popular way to communicate with sensors and devices with an Arduino. This protocol was built to limit the pins needed and to standardize the communication so&hellip;<\/p>\n","category_list_v2":"<a href=\"https:\/\/robotsbench.com\/category\/arduino\/\" rel=\"category tag\">Arduino<\/a>, <a href=\"https:\/\/robotsbench.com\/category\/products\/\" rel=\"category tag\">Products<\/a>","author_info_v2":{"name":"Cindy","url":"https:\/\/robotsbench.com\/author\/cindyptn\/"},"comments_num_v2":"0 comments","_links":{"self":[{"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/posts\/386"}],"collection":[{"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/comments?post=386"}],"version-history":[{"count":22,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/posts\/386\/revisions"}],"predecessor-version":[{"id":1275,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/posts\/386\/revisions\/1275"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/media\/783"}],"wp:attachment":[{"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/media?parent=386"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/categories?post=386"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/robotsbench.com\/wp-json\/wp\/v2\/tags?post=386"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}