€•2OŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ//translations/zh_CN/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/zh_TW/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/it_IT/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/ja_JP/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/ko_KR/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/pt_BR/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ//translations/sp_SP/firmware-guide/acpi/dsd/phy”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒI/var/lib/git/docbuild/linux/Documentation/firmware-guide/acpi/dsd/phy.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒMDIO bus and PHYs in ACPI”h]”hŒMDIO bus and PHYs in ACPI”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ\The PHYs on an MDIO bus [phy] are probed and registered using fwnode_mdiobus_register_phy().”h]”hŒ\The PHYs on an MDIO bus [phy] are probed and registered using fwnode_mdiobus_register_phy().”…””}”(hhßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒuLater, for connecting these PHYs to their respective MACs, the PHYs registered on the MDIO bus have to be referenced.”h]”hŒuLater, for connecting these PHYs to their respective MACs, the PHYs registered on the MDIO bus have to be referenced.”…””}”(hhíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÞ)”}”(hŒThis document introduces two _DSD properties that are to be used for connecting PHYs on the MDIO bus [dsd-properties-rules] to the MAC layer.”h]”hŒThis document introduces two _DSD properties that are to be used for connecting PHYs on the MDIO bus [dsd-properties-rules] to the MAC layer.”…””}”(hhûh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÞ)”}”(hŒÙThese properties are defined in accordance with the "Device Properties UUID For _DSD" [dsd-guide] document and the daffd814-6eba-4d8c-8a91-bc9bbf4aa301 UUID must be used in the Device Data Descriptors containing them.”h]”hŒÝThese properties are defined in accordance with the “Device Properties UUID For _DSD†[dsd-guide] document and the daffd814-6eba-4d8c-8a91-bc9bbf4aa301 UUID must be used in the Device Data Descriptors containing them.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒ phy-handle”h]”hŒ phy-handle”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´KubhÞ)”}”(hŒÈFor each MAC node, a device property "phy-handle" is used to reference the PHY that is registered on an MDIO bus. This is mandatory for network interfaces that have PHYs connected to MAC via MDIO bus.”h]”hŒÌFor each MAC node, a device property “phy-handle†is used to reference the PHY that is registered on an MDIO bus. This is mandatory for network interfaces that have PHYs connected to MAC via MDIO bus.”…””}”(hj(h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjh²hubhÞ)”}”(hŒDuring the MDIO bus driver initialization, PHYs on this bus are probed using the _ADR object as shown below and are registered on the MDIO bus.”h]”hŒDuring the MDIO bus driver initialization, PHYs on this bus are probed using the _ADR object as shown below and are registered on the MDIO bus.”…””}”(hj6h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjh²hubhŒ literal_block”“”)”}”(hŒ‡Scope(\_SB.MDI0) { Device(PHY1) { Name (_ADR, 0x1) } // end of PHY1 Device(PHY2) { Name (_ADR, 0x2) } // end of PHY2 }”h]”hŒ‡Scope(\_SB.MDI0) { Device(PHY1) { Name (_ADR, 0x1) } // end of PHY1 Device(PHY2) { Name (_ADR, 0x2) } // end of PHY2 }”…””}”hjFsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆŒforce”‰Œlanguage”Œnone”Œhighlight_args”}”uh1jDh³hÇh´Khjh²hubhÞ)”}”(hXLater, during the MAC driver initialization, the registered PHY devices have to be retrieved from the MDIO bus. For this, the MAC driver needs references to the previously registered PHYs which are provided as device object references (e.g. \_SB.MDI0.PHY1).”h]”hXLater, during the MAC driver initialization, the registered PHY devices have to be retrieved from the MDIO bus. For this, the MAC driver needs references to the previously registered PHYs which are provided as device object references (e.g. _SB.MDI0.PHY1).”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K+hjh²hubeh}”(h]”Œ phy-handle”ah ]”h"]”Œ phy-handle”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒphy-mode”h]”hŒphy-mode”…””}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjoh²hh³hÇh´K1ubhÞ)”}”(hŒ‘The "phy-mode" _DSD property is used to describe the connection to the PHY. The valid values for "phy-mode" are defined in [ethernet-controller].”h]”hŒ™The “phy-mode†_DSD property is used to describe the connection to the PHY. The valid values for “phy-mode†are defined in [ethernet-controller].”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K2hjoh²hubeh}”(h]”Œphy-mode”ah ]”h"]”Œphy-mode”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K1ubhÉ)”}”(hhh]”(hÎ)”}”(hŒmanaged”h]”hŒmanaged”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj–h²hh³hÇh´K6ubhÞ)”}”(hŒ€Optional property, which specifies the PHY management type. The valid values for "managed" are defined in [ethernet-controller].”h]”hŒ„Optional property, which specifies the PHY management type. The valid values for “managed†are defined in [ethernet-controller].”…””}”(hj§h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K7hj–h²hubeh}”(h]”Œmanaged”ah ]”h"]”Œmanaged”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K6ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ fixed-link”h]”hŒ fixed-link”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj½h²hh³hÇh´K;ubhÞ)”}”(hXªThe "fixed-link" is described by a data-only subnode of the MAC port, which is linked in the _DSD package via hierarchical data extension (UUID dbb8e3e6-5886-4ba6-8795-1319f52a966b in accordance with [dsd-guide] "_DSD Implementation Guide" document). The subnode should comprise a required property ("speed") and possibly the optional ones - complete list of parameters and their values are specified in [ethernet-controller].”h]”hX¶The “fixed-link†is described by a data-only subnode of the MAC port, which is linked in the _DSD package via hierarchical data extension (UUID dbb8e3e6-5886-4ba6-8795-1319f52a966b in accordance with [dsd-guide] “_DSD Implementation Guide†document). The subnode should comprise a required property (“speedâ€) and possibly the optional ones - complete list of parameters and their values are specified in [ethernet-controller].”…””}”(hjÎh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KDocumentation/devicetree/bindings/net/ethernet-controller.yaml”h]”hŒ>Documentation/devicetree/bindings/net/ethernet-controller.yaml”…””}”(hjDh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KÅhjAubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj/ubeh}”(h]”h ]”h"]”h$]”h&]”uh1júh³hÇh´KÅhj÷h²hubjû)”}”(hŒi[dsd-guide] DSD Guide. https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc, referenced 2021-11-30.”h]”(j)”}”(hŒ[dsd-guide] DSD Guide.”h]”hŒ[dsd-guide] DSD Guide.”…””}”(hjbh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KÈhj^ubj)”}”(hhh]”hÞ)”}”(hŒRhttps://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc, referenced 2021-11-30.”h]”(hŒ reference”“”)”}”(hŒ:https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc”h]”hŒ:https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc”…””}”(hjyh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j{uh1jwhjsubhŒ, referenced 2021-11-30.”…””}”(hjsh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KÈhjpubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1júh³hÇh´KÈhj÷h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1jõhjÖh²hh³hÇh´Nubeh}”(h]”Œ references”ah ]”h"]”Œ references”ah$]”h&]”uh1hÈhjµh²hh³hÇh´K½ubeh}”(h]”Œ*mac-node-example-with-a-fixed-link-subnode”ah ]”h"]”Œ-mac node example with a "fixed-link" subnode.”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K£ubeh}”(h]”Œmdio-bus-and-phys-in-acpi”ah ]”h"]”Œmdio bus and phys in acpi”ah$]”h&]”uh1hÈhhh²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¶jljij“jjºj·jïjìjRjOj‰j†j²j¯j±j®j©j¦uŒ nametypes”}”(j¹‰jl‰j“‰jº‰jï‰jR‰j‰‰j²‰j±‰j©‰uh}”(j¶hÊjijjjoj·j–jìj½jOjòj†jUj¯jŒj®jµj¦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”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.