€•23      Œ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/devicetree/bindings/ABI”Œ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/devicetree/bindings/ABI”Œ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/devicetree/bindings/ABI”Œ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/devicetree/bindings/ABI”Œ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/devicetree/bindings/ABI”Œ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/devicetree/bindings/ABI”Œ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Œcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒE/var/lib/git/docbuild/linux/Documentation/devicetree/bindings/ABI.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDevicetree (DT) ABI”h]”hŒDevicetree (DT) ABI”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hXä  Regarding stable bindings/ABI, we quote from the 2013 ARM mini-summit
summary document:

  "That still leaves the question of, what does a stable binding look
  like?  Certainly a stable binding means that a newer kernel will not
  break on an older device tree, but that doesn't mean the binding is
  frozen for all time. Grant said there are ways to change bindings that
  don't result in breakage. For instance, if a new property is added,
  then default to the previous behaviour if it is missing. If a binding
  truly needs an incompatible change, then change the compatible string
  at the same time.  The driver can bind against both the old and the
  new. These guidelines aren't new, but they desperately need to be
  documented."
”h]”(hŒ	paragraph”“”)”}”(hŒWRegarding stable bindings/ABI, we quote from the 2013 ARM mini-summit
summary document:”h]”hŒWRegarding stable bindings/ABI, we quote from the 2013 ARM mini-summit
summary document:”…””}”(hhÖhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h KhhÐubhŒblock_quote”“”)”}”(hXw  "That still leaves the question of, what does a stable binding look
like?  Certainly a stable binding means that a newer kernel will not
break on an older device tree, but that doesn't mean the binding is
frozen for all time. Grant said there are ways to change bindings that
don't result in breakage. For instance, if a new property is added,
then default to the previous behaviour if it is missing. If a binding
truly needs an incompatible change, then change the compatible string
at the same time.  The driver can bind against both the old and the
new. These guidelines aren't new, but they desperately need to be
documented."
”h]”hÕ)”}”(hXv  "That still leaves the question of, what does a stable binding look
like?  Certainly a stable binding means that a newer kernel will not
break on an older device tree, but that doesn't mean the binding is
frozen for all time. Grant said there are ways to change bindings that
don't result in breakage. For instance, if a new property is added,
then default to the previous behaviour if it is missing. If a binding
truly needs an incompatible change, then change the compatible string
at the same time.  The driver can bind against both the old and the
new. These guidelines aren't new, but they desperately need to be
documented."”h]”hX€  â€œThat still leaves the question of, what does a stable binding look
like?  Certainly a stable binding means that a newer kernel will not
break on an older device tree, but that doesnâ€™t mean the binding is
frozen for all time. Grant said there are ways to change bindings that
donâ€™t result in breakage. For instance, if a new property is added,
then default to the previous behaviour if it is missing. If a binding
truly needs an incompatible change, then change the compatible string
at the same time.  The driver can bind against both the old and the
new. These guidelines arenâ€™t new, but they desperately need to be
documented.â€”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h K
hhæubah}”(h]”h ]”h"]”h$]”h&]”uh1hähŸh³h K
hhÐubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÎhhËhžhhŸh³h NubhÏ)”}”(hŒGeneral binding rules
”h]”hÕ)”}”(hŒGeneral binding rules”h]”hŒGeneral binding rules”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhhËhžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ
upperroman”Œprefix”hŒsuffix”Œ.”uh1hÉhh¶hžhhŸh³h Kubhå)”}”(hX  1) Maintainers, don't let perfect be the enemy of good.  Don't hold up a
   binding because it isn't perfect.

2) Use specific compatible strings so that if we need to add a feature (DMA)
   in the future, we can create a new compatible string.  See I.

3) Bindings can be augmented, but the driver shouldn't break when given
   the old binding. ie. add additional properties, but don't change the
   meaning of an existing property. For drivers, default to the original
   behaviour when a newly added property is missing.

4) Don't submit bindings for staging or unstable.  That will be decided by
   the devicetree maintainers *after* discussion on the mailinglist.
”h]”hÊ)”}”(hhh]”(hÏ)”}”(hŒhMaintainers, don't let perfect be the enemy of good.  Don't hold up a
binding because it isn't perfect.
”h]”hÕ)”}”(hŒgMaintainers, don't let perfect be the enemy of good.  Don't hold up a
binding because it isn't perfect.”h]”hŒmMaintainers, donâ€™t let perfect be the enemy of good.  Donâ€™t hold up a
binding because it isnâ€™t perfect.”…””}”(hj2  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h Khj.  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhj+  ubhÏ)”}”(hŒˆUse specific compatible strings so that if we need to add a feature (DMA)
in the future, we can create a new compatible string.  See I.
”h]”hÕ)”}”(hŒ‡Use specific compatible strings so that if we need to add a feature (DMA)
in the future, we can create a new compatible string.  See I.”h]”hŒ‡Use specific compatible strings so that if we need to add a feature (DMA)
in the future, we can create a new compatible string.  See I.”…””}”(hjJ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h KhjF  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhj+  ubhÏ)”}”(hX  Bindings can be augmented, but the driver shouldn't break when given
the old binding. ie. add additional properties, but don't change the
meaning of an existing property. For drivers, default to the original
behaviour when a newly added property is missing.
”h]”hÕ)”}”(hX  Bindings can be augmented, but the driver shouldn't break when given
the old binding. ie. add additional properties, but don't change the
meaning of an existing property. For drivers, default to the original
behaviour when a newly added property is missing.”h]”hX  Bindings can be augmented, but the driver shouldnâ€™t break when given
the old binding. ie. add additional properties, but donâ€™t change the
meaning of an existing property. For drivers, default to the original
behaviour when a newly added property is missing.”…””}”(hjb  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h Khj^  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhj+  ubhÏ)”}”(hŒŠDon't submit bindings for staging or unstable.  That will be decided by
the devicetree maintainers *after* discussion on the mailinglist.
”h]”hÕ)”}”(hŒ‰Don't submit bindings for staging or unstable.  That will be decided by
the devicetree maintainers *after* discussion on the mailinglist.”h]”(hŒeDonâ€™t submit bindings for staging or unstable.  That will be decided by
the devicetree maintainers ”…””}”(hjz  hžhhŸNh NubhŒemphasis”“”)”}”(hŒ*after*”h]”hŒafter”…””}”(hj„  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j‚  hjz  ubhŒ discussion on the mailinglist.”…””}”(hjz  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h K"hjv  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhj+  ubeh}”(h]”h ]”h"]”h$]”h&]”j"  Œarabic”j$  hj%  Œ)”uh1hÉhj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hähŸh³h Khh¶hžhubhÊ)”}”(hhh]”hÏ)”}”(hŒNotes
”h]”hÕ)”}”(hŒNotes”h]”hŒNotes”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h K%hj³  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhj°  hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”j"  j#  j$  hj%  j&  Œstart”Kuh1hÉhh¶hžhhŸh³h K%ubhå)”}”(hX  1) This document is intended as a general familiarization with the process as
   decided at the 2013 Kernel Summit.  When in doubt, the current word of the
   devicetree maintainers overrules this document.  In that situation, a patch
   updating this document would be appreciated.”h]”hÊ)”}”(hhh]”hÏ)”}”(hX  This document is intended as a general familiarization with the process as
decided at the 2013 Kernel Summit.  When in doubt, the current word of the
devicetree maintainers overrules this document.  In that situation, a patch
updating this document would be appreciated.”h]”hÕ)”}”(hX  This document is intended as a general familiarization with the process as
decided at the 2013 Kernel Summit.  When in doubt, the current word of the
devicetree maintainers overrules this document.  In that situation, a patch
updating this document would be appreciated.”h]”hX  This document is intended as a general familiarization with the process as
decided at the 2013 Kernel Summit.  When in doubt, the current word of the
devicetree maintainers overrules this document.  In that situation, a patch
updating this document would be appreciated.”…””}”(hjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h K'hjÙ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÎhjÖ  ubah}”(h]”h ]”h"]”h$]”h&]”j"  j¨  j$  hj%  j©  uh1hÉhjÒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hähŸh³h K'hh¶hžhubeh}”(h]”Œdevicetree-dt-abi”ah ]”h"]”Œdevicetree (dt) abi”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(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ÿ  sŒ	nametypes”}”j  ‰sh}”jÿ  h¶sŒ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”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hÕ)”}”(hŒ<Enumerated list start value not ordinal-1: "III" (ordinal 3)”h]”hŒ@Enumerated list start value not ordinal-1: â€œIIIâ€ (ordinal 3)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÔhjŒ  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jŠ  hh¶hžhhŸh³h K%ubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.