€•ü%      Œ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/power/regulator/design”Œ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/power/regulator/design”Œ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/power/regulator/design”Œ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/power/regulator/design”Œ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/power/regulator/design”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/pt_BR/power/regulator/design”Œ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/power/regulator/design”Œ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ŒRegulator API design notes”h]”hŒRegulator API design notes”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒD/var/lib/git/docbuild/linux/Documentation/power/regulator/design.rst”h´KubhŒ	paragraph”“”)”}”(hŒŠThis document provides a brief, partially structured, overview of some
of the design considerations which impact the regulator API design.”h]”hŒŠThis document provides a brief, partially structured, overview of some
of the design considerations which impact the regulator API design.”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒSafety”h]”hŒSafety”…””}”(hhÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhÛh²hh³hÊh´K	ubhŒblock_quote”“”)”}”(hXƒ  - Errors in regulator configuration can have very serious consequences
  for the system, potentially including lasting hardware damage.
- It is not possible to automatically determine the power configuration
  of the system - software-equivalent variants of the same chip may
  have different power requirements, and not all components with power
  requirements are visible to software.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒƒErrors in regulator configuration can have very serious consequences
for the system, potentially including lasting hardware damage.”h]”hÌ)”}”(hŒƒErrors in regulator configuration can have very serious consequences
for the system, potentially including lasting hardware damage.”h]”hŒƒErrors in regulator configuration can have very serious consequences
for the system, potentially including lasting hardware damage.”…””}”(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ôubhø)”}”(hŒóIt is not possible to automatically determine the power configuration
of the system - software-equivalent variants of the same chip may
have different power requirements, and not all components with power
requirements are visible to software.
”h]”hÌ)”}”(hŒòIt is not possible to automatically determine the power configuration
of the system - software-equivalent variants of the same chip may
have different power requirements, and not all components with power
requirements are visible to software.”h]”hŒòIt is not possible to automatically determine the power configuration
of the system - software-equivalent variants of the same chip may
have different power requirements, and not all components with power
requirements are visible to software.”…””}”(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ôubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hòh³hÊh´Khhîubah}”(h]”h ]”h"]”h$]”h&]”uh1hìh³hÊh´KhhÛh²hubhŒnote”“”)”}”(hŒ—The API should make no changes to the hardware state unless it has
specific knowledge that these changes are safe to perform on this
particular system.”h]”hÌ)”}”(hŒ—The API should make no changes to the hardware state unless it has
specific knowledge that these changes are safe to perform on this
particular system.”h]”hŒ—The API should make no changes to the hardware state unless it has
specific knowledge that these changes are safe to perform on this
particular system.”…””}”(hj=  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj9  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7  hhÛh²hh³hÊh´Nubeh}”(h]”Œsafety”ah ]”h"]”Œsafety”ah$]”h&]”uh1hµhh·h²hh³hÊh´K	ubh¶)”}”(hhh]”(h»)”}”(hŒConsumer use cases”h]”hŒConsumer use cases”…””}”(hj\  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjY  h²hh³hÊh´Kubhí)”}”(hX  - The overwhelming majority of devices in a system will have no
  requirement to do any runtime configuration of their power beyond
  being able to turn it on or off.

- Many of the power supplies in the system will be shared between many
  different consumers.
”h]”hó)”}”(hhh]”(hø)”}”(hŒ¡The overwhelming majority of devices in a system will have no
requirement to do any runtime configuration of their power beyond
being able to turn it on or off.
”h]”hÌ)”}”(hŒ The overwhelming majority of devices in a system will have no
requirement to do any runtime configuration of their power beyond
being able to turn it on or off.”h]”hŒ The overwhelming majority of devices in a system will have no
requirement to do any runtime configuration of their power beyond
being able to turn it on or off.”…””}”(hju  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjq  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h÷hjn  ubhø)”}”(hŒZMany of the power supplies in the system will be shared between many
different consumers.
”h]”hÌ)”}”(hŒYMany of the power supplies in the system will be shared between many
different consumers.”h]”hŒYMany of the power supplies in the system will be shared between many
different consumers.”…””}”(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jn  ubeh}”(h]”h ]”h"]”h$]”h&]”j/  j0  uh1hòh³hÊh´Khjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hìh³hÊh´KhjY  h²hubj8  )”}”(hŒ©The consumer API should be structured so that these use cases are
very easy to handle and so that consumers will work with shared
supplies without any additional effort.”h]”hÌ)”}”(hŒ©The consumer API should be structured so that these use cases are
very easy to handle and so that consumers will work with shared
supplies without any additional effort.”h]”hŒ©The consumer API should be structured so that these use cases are
very easy to handle and so that consumers will work with shared
supplies without any additional effort.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K$hj­  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7  hjY  h²hh³hÊh´Nubeh}”(h]”Œconsumer-use-cases”ah ]”h"]”Œconsumer use cases”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubeh}”(h]”Œregulator-api-design-notes”ah ]”h"]”Œregulator api design notes”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Ï  jV  jS  jÊ  jÇ  uŒ	nametypes”}”(jÒ  ‰jV  ‰jÊ  ‰uh}”(jÏ  h·jS  hÛjÇ  jY  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”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.