€•<      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/translations/zh_CN/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/zh_TW/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/it_IT/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ja_JP/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ko_KR/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/sp_SP/i2c/summary”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒIntroduction to I2C and SMBus”h]”hŒIntroduction to I2C and SMBus”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ9/var/lib/git/docbuild/linux/Documentation/i2c/summary.rst”h KubhŒ	paragraph”“”)”}”(hX%  IÂ²C (pronounce: I squared C and written I2C in the kernel documentation) is
a protocol developed by Philips. It is a two-wire protocol with variable
speed (typically up to 400 kHz, high speed modes up to 5 MHz). It provides
an inexpensive bus for connecting many types of devices with infrequent or
low bandwidth communications needs. I2C is widely used with embedded
systems. Some systems use variants that don't meet branding requirements,
and so are not advertised as being I2C but come under different names,
e.g. TWI (Two Wire Interface), IIC.”h]”hX'  IÂ²C (pronounce: I squared C and written I2C in the kernel documentation) is
a protocol developed by Philips. It is a two-wire protocol with variable
speed (typically up to 400 kHz, high speed modes up to 5 MHz). It provides
an inexpensive bus for connecting many types of devices with infrequent or
low bandwidth communications needs. I2C is widely used with embedded
systems. Some systems use variants that donâ€™t meet branding requirements,
and so are not advertised as being I2C but come under different names,
e.g. TWI (Two Wire Interface), IIC.”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒÖThe latest official I2C specification is the `"IÂ²C-bus specification and user
manual" (UM10204) <https://www.nxp.com/docs/en/user-guide/UM10204.pdf>`_
published by NXP Semiconductors, version 7 as of this writing.”h]”(hŒ-The latest official I2C specification is the ”…””}”(hhÇhžhhŸNh NubhŒ	reference”“”)”}”(hŒj`"IÂ²C-bus specification and user
manual" (UM10204) <https://www.nxp.com/docs/en/user-guide/UM10204.pdf>`_”h]”hŒ6â€œIÂ²C-bus specification and user
manualâ€ (UM10204)”…””}”(hhÑhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œ2"IÂ²C-bus specification and user manual" (UM10204)”Œrefuri”Œ2https://www.nxp.com/docs/en/user-guide/UM10204.pdf”uh1hÏhhÇubhŒtarget”“”)”}”(hŒ5 <https://www.nxp.com/docs/en/user-guide/UM10204.pdf>”h]”h}”(h]”Œ-i2c-bus-specification-and-user-manual-um10204”ah ]”h"]”Œ2"iÂ²c-bus specification and user manual" (um10204)”ah$]”h&]”Œrefuri”hâuh1hãŒ
referenced”KhhÇubhŒ?
published by NXP Semiconductors, version 7 as of this writing.”…””}”(hhÇhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hX“  SMBus (System Management Bus) is based on the I2C protocol, and is mostly
a subset of I2C protocols and signaling. Many I2C devices will work on an
SMBus, but some SMBus protocols add semantics beyond what is required to
achieve I2C branding. Modern PC mainboards rely on SMBus. The most common
devices connected through SMBus are RAM modules configured using I2C EEPROMs,
and hardware monitoring chips.”h]”hX“  SMBus (System Management Bus) is based on the I2C protocol, and is mostly
a subset of I2C protocols and signaling. Many I2C devices will work on an
SMBus, but some SMBus protocols add semantics beyond what is required to
achieve I2C branding. Modern PC mainboards rely on SMBus. The most common
devices connected through SMBus are RAM modules configured using I2C EEPROMs,
and hardware monitoring chips.”…””}”(hhýhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hX  Because the SMBus is mostly a subset of the generalized I2C bus, we can
use its protocols on many I2C systems. However, there are systems that don't
meet both SMBus and I2C electrical constraints; and others which can't
implement all the common SMBus protocol semantics or messages.”h]”hX  Because the SMBus is mostly a subset of the generalized I2C bus, we can
use its protocols on many I2C systems. However, there are systems that donâ€™t
meet both SMBus and I2C electrical constraints; and others which canâ€™t
implement all the common SMBus protocol semantics or messages.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒTerminology”h]”hŒTerminology”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K ubh¸)”}”(hŒOThe I2C bus connects one or more controller chips and one or more target chips.”h]”hŒOThe I2C bus connects one or more controller chips and one or more target chips.”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K"hj  hžhubŒkfigure”Œkernel_figure”“”)”}”(hhh]”hŒfigure”“”)”}”(hhh]”(hŒimage”“”)”}”(hŒp.. kernel-figure::  i2c_bus.svg
   :alt:    Simple I2C bus with one controller and 3 targets

   Simple I2C bus
”h]”h}”(h]”h ]”h"]”h$]”h&]”Œalt”Œ0Simple I2C bus with one controller and 3 targets”Œuri”Œi2c/i2c_bus.svg”Œ
candidates”}”Œ*”jR  suh1jC  hj@  hŸh¶h K ubhŒcaption”“”)”}”(hŒSimple I2C bus”h]”hŒSimple I2C bus”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jV  hŸh¶h K'hj@  ubeh}”(h]”Œid1”ah ]”h"]”h$]”h&]”uh1j>  hj;  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9  hj  hžhhŸh¶h Nubh¸)”}”(hŒàA **controller** chip is a node that starts communications with targets. In the
Linux kernel implementation it is also called an "adapter" or "bus". Controller
drivers are usually in the ``drivers/i2c/busses/`` subdirectory.”h]”(hŒA ”…””}”(hjs  hžhhŸNh NubhŒstrong”“”)”}”(hŒ**controller**”h]”hŒ
controller”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j{  hjs  ubhŒ³ chip is a node that starts communications with targets. In the
Linux kernel implementation it is also called an â€œadapterâ€ or â€œbusâ€. Controller
drivers are usually in the ”…””}”(hjs  hžhhŸNh NubhŒliteral”“”)”}”(hŒ``drivers/i2c/busses/``”h]”hŒdrivers/i2c/busses/”…””}”(hj‘  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjs  ubhŒ subdirectory.”…””}”(hjs  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K)hj  hžhubh¸)”}”(hŒüAn **algorithm** contains general code that can be used to implement a whole
class of I2C controllers. Each specific controller driver either depends on an
algorithm driver in the ``drivers/i2c/algos/`` subdirectory, or includes its
own implementation.”h]”(hŒAn ”…””}”(hj©  hžhhŸNh Nubj|  )”}”(hŒ**algorithm**”h]”hŒ	algorithm”…””}”(hj±  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j{  hj©  ubhŒ¤ contains general code that can be used to implement a whole
class of I2C controllers. Each specific controller driver either depends on an
algorithm driver in the ”…””}”(hj©  hžhhŸNh Nubj  )”}”(hŒ``drivers/i2c/algos/``”h]”hŒdrivers/i2c/algos/”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj©  ubhŒ2 subdirectory, or includes its
own implementation.”…””}”(hj©  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K-hj  hžhubh¸)”}”(hXš  A **target** chip is a node that responds to communications when addressed by a
controller. In the Linux kernel implementation it is also called a "client".
While targets are usually separate external chips, Linux can also act as a
target (needs hardware support) and respond to another controller on the bus.
This is then called a **local target**. In contrast, an external chip is called
a **remote target**.”h]”(hŒA ”…””}”(hjÛ  hžhhŸNh Nubj|  )”}”(hŒ
**target**”h]”hŒtarget”…””}”(hjã  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j{  hjÛ  ubhXD   chip is a node that responds to communications when addressed by a
controller. In the Linux kernel implementation it is also called a â€œclientâ€.
While targets are usually separate external chips, Linux can also act as a
target (needs hardware support) and respond to another controller on the bus.
This is then called a ”…””}”(hjÛ  hžhhŸNh Nubj|  )”}”(hŒ**local target**”h]”hŒlocal target”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j{  hjÛ  ubhŒ,. In contrast, an external chip is called
a ”…””}”(hjÛ  hžhhŸNh Nubj|  )”}”(hŒ**remote target**”h]”hŒremote target”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j{  hjÛ  ubhŒ.”…””}”(hjÛ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K2hj  hžhubh¸)”}”(hŒ±Target drivers are kept in a directory specific to the feature they provide,
for example ``drivers/gpio/`` for GPIO expanders and ``drivers/media/i2c/`` for
video-related chips.”h]”(hŒYTarget drivers are kept in a directory specific to the feature they provide,
for example ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``drivers/gpio/``”h]”hŒdrivers/gpio/”…””}”(hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ for GPIO expanders and ”…””}”(hj  hžhhŸNh Nubj  )”}”(hŒ``drivers/media/i2c/``”h]”hŒdrivers/media/i2c/”…””}”(hj9  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ for
video-related chips.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K9hj  hžhubh¸)”}”(hŒ©For the example configuration in the figure above, you will need one driver for
the I2C controller, and drivers for your I2C targets. Usually one driver for
each target.”h]”hŒ©For the example configuration in the figure above, you will need one driver for
the I2C controller, and drivers for your I2C targets. Usually one driver for
each target.”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K=hj  hžhubh¢)”}”(hhh]”(h§)”}”(hŒSynonyms”h]”hŒSynonyms”…””}”(hjb  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj_  hžhhŸh¶h KBubh¸)”}”(hX@  As mentioned above, the Linux I2C implementation historically uses the terms
"adapter" for controller and "client" for target. A number of data structures
have these synonyms in their name. So, when discussing implementation details,
you should be aware of these terms as well. The official wording is preferred,
though.”h]”hXH  As mentioned above, the Linux I2C implementation historically uses the terms
â€œadapterâ€ for controller and â€œclientâ€ for target. A number of data structures
have these synonyms in their name. So, when discussing implementation details,
you should be aware of these terms as well. The official wording is preferred,
though.”…””}”(hjp  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KDhj_  hžhubeh}”(h]”Œsynonyms”ah ]”h"]”Œsynonyms”ah$]”h&]”uh1h¡hj  hžhhŸh¶h KBubh¢)”}”(hhh]”(h§)”}”(hŒOutdated terminology”h]”hŒOutdated terminology”…””}”(hj‰  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj†  hžhhŸh¶h KKubh¸)”}”(hXË  In earlier I2C specifications, controller was named "master" and target was
named "slave". These terms have been obsoleted with v7 of the specification and
their use is also discouraged by the Linux Kernel Code of Conduct. You may
still find them in references to documentation which has not been updated. The
general attitude, however, is to use the inclusive terms: controller and
target. Work to replace the old terminology in the Linux Kernel is on-going.”h]”hXÓ  In earlier I2C specifications, controller was named â€œmasterâ€ and target was
named â€œslaveâ€. These terms have been obsoleted with v7 of the specification and
their use is also discouraged by the Linux Kernel Code of Conduct. You may
still find them in references to documentation which has not been updated. The
general attitude, however, is to use the inclusive terms: controller and
target. Work to replace the old terminology in the Linux Kernel is on-going.”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KMhj†  hžhubeh}”(h]”Œoutdated-terminology”ah ]”h"]”Œoutdated terminology”ah$]”h&]”uh1h¡hj  hžhhŸh¶h KKubeh}”(h]”Œterminology”ah ]”h"]”Œterminology”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K ubeh}”(h]”Œintroduction-to-i2c-and-smbus”ah ]”h"]”Œintroduction to i2c and smbus”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jà  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jº  j·  hîhëj²  j¯  jƒ  j€  jª  j§  uŒ	nametypes”}”(jº  ‰hîˆj²  ‰jƒ  ‰jª  ‰uh}”(j·  h£hëhåj¯  j  j€  j_  j§  j†  jh  j@  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”jî  Ks…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.